_______________________________________________________________________ ftphelp.txt FTP ACCESS HELP For additional help send email to info@rcsb.org _______________________________________________________________________ ___________________ Useful FTP Commands ___________________ ascii Set the file transfer type to network ASCII. binary Set the file transfer type to support binary image transfer. bye Terminate the FTP session with the remote server and exit ftp. cd remote-directory Change the working directory on the remote machine to remote-directory. cdup Change the remote machine working directory to the parent of the current remote machine working directory. dir [ remote-directory ] [ local-file ] Print a listing of the directory contents in the directory, remote-directory, and, optionally, placing the output in local-file. get remote-file [ local-file ] Retrieve the remote-file and store it on the local machine. help [ command ] Print an informative message about the meaning of command. ls [ remote-directory ] [ local-file ] Print a listing of the contents of a directory on the remote machine. put local-file [ remote-file ] Store a local file on the remote machine. pwd Print the name of the current working directory on the remote machine. quit A synonym for bye. _______________________________________________________________________ ____________ Descriptions ____________ file: README - the FTP login message and README file file: advisory.doc - the PDB Advisory Notice file: ls-lR - listing of files and directories on FTP directory: data/status - has subdirectories containing listings of weekly added, modified and obsolete files. directory: data/structures/current_release/pdb - is originally last quarterly full release BUT then is modified to include withdrawn (removed), replacement, and additional entries since last quarterly full release - is the current full release (last quarterly plus updates) - divided into 2-letter directories file: how2dnld.txt - info on how to download a file file: how2upld.txt - info on how to upload a file directory: data/structures/current_release/nmr_restraints - nmr restraint files directory: data/structures/current_release/structure_factors - structure factor files _______________________________________________________________________ ________________________________________ How To Download Files From PDB Using FTP ________________________________________ ******************************************************* * * once you are logged into PDB using FTP, you can * download files to your computer using the "get" * command * * this example shows how you can download a file named * pdb3fxc.ent.Z (obsolete) to your computer * ******************************************************* ******************************************************* * * ftp to ftp.rcsb.org * * do not use rsh, rlogin, or telnet -- they won't work * ******************************************************* prompt> ftp ftp.rcsb.org ^^^^^^^^^^^^^^^^ Connected to ftp.rcsb.org. 220 godzilla.sdsc.edu FTP server (BeroFTPD 1.3.4(1) Tue Mar 30 18:26:56 PST 1999) ready. Name (ftp.rcsb.org:kenneth): anonymous ^^^^^^^^^ 331 Guest login ok, send your complete e-mail address as password. Password: ^^^^^^^^^^^^^^ 230-Please read the file README 230- it was last modified on Fri Apr 16 16:28:06 1999 - 0 days ago 230 Guest login ok, access restrictions apply. ******************************************************* * * do a listing to see what's at the top level of the * FTP directory * ******************************************************* ftp> ls -l ^^^^^ 200 PORT command successful. 150 Opening ASCII mode data connection for directory listing. total 2420 -rwxr-xr-x 1 kenneth use300 2330 Apr 16 16:28 README lrwxrwxrwx 1 root root 9 Mar 30 06:27 bin -> ./usr/bin dr-xr-xr-x 2 root root 512 Apr 16 10:31 dev dr-xr-xr-x 2 root root 512 Apr 16 10:27 etc lrwxrwxrwx 1 root root 9 Mar 30 06:27 lib -> ./usr/lib drwxr-xr-x 3 kenneth use300 512 Apr 16 16:08 mirrortest drwxr-xr-x 3 kenneth use300 512 Apr 6 11:23 pub dr-xr-xr-x 5 root root 512 Apr 16 10:27 usr -rw-r--r-- 1 kenneth use300 1218064 Apr 16 16:08 verify.init.log 226 Transfer complete. remote: -l 600 bytes received in 0.1 seconds (5.7 Kbytes/s) ******************************************************* * * remember, you wanted to get the file named * pdb3fxc.ent.Z * * it's not visible here, change your directory to * pub/pdb/data/structures/obsolete * ******************************************************* ftp> cd pub/pdb/data/structures/obsolete ^^^^^^^^^^^^^^^^^^^^^^^^ 250 CWD command successful. ******************************************************* * * do another listing of the directory * ******************************************************* ftp> ls -l ^^^^^ 200 PORT command successful. 150 Opening ASCII mode data connection for directory listing. total 16 drwxrwxr-x 197 kenneth rcsb 2560 Apr 16 13:04 mmCIF drwxrwxr-x 16 kenneth rcsb 512 Apr 16 13:02 nmr_restraints drwxrwxr-x 197 kenneth rcsb 2560 Apr 16 13:04 pdb drwxrwxr-x 12 kenneth rcsb 512 Apr 16 13:04 structure_factors 226 Transfer complete. remote: -l 277 bytes received in 0.026 seconds (10 Kbytes/s) ******************************************************* * * you still have to go into another directory * * change to the "pdb" directory * ******************************************************* ftp> cd pdb ^^^^^ 250 CWD command successful. ******************************************************* * * do another directory listing * ******************************************************* ftp> ls -l 200 PORT command successful. 150 Opening ASCII mode data connection for directory listing. total 390 drwxrwxr-x 2 kenneth rcsb 512 Apr 16 13:04 16 drwxrwxr-x 2 kenneth rcsb 512 Apr 16 13:04 25 drwxrwxr-x 2 kenneth rcsb 512 Apr 16 13:04 28 drwxrwxr-x 2 kenneth rcsb 512 Apr 16 13:04 47 drwxrwxr-x 2 kenneth rcsb 512 Apr 16 13:04 51 drwxrwxr-x 2 kenneth rcsb 512 Apr 16 13:04 56 drwxrwxr-x 2 kenneth rcsb 512 Apr 16 13:04 73 drwxrwxr-x 2 kenneth rcsb 512 Apr 16 13:04 a9 drwxrwxr-x 2 kenneth rcsb 512 Apr 16 13:04 aa ... (Many directories deleted) ... drwxrwxr-x 2 kenneth rcsb 512 Apr 16 13:05 fx ... (Many directories deleted) ... drwxrwxr-x 2 kenneth rcsb 512 Apr 16 13:06 wb drwxrwxr-x 2 kenneth rcsb 512 Apr 16 13:06 we drwxrwxr-x 2 kenneth rcsb 512 Apr 16 13:06 wg drwxrwxr-x 2 kenneth rcsb 512 Apr 16 13:06 ws drwxrwxr-x 2 kenneth rcsb 512 Apr 16 13:06 xi drwxrwxr-x 2 kenneth rcsb 512 Apr 16 13:06 yh 226 Transfer complete. remote: -l 11516 bytes received in 0.028 seconds (4e+02 Kbytes/s) *************************************** * * change directory to fx * *************************************** ftp> cd fx ^^^^^ 250 CWD command successful. ******************************************************* * * do another directory listing * ******************************************************* ftp> ls -l ^^^^^ 200 PORT command successful. 150 Opening ASCII mode data connection for directory listing. total 286 -rw-r--r-- 1 kenneth use300 16145 Dec 4 1996 pdb1fxb.ent.Z -rw-r--r-- 1 kenneth use300 18854 Dec 4 1996 pdb1fxc.ent.Z -rw-r--r-- 1 kenneth use300 28603 Dec 4 1996 pdb1fxn.ent.Z -rw-r--r-- 1 kenneth use300 19332 Dec 9 1996 pdb3fxc.ent.Z -rw-r--r-- 1 kenneth use300 30270 Mar 13 1997 pdb3fxn.ent.Z -rw-r--r-- 1 kenneth use300 30806 Mar 13 1997 pdb4fxn.ent.Z 226 Transfer complete. remote: -l 431 bytes received in 0.018 seconds (24 Kbytes/s) ******************************************************** * * there's the file you want * * Set transfer type to binary * ******************************************************* ftp> bin ^^^ 200 Type set to I. ******************************************************** * * go ahead and "get" it * ******************************************************* ftp> get pdb3fxc.ent.Z ^^^^^^^^^^^^^^^^^ 200 PORT command successful. 150 Opening BINARY mode data connection for pdb3fxc.ent.Z (19332 bytes). 226 Transfer complete. local: pdb3fxc.ent.Z remote: pdb3fxc.ent.Z 19332 bytes received in 0.051 seconds (3.7e+02 Kbytes/s) ******************************************************* * * return to your local computer * ******************************************************* ftp> bye ^^^ 221 Goodbye. ******************************************************* * * check for the file * ******************************************************* prompt> ls -l pdb3fxc.ent.Z ^^^^^^^^^^^^^^^^^^^ -rw-r--r-- 1 kenneth use300 19332 Apr 16 16:34 pdb3fxc.ent.Z _______________________________________________________________________ Acknowledgement: This page was originally developed at Brookhaven National Laboratory and maintained by John McCarthy. _______________________________________________________________________