1nget(1)                     General Commands Manual                    nget(1)
2
3
4

NAME

6       nget - retrieve files from NNTP (usenet news) hosts
7

SYNOPSIS

9       nget [...]
10

DESCRIPTION

12       nget  retrieves messages matching a regular expression, and decodes any
13       files contained within.  Multipart messages  are  automatically  pieced
14       together.  Parts from multiple servers will be combined if needed.
15

OPTIONS

17       The  order options are specified is significant.  In general, an option
18       will only affect options that come after it on the command line.
19
20       -q/--quiet
21              When specified once, will disable printing of auto-updating text
22              to  allow  the output to be redirected/logged without garbage in
23              it.  When specified  twice,  will  disable  printing  of  merely
24              informative messages.  Errors will still be printed.
25
26       -h/--host host
27              Force  only  the  given host to be used for subsequent commands.
28              (Must be configured in .ngetrc.)  Can reset  to  standard  auto-
29              choosing method with -h ""
30
31       -a/--available
32              Update  the list of available newsgroups.  Subsequent -r/-R com‐
33              mands can be use to search for newsgroups.
34
35       -A/--quickavailable
36              Like -a/--available, but does not update the list, only makes it
37              available for searching.
38
39       -X/--xavailable
40              Search  the  group  list,  but  without  loading  cache  file or
41              retrieving full group list.  Instead, the search will be done on
42              the  server.   Compared  to  -a/-A this has the advantage of not
43              requiring any disk space for cache files, and not requiring  the
44              initial retrieval of the full group list.  The disadvantages are
45              not all servers supporting the  required  NNTP  extensions,  the
46              inability to use complex regexs due to the need to convert it to
47              the simpler wildmat format, and the possibility  that  the  com‐
48              mands  can  be  quite  slow if the server is overloaded (you may
49              need to increase the timeout value in some cases).
50
51       -g/--group group(s)
52              Update the list of available files in group(s).  Multiple groups
53              can  be  specified  by  seperating them with commas.  All cached
54              groups can be selected with "*".  If a host has  been  specified
55              before  with  -h,  it will retrieve headers only from that host.
56              Otherwise it will retrieve headers for all hosts  above  _glevel
57              (see configuration section for more info on priorities.)  Subse‐
58              quent -r/-R commands can be used to retrieve files.
59
60       -G/--quickgroup group(s)
61              Like --group, but does not retrieve new headers.
62
63       -x/--xgroup group(s)
64              Use group(s) for subsequent -r  commands,  but  without  loading
65              cache  file  or  retrieving full header list.  Instead, the XPAT
66              command will used to retrieve only the matching  headers.   Com‐
67              pared  to -g/-G this has the advantage of not requiring any disk
68              space for cache files, and not requiring the  initial  retrieval
69              of  the full header list.  The disadvantages are not all servers
70              supporting XPAT, the inability to use complex regexs due to  the
71              need to convert it to the simpler wildmat format, and the possi‐
72              bility that the xpat command can be quite slow if the server  is
73              overloaded  (you  may need to increase the timeout value in some
74              cases).
75
76       -F/--flushserver host
77              Following -g/-G: Flush  all  headers  for  server  from  current
78              group(s).
79              Following  -a/-A:  Flush all groups/descriptions for server from
80              grouplist.
81
82       -r/--retrieve regex
83              Following -g/-G/-x: Matches regex against subjects of previously
84              selected group(s), and retrieves ones that match.
85              Following  -a/-A:  Matches  regex  against  newsgroup  names and
86              descriptions and lists ones that match. (-T required)
87
88       -R/--expretrieve expression
89              Like -r, but matches expression  instead  of  merely  a  regexp.
90              (see EXPRETRIEVE EXPRESSIONS section for more info.)  Expression
91              is a postfix expression that can contain these keywords:
92              Following -g/-G: subject, author, lines, bytes, have, req, date,
93              age,  update,  updateage,  messageid(or  mid), references.  Note
94              that the --limit argument does not affect  the  option,  if  you
95              want  to  limit  based on number of lines, add it as part of the
96              expression.
97              Following -a/-A: group, desc.
98
99       -@/--list LISTFILE
100              Specify a file to load a list of command line args from.   Looks
101              in  ~/.nget5/lists/ dir by default.  A # char in a listfile that
102              is the first character on a line or is preceeded  by  whitespace
103              and not quoted starts a comment which lasts until the end of the
104              line.
105
106       -p/--path DIRECTORY
107              Path to store subsequent retrieves.  Also sets  -P,  and  clears
108              previously specified dupepaths.  Relative to path which nget was
109              started in.  (Except in the case of inside a -@, which  will  be
110              relative to the cwd at the time of the -@.)
111
112       -P/--temppath DIRECTORY
113              Store temporary files in path instead of the current dir.
114
115       --dupepath DIRECTORY
116              Check  for  dupe files from specified path in addition to normal
117              path.  Can be specified multiple times.
118
119       -m/--makedirs no,yes,ask,<max # of directory levels to create>
120              Make dirs specified by -p and -P.  Default is no.  If yes,  will
121              make  dirs  automatically.   If  #, if the number of directories
122              that would need to be created is greater than the number  given,
123              the  answer will be interpreted as no.  If ask, nget will prompt
124              the user when trying to change to a dir  that  does  not  exist.
125              Valid  responses to the prompt are y[es], n[o], and a max number
126              of directory levels to create.  (This means that if you  get  in
127              the habit of answering "1" rather than "y", and one day typo the
128              first portion of a path you won't accidentally create a bunch of
129              dirs in the wrong place.)
130
131       -T/--testmode
132              Causes --retrieve to merely print out all matching files.
133
134       --text ignore,files,mbox[:filename]
135              Specifies  how to handle text posts.  The default is files.  OPT
136              can be ignore to save only binaries, "files" to save  each  text
137              post in a different file, and "mbox" to save each text post as a
138              message in a mbox format mailbox.  The name of the mbox file  to
139              save  in  can  be  specified  with mbox:filename, the default is
140              nget.mbox.  If the filename ends in .gz, it  will  automatically
141              be  gzipped.   Unless  the  filename has an absolute path, it is
142              interpreted as relative to the retrieve path.
143
144       --save-binary-info yes,no
145              Specifies whether to save text messages for posts that contained
146              only binary data. (If you want to see the headers.)
147
148       --test-multiserver OPT
149              Causes  testmode  to  display  which  servers have parts of each
150              file.  OPT may be no to disable(default),  long  for  a  verbose
151              output, and short for a more condensed form. (In short mode, the
152              shortname of each server is printed with  no  seperating  space,
153              and  it  is  upper-cased  if  that  server does not have all the
154              parts.  If the server has no shortname specified, it defaults to
155              the first char of the server alias.)
156
157       --fullxover OPT
158              Override the fullxover settings of the config file.  The default
159              is -1, which doesn't override.
160
161       -M/--mark
162              Mark matched files as retrieved.
163
164       -U/--unmark
165              Unmark matched files as retrieved.  (Automatically sets -dI)
166
167       -t/--tries int
168              Set maximum number of retries.  -1 will retry indefinatly (prob‐
169              ably not a good idea).
170
171       -l/--limit int
172              Set  the  minimum  number of lines a message (or total number of
173              lines for a multi-part message) must have to be  considered  for
174              retrieval.
175
176       -L/--maxlines int
177              Set  the  maximum number of lines a message must have to be con‐
178              sidered for retrieval. (-1 for unlimited)
179
180       -s/--delay int
181              Set the number of seconds to wait between retry attempts.
182
183       --timeout int
184              Set the number of seconds to wait for  a  reply  from  the  nntp
185              server before giving up.
186
187       -i/--incomplete
188              Retrieve files with missing parts.
189
190       -I/--complete
191              Retrieve only files with all parts.
192
193       --decode
194              Decode and delete temp files (default)
195
196       -k/--keep
197              Decode and keep temp files.
198
199       -K/--no-decode
200              Keep temp files, and don't try to decode them.
201
202       -c/--case
203              Match case sensitively.
204
205       -C/--nocase
206              Match case insensitively.
207
208       --autopar
209              Enable  automatic  parfile  handling. (default) Only download as
210              many par files as needed to replace missing or corrupt files.
211
212       --no-autopar
213              Disable automatic parfile handling.  All parfiles that match the
214              expression will be downloaded.
215
216       -d/--dupecheck FLAGS
217              Check  to  make sure you don't already have files.  This is done
218              in two ways.  The first ("f") is by  compiling  a  list  of  all
219              files  in  the current directory, then checking against all mes‐
220              sages to be retrieved to see if one of the filenames shows up in
221              the  subject.   This works reasonably well, though sometimes the
222              filename isn't in the subject.  It can also  cause  problems  if
223              you  happen  to  have  files in the directory named silly things
224              like "a", in which case all messages with the word "a"  in  them
225              will  be skipped.  However, it is still smart enough not to skip
226              messages that merely have a word containing "a".
227              The second method ("i") is by setting a flag in the header cache
228              that  will  prevent  it from being retrieved again.  You can use
229              combos such as -dfi to check both, -dFi to only check the  flag,
230              -dfI to only check files, etc.
231              The third ("m") will cause files that are found by the dupe file
232              check ("f") to be marked as retrieved in the cache. (Useful  for
233              handling crossposted binaries and/or binaries saved with another
234              newsreader.)
235
236       -D/--nodupecheck
237              Don't check either of the --dupecheck methods, retrieve any mes‐
238              sages that match.
239
240       -N/--noconnect
241              Do  not  connect  to any server for retrieving articles.  Useful
242              for trying to decode as much as you have.   (if  you  got  stuff
243              with -K or ngetlite.)
244
245       -w/--writelite LITEFILE
246              Write a list of parts to retrieve with ngetlite.
247
248       --help Show help.
249

EXPRETRIEVE EXPRESSIONS

251       Expressions  are  in  postfix order.  For the int, date, and age types,
252       standard int comparisons are allowed (==, !=, <, <=, >, >=).  For regex
253       types, ==(=~), !=(!~) are allowed.
254
255       Thus a comparison would take the following form:
256       Infix: <keyword> <operator> <value>  Postfix: <keyword> <value> <opera‐
257       tor>
258
259       Comparisons can be joined with &&(and), ||(or).
260       Infix: <comparison> && <comparison>  Postfix: <comparison> <comparison>
261       &&
262
263   -g/-G keywords
264       subject (regex)
265              Matches the Subject: header.
266
267       author (regex)
268              Matches the From: header.
269
270       lines (int)
271              Matches the Lines: header.
272
273       bytes (int)
274              Matches the length of the message in bytes
275
276       have (int)
277              Matches the number of parts of a multipart file that we have.
278
279       req (int)
280              Matches the total number of parts of a multipart file.
281
282       date (date)
283              Matches   the  Date:  header.   All  the  standard  formats  are
284              accepted.
285
286       age (age)
287              Matches the time since the Date: header.
288              Format: [X y[ears]] [X  mo[nths]]  [X  w[eeks]]  [X  d[ays]]  [X
289              h[ours]] [X m[inutes]] [X s[econds]]
290              Ex.: "6 months 7 hours 8 minutes"
291              Ex.: "6mo7h8m"
292
293       update (date)
294              Matches  the "update time" of the cache item.  That is, the most
295              recent time that a new part of the file  has  been  added.   For
296              example,  if  part 1 was added one day, and part 2 only appeared
297              on the server the next day, then the update time would  be  when
298              part 2 was added on the second day.  But if both parts were seen
299              on the first day, then seen again from a different server on the
300              second day, the update time would stay at the original value.
301
302       updateage (age)
303              Matches the time since the update of the cache item.
304
305       messageid (regex), mid (regex)
306              Matches  the  Message-ID  header.   (For  multi-part  posts,  it
307              matches the message-id of the first part.)
308
309       references (regex)
310              Matches any of the message's References.
311
312   -a/-A keywords
313       group (regex)
314              Matches the newsgroup name.
315
316       desc (regex)
317              Matches the newsgroup description.
318

CONFIGURATION

320       Upon startup, nget will read ~/.nget5/.ngetrc for default configuration
321       values  and  host/group  aliases.   An example .ngetrc should have been
322       included with nget.
323
324       nget will also check ~/_nget5/ and _ngetrc if needed, to handle OS  and
325       filesystems that can't (or won't) handle files starting with a period.
326
327       Options are specified one per line in the form:
328              key=value
329
330       Values  may  be strings(any sequence of characters ending in a newline,
331       not quoted), integers(whole numbers),  floats(decimal  numbers),  bool‐
332       ean(0=false/1=true).
333
334       Subsections are specified in the form:
335              {section_name
336                     data
337              }
338       where data is any number of options.
339
340   Global Configuration Options
341       limit (int, default=0)
342              Default value for -l/--limit
343
344       tries (int, default=20)
345              Default value for -t/--tries
346
347       delay (int, default=1)
348              Default value for -s/--delay
349
350       usegz (int, default=-1)
351              Default  gzip  compression  level to use for cache/midinfo files
352              (can be overridden on a per-group basis).  Acceptable values are
353              -1=zlib default, 0=uncompressed, and 1-9.
354
355       timeout (int, default=180)
356              Seconds  to  wait for a reply from the nntp server before giving
357              up.
358
359       maxstreaming (int, default=64)
360              Sets how many xover commands will be sent at  once,  when  using
361              fullxover.   maxstreaming=0  will  disable streaming.  Note that
362              setting maxstreaming too high can cause your connection to dead‐
363              lock  if  the  write  buffer  is filled up and the write command
364              blocks, but the server will never read more commands since it is
365              waiting for us to read what it has already sent us.
366
367       maxconnections (int, default=-1)
368              Maximum  number  of  connections  to  open  at once, -1 to allow
369              unlimited open connections.   When  reached,  the  servers  used
370              least  recently  will be disconnected first.  (Note that regard‐
371              less of this setting, nget never opens more than one  connection
372              per server.)
373
374       idletimeout (int, default=300)
375              Max seconds to keep an idle connection to a nntp server open.
376
377       curservmult (float, default=2.0)
378              Priority  multiplier  given  to servers which are currently con‐
379              nected.  This can be used to avoid excessive  server  switching.
380              (Set to 1.0 if you want to disable it.)
381
382       penaltystrikes (int, default=3)
383              Number of consecutive connect errors before penalizing a server,
384              -1 to disable penalization.
385
386       initialpenalty (int, default=180)
387              Number of seconds to ignore a penalized server for.
388
389       penaltymultiplier (float, default=2.0)
390              Multiplier for penalty time for each time the penalty time  runs
391              out and the server continues to be down.
392
393       case (boolean, default=0)
394              Default for regex case sensitivity. (0=-C/--nocase, 1=-c/--case)
395
396       complete (boolean, default=1)
397              Default   for   incomplete   file   filter.  (0=-i/--incomplete,
398              1=-I/--complete)
399
400       dupeidcheck (boolean, default=1)
401              Default for already downloaded file filter. (0=-dI, 1=-di)
402
403       dupefilecheck (boolean, default=1)
404              Default for duplicate file filter. (0=-dF, 1=-df)
405
406       autopar (boolean, default=1)
407              Default   for   automatic   par    handling.    (0=--no-autopar,
408              1=--autopar)
409
410       autopar_optimistic (boolean, default=0)
411              One  problem with automatic par handling, is that sometimes peo‐
412              ple do multi-day  posts  and  post  the  par  files  first.   If
413              autopar_optimistic  is  enabled,  it will assume that when there
414              aren't enough .pxx files, that it must just be a multi-day  post
415              and  will not grab any pxx files.  If autopar_optimistic is off,
416              it grab all the pxx files so that if they expire before more are
417              posted, we will already have them.
418
419       quiet (boolean, default=0)
420              Default for quiet option. (0=normal, 1=-q)
421
422       tempshortnames (boolean, default=0)
423              1=Use  8.3  tempfile  names (for old dos partitions, etc), 0=Use
424              17.3 tempfile names
425
426       fatal_user_errors (boolean, default=0)
427              Makes user/path errors cause an immediate exit rather than  con‐
428              tinuing if possible.
429
430       unequal_line_error (boolean, default=0)
431              If  set,  downloaded  articles whose actual number of lines does
432              not match the expected value will be regarded as  an  error  and
433              ignored.  If 0, a warning will be generated but the article will
434              be accepted.
435
436       fullxover (int, default=0)
437              Controls whether nget will check for articles added  or  removed
438              out  of order when updating header cache.  fullxover=0 will fol‐
439              low the nntp spec and  assume  articles  are  always  added  and
440              removed  in the correct order.  fullxover=1 will assume articles
441              may be added out of order, but are still removed in order.  ful‐
442              lxover=2 handles articles being added and removed in any order.
443
444       makedirs (special, default=no)
445              Create    non-existant    directories    specified   by   -p/-P?
446              (yes/no/ask/#)
447
448       test_multiserver (special, default=no)
449              Display multiserver file complition  info  in  testmode  output?
450              (no=no,  short=show  shortname  of each server that has parts of
451              the file, lowercase when complete and uppercase when that server
452              only  has  some  parts,  long=show fullname of each server along
453              with a count of how many parts it has if it does not  have  them
454              all.)
455
456       text (special, default=files)
457              Default   for   the   --text   option   (possible   values   are
458              ignore,files,mbox[:filename]).
459
460       save_binary_info (boolean, default=0)
461              Default for the --save-binary-info option.
462
463       cachedir (string)
464              Specifies a different location to store cache files.   Could  be
465              used  to  share  a  single  cache dir between a trusted group of
466              users, to reduce HD/bandwidth usage, while still  allowing  each
467              user to have their own config/midinfo files.)
468
469   Host Configuration
470       Host configuration is done in the halias section, with a subsection for
471       each host containing its options:
472
473       address (string, required)
474              Address of the server, with optional port number seperated by  a
475              colon.   To  specify  a literal IPv6 address with a port number,
476              use the format "[address]:port".
477
478       id (int, required)
479              An identifier for this server.  The  id  uniquely  identifies  a
480              certain  set  of header cache data.  You may specify the same id
481              in more than one host, for example if you have multiple accounts
482              on  a  server  to  avoid to storing the same cache data multiple
483              times.  The id should not be changed after  you  have  used  it.
484              Must  be  greater  than  0  and  less  than  ULONG_MAX. (usually
485              4294967295).
486
487       shortname (string, default=first character of host alias)
488              The shortname to use for this server.
489
490       user (string)
491              Username for the server, if it requires authorization.
492
493       pass (string)
494              Password for the server, if it requires authorization.
495
496       fullxover (int)
497              Override global fullxover setting for this server only.
498
499       maxstreaming (int)
500              Override global maxstreaming setting for this server only.
501
502       idletimeout (int)
503              Override global idletimeout setting for this server only.
504
505       linelenience (special, default=0)
506              The linelenience option may be specified as either a single int,
507              or  two  ints  seperated by a comma.  If only a single int, X is
508              specified, then it will be interpeted as shorthand for  "-X,+X".
509              These values specify the ammount that the real (recieved) number
510              of lines (inclusive) for an article may deviate from the  values
511              returned  by  the  server  in the header listings.  For example,
512              "-1,2" means that the real number of lines may be one less than,
513              equal  to,  one  greater  than, or two greater than the expected
514              amount.
515
516       For example, the following host section defines a single host  "host1",
517       with  nntp authentication for user "bob", password "something", and the
518       fullxover option enabled.
519              {halias
520                     {host1
521                            addr=news.host1.com
522                            id=3838
523                            user=bob
524                            pass=something
525                            fullxover=1
526                            linelenience=-1,2
527                     }
528              }
529
530   Server Priority Configuration
531       Multiserver priorities are defined in the hpriority section.   Multiple
532       priority groups can be made, and different newsgroups can be configured
533       to use their own  priority  grouping,  or  they  will  default  to  the
534       "default"  group.   The  -a  option  will use the "_grouplist" priority
535       group if it exists, otherwise it will use the "default" group.
536
537       The hpriority section contains a subsection for  each  priority  group,
538       with  data  items  of  server=prio-multiplier,  and  the  special items
539       _level=float  and  _glevel=float.   _level  sets  the  priority   level
540       assigned  to  any  host  not  listed in the group, and _glevel sets the
541       required priority needed for -g and -a to automatically use that  host.
542       Both _level and _glevel default to 1.0 if not specified.
543
544       The  priority  group "trustsizes" also has special meaning, and is used
545       to choose which servers reporting of article line/byte counts to  trust
546       when reporting to the user.
547
548       For  example,  the following section defines the default priority group
549       and the trustsizes priority group.  If all hosts have a  certain  arti‐
550       cle,  goodhost  will  be  most  likely  to be chosen, and badhost least
551       likely.  It also sets the default priority level to 1.01,  meaning  any
552       hosts  not  listed  in  this  group will have a priority of 1.01.  When
553       using -g without first specifying a host, only those with prios 1.2  or
554       above will be selected.
555              {hpriority
556                     {default
557                            _level=1.01
558                            _glevel=1.2
559                            host1=1.9
560                            goodhost=2.0
561                            badhost=0.9
562                     }
563                     {trustsizes
564                            goodhost=5.0
565                            badhost=0.1
566                     }
567              }
568
569   Newsgroup Alias Configuration
570       Newsgroup aliases are defined in the galias section.  An alias can be a
571       simple alias=fullname data item, or  a  subsection  containing  group=,
572       prio=, and usegz= items.  The per-group usegz setting will override the
573       global setting.
574
575       An alias can also refer to multiple groups (either fullnames or further
576       aliases).
577
578       For  example,  the  following galias section defines an alias of "abpl"
579       for the group "alt.binaries.pictures.linux", "chocobo"  for  the  group
580       "alt.chocobo",  and  ospics  for  both  alt.binaries.pictures.linux and
581       alt.binaries.pictures.freebsd.   In  addition,  the  chocobo  group  is
582       assigned  to  use  the  chocoprios priority grouping when deciding what
583       server to retrieve from.
584              {galias
585                     abpl=alt.binaries.pictures.linux
586                     {chocobo
587                            group=alt.chocobo
588                            prio=chocoprios
589                     }
590                     ospics=abpl,alt.binaries.pictures.freebsd
591              }
592

EXIT STATUS

594       On exit,  nget will display a summary of the run.  The summary is split
595       into three parts:
596
597       OK     Lists successful operations.
598
599              total  Total number of "logical messages" retrieved (after join‐
600                     ing parts).
601
602              uu     Number of uuencoded files.
603
604              base64 Number of Base64 (Mime) files.
605
606              XX     Number of xxencoded files.
607
608              binhex Number of Binhex encoded files.
609
610              plaintext
611                     Number of plaintext files saved.
612
613              qp     Number of Quoted-Printable encoded files.
614
615              yenc   Number of yEncoded files.
616
617              dupe   Number of decoded files that were exact dupes of existing
618                     files, and thus deleted.
619
620              skipped
621                     Number  of  files that were queued to download but turned
622                     out to be dupes after decoding earlier parts and  compar‐
623                     ing  their  filenames  to the subject line.  (Same method
624                     thats used for the dupe file check when queueing them up,
625                     just  that the filename(s) of any decoded files cannot be
626                     known until they are downloaded, so some of the  checking
627                     must occur during the run rather than at queue time.)
628
629              group  Number of groups successfully updated.
630
631              grouplist
632                     Newsgroup list successfully updated.
633
634              autopar
635                     Number of parity sets that are complete.
636
637       WARNINGS
638
639              group  Updating  group  info  failed  for  some  (but  not  all)
640                     attempted servers.
641
642              xover  Weird things happened while updating group info.
643
644              grouplist
645                     Updating newsgroup list failed for  some  (but  not  all)
646                     attempted servers.
647
648              retrieve
649                     Article retrieval failed for some (but not all) attempted
650                     servers.
651
652              undecoded
653                     Articles were not decoded (usually because -K was used).
654
655              unequal_line_count
656                     Some articles retrieved had different  line  counts  than
657                     the  server said they should.  (And unequal_line_error is
658                     set to 0).
659
660              dupe   Number of decoded files that had the same name as  exist‐
661                     ing files, but different content.
662
663              autopar
664                     Weirdness  encountered reading par files, such as encoun‐
665                     tering unknown par versions, or  non-ascii  filenames  in
666                     the pars.
667
668       ERRORS Lists errors that occured.  In addition, the exit status will be
669              set to a bitwise OR of the codes of  all  errors  that  occured.
670              (Note  that some errors share an exit code, since there are only
671              8 bits available.)
672
673              decode (exit code 1)
674                     Number of file decoding errors.
675
676              autopar (exit code 2)
677                     Number of parity sets that could not be completed.
678
679              path (exit code 4)
680                     Errors changing to paths specified with -p or -P.
681
682              user (exit code 4)
683                     User errors, such as trying -r without specifying a group
684                     first.
685
686              retrieve (exit code 8)
687                     Number   of   times  article  retrieval  failed  for  all
688                     attempted servers.
689
690              group (exit code 16)
691                     Number of times header retrieval failed for all attempted
692                     servers.
693
694              grouplist (exit code 32)
695                     Number  of  times newsgroup list retrieval failed for all
696                     attempted servers.
697
698              fatal (exit code 128)
699                     Error preventing further operation,  such  as  "No  space
700                     left on device".
701
702              other (exit code 64)
703                     Any other kind of error.
704

EXAMPLES

706       The  simplest  possible  example.   Retrieve and decode everything from
707       alt.binaries.test that you haven't already gotten before:
708       nget -g alt.binaries.test -r ""
709
710       get listing of all files matching penguin.*png  from  alt.binaries.pic‐
711       tures.linux (note this is a regex, equivilant to standard shell glob of
712       penguin*png.. see the regex(7) or grep manpage for more info on regular
713       expressions.)
714       nget -g alt.binaries.pictures.linux -DTr "penguin.*png"
715
716       retrieve all the ones that have more than 50 lines:
717       nget -g alt.binaries.pictures.linux -l 50 -r "penguin.*png"
718
719       equivilant to above, using -R:
720       nget -g alt.binaries.pictures.linux -R "lines 50 > subject penguin.*png
721       == &&"
722       (basically (lines > 50) && (subject == penguin.*png))
723
724       flush  all  headers  from  host  goodhost  in  group  alt.binaries.pic‐
725       tures.linux:
726       nget -Galt.binaries.pictures.linux -Fgoodhost
727
728       retrieve/update  group  list,  and  list all groups with "linux" in the
729       name or description:
730       nget -a -Tr linux
731
732       equivilant to above, using -R:
733       nget -a -TR "group linux == desc linux == ||"
734
735       flush all groups from host goodhost in grouplist:
736       nget -A -Fgoodhost
737

NOTES

739       Running multiple copies of nget at once should be safe.  It  uses  file
740       locking,  so  there should be no way for the files to actually get cor‐
741       rupted.  However if you have two ngets doing a -g on the same group  at
742       the  same time, it would duplicate the download for both processes.  If
743       you are using -G there is no problem at all.  (Theoretically you  might
744       be  able  to  cause some sort of problems by downloading the same files
745       from the same group in the same directory at the same time..)
746

ENVIRONMENT

748       HOME   Where to put .nget5 directory. (put nget files $HOME/.nget5/)
749
750       NGETHOME
751              Override HOME var (put nget files in $NGETHOME)
752
753       NGETCACHE
754              Override HOME/NGETHOME vars and  .ngetrc  cachedir  option  (put
755              nget cache files in $NGETCACHE)
756
757       NGETRC Alternate configuration file to use.
758

FILES

760       ~/.nget5/
761              All  configuration  and cache files are stored here.  Changed to
762              .nget5/ because cache format changed in nget 0.27.   (The  5  in
763              the  directory  name is for file format version 5, not nget ver‐
764              sion 5.)  To upgrade a .nget4 directory to  .nget5,  simply  run
765              "mv ~/.nget4 ~/.nget5 ; rm ~/.nget5/*,cache*"
766
767       ~/.nget5/.ngetrc
768              Configuration  file.   If  you  store authentication information
769              here, be sure to set it readable only by owner.
770
771       ~/_nget5/_ngetrc
772              Alternate location, use this if  you  can't  create  a  dir/file
773              starting with a period.
774
775       ~/.nget5/lists/
776              Default directory for listfiles.
777

AUTHOR

779       Matthew Mueller <donut AT dakotacom.net>
780
781       The  latest  version,  and other programs I have written, are available
782       from:
783       http://www.dakotacom.net/~donut/programs/
784

ACKNOWLEDGEMENTS

786       Frank Pilhofer, author of uulib, which nget depends upon for uudecoding
787       the   files   once  they  are  downloaded.   http://www.fpx.de/fp/Soft
788       ware/UUDeview/
789
790       Peter Brian  Clements,  author  of  par2-cmdline,  which  nget  uses  a
791       stripped     down     version     of    for    its    par2    checking.
792       http://parchive.sourceforge.net/
793
794       The Unix-socket-faq, which my url for has gone bad, but  is  supposedly
795       posted monthly on comp.unix.programmer.
796
797       Beej's        Guide        to        Network       Programming       at
798       http://www.ecst.csuchico.edu/~beej/guide/net/
799
800       Jean-loup Gailly and Mark Adler, for the zlib library.
801

SEE ALSO

803       ngetlite(1), regex(7), grep(1)
804
805
806
807                                  21 Dec 2004                          nget(1)
Impressum