NAME pftp_client - HPSS Parallel FTP Client user/password authentication over TCP/IP pftp_client_ident - HPSS Parallel FTP Client IDENT authentication over TCP/IP krb5_gss_pftp_client - HPSS Parallel FTP Client using Generic Security Service and Kerberos credentials over TCP/IP PURPOSE Transfers files between a local host and a remote host. SYNTAX pftp_client [ standard ftp flags ][ extended pftp flags ] [ HostName [ Port ] ] DESCRIPTION The pftp_client command uses the File Transfer Protocol (FTP) to transfer files between a local host and a remote non-HPSS host, or a local host and a remote HPSS host. If communicating with a remote HPSS host, the pftp_client command can perform a parallel file transfer utilizing a single local processor (parallel transfer) or multiple processors (multinode transfer). STANDARD FTP FLAGS Consult the ftp man pages. EXTENDED PFTP FLAGS NOTE: Spaces are NOT permitted after flags requiring values; e.g., -w4 NOT -w 4 to specify the stripewidth. -bSize Sets the PDATA_ONLY BufferSize. The size may be specified in the format 256KB. -c Turns on the childmode. Useful for batch mode client operations. -d Turns on debugging. Noisy! -e Turns on "echo" mode. Useful for batch mode client operations. Causes every command to be echoed to the output file along with the responses from the Daemon. -g Turn of globbing. -h Specify the standard HPSS Protocol, PDATA_AND_MOVER, regardless of the setting in the HPSS.conf file. However, this will be overridden by commands in the ~/.netrc file. -i Disables interactive Mode. -kNAME Sets the Generic Security Service realm to NAME. -m Enable the use of multiple processors to complete a parallel file transfer to/from an HPSS host. To utilize multiple processors: the multinode daemon (multinoded) must be employed; and a parallel ftp configuration file, containing a list of nodes configured to run the multinode daemon, must be available. -n Disables autologon mode (~/.netrc file) -p Specify the WAN HPSS Protocol, PDATA_ONLY, regardless of the setting in the HPSS.conf file. However, this will be overridden by commands in the ~/.netrc file. -t Turns on packet tracing -v Sets verbose mode. Noisy! -wVAL Sets the parallel stripe width to VAL. -BSize Specify the parallelblock size. The size may be specified in the format 4MB. -C# Specify the default Class of Service (COS). -P Specify the WAN HPSS Protocol, PDATA_PUSH, regardless of the setting in the HPSS.conf file. However, this will be overridden by commands in the ~/.netrc file. -R#-# Specify a Restricted Port Range. -SSize Specify the PTRAN Open/Close Size. The size may be specified in the format 20GB. Other factors may prevent this from operating as the customer specifies! ISSUING SUBCOMMANDS See the UNIX ftp man page. STANDARD FTP COMPATIBLE SUBCOMMANDS ! dir mode restart $ disconnect modtime rhelp ? form mput rmdir account get nlist rstatus append glob nmap runique ascii hash ntrans send bell help open size binary image prompt status bye lcd proxy struct case ls put sunique cd macdef pwd system cdup mdelete quit tenex close mdir quote trace cr mget recv type delete mkdir rename user debug mls reset verbose UNSUPPORTED FTP SUBCOMMANDS block exp_cmd non-print stream ebcdic local record telnet EXTENDED PFTP SUBCOMMANDS autoparallel mlfget pdata quote site/site chgrp mlfput pdatapush reget chmod mpget penable sendport features mpput pget setpblocksize getprot multinode pmover setpwidth gettuningparms newer pput setsockbufsize lfappend pappend protect setxferbufsize lfget passive psocket umask lfput DESCRIPTION OF EXTENDED PFTP SUBCOMMANDS NOTE: Acceptable minimum abbreviations in parentheses. autoparallel (autop) Usage: autoparallel Toggle the flag to automatically substitute parallel commands for non-parallel commands. chgrp (chg) Usage: chgrp groupname filename Change group ID of a remote file. chmod (chm) Usage: chmod mode filename Change file permissions mode of a remote file. features (fea) Usage: features List supported features. getprot (getp) Usage: getprot Determine the current protocol state. gettuningparms (gettun) Usage: gettuningparms [destination] Show the configuration parameters between the Client host and other hosts. lfappend (lfa) Usage: lfappend [-l localfileoffset] [-s sizeoftransfer] local-file [remote-file] Append from a local file system file to remote file. lfget (lfg) Usage: lfget [-r remotefileoffset] [-l localfileoffset] [-s sizeoftransfer] remote-file [local-file] Get a file to local system file. lfput (lfp) Usage: lfput [-r remotefileoffset] [-l localfileoffset] [-s sizeoftransfer] local-file [remote-file] Send a local file system file. mlfget (mlfg) Usage: mlfget remote-files Get multiple files to local file system. mlfput (mlfp) Usage: mlfput local-files Send multiple local file system files. mpget (mpg) Usage: mpget remote-files Get multiple files in parallel. mpput (mpp) Usage: mpput local-files Send multiple files in parallel. multinode (multi) Usage: multinode Enable the use of multiple processors to complete a parallel file transfer to (from) an HPSS host. To utilize multiple processors: the multinode daemon (multinoded) must be employed; and an HPSS configuration file (HPSS.conf), containing a list of nodes configured to run the multinode daemon, must be available. newer (new) Usage: newer remote-file [local-file] Get file if remote file is newer than local file. pappend (papp) Usage: Append a local file to a remote file in parallel. passive (pass) Usage: passive Toggle passive transfer mode. (passive mode NOT supported by HPSS PFTP Daemons for parallel transfers except for pdatapush protocol) pdata (pdata) Usage: pdata Set the Parallel Transfer mode to use the PDATA_ONLY mechanism. pdatapush (pdatap) Usage: pdatapush Set the Parallel Transfer mode to use the PDATA_PUSH mechanism. penable (pen) Usage: penable Override the inability to perform parallel commands resulting from the fact that the Daemon did NOT respond appropriately to the PRLL command. pget (pg) Usage: pget [-r remotefileoffset] [-l localfileoffset] [-s sizeoftransfer] remote-file [local-file] Retrieve one file in parallel. pmover (pm) Usage: pmover Set the Parallel Transfer mode to use the PDATA_AND_MOVER mechanism. pput (pp) Usage: pput [-r remotefileoffset] [-l localfileoffset] [-s sizeoftransfer] remote-file [local-file] Send one file in parallel. protect (prot) Usage: protect [clear | safe | private] Set protection level for file transfer. psocket (ps) Usage: psocket Set parallel transfers to go across sockets. quote site (quo) site (sit) Usage: (quote site | site) line-to-send Send site specific command to remote server. Try "rhelp site" or "site help" for more information. quote site or site supported commands: chgrp Change group ownership of remote file. chmod Change file permissions of remote file. Octal value between 0 an 777 may be used. The resulting permissions will be the exact value provided; e.g., "site chmod 4 myfile" will result in the permissions -------r-- on myfile. The extended mode bits setuid, setgid, etc. are NOT modified by any octal specification. To modify these bits use the symbolic format of the chmod command; e.g., "site chmod u-s,g+srwx,o=rx myfile". This would yield the permission -rwxrwsr-x on myfile (if the rwx permissions ere already present on myfile). NOTE: the setuid and save text attribute have no meaning to HPSS. The setgid bit has no meaning to HPSS on files; but, is used for "inheritance" on directories. chown Change ownership of remote file. (Only usable by root user) chuid Change ownership of remote file. (Only usable by root user) setcos Set the preferred Class of Service. symlink Establish a symbolic link. acl Change/ Add ACLs to HPSS objects. site acl sub-commands. site acl help - Obtain help site acl show object - Show ACLs on an object. site acl update [-ic] [-io] acl_type:name:perms object - Add/Change ACLs on an object. site acl replace [-ic] [-io] acl_type:name:perms object - Add/Change ACLs on an object. site acl remove [-ic] [-io] acl_type:name object - Remove a specific ACL from an object. site acl clear [-ic] [-io] acl_type:name object - Remove ALL ACLs from an object leaving only the user_obj, group_obj, and other_obj. reget (reg) Usage: reget remote-file [local-file] Get file restarting at end of local file. sendport (send) Usage: sendport Toggle use of PORT cmd for each data connection. setpblocksize (setpb) Usage: setpblocksize [size] Set the block size of the parallel stripe. setpwidth (setpw) Usage: setpwidth [width] Set the width of the parallel stripe. setsockbufsize (sets) Usage: setsockbufsize [size] Set the socket buffer size. setxferbufsize (setx) Usage: setxferbufsize [size] Set the transfer buffer size. umask (um) Usage: umask [mask] Get (set) umask on remote side. EXAMPLES pftp_client destination port pftp_client_ident destination port krb5_gss_pftp_client destination port BUILDING A CONFIGURATION FILE A configuration file will be used to specify different IP addresses or remote nodes on which the data transfer processes are to be spawned by HPSS Parallel FTP Client (multinode mode) or which network interfaces to use for network striping (multihomed mode). The default configuration file is /var/hpss/etc/HPSS.conf. The user can override the path to this file with the HPSS_PATH_ETC environment variable. It is the Administrator's responsibility to correctly configure and maintain the HPSS.conf file as well as implementing the multinoded components on all remote systems. LOAD LEVELING Multinode parallel ftp load leveling across the various nodes is accomplished using an offset file and a properly ordered configuration file. The offset file is automatically created and maintained by the HPSS Parallel FTP Client. The offset file will have the same path and name as the configuration file, with the .off extension. The offset file is used to level the load across every interface in the configuration file for each instance of the HPSS Parallel FTP Client. By placing the configuration file in a shared location, load leveling can be achieved for each instance of the HPSS Parallel FTP Client across the network. Each instance of the HPSS Parallel FTP Client builds its own internal node list using the configuration file. The HPSS Parallel FTP Client will use the same internal node list, to transfer files, its entire life. Nodes can only be added to this list by increasing the pwidth. Decreasing the pwidth will not remove nodes from the internal node list. Because of this, it is very important to properly order the configuration file by alternating the interfaces of various processors. FILES ~/.netrc /var/hpss/etc/HPSS.conf HPSS_PATH_ETC environment variable RELATED INFORMATION ftp, hpss_ftp.7, multinoded(7), pftpd(7), auth_manager(7), HPSS.conf(7). The .netrc file format. HPSS User's Guide HPSS System Administration Guide SCCS static char SccsId[] = " @(#)91 1.11 man/pftp_client.7, gen, 5.1, 5.1.0.0 2/26/03 10:02:12";