.TH fget 1 "January 2004" "Feep Networks" "FTP Utilities" .SH NAME fget \- commandline FTP client .SH SYNOPSIS \fBfget [options] URL ...\fP .br \fBfget [options] -l URL ...\fP .br \fBfget [options] -e URL ...\fP .SH VERSION This man page documents version 1.3 of \fBfget\fP. .SH DESCRIPTION \fBfget\fP is a commandline FTP utility. It allows simple mirroring of data from remote FTP servers. .SH OPTIONS Options which turn on or off features act as toggles. Specifying them twice will return to the default behavior. .TP .B -c Chase symbolic links. The link itself will be downloaded, as well as the file or directory it points to. This option has no effect when \fI-D\fP is specified. (This option is active by default, except in list mode.) .TP .B -C dir Save files to local directory \fIdir\fP instead of the current directory. .TP .B -d Increment debug level. Higher debug levels produce more output from the FTP connection. .TP .B -D Dereference symbolic links. Instead of downloading the a symlink from the FTP server, \fBfget\fP will download the file that the link points to. .TP .B -e Estimate mode. \fBfget\fP will estimate the total size of the requested files, rather than downloading them. .TP .B -E extendfs_command If the filesystem fills up while \fBfget\fP is downloading files, it will run this command to gain more space on the filesystem. (This is primarily intended for systems like AIX where filesystems can be grown on the fly, but the command could also be a script which deletes old files to free up space.) .TP .B -F Fix symbolic links. Symlinks which point to an absolute path will be converted to point to a relative path before being mirrored. This option has no effect when \fI-D\fP is specified. .TP .B -H Use host directories. Normally, if you download \fIftp://ftp.feep.net/pub/software/fget/\fP, the files are saved in the subdirectory \fIfget\fP. However, if you specify the \fI-H\fP option, the files are saved in the subdirectory \fIftp.feep.net/pub/software/fget\fP. .TP .B -i cache_interval The \fIcache_interval\fP argument specifies the maximum number of seconds a directory cache entry is valid for. If a cache entry is found which is older than this value, the directory is refreshed from the server. If set to -1, there is no limit. The default is -1. .TP .B -I urlfile Reads list of URLs from \fIurlfile\fP. The URLs read from the file are treated the same as if they had been specified on the command line. .TP .B -l List mode. \fBfget\fP will list files at the specified FTP location, rather than downloading them. Specifying \fI-l\fP will also disable recursive operation (see \fI-R\fP) and chasing of symbolic links (see \fI-c\fP). .TP .B -m max_sessions Normally, \fBfget\fP caches connections so that it will not have to reconnect if multiple URLs point to the same FTP server and login. This option sets the number of cached connections to \fImax_sessions\fP. The default is 5. .TP .B -M cache_maxsize The \fIcache_maxsize\fP argument specifies the maximum number of valid directory cache entries to be kept at any given time for each active FTP connection. If set to -1, there is no limit. The default is 1024. .TP .B -N Do not replace local files unless the copy on the server has a newer date. (This is the default.) .TP .B -p Disables passive FTP mode. (Passive mode is on by default.) .TP .B -P Attempt to preserve ownership and permissions of remote files. Note that this may not be possible, since the same user or group may not exist on the local host. .TP .B -q Quiet mode. \fBfget\fP displays no output unless an error occurs. .TP .B -r Do not remove local files which do not exist on the server. (The default is to remove these files.) .TP .B -R Recursive operation. (This option is on by default, except in list mode.) .TP .B -s Do not replace local files unless the copy on the server is a different size than the local copy. (This is the default.) .TP .B -S When downloading a directory, download files into the current directory, instead of creating a subdirectory with the name of the remote directory. This option is ignored when \fI-H\fP is specified. (The default is to download the files into a subdirectory.) .TP .B -t timeout Sets the I/O timeout to \fItimeout\fP seconds. A value of -1 means no timeout (although the kernel may still enforce timeouts for certain operations). The default is -1. .TP .B -T num_retries Sets the number of times to retry a failed connection to \fInum_retries\fP. A value of 0 means unlimited retries. The default is 1. .TP .B -v Increase verbosity. This option can be specified multiple times. .TP .B -V Print \fBfget\fP's version and compile-time defaults. .SH BUGS Probably quite a few. Reports are welcome. .SH SEE ALSO The \fBfget\fP Homepage (\fIhttp://www.feep.net/fget/\fP) .SH AUTHOR Mark D. Roth