|
|
1.1 root 1: .TH NFARCHIVE 8 "University of Illinois"
2: .SH NAME
3: nfarchive \- archive notesfiles
4: .SH SYNOPSIS
5: .B nfarchive
6: [
7: .B "-#"
8: ]
9: [
10: .B "-d"
11: ]
12: [
13: .B "-m-"
14: or
15: .B "-m+"
16: ]
17: [
18: .B "-w#"
19: ]
20: [
21: .B "-f"
22: file
23: ]
24: topic [ ... ]
25: .SH DESCRIPTION
26: .I "Nfarchive"
27: is used to expire notes that have not been modified in a certain
28: amount of time.
29: Archives are stored in ``archive notesfiles''.
30: .PP
31: The
32: .B "-#"
33: parameter is the number of days
34: a notestring must be idle (no new responses) before
35: being eligible for archival.
36: .PP
37: Expired notestrings are either deleted or placed in an archive.
38: The
39: .B "-d"
40: parameter tells
41: .I "nfarchive"
42: to delete expired notestrings.
43: If unselected,
44: the expired notestrings are placed in an archive.
45: .PP
46: The
47: .B "-m+"
48: option specifies that only notes marked with a
49: director message are eligible for expiration.
50: .B "-m-"
51: specifies that only notes without a director message are eligible
52: for expiration.
53: By default, the expiration algorithm is indifferent to
54: a note's director message status.
55: .PP
56: The
57: .B "-w#"
58: option specified the working set size
59: for the expired notesfiles.
60: The specified number
61: represents the minimum number of notes to leave in the notesfile.
62: .PP
63: The expiration threshold,
64: working set size,
65: expiration action,
66: and
67: director message requirements
68: can all be specified as a director's option in each notesfile.
69: Specific values override what is specified on the
70: .I "nfarchive"
71: command line.
72: A default value specifies using the value specified on the
73: command line.
74: .PP
75: The
76: .B "-f"
77: parameter specifies a file containing a list of notesfiles
78: to archive.
79: Notesfiles can also be specified on the command line.
80: .PP
81: By default, the archive of notesfile
82: .I /usr/spool/notes/somenotes
83: is in
84: .I /usr/spool/oldnotes/somenotes.
85: The archive of
86: .I /some/other/place/somenotes
87: also defaults to
88: .I /usr/spool/oldnotes/somenotes.
89: To prevent collisions of this nature,
90: mapping between active and archive notesfiles is implemented.
91: The file
92: .I /usr/spool/notes/.utilities/net.alias/Archive-into
93: contains lines of the form:
94:
95: active-notesfile:archive notesfile
96:
97: Lines in this file beginning with `#' are comments.
98: Notesfiles without an entry in this file are archived into
99: the
100: .I /usr/spool/oldnotes
101: directory with the appropriate last component.
102: .PP
103: When initially created, an archive notesfile
104: has an access list matching its active counterpart.
105: Currently, only directors are allowed to write in an
106: archive notesfile.
107: .I Nfarchive
108: refuses to archive an archive notesfile.
109: .SH FILES
110: .PD 0
111: .TP 45
112: /usr/spool/notes/.utilities
113: where this programs lives.
114: .TP 45
115: /usr/spool/notes/.utilities/net.alias/Archive-into
116: maps active notesfiles into their archives.
117: .TP 45
118: /usr/spool/notes
119: Default notes data base
120: .TP 45
121: /usr/spool/oldnotes
122: Default archive directory
123: .PD
124: .SH SEE ALSO
125: notes(1),
126: .br
127: .ul
128: The Notesfile Reference Manual
129: .SH AUTHORS
130: .nf
131: Ray Essick (uiucdcs!essick, essick%[email protected])
132: Department of Computer Science
133: University of Illinois at Urbana-Champaign
134: Urbana, IL
135: .sp
136: Rob Kolstad ([email protected])
137: CONVEX Computer Corporation
138: Richardson, TX
139: .fi
This archive runs on limited infrastructure. Preserving old code on modern bandwidth. Automated agents are requested to crawl responsibly.