brag(1) 						      General Commands Manual							   brag(1)

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  combin-
       ing 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.

																	   brag(1)