fuser(1) [freebsd man page]

FUSER(1)						    BSD 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).

BSD
								   May 13, 2011 							       BSD

Check Out this Related Man Page

fuser(2)							System Calls Manual							  fuser(2)

NAME

       fuser - Reports PIDs and UIDs for files, file systems and/or the devices attached to them.

SYNOPSIS

       #include <sys/fuser.h>

       int fuser(
	       char *file,
	       long flag,
	       struct f_user fuser_array[],
	       long sizeof_fuser_array );

PARAMETERS

       Specifies  the  file  name.   Specifies	one of the following values.  If none of the following are values are specified, the default is to
       match open files.  Matches only file ids.  Provides mount point matching.  Matches deleted files on the	mount  point  specified  by  file.
       Specifies the array.  Specifies the number of elements in the fuser array.

DESCRIPTION

       The  fuser  function  reports  a  list of PIDs and UIDs that are associated with a specified file, file system, and/or the devices that are
       attached to them.

       The fuser function can report back additional information about "matches" by ORing one of the following constants that can be  passed  back
       in  the member fu_flags: Current directory Current directory Parent of the current directory At least one file open, but the number open is
       not known.  Executable image.  Controlling terminal Trace At least one file is mmapped

RETURN VALUES

       On success, the fuser function returns the number of fuser_array elements that were found. The contents of the structure are as follows:

       typedef struct  f_user {
	       pid_t   fu_pid;
	       int     fu_flags;
	       uid_t   fu_uid; } f_user_t;

       If an error has occurred, the fuser function returns -1 and sets errno to indicate the error.

ERRORS

       If the fuser function fails, errno may be set to one of the following values: The array is not large enough to hold  the  number  of  array
       elements returned or the array structure cannot be filled The file parameter specified does not exist

EXAMPLES

       Open  regular files and special files are matched using the flag parameter set at 0L. Thus, if process 127 and 3220 open the /home/try file
       simultaneously and the fuser function is active, the PIDs and UIDs associated with the home/try file are reported as in the following exam-
       ple:

	      fuser("/home/try", 0L, fuser_array, 
		   (long)  (sizeof  (fuser_array)/sizeof(fuser_array[0])); Similarly, if the special device file /dev/ttyp2 is open by process 32,
	      then that PID and its associated UID are reported as in the following example:

	      fuser("/dev/ttyp2", 0L, fuser_array, 
		   (long) (sizeof (fuser_array)/sizeof(fuser_array[0]));

																	  fuser(2)

Linux and UNIX Man Pages

fuser(1) [freebsd man page]

Check Out this Related Man Page