Section: User Commands (1)
brag - Grab multipart binaries from news server
[-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 num] [-m max]
-L [-s server] [-P port] [-l user] [-p pass]
downloads and assembles multipart binaries from an NNTP server.
Attachments encoded with uuencode, base64 and yenc are supported.
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 password file
- -p pass
Set password to pass.
Be silent: do not display progress information
Save subjects together with the assembled binaries. Subject files have
the same name as the binary, with .sub extension appended
- -o dir
Set output directory to dir
- -n num
Start with message number num
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
Combine parts, even if they are from different news servers.
Download single-part messages, too
- -a pattern
Add pattern to the list of accept patterns. See next section on
- -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 num
Set the number of parallel connections to num. Default: 2. Set it
to 4 or higher if you have a fast network connection
- -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
For example, to accept all files with extension
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).
Grabbed files are collected in
(if not specified otherwise using the
command line option). If combining parts from multiple servers ("-C"
option), the results are collected in
Work files are kept in
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.
Passwords can be specified on the command line, or for extra security,
in password files. Each server can have its own password file, named
The format of these files is:
Passwords are not encoded. Take care of the file ownership and permissions.
ACCEPT AND REJECT FILES
If a file called
is present in
its lines are added to the list of accept patterns. Empty ones and
comments starting with "#" are ignored. Similarly, the contents of the
will be added to the list of reject patterns.
File system errors
If not specified on the command line, the environment variable
identifies the server, while
the group to read the news from.
is written in Tcl; you need
version 8.0 or later. For the actual decoding of downloaded parts
uudeview(1) is used (
Akos Polster (email@example.com) and
many others - see README for the complete list of
- ACCEPT AND REJECT PATTERNS
- DOWNLOADED FILES
- WORK FILES
- PASSWORD FILES
- ACCEPT AND REJECT FILES
- EXIT CODES
This document was created by