Skip site navigation (1)Skip section navigation (2)

FreeBSD Man Pages

Man Page or Keyword Search:
Man Architecture
Apropos Keyword Search (all sections) Output format
home | help
FUSER(1)                FreeBSD General Commands Manual               FUSER(1)

NAME
     fuser - list IDs of all processes that have one or more files open

SYNOPSIS
     fuser [-cfkmu] [-M core] [-N system] [-s signal] file ...

DESCRIPTION
     The fuser utility writes to stdout the PIDs of processes that have one or
     more named files open.  For block and character special devices, all
     processes using files on that device are listed.  A file is considered
     open by a process if it was explicitly opened, is the working directory,
     root directory, jail root directory, active executable text, kernel trace
     file or the controlling terminal of the process.  If -m option is
     specified, the fuser utility will also look through mmapped files.

     The following options are available:

     -c      Treat files as mount point and report on any files open in the
             file system.

     -f      The report must be only for named files.

     -k      Send signal to reported processes (SIGKILL by default).

     -m      Search through mmapped files too.

     -u      Write the user name associated with each process to stderr.

     -M      Extract values associated with the name list from the specified
             core instead of the default /dev/kmem.

     -N      Extract the name list from the specified system instead of the
             default, which is the kernel image the system has booted from.

     -s      Use given signal name instead of default SIGKILL.

     The following symbols, written to stderr will indicate how files is used:

     r      The file is the root directory of the process.

     c      The file is the current workdir directory of the process.

     j      The file is the jail-root of the process.

     t      The file is the kernel tracing file for the process.

     x      The file is executable text of the process.

     y      The process use this file as its controlling tty.

     m      The file is mmapped.

     w      The file is open for writing.

     a      The file is open as append only (O_APPEND was specified).

     d      The process bypasses fs cache while writing to this file (O_DIRECT
            was specified).

     s      Shared lock is hold.

     e      Exclusive lock is hold.

EXIT STATUS
     The fuser utility returns 0 on successful completion and >0 otherwise.

EXAMPLES
     The command: ``fuser -fu .'' writes to standard output the process IDs of
     processes that are using the current directory and writes to stderr an
     indication of how those processes are using the directory and user names
     associated with the processes that are using this directory.

SEE ALSO
     fstat(1), ps(1), systat(1), iostat(8), pstat(8), vmstat(8)

STANDARDS
     The fuser utility is expected to conform to IEEE Std 1003.1-2004
     (``POSIX.1'').

HISTORY
     The fuser utility appeared in FreeBSD 9.0.

AUTHORS
     The fuser utility and this manual page was written by Stanislav Sedov
     <stas@FreeBSD.org>.

BUGS
     Since fuser takes a snapshot of the system, it is only correct for a very
     short period of time.  When working via kvm(3) interface the report will
     be limited to filesystems the fuser utility knows about (currently only
     cd9660, devfs, nfs, ntfs, nwfs, udf, ufs and zfs).

FreeBSD 11.0-PRERELEASE          May 13, 2011          FreeBSD 11.0-PRERELEASE

NAME | SYNOPSIS | DESCRIPTION | EXIT STATUS | EXAMPLES | SEE ALSO | STANDARDS | HISTORY | AUTHORS | BUGS

Want to link to this manual page? Use this URL:
<https://www.freebsd.org/cgi/man.cgi?query=fuser&manpath=FreeBSD+9.2-RELEASE>

home | help