revoke man page on OSF1

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

revoke(2)							     revoke(2)

NAME
       revoke - Void all references to a file

SYNOPSIS
       int revoke(
	       char *path );

PARAMETERS
       Points to a null-terminated string containing the appropriate pathname.

DESCRIPTION
       The  revoke() function invalidates all file descriptors associated with
       the pathname specified in path, which must be a	block-	or  character-
       special	file.  Any  open file system object on the device on which the
       revoked file system object resides subsequently holds an	 invalid  file
       descriptor, and will receive errors on attempts to access the file with
       any read(), write(), ioctl(), or select() system call.  The  only  call
       that  will succeed under these conditions is close(). A subsequent call
       to open() will result in a  valid  file	descriptor  and	 again	enable
       access to the file.

       The  behavior of the revoke() system call depends on the setting of the
       revoke_tty_only attribute of the vfs kernel subsystem. By default,  the
       revoke_tty_only	attribute is set to 1. In this case, the revoke() sys‐
       tem call can invalidate	file  descriptors  of  only  tty  devices.  On
       attempts	 to invalidate file descriptors of any other devices, the call
       returns the [ENOTTY] error.

       If you set the revoke_tty_only attribute to 0, the system call conforms
       to  its	behavior in early versions of the Tru64 UNIX operating system;
       however, it is strongly recommended that this attribute remain  at  its
       default setting (1) in a cluster environment.

       The  effective  user ID of the process must be the same as the owner of
       the file, or the process must have superuser privilege in order to  use
       the call in this manner.

RETURN VALUES
       Upon  successful	 completion,  a	 value of 0 (zero) is returned. If the
       revoke() function fails, it returns a value of -1  and  sets  errno  to
       indicate the error.

ERRORS
       If  the revoke function fails, errno may be set to one of the following
       values: The file represented by the pathname is of the incorrect	 type.
       The  size  of  the pathname exceeds PATH_MAX or a pathname component is
       longer than NAME_MAX.  A component of the specified pathname  does  not
       exist, or the path parameter points to an empty string.	A component of
       the  path  prefix  is  not   a	directory.    The   system   attribute
       revoke_tty_only is set on and the device is not a tty.

SEE ALSO
       Commands: sysconfig(8)

       Functions: ioctl(2), open(2), read(2), select(2), write(2)

       Others: sys_attrs(5), sys_attrs_vfs(5)

								     revoke(2)
[top]
                             _         _         _ 
                            | |       | |       | |     
                            | |       | |       | |     
                         __ | | __ __ | | __ __ | | __  
                         \ \| |/ / \ \| |/ / \ \| |/ /  
                          \ \ / /   \ \ / /   \ \ / /   
                           \   /     \   /     \   /    
                            \_/       \_/       \_/ 
More information is available in HTML format for server OSF1

List of man pages available for OSF1

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