nap.1.in

P2P NAP的C实现 P2P在网络应用中越来越流行

.TH "nap" "1" "@VERSION@" "Peter Selinger" "Napter client"
.SH "NAME"
nap, napping - Linux Napster Client
.SH "SYNTAX"
nap <\fIoptions\fP>
.br 
napping
.SH "DESCRIPTION"
.LP 
Nap is a linux console napster client written by Kevin Sullivan and
improved by Peter Selinger and others. The advantage of nap over other
graphical clients like gnome-napster is that you can run it under
screen(1) on a remote host and disconnect from your session while nap
continues the downloads. You can later reconnect to your running
client even from another host and do more commands.
.LP 
Napping is a helper application required by nap to send and reveive
ping packets. For napping to work it should be installed suid root.
.LP 
For more information, please see the HTML documentation at
http://nap.sourceforge.net/userguide.html.
.SH "OPTIONS"
.LP 
.TP 
\fB\-h, \-\-help\fR
Output help information and exit
.TP 
\fB\-v, \-\-version\fR
print version info and exit
.TP 
\fB\-b, \-\-build\fR
build library of your shared files to send to server (obsolete, as nap
will do this by default).
.TP 
\fB\-B, \-\-build\-only\fR
build library and exit
.TP 
\fB\-N, \-\-nobuild\fR
do not build library, even if it is out of date 
.TP 
\fB\-m, \-\-create\fR
create a new account with the napster server (obsolete)
.TP 
\fB\-r, \-\-reconnect\fR
keep reconnecting until server connection established 
.TP 
\fB\-a, \-\-autorestart\fR
automatically reconnect when connection to server lost 
.TP 
\fB\-q, \-\-daemon\fR
run without user interface; file sharing only
.TP 
\fB\-t, \-\-notitle\fR
do not display the title bar (fixes messed\-up displays) 
.TP 
\fB\-l, \-\-nxterm\fR
try using a terminal which is compatible with most  systems (fixes
some messed\-up displays)
.TP 
\fB\-T, \-\-transparent\fR
use the terminal's default background instead of black
.TP 
\fB\-n, \-\-noserver\fR
start up without connecting to a server
.TP 
\fB\-f \fI<filename>\fP, \-\-config \fI<filename>\fP\fR
specifies the config file to use (default ~/.nap/napconf) 
.TP 
\fB\-x \fI<filename>\fP, \-\-log \fI<filename>\fP\fR
log all transfers to a specific filename 
.TP 
\fB\-g \fI<filename>\fP, \-\-logall \fI<filename>\fP\fR
log everything to a specific filename 
.TP 
\fB\-s \fI<server>\fP, \-\-server \fI<server>\fP\fR
select a specific server (multiple \-s opts possible) 
.TP 
\fB\-d \fI<n>\fP, \-\-debug \fI<n>\fP\fR
set debug level 
.TP 
\fB\-u \fI<str>\fP, \-\-user \fI<str>\fP\fR
specify napster username 
.TP 
\fB\-p \fI<str>\fP, \-\-pass \fI<str>\fP\fR
specify user's password 
.TP 
\fB\-e \fI<str>\fP, \-\-email \fI<str>\fP\fR
specify user's email address 
.TP 
\fB\-U \fI<dir>\fP, \-\-upload \fI<dir>\fP\fR
specify upload directory (multiple \-U opts possible) 
.TP 
\fB\-D \fI<dir>\fP, \-\-download \fI<dir>\fP\fR
specify download directory 
.TP 
\fB\-I \fI<dir>\fP, \-\-incomplete \fI<dir>\fP\fR
specify directory for incomplete files 
.TP 
\fB\-P \fI<n>[-<m>]\fP, \-\-dataport \fI<n>[\-<m>]\fP\fR
specify port(s) to use for incoming upload requests
.TP 
\fB\-C \fI<n>\fP, \-\-connection \fI<n>\fP\fR
specify connection speed number, according to the following chart:

 Connection | Number
 -------------------
 Unknown    |  0
 14.4       |  1
 28.8       |  2
 33.6       |  3
 56.7       |  4
 64K ISDN   |  5
 128K ISDN  |  6
 Cable      |  7
 DSL        |  8
 T1         |  9
 T3 or >    | 10

.TP 
\fB\-M \fI<n>\fP, \-\-maxuploads \fI<n>\fP\fR
specify maximum number of simultaneous uploads 
.TP 
\fB\-o \fI<var>=<value>\fP, \-\-option \fI<var>=<value>\fP\fR
set user configuration variable
.SH "CONFIGURATION VARIABLES"
.LP 
Configuration variables can be set in the file ~/.nap/napconf, on the
command line via the \fB\-o\fR option, or interactively via the /set
command.  Here is an almost complete list of configuration variables:
.TP
\fBuser\fR
your napster username
.TP
\fBpass\fR
your napster password - optional
.TP
\fBemail\fR
your napster email address
.TP
\fBupload\fR
list of upload directories, separated by semicolons
.TP
\fBdownload\fR
your download directory
.TP
\fBincomplete\fR
your directory for incomplete files
.TP
\fBconnection\fR
your connection speed (see \fB\-C\fP option)
.TP
\fBmaxuploads\fR
maximal number of simultaneous uploads allowed
.TP
\fBmaxupuser\fR
maximum number of simultaneous uploads per user
.TP
\fBmaxdownloads\fR
maximum number of simultaneous downloads allowed
.TP
\fBmaxdownuser\fR
maximum number of simultaneous downloads per user
.TP
\fBservers\fR
list of servers, separated by semicolons (note: this is now ignored and overwritten unless nometa is set)
.TP
\fBdataport\fR
port or range of ports to use for client-client connections. Set this to 0 if you are behind a firewall
.TP
\fBlogfile\fR
log file for transfer logs
.TP
\fBlogallfile\fR
log file for logging everything
.TP
\fBbandwidthdown\fR
global bandwidth limit for downloads (in kB/s)
.TP
\fBbandwidthdown1\fR
download bandwidth limit per connection (in kB/s)
.TP
\fBbandwidthup\fR
global bandwidth limit for uploads (in kB/s)
.TP
\fBbandwidthup1\fR
upload bandwidth limit per connection (in kB/s)
.TP
\fBannouncepongs\fR
should receipt of PONG packets be announced?
.TP
\fBautopurge\fR
time to delete stopped items from up- and download lists
.TP
\fBautopurgeup\fR
time to delete stopped items from upload list
.TP
\fBautopurgedown\fR
time to delete stopped items from download list
.TP
\fBautoreply\fR
a string to send as an automatic reply to incoming user messages
.TP
\fBautorestart\fR
automatically reconnect when connection to server lost?
.TP
\fBconnecttimeout\fR
timeout after this many seconds while connecting to server
.TP
\fBcursorfollowsscreen\fR
should PgUp and PgDn move the screen, rather than the cursor, on the search result screen?
.TP
\fBdebug\fR
debug level
.TP
\fBidentity\fR
fake client id for fooling servers that refuse connections from nap client
.TP
\fBhash\fR
shall we calculate MD5 hashes? Note that most servers don't use them.
.TP
\fBincompletesuffix\fR
suffix to use for incomplete files
.TP
\fBlibraryfile\fR
location of your library file
.TP
\fBmetaserver\fR
URL of a napigator-style metaserver
.TP
\fBmetatimeout\fR
timeout for connecting to metaserver
.TP
\fBnapping\fR
relative or absolute filename of the napping program to use
.TP
\fBnewstimeout\fR
timeout for retrieving news
.TP
\fBnoechosets\fR
should the /set command be quiet?
.TP
\fBnomasq\fR
should filename masquerading be disabled?
.TP
\fBnometa\fR
skip connecting to metaserver on startup?
.TP
\fBnonews\fR
do you want to skip news about new releases on startup?
.TP
\fBnoping\fR
do you want to disable pings?
.TP
\fBnoresultscreen\fR
should search results be displayed on the main screen?
.TP
\fBnoscroll\fR
should main screen not scroll to bottom automatically on output?
.TP
\fBproxy\fR
URL of http proxy, if needed to access www through firewall
.TP
\fBsavechannels\fR
should your open channels to be saved between sessions?
.TP
\fBsavepass\fR
should password be saved in config file?
.TP
\fBscrollsize\fR
limit on the number of lines in main screen, or 0 for no limit
.TP
\fBsdefaults\fR
default keystrokes for search result screen appearance
.TP
\fBsharetypes\fR
semicolon-separated list of file extensions to share in addition to mp3 files. Case insensitive. Use '*' for 'all files'.
.TP
\fBshowtoomanyuploads\fR
display a message when upload limit is reached?
.TP
\fBturdsize\fR
size of the largest incomplete file which will be auto-removed
.SH "COMMANDS"
.LP 
Nap has an irc-like interface. Commands start with a slash "/". The
two most important commands are \fB/search\fP to start a search, and
\fB/reconnect\fP to cycle through the list of servers. Here is a
complete list of commands:

\fB/about\fP \- Shows credits
.TP
\fB/alias\fP \fI[name]\fP \fI[args]\fP \- Creates an alias, or lists current aliases
.TP
\fB/aliaslist\fP \- Shows current list of aliases
.TP
\fB/announce\fP \fImsg\fP \- Broadcasts a message to all users
.TP
\fB/ban\fP \fI[user/IP]\fP \- Bans the specified user or IP, or lists banned users