PowerScaleOneFS CLI Command Reference

Syntax

isi smb shares create <name> <path>
  [--zone <string>]
  [--inheritable-path-acl {yes | no}]
  [--continuously-available {yes | no}]
  [--create-path
  [--host-acl <string>]
  [--description <string>]
  [--csc-policy {none | documents | manual | programs}]
  [--allow-variable-expansion {yes | no}]
  [--auto-create-directory {yes | no}]
  [--browsable {yes | no}]
  [--allow-execute-always {yes | no}]
  [--directory-create-mask <integer>]
  [--strict-locking {yes | no}]
  [--hide-dot-files {yes | no}]
  [--impersonate-guest {always | "bad user" | never}]
  [--strict-flush {yes | no}]
  [--access-based-enumeration {yes | no}]
  [--access-based-enumeration-root-only {yes | no}]
  [--continuously-available {yes | no}]
  [--ca-timeout <integer>]
  [--strict-ca-lockout {yes | no}]
  [--ca-write-integrity {none | write-read-coherent | full}]
  [--mangle-byte-start <string>]
  [--file-create-mask <integer>]
  [--create-permissions {"default acl" | "inherit mode bits" 
    | "use create mask and mode"}]
  [--mangle-map <string>]
  [--impersonate-user <string>]
  [--change-notify <string>]
  [--oplocks {yes | no}]
  [--allow-delete-readonly {yes | no}]
  [--directory-create-mode <integer>]
  [--ntfs-acl-support {yes | no}]
  [--file-create-mode <integer>]
  [--file-filtering-enabled {yes | no}]
  [--file-filter-type {deny | allow}]
  [--file-filter-extensions <string>]
  [--smb3-encryption-enabled {yes | no}
  [--help | -h]
  [--verbose | -v]
  

Required Privileges

ISI_PRIV_SMB

Options

<name>

Required. Specifies the name for the new SMB share.

<path>

Required. Specifies the full path of the SMB share to create, beginning at /ifs.

--zone <string>

Specifies the access zone the new SMB share is assigned to. If no access zone is specified, the new SMB share is assigned to the default System zone.

{--inheritable-path-acl | -i} {yes | no}

If set to yes, if the parent directory has an inheritable access control list (ACL), its ACL will be inherited on the share path. The default setting is no.

--create-path

Creates the SMB-share path if one doesn't exist.

--host-acl <string>

Specifies the ACL that defines host access. Specify --host-acl for each additional host ACL clause.

--description <string>

Specifies a description for the SMB share.

--csc-policy {none | documents | manual | programs}

Sets the client-side caching policy for the share.

--allow-variable-expansion {yes | no}

Specifies automatic expansion of variables for home directories.

--directory-create-mask <integer>

Creates home directories automatically.

--browsable {yes | no}, -b {yes | no}

If set to yes, makes the share visible in net view and the browse list. The default setting is yes.

--allow-execute-always {yes | no}

If set to yes, allows a user with read access to a file to also execute the file. The default setting is no.

--directory-create-mask <integer>

Defines which mask bits are applied when a directory is created.

--strict-locking {yes | no}

If set to yes, directs the server to check for and enforce file locks. The default setting is no.

--hide-dot-files {yes | no}

If set to yes, hides files that begin with a decimal—for example, UNIX configuration files. The default setting is no.

--impersonate-guest {always | "bad user" | never}

Allows guest access to the share. The acceptable values are always, "bad user", and never.

--strict-flush {yes | no}

If set to yes, flush requests are always honored. The default setting is yes.

--access-based-enumeration {yes | no}

If set to yes, enables access-based enumeration only on the files and folders that the requesting user can access. The default setting is no.

--access-based-enumeration-root-only {yes | no}

If set to yes, enables access-based enumeration only on the root directory of the SMB share. The default setting is no.

--continuously-available {yes | no}

If set to yes, the share allows certain Windows clients to open persistent handles that can be reclaimed after a network disconnect or server failure. The default is no.

--ca-timeout <integer>

The amount of time, in seconds, a persistent handle is retained after a client is disconnected or a server fails. The default is 120 seconds.

--strict-ca-lockout {yes | no}

If set to yes, prevents a client from opening a file if another client has an open but disconnected persistent handle for that file. If set to no, OneFS issues persistent handles, but discards them if any client other than the original opener attempts to open the file. The default is yes.

--ca-write-integrity {none | write-read-coherent | full}

Specifies the level of write integrity on continuously available shares:

none

Continuously available writes are not handled differently than other writes to the cluster. If you specify none and a node fails, you may experience data loss without notification. Therefore, we do not recommend this option.

write-read-coherent

Ensures that writes to the share are moved to persistent storage before a success message is returned to the SMB client that sent the data. This is the default setting.

full

Ensures that writes to the share are moved to persistent storage before a success message is returned to the SMB client that sent the data, and prevents OneFS from granting SMB clients write-caching and handle-caching leases.

--mangle-byte-start <string>

Specifies the wchar_t starting point for automatic invalid byte mangling.

--file-create-mask <integer>

Defines which mask bits are applied when a file is created.

--create-permissions {"default acl" | "inherit mode bits" | "use create mask and mode"}

Sets the default permissions to apply when a file or directory is created. Valid values are "default acl", "inherit mode bits", and "use create mask and mode"

--mangle-map <string>

Maps characters that are valid in OneFS but are not valid in SMB names.

--impersonate-user <string>

Allows all file access to be performed as a specific user. This value must be a fully qualified user name.

--change-notify {norecurse | all | none}

Defines the change notify setting. The acceptable values are norecurse, all, or none.

--oplocks {yes | no}

If set to yes, allows oplock requests. The default setting is yes.

--allow-delete-readonly {yes | no}

If set to yes, allows read-only files to be deleted. The default setting is no.

--directory-create-mode <integer>

Defines which mode bits are applied when a directory is created.

--ntfs-acl-support {yes | no}

If set to yes, allows ACLs to be stored and edited from SMB clients. The default setting is yes.

--file-create-mode <integer>

Defines which mode bits are applied when a file is created.

--file-filtering-enabled {yes | no}

If set to yes, enables file filtering at the share level. The default setting is no.

--file-filter-type {deny | allow}

If set to allow, allows the specified file types to be written to the share. The default setting is deny.

--file-filter-extensions <string>

Specifies the list of file extensions to deny or allow writes to the share, depending on the setting of --file-filter-type. File types may be specified in a list of comma separated values.

--smb3-encryption-enabled {yes | no}

Enables SMBv3 encryption on the share.

{--verbose | -v}

Displays more detailed information.

--help | -h

Display help for this command.