fuser man page on SmartOS

Man page or keyword search:  
man Server   16655 pages
apropos Keyword Search (all sections)
Output format
SmartOS logo
[printable version]

FUSER(1M)							     FUSER(1M)

NAME
       fuser - identify users of files and devices

SYNOPSIS
       /usr/sbin/fuser [-c | -d | -f] [-nu] [-k | -s sig] files
	    [ [- ] [-c | -d | -f] [-nu] [-k | -s sig] files] ...

DESCRIPTION
       The  fuser  utility  displays the process IDs of the processes that are
       using the files specified as arguments.

       Each process ID is followed by a letter code. These  letter  codes  are
       interpreted as follows. If the process is using the file as

       c
	    Indicates that the process is using the file as its current direc‐
	    tory.

       m
	    Indicates that the process is using a file	mapped	with  mmap(2).
	    See mmap(2) for details.

       n
	    Indicates  that  the  process  is holding a non-blocking mandatory
	    lock on the file.

       o
	    Indicates that the process is using the file as an open file.

       r
	    Indicates that the process is using the file as  its  root	direc‐
	    tory.

       t
	    Indicates that the process is using the file as its text file.

       y
	    Indicates  that  the  process is using the file as its controlling
	    terminal.

       For block special devices with  mounted	file  systems,	all  processes
       using  any file on that device are listed. For all types of files (text
       files, executables, directories, devices, and so forth), only the  pro‐
       cesses using that file are reported.

       For  all	 types	of  devices, fuser also displays any known kernel con‐
       sumers that have the device open. Kernel consumers are displayed in one
       of the following formats:

	 [module_name]
	 [module_name,dev_path=path]
	 [module_name,dev=(major,minor)]
	 [module_name,dev=(major,minor),dev_path=path]

       If  more	 than  one  group  of  files are specified, the options may be
       respecified for each additional group of files. A lone dash cancels the
       options currently in force.

       The  process  IDs  are printed as a single line on the standard output,
       separated by spaces and terminated with a single new  line.  All	 other
       output is written on standard error.

       Any  user  can  run fuser, but only the superuser can terminate another
       user's process.

OPTIONS
       The following options are supported:

       -c
		 Reports on files that are mount points for file systems,  and
		 any files within that mounted file system.

       -d
		 Report	 device usage information for all minor nodes bound to
		 the same device node as the specified minor node. This option
		 does  not  report  file usage for files within a mounted file
		 system.

       -f
		 Prints a report for the named file, not for  files  within  a
		 mounted file system.

       -k
		 Sends	the  SIGKILL signal to each process. Since this option
		 spawns kills for each process, the kill messages may not show
		 up immediately (see kill(2)). No signals will be sent to ker‐
		 nel file consumers.

       -n
		 Lists only processes with non-blocking mandatory locks	 on  a
		 file.

       -s sig
		 Sends a signal to each process. The sig option argument spec‐
		 ifies one of the symbolic names  defined  in  the  <signal.h>
		 header,  or a decimal integer signal number. If sig is a sym‐
		 bolic name, it is recognized in a  case-independent  fashion,
		 without  the  SIG  prefix.  The -k option is equivalent to -s
		 KILL or -s 9. No signals will be sent	to  kernel  file  con‐
		 sumers.

       -u
		 Displays  the	user  login  name in parentheses following the
		 process ID.

EXAMPLES
       Example 1 Reporting on the Mount Point and Files

       The following example reports on the mount point and files  within  the
       mounted file system.

	 example% fuser -c /export/foo

       Example	2  Restricting	Output	when  Reporting on the Mount Point and
       Files

       The following example reports on the mount point and files  within  the
       mounted	file  system,  but  the output is restricted to processes that
       hold non-blocking mandatory locks.

	 example% fuser -cn /export/foo

       Example 3 Sending SIGTERM to Processes Holding a Non-blocking Mandatory
       Lock

       The  following  command sends SIGTERM to any processes that hold a non-
       blocking mandatory lock on file /export/foo/my_file.

	 example% fuser -fn -s term /export/foo/my_file

ENVIRONMENT VARIABLES
       See environ(5) for descriptions of the following environment  variables
       that affect the execution of fuser: LANG, LC_ALL LC_CTYPE, LC_MESSAGES,
       and NLSPATH.

ATTRIBUTES
       See attributes(5) for descriptions of the following attributes:

       ┌────────────────────┬─────────────────┐
       │  ATTRIBUTE TYPE    │ ATTRIBUTE VALUE │
       ├────────────────────┼─────────────────┤
       │Interface Stability │ Standard	      │
       └────────────────────┴─────────────────┘

SEE ALSO
       ps(1), mount(1M), kill(2), mmap(2),  signal(3C),	 attributes(5),	 envi‐
       ron(5), standards(5)

NOTES
       Because	fuser  works  with a snapshot of the system image, it may miss
       processes that begin using a file while fuser is	 running.  Also,  pro‐
       cesses  reported	 as using a file may have stopped using it while fuser
       was running. These factors should discourage the use of the -k option.

				 Oct 21, 2003			     FUSER(1M)
[top]

List of man pages available for SmartOS

Copyright (c) for man pages and the logo by the respective OS vendor.

For those who want to learn more, the polarhome community provides shell access and support.

[legal] [privacy] [GNU] [policy] [cookies] [netiquette] [sponsors] [FAQ]
Tweet
Polarhome, production since 1999.
Member of Polarhome portal.
Based on Fawad Halim's script.
....................................................................
Vote for polarhome
Free Shell Accounts :: the biggest list on the net