{ "content": [ { "type": "text", "text": "# ncftpget(1) (man)\n\n**Summary:** ncftpget - Internet file transfer program for scripts\n\n**Synopsis:** ncftpget [options] remote-host local-directory remote-files...\nncftpget [options] bookmark-name local-directory remote-files...\nncftpget -f login.cfg [options] local-directory remote-files...\nncftpget [options] ftp://url.style.host/path/name\nncftpget -c [options] remote-host remote-file > stdout\nncftpget -C [options] remote-host remote-file local-path-name\nncftpget -c [options] ftp://url.style.host/path/name > stdout\n\n## Flags\n\n| Flag | Long | Arg | Description |\n|------|------|-----|-------------|\n| -u | — | — | |\n| -p | — | — | |\n| -P | — | — | |\n| -j | — | — | |\n| -d | — | — | |\n| -a | — | — | |\n| -t | — | — | |\n| -V | — | — | stream is a TTY. |\n| -f | — | — | |\n| -c | — | — | |\n| -C | — | — | |\n| -A | — | — | |\n| -Z | — | — | |\n| -E | — | — | |\n| -F | — | — | to regular if the passive connection fails or times out. |\n| — | — | — | |\n| -R | — | — | |\n| -T | — | — | ncftpget uses TAR whenever possible since this usually preserves symbolic links and file permissions. TAR mode can also |\n| -r | — | — | |\n| -b | — | — | |\n| -b | — | — | batch for the batch job to be processed. This is useful if you already have a ncftp‐ batch process running, or wish to h |\n| -B | — | — | |\n| -W | — | — | |\n| -X | — | — | |\n| -Y | — | — | The -W, -X, and -Y options are useful for advanced users who need to tweak behavior on some servers. For example, users |\n| -o | — | — | This option is used primarily for debugging. It sets the value of an internal vari‐ able to an integer value. An example |\n\n## See Also\n\n- ncftpput(1)\n- ncftp(1)\n- ftp(1)\n- rcp(1)\n- tftp(1)\n\n## Section Outline\n\n- **NAME** (2 lines)\n- **SYNOPSIS** (14 lines)\n- **OPTIONS** (1 lines) — 27 subsections\n - Command line flags: (1 lines)\n - -u (1 lines)\n - -p (1 lines)\n - -P (1 lines)\n - -j (1 lines)\n - -d (1 lines)\n - -a (1 lines)\n - -t (1 lines)\n - -v -V (2 lines)\n - -f (1 lines)\n - -c (1 lines)\n - -C (1 lines)\n - -A (1 lines)\n - -z -Z (1 lines)\n - -E (1 lines)\n - -F (2 lines)\n - -DD (1 lines)\n - -R (1 lines)\n - -T (8 lines)\n - -r (1 lines)\n - -b (1 lines)\n - -bb -b (9 lines)\n - -B (1 lines)\n - -W (1 lines)\n - -X (1 lines)\n - -Y (8 lines)\n - -o (7 lines)\n- **DESCRIPTION** (68 lines)\n- **DIAGNOSTICS** (26 lines)\n- **AUTHOR** (2 lines)\n- **SEE ALSO** (7 lines)\n\n## Full Content\n\n### NAME\n\nncftpget - Internet file transfer program for scripts\n\n### SYNOPSIS\n\nncftpget [options] remote-host local-directory remote-files...\n\nncftpget [options] bookmark-name local-directory remote-files...\n\nncftpget -f login.cfg [options] local-directory remote-files...\n\nncftpget [options] ftp://url.style.host/path/name\n\nncftpget -c [options] remote-host remote-file > stdout\n\nncftpget -C [options] remote-host remote-file local-path-name\n\nncftpget -c [options] ftp://url.style.host/path/name > stdout\n\n### OPTIONS\n\n#### Command line flags:\n\n#### -u\n\n#### -p\n\n#### -P\n\n#### -j\n\n#### -d\n\n#### -a\n\n#### -t\n\n#### -v -V\n\nstream is a TTY.\n\n#### -f\n\n#### -c\n\n#### -C\n\n#### -A\n\n#### -z -Z\n\n#### -E\n\n#### -F\n\nto regular if the passive connection fails or times out.\n\n#### -DD\n\n#### -R\n\n#### -T\n\nncftpget uses TAR whenever possible since this usually preserves symbolic links and\nfile permissions. TAR mode can also result in faster transfers for directories con‐\ntaining many small files, since a single data connection can be used rather than an\nFTP data connection for each small file. The downside to using TAR is that it forces\ndownloading of the whole directory, even if you had previously downloaded a portion\nof it earlier, so you may want to use this option if you want to resume downloading\nof a directory.\n\n#### -r\n\n#### -b\n\n#### -bb -b\n\nbatch for the batch job to be processed. This is useful if you already have a ncftp‐\nbatch process running, or wish to have better control of when batch jobs are pro‐\ncessed.\n\nFor example, if you wanted to do background processing of three files all on the same\nremote server, it is more polite to use just one ncftpbatch process to process the\nthree jobs sequentially, rather than having three ncftpbatch processes open three si‐\nmultaneous FTP sessions to the same server.\n\n#### -B\n\n#### -W\n\n#### -X\n\n#### -Y\n\nThe -W, -X, and -Y options are useful for advanced users who need to tweak behavior\non some servers. For example, users accessing mainframes might need to send some\nspecial SITE commands to set blocksize and record format information.\n\nFor these options, you can use them multiple times each if you need to send multiple\ncommands. For the -X option, you can use the cookie %s to expand into the name of\nthe file that was transferred.\n\n#### -o\n\nThis option is used primarily for debugging. It sets the value of an internal vari‐\nable to an integer value. An example usage would be: -o useFEAT=0,useCLNT=1 which in\nthis case, disables use of the FEAT command and enables the CLNT command. The avail‐\nable variables include: usePASV, useSIZE, useMDTM, useREST, useNLSTa, useNLSTd,\nuseFEAT, useMLSD, useMLST, useCLNT, useHELPSITE, useSITEUTIME, STATfileParamWorks,\nNLSTfileParamWorks, require20, allowProxyForPORT, doNotGetStartCWD.\n\n### DESCRIPTION\n\nThe purpose of ncftpget is to do file transfers from the command-line without entering an in‐\nteractive shell. This lets you write shell scripts or other unattended processes that can do\nFTP. It is also useful for advanced users who want to retrieve files from the shell command\nline without entering an interactive FTP program such as ncftp.\n\nOne particularly useful feature of this program is that you can give it a uniform resource\nlocator as the only argument and the program will download that file. You can then copy and\npaste from your web browser or newsreader and use that URL. Example:\n\n$ cd /tmp\n$ ncftpget ftp://ftp.ncftp.com/pub/ncftp/ncftp.tar.Z\n$ zcat ncftp.tar.Z | tar xf -\n\nBy default the program tries to open the remote host and login anonymously, but you can spec‐\nify a username and password information. The -u option is used to specify the username to\nlogin as, and the -p option is used to specify the password. If you are running the program\nfrom the shell, you may omit the -p option and the program will prompt you for the password.\n\nUsing the -u and -p options are not recommended, because your account information is exposed\nto anyone who can see your shell script or your process information. For example, someone\nusing the ps program could see your password while the program runs.\n\nYou may use the -f option instead to specify a file with the account information. However,\nthis is still not secure because anyone who has read access to the information file can see\nthe account information. Nevertheless, if you choose to use the -f option the file should\nlook something like this:\n\nhost sphygmomanometer.ncftp.com\nuser gleason\npass mypasswd\n\nDon't forget to change the permissions on this file so no one else can read them.\n\nThe -d option is very useful when you are trying to diagnose why a file transfer is failing.\nIt prints out the entire FTP conversation to the file you specify, so you can get an idea of\nwhat went wrong. If you specify the special name stdout as the name of the debugging output\nfile, the output will instead print to the screen. Example:\n\n$ ncftpget -d stdout bowser.nintendo.co.jp . /pub/README\n220: FTP server ready.\nConnected to bowser.nintendo.co.jp.\nCmd: USER anonymous\n331: Guest login ok, send your complete e-mail address as password.\nCmd: PASS xxxxxxxx\n230: Welcome!\nLogged in to bowser.nintendo.co.jp as anonymous.\nCmd: TYPE I\n200: Type set to I.\nCmd: PORT 192,168,9,37,6,76\n200: PORT command successful.\nCmd: RETR /pub/README\n550: /pub/README: File in use.\nCmd: QUIT\n221: Goodbye.\n\nUsing ASCII mode is helpful when the text format of your host differs from that of the remote\nhost. For example, if you are retrieving a .TXT file from a Windows-based host to a UNIX\nsystem, you could use the -a flag which would use ASCII transfer mode so that the file cre‐\nated on the UNIX system would be in the UNIX text format instead of the MS-DOS text format.\n\nYou can retrieve an entire directory tree of files by using the -R flag. However, this will\nwork only if the remote FTP server is a UNIX server, or emulates UNIX's list output. Exam‐\nple:\n\n$ ncftpget -R ftp.ncftp.com /tmp /pub/ncftp\n\nThis would create a /tmp/ncftp hierarchy.\n\n### DIAGNOSTICS\n\nncftpget returns the following exit values:\n\n0 Success.\n\n1 Could not connect to remote host.\n\n2 Could not connect to remote host - timed out.\n\n3 Transfer failed.\n\n4 Transfer failed - timed out.\n\n5 Directory change failed.\n\n6 Directory change failed - timed out.\n\n7 Malformed URL.\n\n8 Usage error.\n\n9 Error in login configuration file.\n\n10 Library initialization failed.\n\n11 Session initialization failed.\n\n### AUTHOR\n\nMike Gleason, NcFTP Software (http://www.ncftp.com).\n\n### SEE ALSO\n\nncftpput(1), ncftp(1), ftp(1), rcp(1), tftp(1).\n\nLibNcFTP (http://www.ncftp.com/libncftp/).\n\n\n\nncftpget NcFTP Software ncftpget(1)\n\n" } ], "structuredContent": { "command": "ncftpget", "section": "1", "mode": "man", "summary": "ncftpget - Internet file transfer program for scripts", "synopsis": "ncftpget [options] remote-host local-directory remote-files...\nncftpget [options] bookmark-name local-directory remote-files...\nncftpget -f login.cfg [options] local-directory remote-files...\nncftpget [options] ftp://url.style.host/path/name\nncftpget -c [options] remote-host remote-file > stdout\nncftpget -C [options] remote-host remote-file local-path-name\nncftpget -c [options] ftp://url.style.host/path/name > stdout", "flags": [ { "flag": "-u", "long": null, "arg": null, "description": "" }, { "flag": "-p", "long": null, "arg": null, "description": "" }, { "flag": "-P", "long": null, "arg": null, "description": "" }, { "flag": "-j", "long": null, "arg": null, "description": "" }, { "flag": "-d", "long": null, "arg": null, "description": "" }, { "flag": "-a", "long": null, "arg": null, "description": "" }, { "flag": "-t", "long": null, "arg": null, "description": "" }, { "flag": "-V", "long": null, "arg": null, "description": "stream is a TTY." }, { "flag": "-f", "long": null, "arg": null, "description": "" }, { "flag": "-c", "long": null, "arg": null, "description": "" }, { "flag": "-C", "long": null, "arg": null, "description": "" }, { "flag": "-A", "long": null, "arg": null, "description": "" }, { "flag": "-Z", "long": null, "arg": null, "description": "" }, { "flag": "-E", "long": null, "arg": null, "description": "" }, { "flag": "-F", "long": null, "arg": null, "description": "to regular if the passive connection fails or times out." }, { "flag": "", "long": null, "arg": null, "description": "" }, { "flag": "-R", "long": null, "arg": null, "description": "" }, { "flag": "-T", "long": null, "arg": null, "description": "ncftpget uses TAR whenever possible since this usually preserves symbolic links and file permissions. TAR mode can also result in faster transfers for directories con‐ taining many small files, since a single data connection can be used rather than an FTP data connection for each small file. The downside to using TAR is that it forces downloading of the whole directory, even if you had previously downloaded a portion of it earlier, so you may want to use this option if you want to resume downloading of a directory." }, { "flag": "-r", "long": null, "arg": null, "description": "" }, { "flag": "-b", "long": null, "arg": null, "description": "" }, { "flag": "-b", "long": null, "arg": null, "description": "batch for the batch job to be processed. This is useful if you already have a ncftp‐ batch process running, or wish to have better control of when batch jobs are pro‐ cessed. For example, if you wanted to do background processing of three files all on the same remote server, it is more polite to use just one ncftpbatch process to process the three jobs sequentially, rather than having three ncftpbatch processes open three si‐ multaneous FTP sessions to the same server." }, { "flag": "-B", "long": null, "arg": null, "description": "" }, { "flag": "-W", "long": null, "arg": null, "description": "" }, { "flag": "-X", "long": null, "arg": null, "description": "" }, { "flag": "-Y", "long": null, "arg": null, "description": "The -W, -X, and -Y options are useful for advanced users who need to tweak behavior on some servers. For example, users accessing mainframes might need to send some special SITE commands to set blocksize and record format information. For these options, you can use them multiple times each if you need to send multiple commands. For the -X option, you can use the cookie %s to expand into the name of the file that was transferred." }, { "flag": "-o", "long": null, "arg": null, "description": "This option is used primarily for debugging. It sets the value of an internal vari‐ able to an integer value. An example usage would be: -o useFEAT=0,useCLNT=1 which in this case, disables use of the FEAT command and enables the CLNT command. The avail‐ able variables include: usePASV, useSIZE, useMDTM, useREST, useNLSTa, useNLSTd, useFEAT, useMLSD, useMLST, useCLNT, useHELPSITE, useSITEUTIME, STATfileParamWorks, NLSTfileParamWorks, require20, allowProxyForPORT, doNotGetStartCWD." } ], "examples": [], "see_also": [ { "name": "ncftpput", "section": "1", "url": "https://www.chedong.com/phpMan.php/man/ncftpput/1/json" }, { "name": "ncftp", "section": "1", "url": "https://www.chedong.com/phpMan.php/man/ncftp/1/json" }, { "name": "ftp", "section": "1", "url": "https://www.chedong.com/phpMan.php/man/ftp/1/json" }, { "name": "rcp", "section": "1", "url": "https://www.chedong.com/phpMan.php/man/rcp/1/json" }, { "name": "tftp", "section": "1", "url": "https://www.chedong.com/phpMan.php/man/tftp/1/json" } ], "section_outline": [ { "name": "NAME", "lines": 2, "subsections": [] }, { "name": "SYNOPSIS", "lines": 14, "subsections": [] }, { "name": "OPTIONS", "lines": 1, "subsections": [ { "name": "Command line flags:", "lines": 1 }, { "name": "-u", "lines": 1, "flag": "-u" }, { "name": "-p", "lines": 1, "flag": "-p" }, { "name": "-P", "lines": 1, "flag": "-P" }, { "name": "-j", "lines": 1, "flag": "-j" }, { "name": "-d", "lines": 1, "flag": "-d" }, { "name": "-a", "lines": 1, "flag": "-a" }, { "name": "-t", "lines": 1, "flag": "-t" }, { "name": "-v -V", "lines": 2, "flag": "-V" }, { "name": "-f", "lines": 1, "flag": "-f" }, { "name": "-c", "lines": 1, "flag": "-c" }, { "name": "-C", "lines": 1, "flag": "-C" }, { "name": "-A", "lines": 1, "flag": "-A" }, { "name": "-z -Z", "lines": 1, "flag": "-Z" }, { "name": "-E", "lines": 1, "flag": "-E" }, { "name": "-F", "lines": 2, "flag": "-F" }, { "name": "-DD", "lines": 1 }, { "name": "-R", "lines": 1, "flag": "-R" }, { "name": "-T", "lines": 8, "flag": "-T" }, { "name": "-r", "lines": 1, "flag": "-r" }, { "name": "-b", "lines": 1, "flag": "-b" }, { "name": "-bb -b", "lines": 9, "flag": "-b" }, { "name": "-B", "lines": 1, "flag": "-B" }, { "name": "-W", "lines": 1, "flag": "-W" }, { "name": "-X", "lines": 1, "flag": "-X" }, { "name": "-Y", "lines": 8, "flag": "-Y" }, { "name": "-o", "lines": 7, "flag": "-o" } ] }, { "name": "DESCRIPTION", "lines": 68, "subsections": [] }, { "name": "DIAGNOSTICS", "lines": 26, "subsections": [] }, { "name": "AUTHOR", "lines": 2, "subsections": [] }, { "name": "SEE ALSO", "lines": 7, "subsections": [] } ] } }