*nix Documentation Project
·  Home
 +   man pages
·  Linux HOWTOs
·  FreeBSD Tips
·  *niX Forums

  man pages->Tru64 Unix man pages -> fuser (8)              
Title
Content
Arch
Section
 

fuser(8)

Contents


NAME    [Toc]    [Back]

       fuser  - Lists process IDs of processes that are using one
       or more files or file structures

SYNOPSIS    [Toc]    [Back]

       /usr/sbin/fuser [-cfu]  file...

       [Tru64 UNIX]  The following format  shows  extensions  not
       included  in  the  XCU  specification  for  this  utility:
       /usr/sbin/fuser [ -cdfku] [ -h] [-vH ] file ...

STANDARDS    [Toc]    [Back]

       Interfaces documented on this reference  page  conform  to
       industry standards as follows:

       fuser: XCU5.0

       Refer to the standards(5) reference page for more information
 about industry standards and associated tags.

OPTIONS    [Toc]    [Back]

       Identifies file as a mount  point.  In  this  case,  fuser
       reports  on  any  files  that are open in the mounted file
       system.  Reports  any  referenced  files  that  have  been
       deleted  including the referencing PID and the block count
       for the file in 512 byte block units.  Requests  a  report
       only  for  the  specified  files. If a specified file is a
       mount point, fuser reports only on that file, not  on  any
       files below it.  [Tru64 UNIX]   Suppresses column headings
       in fuser output when used  with  the  -v  option.   [Tru64
       UNIX]  Directs fuser to display information about its command-line
 options.  [Tru64 UNIX]  Directs fuser to send  a
       SIGKILL  signal  to  each  corresponding process. The kill
       messages might not show up immediately because the signals
       operate  asynchronously.   Directs  fuser to show the user
       login name, in parentheses, associated with  each  process
       ID.   [Tru64  UNIX]  Directs  fuser  to display results in
       verbose form.

PARAMETERS    [Toc]    [Back]

       [Tru64 UNIX]  Directs fuser to ignore previous option settings
  for  the next set of file parameters. The - operand
       allows you to apply different options to different sets of
       files in the same command line.  Specifies the pathname of
       the file or the mount point of the file  system  on  which
       fuser reports.

DESCRIPTION    [Toc]    [Back]

       The  fuser  utility  writes to standard output the process
       IDs of processes that are running on the local system  and
       have  one  or  more  files  or file structures in use. The
       utility writes to standard  error  additional  information
       about  these resources that indicates how each resource is
       being used.

       The fuser utility reports on processes that reference  the
       file  parameter.  When  run  with  root  privilege,  fuser
       reports on all processes. Otherwise, running fuser reports
       only  on  those processes with a matching effective UID or
       real UID.

       The utility uses the following format to write the process
       ID for each process using each file:

       "%d", process_id

       The  fuser  utility writes diagnostic messages to standard
       error.

       In addition, the utility writes the following  information
       to  standard error: The pathname of each file, immediately
       followed by a colon.  For each process ID written to standard
  output, one of the following characters: If the process
 is using the file as its current  directory.   [Tru64
       UNIX]  If  the  process  is  using  a  memory-mapped file.
       [Tru64 UNIX]  If the process is using the file as the parent
 of its current directory.  If the process is using the
       file as its root directory.  [Tru64 UNIX]  If the  process
       has  the file open.  [Tru64 UNIX]  If the process is using
       the file as its controlling  tty.   [Tru64  UNIX]  If  the
       process is using the text file as an executable.

              If you specify the -u option, characters indicating
              the use of the file are followed immediately by the
              user  name, in parentheses, that corresponds to the
              process's real user ID. If the user name cannot  be
              resolved  from the process's real user ID, the process's
 real user ID is written instead of the  user
              name.

       When  standard  output  and standard error are directed to
       the same file, the utility intersperses output so that the
       file  appears  at  the start of each line, followed by the
       process ID and the characters indicating file  use.  Then,
       if the -u option is specified, the utility writes the user
       name or user ID for each process that is using that  file.
       The  utility writes a newline character at the end of output
 for each file.

NOTES    [Toc]    [Back]

       [Tru64 UNIX]  The fuser utility may  not  report  on  processes
  that  begin using a file while the utility is running.
 Furthermore, processes that fuser reports are  using
       a  file  may  have  stopped using it while the utility was
       running.

       If an accounting file has been opened by an  acct()  sytem
       call,  the  fuser  command and system call will report any
       match as being open by the kernel task.

EXIT STATUS    [Toc]    [Back]

       The fuser utility returns the following exit values:  Successful
 completion.  An error occurred.

EXAMPLES    [Toc]    [Back]

       The  following  command lists the process IDs of processes
       using the /etc/hosts file: fuser /etc/hosts The  following
       command  writes to standard output the process IDs of processes
 that are using the current directory.  The  command
       writes  to  standard error an indication of how those processes
 are using the directory and the user names  associated
 with those processes.  fuser -fu.





ENVIRONMENT VARIABLES    [Toc]    [Back]

       The  following  environment variables affect this utility:
       Provides a default value for the locale variables that are
       unset or null. If LANG is unset or null, the corresponding
       value from the POSIX (C) locale is used.  If  any  of  the
       locale  variables  contain an invalid setting, the utility
       behaves as if none of the variables had been set.  If  set
       to  a  non-empty string value, overrides the values of all
       the other locale variables.  Specifies the locale used  to
       interpret  sequences  of  bytes of text data as characters
       (for example, determines whether arguments contain singlebyte
  or multibyte characters).  Specifies the locale that
       affects the format and  contents  of  diagnostic  messages
       written  to  standard  error.   Determines the location of
       message catalogs for the processing of LC_MESSAGES.

SEE ALSO    [Toc]    [Back]

      
      
       Functions: fuser(2), kill(2)



                                                         fuser(8)
[ Back ]
 Similar pages
Name OS Title
semmnu HP-UX maximum number of System V IPC undo structures for processes
ncheck Tru64 Lists i-number or tag and pathname for files in a local file system.
setacl HP-UX modify access control lists (ACLs) for files (JFS File Systems only)
getacl HP-UX list access control lists (ACLs) for files (JFS File Systems only)
pax HP-UX Extracts, writes, and lists archive files; copies files and directory hierarchies
serialize HP-UX force target process to run serially with other processes
kill IRIX send a signal to a process or a group of processes
pxfkill IRIX Sends a signal to a process or group of processes
kill Tru64 Send a signal to a process or to a group of processes
sigsendset HP-UX send a signal to a process or a group of processes
Copyright © 2004-2005 DeniX Solutions SRL
newsletter delivery service