PowerScale OneFS 9.3.0.0 CLI Command Reference

Syntax

isi ftp settings modify
  [--accept-timeout <duration>]
  [--revert-accept-timeout]      
  [--allow-anon-access {yes | no}]
  [--revert-allow-anon-access]
  [--allow-anon-upload {yes | no}]
  [--revert-allow-anon-upload
  [--allow-dirlists {yes | no}]
  [--revert-allow-dirlists]
  [--allow-downloads {yes | no}]
  [--revert-allow-downloads]
  [--allow-local-access {yes | no}]
  [--revert-allow-local-access]
  [--allow-writes {yes | no}]
  [--revert-allow-writes]
  [--always-chdir-homedir {yes | no}]
  [--revert-always-chdir-homedir]
  [--anon-chown-username <string>]
  [--revert-anon-chown-username]
  [--anon-password-list <string>...]
  [--clear-anon-password-list]
  [--add-anon-password-list <string>...]
  [--remove-anon-password-list <string>...]
  [--revert-anon-password-list]
  [--anon-root-path <path>]
  [--revert-anon-root-path]
  [--anon-umask <integer-octal>]
  [--revert-anon-umask]
  [--ascii-mode {off | upload | download | both}]
  [--revert-ascii-mode]        
  [--chroot-exception-list <string>...]
  [--clear-chroot-exception-list]
  [--add-chroot-exception-list <string>...]
  [--remove-chroot-exception-list <string>...]
  [--revert-chroot-exception-list]        
  [--chroot-local-mode {all | none | all-with-exceptions | none-with-exceptions}]
  [--revert-chroot-local-mode
  [--connect-timeout <duration>]
  [--revert-connect-timeout]
  [--data-timeout <duration>]
  [--revert-data-timeout]
  [--denied-user-list <string>...]
  [--clear-denied-user-list]
  [--add-denied-user-list <string>...]
  [--remove-denied-user-list <string>...]
  [--revert-denied-user-list]
  [--dirlist-localtime {yes | no}]
  [--revert-dirlist-localtime]
  [--dirlist-names {numeric | textual | hide}]        
  [--revert-dirlist-names]
  [--file-create-perm <integer-octal>]
  [--revert-file-create-perm]
  [--limit-anon-passwords {yes | no}]
  [--revert-limit-anon-passwords]
  [--local-root-path <path>]
  [--revert-local-root-path]
  [--local-umask <integer-octal>]
  [--revert-local-umask]
  [--server-to-server {yes | no}]
  [--revert-server-to-server]
  [--session-support {yes | no}]
  [--revert-session-support]
  [--session-timeout <duration>]
  [--revert-session-timeout
  [--user-config-dir <path>]
  [--revert-user-config-dir]
  [--service {yes | no}]

Options

--accept-timeout <duration>

Specifies the time, in seconds, that a remote client has to establish a PASV style data connection before timeout. All integers between 30 and 600 are valid values. The default value is 60.

--revert-accept-timeout

Sets the value to the system default for --accept-timeout.

--allow-anon-access {yes | no}

Controls whether anonymous logins are permitted. If enabled, both the usernames ftp and anonymous are recognized as anonymous logins. The default value is No.

--revert-allow-anon-access

Sets the value to the system default for --allow-anon-access.

--allow-anon-upload {yes | no}

Controls whether anonymous users are able to upload files under certain conditions. For anonymous users to be able to upload, you must set the --allow-writes option to Yes, and the anonymous user must have write permission on the desired upload location. The default value is Yes.

--revert-allow-anon-upload

Sets the value to the system default for --allow-anon-upload.

--allow-dirlists {yes | no}

Controls whether directory list commands are enabled. The default value is Yes.

--revert-allow-dirlists

Sets the value to the system default for --allow-dirlists.

--allow-downloads {yes | no}

Controls whether files can be downloaded. The default value is Yes.

--revert-allow-downloads

Sets the value to the system default for --allow-downloads.

--allow-local-access {yes | no}

Controls whether local logins are permitted. If set to Yes, normal user accounts can be used to log in. The default value is Yes.

--revert-allow-local-access

Sets the value to the system default for --allow-local-access.

--allow-writes {yes | no}

Sets and displays whether commands that change the file system are permitted. Controls whether any of the following commands are allowed:

• STOR
• DELE
• RNFR
• RNTO
• MKD
• RMD
• APPE
• SITE

The default value is yes.

--revert-allow-writes

Sets the value to the system default for --allow-writes.

--always-chdir-homedir {yes | no}

Controls whether FTP always initially changes directories to the home directory of the user. If set to No, you can set up a chroot area in FTP without having a home directory for the user. The default value is Yes.

--revert-always-chdir-homedir

Sets the value to the system default for --always-chdir-homedir.

--anon-chown-username <string>

Gives ownership of anonymously uploaded files to the specified user. The value must be a local username. The default value is root.

--revert-anon-chown-username

Sets the value to the system default for --anon-chown-username.

--anon-password-list <string>...

Displays the list of anonymous user passwords.

--clear-anon-password-list

Clears the list of passwords for anonymous users.

--add-anon-password-list <string>...

Adds items to list of passwords for anonymous users. Specify --add-anon-password-list for each additional password to add.

--remove-anon-password-list <string>...

Removes items from list of passwords for anonymous users. Specify --remove-anon-password-list for each additional password to remove.

--revert-anon-password-list

Sets the value to the system default for --anon-password-list.

--anon-root-path <path>

Displays and specifies the root path for anonymous users, which is a directory in /ifs that the Very Secure FTP Daemon (VSFTPD) will try to change to after an anonymous login. Valid paths are in /ifs. The default value is /ifs/home/ftp.

--revert-anon-root-path

Sets the value to the system default for --anon-root-path.

--anon-umask <integer-octal>

Specifies the umask for file creation by anonymous users. Valid values are octal umask numbers. The default value is 077.

NOTE The value must contain the 0 prefix; otherwise it will be interpreted as a base 10 integer.

--revert-anon-umask

Sets the value to the system default for --anon-umask.

--ascii-mode {off | upload | download | both}

Enables ASCII downloads, uploads, or both.

--revert-ascii-mode

Sets the value to the system default for --ascii-mode.

--chroot-exception-list <string>

Displays the list of local user chroot exceptions.

--clear-chroot-exception-list

Clears the list of local user chroot exceptions.

--add-chroot-exception-list <string>

Adds users to the chroot exception list.

--remove-chroot-exception-list <string>

Removes users from the chroot exception list.

--revert-chroot-exception-list

Sets the value to the system default for --chroot-exception-list.

--chroot-local-mode {all | none | all-with-exceptions | none-with-exceptions}

Specifies which users are placed in a chroot jail in their home directory after login.

--revert-chroot-local-mode

Sets the value to the system default for --chroot-local-mode.

--connect-timeout <duration>

Specifies the timeout in seconds for a remote client to respond to a PORT style data connection. Valid durations are integers between 30 and 600. The default value is 60 (one minute).

--revert-connect-timeout

Sets the value to the system default for --connect-timeout.

--data-timeout <duration>

Specifies the maximum time (in seconds) data transfers are allowed to stall with no progress before the remote client is removed. Valid durations are integers between 30 and 600. The default value is 300 (five minutes).

--revert-data-timeout

Sets the value to the system default for --data-timeout.

--denied-user-list <string>

Displays the list of denied users.

--clear-denied-user-list

Clears the list of denied users.

--add-denied-user-list <string>

Add users to the list of denied users.

--remove-denied-user-list <string>

Removes users from the list of denied users.

--revert-denied-user-list

Sets the value to the system default for --denied-user-list (empty).

--dirlist-localtime {yes | no}

Specifies whether the time displayed in directory listings is in your local time zone. Valid values are Yes and No. If No, time displays on GMT. If Yes, the time displays in your local time zone. The default value is No.

The last-modified times returned by commands issued inside of the FTP shell are also affected by this parameter.

--revert-dirlist-localtime

Sets the value to the system default for --dirlist-localtime.

--dirlist-names {numeric | textual | hide}

Determines what information is displayed about users and groups in directory listings. The following are valid:

numeric

Numeric IDs are shown in the user and group fields of directory listings.

textual

Names are shown in text format in the user and group fields of directory listings.

hide

All user and group information in directory listings is displayed as ftp. This is the default setting.

--revert-dirlist-names

Sets the value to the system default for --dirlist-names.

--file-create-perm <integer-octal>

Specifies the permissions with which uploaded files are created. Valid values are octal permission numbers. The default value is 0666.

NOTE For uploaded files to be executable, set the permissions to 0777.

--revert-file-create-perm

Sets the value to the system default for --file-create-perm.

--limit-anon-passwords {yes | no}

Limits anonymous passwords.

--revert-limit-anon-passwords

Sets the value to the system default for --limit-anon-passwords.

--local-root-path <path>

Specifies the initial directory in /ifs for a local login. Valid paths are in /ifs. The default path is the local user home directory.

--revert-local-root-path

Sets the value to the system default for --local-root-path.

--local-umask <integer-octal>

Species the umask for file creation by local users. Valid values are octal umask numbers. The default value is 077.

NOTE The value must contain the 0 prefix; otherwise it will be interpreted as a base 10 integer.

--revert-local-umask

Sets the value to the system default for --local-umask.

--server-to-server {yes | no}

Specifies whether to allow server-to-server (FXP) transfers. Valid values are Yes and No. The default value is No.

--revert-server-to-server

Sets the value to the system default for --server-to-server.

--session-support {yes | no}

Enables or disables FTP session support. If set to YES, the command maintains login sessions for each user through Pluggable Authentication Modules (PAM). If set to NO, the command prevents automatic home directory creation if that functionality is otherwise available. The default value is YES.

--revert-session-support

Sets the value to the system default for --session-support.

--session-timeout <duration>

Specifies the maximum time (in seconds) that a remote client may spend between FTP commands before the remote client is kicked off. Valid values are integers between 30 and 600. The default value is 300 (five minutes).

--revert-session-timeout

Sets the value to the system default for --session-timeout.

--user-config-dir <path>

Specifies the directory where user-specific configurations that override global configurations can be found. The default value is the local user home directory.

--revert-user-config-dir

Sets the value to the system default for --user-config-dir.

--service {yes | no}

Specifies whether the FTP service is enabled.