diff options
| author | Masatake YAMATO | 2017-03-07 03:33:50 +0100 |
|---|---|---|
| committer | Karel Zak | 2017-03-23 12:46:38 +0100 |
| commit | ffbfa7fbafef20aa4815a921d453f511eacc4808 (patch) | |
| tree | 825d690930043c939f15e62bbcd94c9eb1ab46d6 /misc-utils | |
| parent | fincore: new command for counting pages of file contents in core (diff) | |
| download | kernel-qcow2-util-linux-ffbfa7fbafef20aa4815a921d453f511eacc4808.tar.gz kernel-qcow2-util-linux-ffbfa7fbafef20aa4815a921d453f511eacc4808.tar.xz kernel-qcow2-util-linux-ffbfa7fbafef20aa4815a921d453f511eacc4808.zip | |
man: add a page for fincore command
Signed-off-by: Masatake YAMATO <yamato@redhat.com>
Diffstat (limited to 'misc-utils')
| -rw-r--r-- | misc-utils/Makemodule.am | 1 | ||||
| -rw-r--r-- | misc-utils/fincore.1 | 76 |
2 files changed, 77 insertions, 0 deletions
diff --git a/misc-utils/Makemodule.am b/misc-utils/Makemodule.am index 6c7fab676..8cad4d650 100644 --- a/misc-utils/Makemodule.am +++ b/misc-utils/Makemodule.am @@ -183,5 +183,6 @@ endif if BUILD_FINCORE usrbin_exec_PROGRAMS += fincore +dist_man_MANS += misc-utils/fincore.1 fincore_SOURCES = misc-utils/fincore.c endif diff --git a/misc-utils/fincore.1 b/misc-utils/fincore.1 new file mode 100644 index 000000000..7b9b799cf --- /dev/null +++ b/misc-utils/fincore.1 @@ -0,0 +1,76 @@ +.\" Copyright 2017 Red Hat, Inc. +.\" +.\" This file may be copied under the terms of the GNU Public License. +.TH FINCORE 1 "March 2017" "util-linux" "User Commands" +.SH NAME +fincore \- count pages of file contents in core +.SH SYNOPSIS +.B fincore +[options] +.I file ... +.SH DESCRIPTION +.B fincore +counts pages of file contents being resident in memory(in core), and +reports the numbers. An output line has 3 columns: the number of +pages in core, a file size in bytes, and a file name. If an error +occurs during counting, failing to open a file for example, +.B failed +is printed at the column of the number of pages in core. Even if +errors occur, +.B fincore +continues processing the rest of files listed in a command line. +.SH OPTIONS +.TP +\fB\-V\fR, \fB\-\-version\fR +Display version information and exit. +.TP +\fB\-h\fR, \fB\-\-help\fR +Display help text and exit. +.SH EXAMPLES +.PP +An example of successfully executed case: +.PP +.RS +.PD 0 +.TP +.B fincore /etc/fstab /bin/emacs +.TP +1 1544 /etc/fstab +.TP +4156 17163144 /bin/emacs +.TP +.B echo $? +.TP +0 +.PD +.RE +.PP +An example of failure case: +.PP +.RS +.PD 0 +.TP +.B fincore /etc/passwd +.TP +.I fincore: failed to open: /var/log/messages: Permission denied +.TP +failed -1 /var/log/messages +.TP +.B echo $? +.TP +1 +.PD +.RE +.SH AUTHORS +.MT yamato@\:redhat.com +Masatake YAMATO +.ME +.SH "SEE ALSO" +.BR mincore (2), +.BR getpagesize (2), +.BR getconf (1) +.SH AVAILABILITY +The example command is part of the util-linux package and is available from +.UR https://\:www.kernel.org\:/pub\:/linux\:/utils\:/util-linux/ +Linux Kernel Archive +.UE . |