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.

                                                                                                         brag(1)