share/man/man8/whodo.8

   1 '\" te
   2 .\" Copyright (c) 2013 Gary Mills
   3 .\" Copyright (c) 2001 Sun Microsystems, Inc. All Rights Reserved.
   4 .\" Copyright 1989 AT&T
   5 .\" The contents of this file are subject to the terms of the Common Development and Distribution License (the "License").  You may not use this file except in compliance with the License.
   6 .\" You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE or http://www.opensolaris.org/os/licensing.  See the License for the specific language governing permissions and limitations under the License.
   7 .\" When distributing Covered Code, include this CDDL HEADER in each file and include the License file at usr/src/OPENSOLARIS.LICENSE.  If applicable, add the following below this CDDL HEADER, with the fields enclosed by brackets "[]" replaced with your own identifying information: Portions Copyright [yyyy] [name of copyright owner]
   8 .TH WHODO 8 "Dec 15, 2013"
   9 .SH NAME
  10 whodo \- who is doing what
  11 .SH SYNOPSIS
  12 .LP
  13 .nf
  14 \fB/usr/sbin/whodo\fR [\fB-h\fR] [\fB-l\fR] [\fIuser\fR]
  15 .fi
  16
  17 .SH DESCRIPTION
  18 .sp
  19 .LP
  20 The \fBwhodo\fR command produces formatted and dated output from information in
  21 the \fB/var/log/utmpx\fR and \fB/proc/pid\fR files.
  22 .sp
  23 .LP
  24 The display is headed by the date, time, and machine name. For each user logged
  25 in, device name, user-ID and login time is shown, followed by a list of active
  26 processes associated with the user-ID. The list includes the device name,
  27 process-ID, CPU minutes and seconds used, and process name.
  28 .sp
  29 .LP
  30 If \fIuser\fR is specified, output is restricted to all sessions pertaining to
  31 that user.
  32 .SH OPTIONS
  33 .sp
  34 .LP
  35 The following options are supported:
  36 .sp
  37 .ne 2
  38 .na
  39 \fB\fB-h\fR\fR
  40 .ad
  41 .RS 6n
  42 Suppress the heading.
  43 .RE
  44
  45 .sp
  46 .ne 2
  47 .na
  48 \fB\fB-l\fR\fR
  49 .ad
  50 .RS 6n
  51 Produce a long form of output. The fields displayed are: the user's login name,
  52 the name of the tty the user is on, the time of day the user logged in
  53 (in ISO time format, weekday name and \fIhours\fR\fB:\fR\fIminutes\fR,
  54 or ISO date format),
  55 the idle time \(em that is, the time since the user last typed anything
  56 (in \fIhours\fR\fB:\fR\fIminutes\fR\fB:\fR\fIseconds\fR),
  57 the CPU time used by all processes and their children on that terminal
  58 (in \fIhours\fR\fB:\fR\fIminutes\fR\fB:\fR\fIseconds\fR),
  59 the CPU time used by the currently active processes
  60 (in \fIhours\fR\fB:\fR\fIminutes\fR\fB:\fR\fIseconds\fR),
  61 and the name and arguments of the current process.
  62 .RE
  63
  64 .SH EXAMPLES
  65 .LP
  66 \fBExample 1 \fRUsing the whodo Command
  67 .sp
  68 .LP
  69 The command:
  70
  71 .sp
  72 .in +2
  73 .nf
  74 example% whodo
  75 .fi
  76 .in -2
  77 .sp
  78
  79 .sp
  80 .LP
  81 produces a display like this:
  82
  83 .sp
  84 .in +2
  85 .nf
  86 Tue Mar 12 15:48:03 1985
  87 bailey
  88 tty09    mcn       8:51
  89     tty09   28158    0:29 sh
  90
  91 tty52    bdr      15:23
  92     tty52   21688    0:05 sh
  93     tty52   22788    0:01 whodo
  94     tty52   22017    0:03 vi
  95     tty52   22549    0:01 sh
  96
  97 xt162    lee      10:20
  98     tty08    6748    0:01 layers
  99     xt162    6751    0:01 sh
 100     xt163    6761    0:05 sh
 101     tty08    6536    0:05 sh
 102 .fi
 103 .in -2
 104 .sp
 105
 106 .SH ENVIRONMENT VARIABLES
 107 .sp
 108 .LP
 109 If any of the \fBLC_*\fR variables ( \fB\fR\fBLC_CTYPE\fR\fB,\fR
 110 \fBLC_MESSAGES\fR\fB,\fR \fBLC_TIME\fR\fB,\fR \fBLC_COLLATE\fR\fB,\fR
 111 \fBLC_NUMERIC\fR\fB,\fR and \fBLC_MONETARY\fR ) (see \fBenviron\fR(5)) are not
 112 set in the environment, the operational behavior of \fBtar\fR(1) for each
 113 corresponding locale category is determined by the value of the \fBLANG\fR
 114 environment variable. If \fBLC_ALL\fR is set, its contents are used to override
 115 both the \fBLANG\fR and the other \fBLC_*\fR variables. If none of the above
 116 variables is set in the environment, the "C" (U.S. style) locale determines how
 117 \fBwhodo\fR behaves.
 118 .sp
 119 .ne 2
 120 .na
 121 \fB\fBLC_CTYPE\fR\fR
 122 .ad
 123 .RS 15n
 124 Determines how \fBwhodo\fR handles characters. When \fBLC_CTYPE\fR is set to a
 125 valid value, \fBwhodo\fR can display and handle text and filenames containing
 126 valid characters for that locale. The \fBwhodo\fR command can display and
 127 handle Extended Unix code (EUC) characters where any individual character can
 128 be 1, 2, or 3 bytes wide. \fBwhodo\fR can also handle EUC characters of 1, 2,
 129 or more column widths. In the "C" locale, only characters from ISO 8859-1 are
 130 valid.
 131 .RE
 132
 133 .sp
 134 .ne 2
 135 .na
 136 \fB\fBLC_MESSAGES\fR\fR
 137 .ad
 138 .RS 15n
 139 Determines how diagnostic and informative messages are presented. This includes
 140 the language and style of the messages, and the correct form of affirmative and
 141 negative responses. In the "C" locale, the messages are presented in the
 142 default form found in the program itself (in most cases, U.S. English).
 143 .RE
 144
 145 .sp
 146 .ne 2
 147 .na
 148 \fB\fBLC_TIME\fR\fR
 149 .ad
 150 .RS 15n
 151 Determines how \fBwhodo\fR handles date and time formats. In the "C" locale,
 152 date and time handling follow the U.S. rules.
 153 .RE
 154
 155 .SH EXIT STATUS
 156 .sp
 157 .LP
 158 The following exit values are returned:
 159 .sp
 160 .ne 2
 161 .na
 162 \fB\fB0\fR\fR
 163 .ad
 164 .RS 12n
 165 Successful completion.
 166 .RE
 167
 168 .sp
 169 .ne 2
 170 .na
 171 \fBnon-zero\fR
 172 .ad
 173 .RS 12n
 174 An error occurred.
 175 .RE
 176
 177 .SH FILES
 178 .sp
 179 .ne 2
 180 .na
 181 \fB\fB/etc/passwd\fR\fR
 182 .ad
 183 .RS 18n
 184 System password file
 185 .RE
 186
 187 .sp
 188 .ne 2
 189 .na
 190 \fB\fB/var/log/utmpx\fR\fR
 191 .ad
 192 .RS 18n
 193 User access and administration information
 194 .RE
 195
 196 .sp
 197 .ne 2
 198 .na
 199 \fB\fB/proc/pid\fR\fR
 200 .ad
 201 .RS 18n
 202 Contains PID
 203 .RE
 204
 205 .SH SEE ALSO
 206 .sp
 207 .LP
 208 \fBps\fR(1), \fBwho\fR(1), \fBattributes\fR(5), \fBenviron\fR(5)