Codebase list debian-goodies / d8137a2
checkrestart.1: Fix multiple rendering and consistency issues Axel Beckert 9 years ago
2 changed file(s) with 23 addition(s) and 21 deletion(s). Raw diff Collapse all Expand all
3131 .SH OPTIONS
3232
3333 .TP
34 .BI -h, --help
34 \fB\-h\fP, \fB \-\-help\fP
3535 Show the program help and exit.
3636
3737 .TP
38 .BI -v, --verbose
38 \fB\-v\fP, \fB\-\-verbose\fP
3939 Generate detailed output. This output includes the list of all
4040 processes found using deleted files or descriptors as well as the deleted files
4141 and descriptors found.
4242
4343 .TP
44 .BI -p, --package
44 \fB\-p\fP, \fB\-\-package\fP
4545 Only process deleted files that belong to a package, ignoring deleted files
4646 which do not have an associated package in the package system.
4747
4848 .TP
49 .BI -a, --all
49 \fB\-a\fP, \fB\-\-all\fP
5050 Process all deleted files regardless of location. This makes
5151 the program analyse deleted files even if they would be discarded
5252 because they are located in locations, such as
5353 .I /tmp
5454 , which are known to produce false positives. It will take preceded if used
5555 simultaneously with the
56 .I -p
56 .B -p
5757 option.
5858
5959 .TP
60 .BI -b\ file, --blacklist=file
60 \fB\-b\fP \fIfile\fP, \fB\-\-blacklist=\fP\fIfile\fP
6161 Read a blacklist of regular expressions from
6262 .I file.
6363 Any files matching the patterns will be ignored. More than one pattern
6464 can be provided by using this option more than once.
6565
6666 .TP
67 .BI -i\ name, --ignore=name
67 \fB\-i\fP \fIname\fP, \fB\-\-ignore=\fP\fIname\fP
6868 Ignore services that are associated to the package name provided in
6969 .I name.
7070 More than one package can be provided by using this option more than once.
7171
72
73 .BI -e\ pid, --excludepid=pid
72 .TP
73 \fB\-e\fP \fIpid\fP, \fB\-\-excludepid=\fP\fIpid\fP
7474 Exclude processes running with
7575 .I pid
7676 when looking for open files. This can speed up checkrestart on systems with a
77 large number of open files. Note: this option only works if lsof is not used.
78 More than one process identifier can be provided by using this option more than
79 once.
80
81 .TP
82 .BI -n, --nolsof
77 large number of open files. Note: this option only works if
78 .B lsof(8)
79 is not used. More than one process identifier can be provided by
80 using this option more than once.
81
82 .TP
83 \fB\-n\fP, \fB\-\-nolsof\fP
8384 Do not use
8485 .B lsof(8)
8586 even if available. In some systems where there are large number of files the
151152 3775 /sbin/dhclient
152153
153154 .SH BUGS
154 This program might fail if the output of the \fIlsof\fP utility changes since it
155 This program might fail if the output of the \fBlsof(8)\fP utility changes since it
155156 depends on it to detect which deleted files are used by processes. It might
156157 also output some false positives depending on the processes' behaviour since
157158 it does not check yet if the (deleted) files in use are really libraries.
162163 please provide the following information when submitting a bug report:
163164
164165 .IP \(em
165 The output of \fBcheckrestart\fP using the \fI-v\fP (verbose) option.
166 The output of \fBcheckrestart\fP using the \fB-v\fP (verbose) option.
166167
167168 .IP \(em
168169 The output of running the following command as root:
171172 .PP
172173
173174 .P
174 .B Checkrestart
175 .B checkrestart
175176 is also sensitive to the kernel version in use. And might fail to work with newer
176177 (or older) versions.
177178
179180 A rewrite to make it less dependent on \fIlsof\fP could improve this, however.
180181
181182 .SH SEE ALSO
182 .B lsof(8), needrestart(8)
183 \fBlsof(8)\fP, \fBneedrestart(8)\fP
183184
184185 Please note that the
185186 .B needrestart
187188 based on deleted files. Results might not be exactly the same as those provided
188189 by
189190 .B checkrestart
190 .TP
191
192191
193192 .SH AUTHOR
194193
200199 .SH COPYRIGHT AND LICENCE
201200
202201 Copyright (C) 2001 Matt Zimmerman <mdz@debian.org>
202 .br
203203 Copyright (C) 2007,2010-2015 Javier Fernandez-Sanguino <jfs@debian.org>
204204
205205 This program is free software; you can redistribute it and/or modify
88 - Properly handle more than one package or glob as parameter as
99 promised by the man page. (dglob can only handle one glob parameter
1010 per call.)
11 * [checkrestart.1]
12 - Fix multiple rendering and consistency issues
1113 * Declare compliance with Debian Policy 3.9.6 (no further changes needed)
1214 * Update Vcs-Browser to use https and the cgit web frontend.
1315 * Convert debian/copyright to machine-readable DEP5 format.