manual/psmisc/original/man1/pidof.1

   1 .TH PIDOF 1 "May 6, 1998" "Linux" "User Commands"
   2 .SH NAME
   3 pidof \- finds processes by name and lists their PIDs
   4 .SH SYNOPSIS
   5 .ad l
   6 .B pidof
   7 .RB [ \-eg ]
   8 .I name ...
   9 .br
  10 .B pidof
  11 .RB \-V
  12 .ad b
  13 .SH DESCRIPTION
  14 .B pidof
  15 lists the PIDs of all processes running any of the specified commands.
  16 .PP
  17 If the command name contains a slash (\fB/\fP), processes executing that
  18 particular file will be selected, independent of their name.
  19 .PP
  20 \fBpidof\fP returns a non-zero return code if no process has been found
  21 for any of the listed commands. If at least one process has been found for
  22 each command, \fBpidof\fP returns zero.
  23 .SH OPTIONS
  24 .IP \fB\-e\fP
  25 Require an exact match for very long names. If a command name is longer
  26 than 15 characters, the full name may be unavailable (i.e. it is swapped
  27 out). In this case, \fBpidof\fP will list everything that matches within
  28 the first 15 characters. With \fB\-e\fP, such entries are silently skipped.
  29 .IP \fB\-g\fP
  30 Show process group IDs instead of process IDs. If multiple processes with
  31 the same process group ID were found, only the first process is shown.
  32 .IP \fB\-V\fP
  33 Display version information.
  34 .SH FILES
  35 .nf
  36 /proc   location of the proc file system
  37 .fi
  38 .SH "KNOWN BUGS"
  39 Selection by file only works for executables that are kept open during
  40 execution, i.e. impure executables can't be selected this way.
  41 .SH AUTHOR
  42 Werner Almesberger <Werner.Almesberger@epfl.ch>
  43 .SH "SEE ALSO"
  44 killall(1), fuser(1), ps(1)
  45 .\"{{{}}}