NAME | SYNOPSIS | DESCRIPTION | OPTIONS | EXIT STATUS | SEE ALSO | AUTHOR | COLOPHON

PIDOF(1)                        User Commands                       PIDOF(1)

NAME         top

       pidof -- find the process ID of a running program.

SYNOPSIS         top

       pidof [-s] [-c] [-x] [-o omitpid[,omitpid..]]  [-o
       omitpid[,omitpid..]..]  program [program..]

DESCRIPTION         top

       Pidof finds the process id's (pids) of the named programs. It prints
       those id's on the standard output.

OPTIONS         top

       -s     Single shot - this instructs the program to only return one
              pid.

       -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.

       -x     Scripts too - this causes the program to also return process
              id's of shells running the named scripts.

       -o omitpid
              Tells pidof to omit processes with that process id. The
              special pid %PPID can be used to name the parent process of
              the pidof program, in other words the calling shell or shell
              script.

EXIT STATUS         top

       0      At least one program was found with the requested name.

       1      No program was found with the requested name.

SEE ALSO         top

       pgrep(1), pkill(1)

AUTHOR         top

       Jaromir Capik <jcapik@redhat.com>

COLOPHON         top

       This page is part of the procps-ng (/proc filesystem utilities)
       project.  Information about the project can be found at 
       ⟨https://gitlab.com/procps-ng/procps⟩.  If you have a bug report for
       this manual page, see 
       ⟨https://gitlab.com/procps-ng/procps/blob/master/Documentation/bugs.md⟩.
       This page was obtained from the project's upstream Git repository 
       ⟨https://gitlab.com/procps-ng/procps.git⟩ on 2017-03-13.  If you dis‐
       cover any rendering problems in this HTML version of the page, or you
       believe there is a better or more up-to-date source for the page, or
       you have corrections or improvements to the information in this
       COLOPHON (which is not part of the original manual page), send a mail
       to man-pages@man7.org

                                 24 Jul 2013                        PIDOF(1)