PowerScaleOneFS CLI Command Reference

Syntax

isi nfs exports modify <id>
        [--block-size <SIZE>]
        [--revert-block-size]
        [--can-set-time <boolean>]
        [--revert-can-set-time]
        [--case-insensitive <boolean>]
        [--revert-case-insensitive]
        [--case-preserving <boolean>]
        [--revert-case-preserving]
        [--chown-restricted <boolean>]
        [--revert-chown-restricted]
        [--directory-transfer-size <SIZE>]
        [--revert-directory-transfer-size]
        [--link-max <integer>]
        [--revert-link-max]
        [--max-file-size <SIZE>]
        [--revert-max-file-size]
        [--name-max-size <integer>]
        [--revert-name-max-size]
        [--no-truncate <boolean>]
        [--revert-no-truncate]
        [--return-32bit-file-ids <boolean>]
        [--revert-return-32bit-file-ids]
        [--symlinks <boolean>]
        [--revert-symlinks]
        [--new-zone <string>]
        [--description <string>]
        [--paths <path> | --clear-paths | --add-paths <path> | --remove-paths
          <path>]
        [--clients <client> | --clear-clients | --add-clients <client> |
          --remove-clients <client>]
        [--root-clients <client> | --clear-root-clients | --add-root-clients
          <client> | --remove-root-clients <client>]
        [--read-write-clients <client> | --clear-read-write-clients |
          --add-read-write-clients <client> | --remove-read-write-clients
          <client>]
        [--read-only-clients <client> | --clear-read-only-clients |
          --add-read-only-clients <client> | --remove-read-only-clients
          <client>]
        [--all-dirs <boolean>]
        [--revert-all-dirs]
        [--encoding <string>]
        [--revert-encoding]
        [--security-flavors (unix | krb5 | krb5i | krb5p) |
          --clear-security-flavors | --add-security-flavors (unix | krb5 | krb5i
          | krb5p) | --remove-security-flavors (unix | krb5 | krb5i | krb5p)]
        [--revert-security-flavors]
        [--snapshot <snapshot>]
        [--revert-snapshot]
        [--map-lookup-uid <boolean>]
        [--revert-map-lookup-uid]
        [--map-retry <boolean>]
        [--revert-map-retry]
        [--map-root-enabled <boolean>]
        [--map-non-root-enabled <boolean>]
        [--map-failure-enabled <boolean>]
        [--map-all <identity>]
        [--revert-map-all]
        [--map-root <identity>]
        [--revert-map-root]
        [--map-non-root <identity>]
        [--revert-map-non-root]
        [--map-failure <identity>]
        [--revert-map-failure]
        [--map-full <boolean>]
        [--revert-map-full]
        [--commit-asynchronous <boolean>]
        [--revert-commit-asynchronous]
        [--read-only <boolean>]
        [--revert-read-only]
        [--readdirplus <boolean>]
        [--revert-readdirplus]
        [--readdirplus-prefetch <integer>]
        [--revert-readdirplus-prefetch]
        [--read-transfer-max-size <SIZE>]
        [--revert-read-transfer-max-size]
        [--read-transfer-multiple <integer>]
        [--revert-read-transfer-multiple]
        [--read-transfer-size <SIZE>]
        [--revert-read-transfer-size]
        [--setattr-asynchronous <boolean>]
        [--revert-setattr-asynchronous]
        [--time-delta <time delta>]
        [--revert-time-delta]
        [--write-datasync-action (datasync | filesync | unstable)]
        [--revert-write-datasync-action]
        [--write-datasync-reply (datasync | filesync)]
        [--revert-write-datasync-reply]
        [--write-filesync-action (datasync | filesync | unstable)]
        [--revert-write-filesync-action]
        [--write-filesync-reply (filesync)]
        [--write-unstable-action (datasync | filesync | unstable)]
        [--revert-write-unstable-action]
        [--write-unstable-reply (datasync | filesync | unstable)]
        [--revert-write-unstable-reply]
        [--write-transfer-max-size <SIZE>]
        [--revert-write-transfer-max-size]
        [--write-transfer-multiple <integer>]
        [--revert-write-transfer-multiple]
        [--write-transfer-size <SIZE>]
        [--revert-write-transfer-size]
        [--zone <string>]
        [{--force | -f}]
        [--ignore-unresolvable-hosts]
        [--ignore-bad-paths]
        [--ignore-bad-auth]
        [--ignore-conflicts]
        [{--verbose | -v}]
        [{--help | -h}]

Required Privileges

IISI_PRIV_NFS.

Options

--block-size <size>

Specifies the block size, in bytes.

--revert-block-size

Restores the setting to the system default.

--can-set-time {yes|no}

If set to yes, enables the export to set time. The default setting is no.

--revert-can-set-time

Restores the setting to the system default.

--case-insensitive {yes|no}

If set to yes, the server will report that it ignores case for file names. The default setting is no.

--revert-case-insensitive

Restores the setting to the system default.

--case-preserving {yes|no}

If set to yes, the server will report that it always preserves case for file names. The default setting is no.

--revert-case-preserving

Restores the setting to the system default.

--chown-restricted {yes|no}

If set to yes, the server will report that only the superuser can change file ownership. The default setting is no.

--revert-chown-restricted

Restores the setting to the system default.

--directory-transfer-size <size>

Specifies the preferred directory transfer size. Valid values are a number followed by a case-sensitive unit of measure: b for bytes; K for KB; M for MB; or G for GB. If no unit is specified, bytes are used by default. The maximum value is 4294967295b. The initial default value is 128K.

--revert-directory-transfer-size

Restores the setting to the system default.

--link-max <integer>

The reported maximum number of links to a file.

--revert-link-max

Restores the setting to the system default.

--max-file-size <size>

Specifies the maximum allowed file size on the server (in bytes). If a file is larger than the specified value, an error is returned.

--revert-max-file-size

Restores the setting to the system default.

--name-max-size <integer>

The reported maximum length of characters in a filename.

--revert-name-max-size

Restores the setting to the system default.

--no-truncate {yes|no}

If set to yes, too-long file names will result in an error rather than be truncated.

--revert-no-truncate

Restores the setting to the system default.

--return-32bit-file-ids {yes|no}

Applies to NFSv3 and later. If set to yes, limits the size of file identifiers returned from readdir to 32-bit values. The default value is no.

NOTE: This setting is provided for backward compatibility with older NFS clients, and should not be enabled unless necessary.

--revert-return-32bit-file-ids

Restores the setting to the system default.

--symlinks {yes|no}

If set to yes, advertises support for symlinks. The default setting is no.

--revert-symlinks

Restores the setting to the system default.

--new-zone <string>

Specifies a new access zone in which the export should apply. The default zone is system.

--all-dirs {yes|yesno}

If set to yes, this export will cover all directories. The default setting is no.

--revert-all-dirs

Restores the setting to the system default.

--encoding <string>

Specifies the character encoding of clients connecting through this NFS export.

Valid values and their corresponding character encodings are provided in the following table. These values are taken from the node's /etc/encodings.xml file, and are not case sensitive.

Table 1. --encoding--encoding

Value	Encoding
cp932	Windows-SJIS
cp949	Windows-949
cp1252	Windows-1252
euc-kr	EUC-KR
euc-jp	EUC-JP
euc-jp-ms	EUC-JP-MS
utf-8-mac	UTF-8-MAC
utf-8	UTF-8
iso-8859-1	ISO-8859-1 (Latin-1)
iso-8859-2	ISO-8859-2 (Latin-2)
iso-8859-3	ISO-8859-3 (Latin-3)
iso-8859-4	ISO-8859-4 (Latin-4)
iso-8859-5	ISO-8859-5 (Cyrillic)
iso-8859-6	ISO-8859-6 (Arabic)
iso-8859-7	ISO-8859-7 (Greek)
iso-8859-8	ISO-8859-8 (Hebrew)
iso-8859-9	ISO-8859-9 (Latin-5)
iso-8859-10	ISO-8859-10 (Latin-6)
iso-8859-13	ISO-8859-13 (Latin-7)
iso-8859- 14	ISO-8859-14 (Latin-8)
iso-8859-15	ISO-8859-15 (Latin-9)
iso-8859-16	ISO-8859-16 (Latin-10)

--revert-encoding

Restores the setting to the system default.

--security-flavors {unix|krb5|krb5i|krb5p} ...

Specifies a security flavor to support. To support multiple security flavors, repeat this option for each additional entry. The following values are valid:

unix

UNIX authentication.

krb5

Kerberos V5 authentication.

krb5i

Kerberos V5 authentication with integrity.

krb5p

Kerberos V5 authentication with privacy.

--revert-security-flavors

Restores the setting to the system default.

--snapshot {<snapshot>|<snapshot-alias>}

Specifies the ID of a snapshot or snapshot alias to export. If you specify this option, directories will be exported in the state captured in either the specified snapshot or the snapshot referenced by the specified snapshot alias. If the snapshot does not capture the exported path, the export will be inaccessible to users.

If you specify a snapshot alias, and the alias is later modified to reference a new snapshot, the new snapshot will be automatically applied to the export.

Because snapshots are read-only, clients will not be able to modify data through the export unless you specify the ID of a snapshot alias that references the live version of the file system.

Specify <snapshot> or <snapshot-alias> as the ID or name of a snapshot or snapshot alias.

--revert-snapshot

Restores the setting to the system default.

--map-lookup-uid {yes|no}

If set to yes, incoming UNIX user identifiers (UIDs) will be looked up locally. The default setting is no.

--revert-map-lookup-uid

Restores the setting to the system default.

--map-retry {yes|no}

If set to yes, the system will retry failed user-mapping lookups. The default setting is no.

--revert-map-retry

Restores the setting to the system default.

--map-root-enabled {yes|no}

Enable/disable mapping incoming root users to a specific account.

--revert-map-root-enabled

Restores the setting to the system default.

--map-non-root-enabled {yes|no}

Enable/disable mapping incoming non-root users to a specific account.

--revert-map-non-root-enabled

Restores the setting to the system default.

--map-failure-enabled {yes|no}

Enable/disable mapping users to a specific account after failing an auth lookup.

--revert-map-failure-enabled

Restores the setting to the system default.

--map-all <identity>

Specifies the default identity that operations by any user will run as. If this option is not set to root, you can allow the root user of a specific client to run operations as the root user of the cluster by including the client in the --root-clients list.

--revert-map-all

Restores the setting to the system default.

--map-root <identity>

Map incoming root users to a specific user and/or group ID.

--revert-map-root

Restores the setting to the system default.

--map-non-root <identity>

Map non-root users to a specific user and/or group ID.

--revert-map-non-root

Restores the setting to the system default.

--map-failure <identity>

Map users to a specific user and/or group ID after a failed auth attempt.

--revert-map-failure

Restores the setting to the system default.

--map-full {yes|no}

Determines how user mapping is accomplished if a user is specified in an export option such as --map-root or --map-all. When enabled, a user mapping queries the OneFS user database and retrieves users from the applicable authentication subsystem, such as local authentication or Active Directory. When disabled, only local authentication is queried.

The default setting is yes.

--revert-map-full

Restores the --map-full setting to the system default, yes.

--commit-asynchronous {yes|no}

If set to yes, enables commit data operations to be performed asynchronously. The default setting is no

--revert-commit-asynchronous

Restores the setting to the system default.

--read-only {yes|no}

Determines the default privileges for all clients accessing the export.

If set to yes, you can grant read/write privileges to a specific client by including the client in the --read-write-clients list.

If set to no, you can make a specific client read-only by including the client in the --read-only-clients list. The default setting is no.

--revert-read-only

Restores the setting to the system default.

--readdirplus {yes|no}

Applies to NFSv3 only. If set to yes, enables processing of readdir-plus requests. The default setting is no.

--revert-readdirplus

Restores the setting to the system default.

--read-transfer-max-size <size>

Specifies the maximum read transfer size to report to NFSv3 and NFSv4 clients. Valid values are a number followed by a case-sensitive unit of measure: b for bytes; K for KB; M for MB; or G for GB. If no unit is specified, bytes are used by default. The maximum value is 4294967295b. The initial default value is 512K.

--revert-read-transfer-max-size

Restores the setting to the system default.

--read-transfer-multiple <integer>

Specifies the suggested multiple read size to report to NFSv3 and NFSv4 clients. Valid values are 0-4294967295. The initial default value is 512.

--revert-read-transfer-multiple

Restores the setting to the system default.

--read-transfer-size <size>

Specifies the preferred read transfer size to report to NFSv3 and NFSv4 clients. Valid values are a number followed by a case-sensitive unit of measure: b for bytes; K for KB; M for MB; or G for GB. If no unit is specified, bytes are used by default. The maximum value is 4294967295b. The initial default value is 128K.

--revert-read-transfer-size

Restores the setting to the system default.

--setattr-asynchronous {yes|no}

If set to yes, performs set-attributes operations asynchronously. The default setting is no.

--revert-setattr-asynchronous

Restores the setting to the system default.

--time-delta <integer>

Specifies server time granularity, in seconds.

--revert-time-delta

Restores the setting to the system default.

--write-datasync-action {datasync|filesync|unstable}

Applies to NFSv3 and NFSv4 only. Specifies an alternate datasync write method. The following values are valid:

• datasync
• filesync
• unstable

The default value is datasync, which performs the request as specified.

--revert-write-datasync-action

Restores the setting to the system default.

--write-datasync-reply {datasync|filesync}

Applies to NFSv3 and NFSv4 only. Specifies an alternate datasync reply method. The following values are valid:

• datasync
• filesync

The default value is datasync (does not respond differently).

--revert-write-datasync-reply

Restores the setting to the system default.

--write-filesync-action {datasync|filesync|unstable}

Applies to NFSv3 and NFSv4 only. Specifies an alternate filesync write method. The following values are valid:

• datasync
• filesync
• unstable

The default value is filesync, which performs the request as specified.

--revert-write-filesync-action

Restores the setting to the system default.

--write-filesync-reply {filesync}

Applies to NFSv3 and NFSv4 only. Specifies an alternate filesync reply method. The only valid value is filesync (does not respond differently).

--write-unstable-action {datasync|filesync|unstable}

Specifies an alternate unstable-write method. The following values are valid:

• datasync
• filesync
• unstable

The default value is unstable, which performs the request as specified.

--revert-write-unstable-action

Restores the setting to the system default.

--write-unstable-reply {datasync|filesync|unstable}

Specifies an alternate unstable-reply method. The following values are valid:

• datasync
• filesync
• unstable

The default value is unstable (does not respond differently).

--revert-write-unstable-reply

Restores the setting to the system default.

--write-transfer-max-size <size>

Specifies the preferred read transfer size to report to NFSv3 and NFSv4 clients. Valid values are a number followed by a case-sensitive unit of measure: b for bytes; K for KB; M for MB; or G for GB. If no unit is specified, bytes are used by default. The maximum value is 4294967295b. The initial default value is 512K.

--revert-write-transfer-max-size

Restores the setting to the system default.

--write-transfer-multiple <integer>

Specifies the suggested write transfer multiplier to report to NFSv3 and NFSv4 clients. Valid values are 0–4294967295. The initial default value is 512.

--revert-write-transfer-multiple

Restores the setting to the system default.

--write-transfer-size <size>

Specifies the preferred read transfer size to report to NFSv3 and NFSv4 clients. Valid values are a number followed by a case-sensitive unit of measure: b for bytes; K for KB; M for MB; or G for GB. If no unit is specified, bytes are used by default. The maximum value is 4294967295b. The initial default value is 512K.

--revert-write-transfer-size

Restores the setting to the system default.

--zone

Access zone in which the export was originally created.

--force

If set to no (default), a confirmation prompt displays when the command runs. If set to yes, the command runs without prompting for confirmation.

--ignore-unresolvable-hosts

Does not generate an error on unresolvable hosts while creating/modifying the export.

--ignore-bad-paths

Does not generate an error on bad paths while creating/modifying the export.

--ignore-conflicts

Ignore bad authentication for mapping options while creating/modifying the export.

--ignore-conflicts

Ignore conflicts between the new/modified export and the existing configuration.

--verbose

Displays more detailed information.

--help | -h

Display help for this command.