1nget(1) General Commands Manual nget(1)
2
3
4
6 nget - retrieve files from NNTP (usenet news) hosts
7
9 nget [...]
10
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
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
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
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
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
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
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
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
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
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
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
803 ngetlite(1), regex(7), grep(1)
804
805
806
807 21 Dec 2004 nget(1)