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..]..]  [-S separator] 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

       -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

       -S separator
              Use separator as a separator put between pids. Used only when
              more than one pids are printed for the program.

EXIT STATUS         top

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

       1      No program was found with the requested name.

BUGS         top

       When using the -x option, pidof only has a simple method for
       detecting scripts and will miss scripts that, for example, use env.
       This limitation is due to how the scripts look in the proc

SEE ALSO         top

       pgrep(1), pkill(1)

AUTHOR         top

       Jaromir Capik <>

COLOPHON         top

       This page is part of the procps-ng (/proc filesystem utilities)
       project.  Information about the project can be found at 
       ⟨⟩.  If you have a bug report for
       this manual page, see
       This page was obtained from the project's upstream Git repository
       ⟨⟩ on 2018-04-30.  (At that
       time, the date of the most recent commit that was found in the repos‐
       itory was 2018-04-10.)  If you discover 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

                                 2018-03-03                         PIDOF(1)

Pages that refer to this page: killall(1)