f5d15f4718
This commit introduces support for special %PPID value that can be passed to the -o option as a substitution for parent PID. It also allows users to use two additional separators for omitted PIDs - colon and semicolon.
63 lines
2.0 KiB
Groff
63 lines
2.0 KiB
Groff
'\" -*- coding: UTF-8 -*-
|
|
.\" Copyright (C) 1998 Miquel van Smoorenburg.
|
|
.\"
|
|
.\" This program is free software; you can redistribute it and/or modify
|
|
.\" it under the terms of the GNU General Public License as published by
|
|
.\" the Free Software Foundation; either version 2 of the License, or
|
|
.\" (at your option) any later version.
|
|
.\"
|
|
.\" This program is distributed in the hope that it will be useful,
|
|
.\" but WITHOUT ANY WARRANTY; without even the implied warranty of
|
|
.\" MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
|
|
.\" GNU General Public License for more details.
|
|
.\"
|
|
.\" You should have received a copy of the GNU General Public License
|
|
.\" along with this program; if not, write to the Free Software
|
|
.\" Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA
|
|
.\"
|
|
.TH PIDOF 1 "24 Jul 2013" "" "User Commands"
|
|
.SH NAME
|
|
pidof -- find the process ID of a running program.
|
|
.SH SYNOPSIS
|
|
.B pidof
|
|
.RB [ \-s ]
|
|
.RB [ \-c ]
|
|
.RB [ \-x ]
|
|
.RB [ \-o
|
|
.IR omitpid[,omitpid..] ]
|
|
.RB [ \-o
|
|
.IR omitpid[,omitpid..].. ]
|
|
.B program
|
|
.RB [ program.. ]
|
|
.SH DESCRIPTION
|
|
.B Pidof
|
|
finds the process id's (pids) of the named programs. It prints those
|
|
id's on the standard output.
|
|
.SH OPTIONS
|
|
.IP \-s
|
|
Single shot - this instructs the program to only return one \fIpid\fP.
|
|
.IP \-c
|
|
Only return process ids that are running with the same root directory.
|
|
This option is ignored for non-root users, as they will be unable to check
|
|
the current root directory of processes they do not own.
|
|
.IP \-x
|
|
Scripts too - this causes the program to also return process id's of
|
|
shells running the named scripts.
|
|
.IP "-o \fIomitpid\fP"
|
|
Tells \fIpidof\fP to omit processes with that process id. The special
|
|
pid \fB%PPID\fP can be used to name the parent process of the \fIpidof\fP
|
|
program, in other words the calling shell or shell script.
|
|
.SH "EXIT STATUS"
|
|
.TP
|
|
.B 0
|
|
At least one program was found with the requested name.
|
|
.TP
|
|
.B 1
|
|
No program was found with the requested name.
|
|
|
|
.SH SEE ALSO
|
|
.BR pgrep (1),
|
|
.BR pkill (1)
|
|
.SH AUTHOR
|
|
Jaromir Capik <jcapik@redhat.com>
|