← Back to branch summary

~ubuntu-branches/ubuntu/lucid/debianutils/lucid

« back to all changes in this revision

Viewing changes to savelog.8

  • Committer: Bazaar Package Importer
  • Author(s): Clint Adams
  • Date: 2009-11-14 13:16:01 UTC
  • mfrom: (1.1.7 sid)
  • Revision ID: james.westby@ubuntu.com-20091114131601-24a06erceh63t4sx
Tags: 3.2.2
http://bugs.debian.org/556227
* savelog: patch from Patrick Coleman to fix breakage when target file
  does not exist.  closes: #556227.
* Bump to Standards-Version 3.8.3.

Show diffs side-by-side

added added

removed removed

Lines of Context:
savelog.8
1
1
.\" -*- nroff -*-
2
 
.TH SAVELOG 8 "21 October 2007" "Debian"
 
2
.TH SAVELOG 8 "1 May 2009" "Debian"
3
3
.SH NAME
4
4
savelog \- save a log file
5
5
.SH SYNOPSIS
18
18
.IR "file" "." "<number>" "" "<compress_suffix>"
19
19
 
20
20
.RE
21
 
where 
 
21
where
22
22
.I <number>
23
23
is the version number, 0 being the newest.  Version numbers > 0 are compressed
24
24
unless
25
25
.B \-l
26
26
prevents it.  Version number 0 is not compressed because a process might still
27
 
have 
 
27
have
28
28
.I file
29
29
opened for I/O.  Only
30
30
.I cycle
39
39
 
40
40
.IP 1)
41
41
Version numbered files are cycled.  Version
42
 
.IR cycle \-2
 
42
.IR "file" "." "2"
43
43
is moved to version
44
 
.IR cycle "\-3,"
 
44
.IR "file" "." "3",
45
45
version
46
 
.IR cycle \-1
47
 
is moved to version
48
 
.IR cycle "\-2 ,"
49
 
and so on.  Finally version 0 is moved to version 1, and version
50
 
.I cycle
 
46
.IR "file" "." "1"
 
47
is moved to version
 
48
.IR "file" "." "2",
 
49
and so on.  Finally version
 
50
.IR "file" "." "0"
 
51
is moved to version
 
52
.IR "file" "." "1",
 
53
and version
 
54
.I "file"
51
55
is deleted.  Both
52
56
compressed names and uncompressed names are cycled, regardless of
53
57
.BR \-l .
55
59
 
56
60
.IP 2)
57
61
The new
58
 
.I file.1
 
62
.IR "file" "." "1"
59
63
is compressed unless the
60
64
.B \-l
61
65
flag was given.  It is changed subject to the
63
67
flags.
64
68
 
65
69
.IP 3)
66
 
The main file is moved to
67
 
.IR file.0 .
 
70
The main
 
71
.IR "file"
 
72
is moved to
 
73
.IR "file" "." "0".
68
74
 
69
75
.IP 4)
70
76
If the
78
84
 
79
85
.IP 5)
80
86
The new
81
 
.I file.0
 
87
.IR "file" "." "0"
82
88
is changed subject to the
83
89
.BR "\-m" ", " "\-u" ", and " "\-g"
84
90
flags.
85
91
 
86
 
Since the version numbers start with 0, version number
87
 
.I cycle
88
 
is never formed.  The
89
 
.I cycle
90
 
count must be at least 2.
91
 
 
92
92
.SH OPTIONS
93
93
.TP
94
94
.B "\-m mode"
104
104
.B \-t
105
105
.TP
106
106
.B "\-c cycle"
107
 
Save cycle versions of the logfile (default: 7)
 
107
Save cycle versions of the logfile (default: 7). The
 
108
.I cycle
 
109
count must be at least 2.
108
110
.TP
109
111
.B \-t
110
112
touch new logfile into existence