nhyatt/putty-source
1
0
Fork 0
mirror of https://git.tartarus.org/simon/putty.git synced 2025-04-21 04:55:02 -05:00
Code Issues Projects Releases Wiki Activity

Document recent changes to PSFTP (and other documentation tweaks).

Browse Source 
[originally from svn r5058]
This commit is contained in:
Jacob Nevins 2005-01-01 16:16:13 +00:00
parent 549dd239c3
commit 5c952ce64e
2 changed files with 75 additions and 38 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

61
doc/psftp.but
View File

@ -408,17 +408,17 @@ The \c{ls} command works exactly the same way as \c{dir}.
\S{psftp-cmd-chmod} The \c{chmod} command: change permissions on \S{psftp-cmd-chmod} The \c{chmod} command: change permissions on
remote files remote files
PSFTP allows you to modify the file permissions on files on the PSFTP allows you to modify the file permissions on files and
server. You do this using the \c{chmod} command, which works very directories on the server. You do this using the \c{chmod} command,
much like the Unix \c{chmod} command. which works very much like the Unix \c{chmod} command.
The basic syntax is \c{chmod modes file}, where \c{modes} represents The basic syntax is \c{chmod modes file}, where \c{modes} represents
a modification to the file permissions, and \c{file} is the filename a modification to the file permissions, and \c{file} is the filename
to modify. For example: to modify. You can specify multiple files or wildcards. For example:
\c chmod go-rwx,u+w privatefile \c chmod go-rwx,u+w privatefile
\c chmod a+r publicfile \c chmod a+r public*
\c chmod 640 groupfile \c chmod 640 groupfile1 groupfile2
The \c{modes} parameter can be a set of octal digits in the Unix The \c{modes} parameter can be a set of octal digits in the Unix
style. (If you don't know what this means, you probably don't want style. (If you don't know what this means, you probably don't want
@ -445,7 +445,8 @@ permissions for members of the owning group and everybody else (so
the only permissions left are the ones for the file owner). \c{u+w} the only permissions left are the ones for the file owner). \c{u+w}
adds write permission for the file owner. adds write permission for the file owner.
\b The second example: \c{a+r} adds read permission for everybody. \b The second example: \c{a+r} adds read permission for everybody to
all files and directories starting with \q{public}.
In addition to all this, there are a few extra special cases for In addition to all this, there are a few extra special cases for
Unix systems. On non-Unix systems these are unlikely to be useful: Unix systems. On non-Unix systems these are unlikely to be useful:
@ -467,9 +468,18 @@ normally only the owner of the \e{directory} would be allowed to).
\S{psftp-cmd-del} The \c{del} command: delete remote files \S{psftp-cmd-del} The \c{del} command: delete remote files
To delete a file on the server, type \c{del} and then the filename: To delete a file on the server, type \c{del} and then the filename
or filenames:
\c del oldfile.dat \c del oldfile.dat
\c del file1.txt file2.txt
\c del *.o
Files will be deleted without further prompting, even if multiple files
are specified.
\c{del} will only delete files. You cannot use it to delete
directories; use \c{rmdir} for that.
The \c{rm} command works exactly the same way as \c{del}. The \c{rm} command works exactly the same way as \c{del}.
@ -480,26 +490,47 @@ directory name:
\c mkdir newstuff \c mkdir newstuff
You can specify multiple directories to create at once:
\c mkdir dir1 dir2 dir3
\S{psftp-cmd-rmdir} The \c{rmdir} command: remove remote directories \S{psftp-cmd-rmdir} The \c{rmdir} command: remove remote directories
To remove a directory on the server, type \c{rmdir} and then the To remove a directory on the server, type \c{rmdir} and then the
directory name: directory name or names:
\c rmdir oldstuff \c rmdir oldstuff
\c rmdir *.old ancient
Directories will be deleted without further prompting, even if
multiple directories are specified.
Most SFTP servers will probably refuse to remove a directory if the Most SFTP servers will probably refuse to remove a directory if the
directory has anything in it, so you will need to delete the directory has anything in it, so you will need to delete the
contents first. contents first.
\S{psftp-cmd-ren} The \c{ren} command: rename remote files \S{psftp-cmd-mv} The \c{mv} command: move and rename remote files
To rename a file on the server, type \c{ren}, then the current file To rename a single file on the server, type \c{mv}, then the current
name, and then the new file name: file name, and then the new file name:
\c ren oldfile newname \c mv oldfile newname
The \c{rename} and \c{mv} commands work exactly the same way as You can also move the file into a different directory and change the
\c{ren}. name:
\c mv oldfile dir/newname
To move one or more files into an existing subdirectory, specify the
files (using wildcards if desired), and then the destination
directory:
\c mv file dir
\c mv file1 dir1/file2 dir2
\c mv *.c *.h ..
The \c{rename} and \c{ren} commands work exactly the same way as
\c{mv}.
\S{psftp-cmd-pling} The \c{!} command: run a local Windows command \S{psftp-cmd-pling} The \c{!} command: run a local Windows command

52
psftp.c
View File

@ -1891,7 +1891,7 @@ static struct sftp_cmd_lookup {
}, },
{ {
"cd", TRUE, "change your remote working directory", "cd", TRUE, "change your remote working directory",
" [ <New working directory> ]\n" " [ <new working directory> ]\n"
" Change the remote working directory for your SFTP session.\n" " Change the remote working directory for your SFTP session.\n"
" If a new working directory is not supplied, you will be\n" " If a new working directory is not supplied, you will be\n"
" returned to your home directory.\n", " returned to your home directory.\n",
@ -1899,10 +1899,11 @@ static struct sftp_cmd_lookup {
}, },
{ {
"chmod", TRUE, "change file permissions and modes", "chmod", TRUE, "change file permissions and modes",
" ( <octal-digits> | <modifiers> ) <filename>\n" " <modes> <filename-or-wildcard> [ <filename-or-wildcard>... ]\n"
" Change the file permissions on a file or directory.\n" " Change the file permissions on one or more remote files or\n"
" <octal-digits> can be any octal Unix permission specifier.\n" " directories.\n"
" Alternatively, <modifiers> can include:\n" " <modes> can be any octal Unix permission specifier.\n"
" Alternatively, <modes> can include the following modifiers:\n"
" u+r make file readable by owning user\n" " u+r make file readable by owning user\n"
" u+w make file writable by owning user\n" " u+w make file writable by owning user\n"
" u+x make file executable by owning user\n" " u+x make file executable by owning user\n"
@ -1933,16 +1934,16 @@ static struct sftp_cmd_lookup {
sftp_cmd_close sftp_cmd_close
}, },
{ {
"del", TRUE, "delete a file", "del", TRUE, "delete files on the remote server",
" <filename>\n" " <filename-or-wildcard> [ <filename-or-wildcard>... ]\n"
" Delete a file.\n", " Delete a file or files from the server.\n",
sftp_cmd_rm sftp_cmd_rm
}, },
{ {
"delete", FALSE, "del", NULL, sftp_cmd_rm "delete", FALSE, "del", NULL, sftp_cmd_rm
}, },
{ {
"dir", TRUE, "list contents of a remote directory", "dir", TRUE, "list remote files",
" [ <directory-name> ]/[ <wildcard> ]\n" " [ <directory-name> ]/[ <wildcard> ]\n"
" List the contents of a specified directory on the server.\n" " List the contents of a specified directory on the server.\n"
" If <directory-name> is not given, the current working directory\n" " If <directory-name> is not given, the current working directory\n"
@ -1999,9 +2000,9 @@ static struct sftp_cmd_lookup {
sftp_cmd_mget sftp_cmd_mget
}, },
{ {
"mkdir", TRUE, "create a directory on the remote server", "mkdir", TRUE, "create directories on the remote server",
" <directory-name>\n" " <directory-name> [ <directory-name>... ]\n"
" Creates a directory with the given name on the server.\n", " Creates directories with the given names on the server.\n",
sftp_cmd_mkdir sftp_cmd_mkdir
}, },
{ {
@ -2014,18 +2015,22 @@ static struct sftp_cmd_lookup {
sftp_cmd_mput sftp_cmd_mput
}, },
{ {
"mv", TRUE, "move or rename a file on the remote server", "mv", TRUE, "move or rename file(s) on the remote server",
" <source-filename> <destination-filename>\n" " <source> [ <source>... ] <destination>\n"
" Moves or renames the file <source-filename> on the server,\n" " Moves or renames <source>(s) on the server to <destination>,\n"
" so that it is accessible under the name <destination-filename>.\n", " also on the server.\n"
" If <destination> specifies an existing directory, then <source>\n"
" may be a wildcard, and multiple <source>s may be given; all\n"
" source files are moved into <destination>.\n"
" Otherwise, <source> must specify a single file, which is moved\n"
" or renamed so that it is accessible under the name <destination>.\n",
sftp_cmd_mv sftp_cmd_mv
}, },
{ {
"open", TRUE, "connect to a host", "open", TRUE, "connect to a host",
" [<user>@]<hostname> [<port>]\n" " [<user>@]<hostname> [<port>]\n"
" Establishes an SFTP connection to a given host. Only usable\n" " Establishes an SFTP connection to a given host. Only usable\n"
" when you did not already specify a host name on the command\n" " when you are not already connected to a server.\n",
" line.\n",
sftp_cmd_open sftp_cmd_open
}, },
{ {
@ -2048,7 +2053,7 @@ static struct sftp_cmd_lookup {
sftp_cmd_quit sftp_cmd_quit
}, },
{ {
"reget", TRUE, "continue downloading a file", "reget", TRUE, "continue downloading files",
" [ -r ] [ -- ] <filename> [ <local-filename> ]\n" " [ -r ] [ -- ] <filename> [ <local-filename> ]\n"
" Works exactly like the \"get\" command, but the local file\n" " Works exactly like the \"get\" command, but the local file\n"
" must already exist. The download will begin at the end of the\n" " must already exist. The download will begin at the end of the\n"
@ -2065,7 +2070,7 @@ static struct sftp_cmd_lookup {
sftp_cmd_mv sftp_cmd_mv
}, },
{ {
"reput", TRUE, "continue uploading a file", "reput", TRUE, "continue uploading files",
" [ -r ] [ -- ] <filename> [ <remote-filename> ]\n" " [ -r ] [ -- ] <filename> [ <remote-filename> ]\n"
" Works exactly like the \"put\" command, but the remote file\n" " Works exactly like the \"put\" command, but the remote file\n"
" must already exist. The upload will begin at the end of the\n" " must already exist. The upload will begin at the end of the\n"
@ -2078,10 +2083,11 @@ static struct sftp_cmd_lookup {
sftp_cmd_rm sftp_cmd_rm
}, },
{ {
"rmdir", TRUE, "remove a directory on the remote server", "rmdir", TRUE, "remove directories on the remote server",
" <directory-name>\n" " <directory-name> [ <directory-name>... ]\n"
" Removes the directory with the given name on the server.\n" " Removes the directory with the given name on the server.\n"
" The directory will not be removed unless it is empty.\n", " The directory will not be removed unless it is empty.\n"
" Wildcards may be used to specify multiple directories.\n",
sftp_cmd_rmdir sftp_cmd_rmdir
} }
}; };