NAME¶
brag - Grab multipart binaries from news server
SYNOPSIS¶
brag [-s server] [-P port] [-g group] [-l user] [-p pass] [-q] [-u] [-o
dir] [-n num] [-c] [-C] [-X] [-a pattern [-a pattern] ...] [-r pattern [-r
pattern] ...] [-A file] [-R file] [-t n] [-b break] [-m max]
or
brag -L [-s server] [-P port] [-l user] [-p pass]
DESCRIPTION¶
brag downloads and assembles multipart binaries from an NNTP server.
Attachments encoded with uuencode, Base64 or yenc are supported.
OPTIONS¶
- -L
- Just print a list of groups available at the server
- -s server
- Set news server to server
- -P port
- Set TCP port to port
- -g group
- Set newsgroup to group
- -l user
- Set user name to user. Setting this option turns NNTP
authentication on. The password can be specified using the -p
command line option, or using a passwod file (see later)
- -p pass
- Set password to pass.
- -q
- Be silent: do not display progress information
- -u
- Save subjects together with the assembled binaries. Subject files have the
same name as the binary, with .sub extension added
- -k
- Keep original file names when possible, only rename when necessary to
avoid a collission with existing files
- -o dir
- Set output directory to dir
- -n num
- Start with message number num
- -c
- Combine parts, even if they are from different newsgroups. Also, an
article will be downloaded only once, even if it was crossposted to more
than one newsgroups
- -C
- Combine parts, even if they are from different news servers
- -X
- Process single-part messages, too
- -a pattern
- Add pattern to the list of accept patterns. See next section on
accept/reject patterns
- -r pattern
- Add pattern to the list of reject patterns
- -A file
- Read accept patterns from this file
- -R file
- Read reject patterns from this file
- -t n
- Use n number of parallel connections to the server. Default: 2. Set to 4
or more if you have a high speed network connection
- -b break
- Specify "break factor": the number of milliseconds to wait
between retrieving lines from the server. Useful to share a low-speed
connection with other applications
- -m max
- Specify the maximum number of messages to download
ACCEPT AND REJECT PATTERNS¶
The subjects of the messages to be downloaded are matched against the list of
accept and/or reject patterns if specified on the command line or in the
accept/reject files (see later). Only articles matching at least one of the
accept patterns will be accepted. Similarly, articles matching one of the
reject patterns will be rejected.
Match operations are performed as in
csh(1). For example, to accept all
files with extension
mp5 , specify
-a ´*.mp5*'
on the command line. Note the quotes (we do not want the shell to process the
pattern) and the second "*" (we are matching against subject lines,
not file names).
FILES¶
DOWNLOADED FILES¶
Grabbed files are collected in
~/.brag/<server>/<group>/finished (if not specified
otherwise using the
-o command line option). If combining parts from
multiple servers ("-C" option), the results are collected in
~/.brag/all-servers/<group>/finished.
WORK FILES¶
Work files are kept in
~/.brag/<server>/<group>/unfinished or
in
~/.brag/all-servers/<group>/unfinished if the "-C"
option is used. It is recommended to regularly purge these directories by
removing old files and subdirectories. What "old" means depends on
the newsgroup's traffic; one week can be a good approximation.
PASSWORD FILES¶
Passwords can be specified on the command line, or for extra security, in
password files. Each server can have its own password file, named
~/.brag/<server>/passwd. The format of these files is:
user1:password1
user2:password2
...
Passwords are not encoded. Take care of the file ownership and permissions.
ACCEPT AND REJECT FILES¶
If a file called
accept is present in
~/.brag/<server>/<group>, its lines are added to the list
of accept patterns. Empty ones and comments starting with "#" are
ignored. Similarly, the contents of the file named
reject will be added
to the list of reject patterns.
EXIT CODES¶
- 0
- Success
- 1
- Usage errors
- 2
- Network errors
- 3
- File system errors
ENVIRONMENT¶
If not specified on the command line, the environment variable
NNTPSERVER
identifies the server, while
NNTPGROUP the group to read the news from.
DEPENDENCIES¶
brag is written in Tcl; you need
tclsh(1) version 8.0 or later.
For the actual decoding of dowloaded parts
uudeview(1)
(
http://www.fpx.de/fp/Software/UUDeview) is used.
AUTHOR¶
Akos Polster (akos@pipacs.com) and many others - see README for the complete
list of contributors.