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 pro-
     cesses 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	9.3			 May 13, 2011			   FreeBSD 9.3

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

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

home | help