From 9e1d79a95ed6291491f43932e450aaa77e8777e0 Mon Sep 17 00:00:00 2001 From: Sami Kerola Date: Sat, 17 Aug 2013 19:15:10 +0100 Subject: docs: add long options to last.1 manual page And align the manual page with Documentation/howto-man-page.txt Signed-off-by: Sami Kerola --- login-utils/last.1 | 180 ++++++++++++++++++++++++++++++----------------------- 1 file changed, 102 insertions(+), 78 deletions(-) (limited to 'login-utils/last.1') diff --git a/login-utils/last.1 b/login-utils/last.1 index 0eaec110e..eff6fe449 100644 --- a/login-utils/last.1 +++ b/login-utils/last.1 @@ -1,4 +1,3 @@ -'\" -*- coding: UTF-8 -*- .\" Copyright (C) 1998-2004 Miquel van Smoorenburg. .\" .\" This program is free software; you can redistribute it and/or modify @@ -15,113 +14,138 @@ .\" along with this program; if not, write to the Free Software .\" Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA .\" -.\"{{{}}} -.\"{{{ Title -.TH LAST,LASTB 1 "Jul 31, 2004" "" "Linux System Administrator's Manual" -.\"}}} -.\"{{{ Name +.TH "LAST,LASTB" "1" "August 2013" "util-linux" "User Commands" .SH NAME last, lastb \- show listing of last logged in users -.\"}}} -.\"{{{ Synopsis .SH SYNOPSIS .B last -.RB [ \-R ] -.RB [ \-\fInum\fP ] -.RB "[ \-\fBn\fP \fInum\fP ]" -.RB [ \-adFiowx ] -.RB "[ \-\fBf\fP \fIfile\fP ]" -.RB "[ \-\fBt\fP \fIYYYYMMDDHHMMSS\fP ]" +.RI [ options ] .RI [ name... ] .RI [ tty... ] .br .B lastb -.RB [ \-R ] -.RB [ \-\fInum\fP ] -.RB "[ \-\fBn\fP \fInum\fP ]" -.RB "[ \-\fBf\fP \fIfile\fP ]" -.RB [ \-adFiowx ] +.RI [ options ] .RI [ name... ] .RI [ tty... ] -.\"}}} -.\"{{{ Description .SH DESCRIPTION -.B Last -searches back through the file \fB/var/log/wtmp\fP (or the file -designated by the \fB\-f\fP flag) and displays a list of all -users logged in (and out) since that file was created. Names of users -and tty's can be given, in which case \fBlast\fP will show only those entries -matching the arguments. Names of ttys can be abbreviated, thus \fBlast -0\fP is the same as \fBlast tty0\fP. +.B last +searches back through the file +.B /var/log/wtmp +(or the file designated by the +.B \-f +option) and displays a list of all users logged in (and out) since that +file was created. +.I Names +of users and +.IR tty 's +can be given, in which case +.B last +will show only those entries matching the arguments. Names of +.I ttys +can be abbreviated, thus +.B last 0 +is the same as +.BR "last tty0" . .PP -When \fBlast\fP catches a \s-2SIGINT\s0 signal (generated by the interrupt key, -usually control-C) or a \s-2SIGQUIT\s0 signal (generated by the quit key, -usually control-\e), \fBlast\fP will show how far it has searched through the -file; in the case of the \s-2SIGINT\s0 signal \fBlast\fP will then terminate. +When +.B last +catches a \s-2SIGINT\s0 signal (generated by the interrupt key, usually +control-C) or a \s-2SIGQUIT\s0 signal, +.B last +will show how far it has searched through the file; in the case of the +\s-2SIGINT\s0 signal +.B last +will then terminate. .PP -The pseudo user \fBreboot\fP logs in each time the system is rebooted. -Thus \fBlast reboot\fP will show a log of all reboots since the log file -was created. +The pseudo user +.B reboot +logs in each time the system is rebooted. Thus +.B last reboot +will show a log of all reboots since the log file was created. .PP -\fBLastb\fP is the same as \fBlast\fP, except that by default it shows a log -of the file \fB/var/log/btmp\fP, which contains all the bad login attempts. -.\"}}} -.\"{{{ Options +.B lastb +is the same as +.BR last , +except that by default it shows a log of the file +.BR /var/log/btmp , +which contains all the bad login attempts. .SH OPTIONS -.IP "\fB\-f\fP \fIfile\fP" -Tells \fBlast\fP to use a specific file instead of \fB/var/log/wtmp\fP. -.IP \fB\-\fP\fInum\fP -This is a count telling \fBlast\fP how many lines to show. -.IP "\fB\-n\fP \fInum\fP" -The same. -.IP "\fB\-t\fP \fIYYYYMMDDHHMMSS\fP" -Display the state of logins as of the specified time. This is -useful, e.g., to determine easily who was logged in at a particular -time -- specify that time with \fB\-t\fP and look for "still logged -in". -.IP "\fB\-f\fP \fIfile\fP" -Specifies a file to search other than \fB/var/log/wtmp\fP. -.IP \fB\-R\fP +.TP +\fB\-f\fR, \fB\-\-file\fR \fIfile\fR +Tell +.B last +to use a specific file instead of +.BR /var/log/wtmp . +.TP +\fB\-\fInumber\fR +.TQ +\fB\-n\fR, \fB\-\-limit\fR \fInumber\fR +This is a count telling +.B last +how many lines to show. +.TP +\fB\-t\fR, \fB\-\-until\fR \fIYYYYMMDDHHMMSS\fR +Display the state of logins as of the specified time. This is useful, +e.g., to determine easily who was logged in at a particular time -- +specify that time with +.B \-\-until +and look for "still logged in". +.TP +\fB\-F\fR, \fB\-\-fulltimes\fR +Print full login and logout times and dates. +.TP +\fB\-R\fR, \fB\-\-nohostname\fR Suppresses the display of the hostname field. -.IP \fB\-a\fP -Display the hostname in the last column. Useful in combination -with the next flag. -.IP \fB\-d\fP +.TP +\fB\-a\fR, \fB\-\-hostlast\fR +Display the hostname in the last column. Useful in combination with the +.B \-\-dns +option. +.TP +\fB\-d\fR, \fB\-\-dns\fR For non-local logins, Linux stores not only the host name of the remote -host but its IP number as well. This option translates the IP number +host but its IP number as well. This option translates the IP number back into a hostname. -.IP \fB\-F\fP +.TP +\fB\-F\fR, \fB\-\-fullnames\fR Print full login and logout times and dates. -.IP \fB\-i\fP -This option is like \fB-d\fP in that it displays the IP number of the remote -host, but it displays the IP number in numbers-and-dots notation. -.IP \fB\-w\fP +.TP +\fB\-i\fR, \fB\-\-ip\fR +This option is like +.B \-\-dns +in that it displays the remote host, but it displays the host in IP +number notation. +.TP +\fB\-w\fR, \fB\-\-fullnames\fR Display full user and domain names in the output. -.IP \fB\-x\fP +.TP +\fB\-x\fR, \fB\-\-system\fR Display the system shutdown entries and run level changes. -.\"}}} .SH NOTES -The files \fIwtmp\fP and \fIbtmp\fP might not be found. The system only -logs information in these files if they are present. This is a local -configuration issue. If you want the files to be used, they can be -created with a simple \fBtouch\fP(1) command (for example, -\fItouch /var/log/wtmp\fP). -.\"{{{ Files +The files +.I wtmp +and +.I btmp +might not be found. The system only logs information in these files if +they are present. This is a local configuration issue. If you want the +files to be used, they can be created with a simple +.BR touch (1) +command (for example, +.IR "touch /var/log/wtmp" ). .SH FILES /var/log/wtmp .br /var/log/btmp -.\"}}} -.\"{{{ Author .SH AUTHOR -Miquel van Smoorenburg, miquels@cistron.nl -.\"}}} +.MT miquels@cistron.nl +Miquel van Smoorenburg +.ME .SH AVAILABILITY The last command is part of the util-linux package and is available from -ftp://ftp.kernel.org/pub/linux/utils/util-linux/. -.\"{{{ See also +.UR ftp://\:ftp.kernel.org\:/pub\:/linux\:/utils\:/util-linux/ +Linux Kernel Archive +.UE . .SH "SEE ALSO" .BR shutdown (8), .BR login (1), .BR init (8) -.\"}}} -- cgit v1.2.3-55-g7522