revoke.2 (24822) | revoke.2 (42781) |
---|---|
1.\" Copyright (c) 1993 2.\" The Regents of the University of California. All rights reserved. 3.\" 4.\" This code is derived from software contributed to Berkeley by 5.\" Berkeley Software Design, Inc. 6.\" 7.\" Redistribution and use in source and binary forms, with or without 8.\" modification, are permitted provided that the following conditions --- 51 unchanged lines hidden (view full) --- 60call will succeed. 61If the file is a special file for a device which is open, 62the device close function 63is called as if all open references to the file had been closed. 64.Pp 65Access to a file may be revoked only by its owner or the super user. 66The 67.Fn revoke | 1.\" Copyright (c) 1993 2.\" The Regents of the University of California. All rights reserved. 3.\" 4.\" This code is derived from software contributed to Berkeley by 5.\" Berkeley Software Design, Inc. 6.\" 7.\" Redistribution and use in source and binary forms, with or without 8.\" modification, are permitted provided that the following conditions --- 51 unchanged lines hidden (view full) --- 60call will succeed. 61If the file is a special file for a device which is open, 62the device close function 63is called as if all open references to the file had been closed. 64.Pp 65Access to a file may be revoked only by its owner or the super user. 66The 67.Fn revoke |
68function is currently supported only for block and character special 69device files. 70It is normally used to prepare a terminal device for a new login session, 71preventing any access by a previous user of the terminal. | 68function is normally used to prepare a terminal device for a new 69login session, preventing any access by a previous user of the terminal. |
72.Sh RETURN VALUES 73A 0 value indicated that the call succeeded. A \-1 return value 74indicates an error occurred and 75.Va errno 76is set to indicated the reason. 77.Sh ERRORS 78Access to the named file is revoked unless one of the following: 79.Bl -tag -width Er --- 7 unchanged lines hidden (view full) --- 87.It Bq Er EACCES 88Search permission is denied for a component of the path prefix. 89.It Bq Er ELOOP 90Too many symbolic links were encountered in translating the pathname. 91.It Bq Er EFAULT 92.Fa Path 93points outside the process's allocated address space. 94.It Bq Er EINVAL | 70.Sh RETURN VALUES 71A 0 value indicated that the call succeeded. A \-1 return value 72indicates an error occurred and 73.Va errno 74is set to indicated the reason. 75.Sh ERRORS 76Access to the named file is revoked unless one of the following: 77.Bl -tag -width Er --- 7 unchanged lines hidden (view full) --- 85.It Bq Er EACCES 86Search permission is denied for a component of the path prefix. 87.It Bq Er ELOOP 88Too many symbolic links were encountered in translating the pathname. 89.It Bq Er EFAULT 90.Fa Path 91points outside the process's allocated address space. 92.It Bq Er EINVAL |
95The named file is neither a character special or block 96special file. | 93The named file does not support the 94.Fn revoke 95operation. |
97.It Bq Er EPERM 98The caller is neither the owner of the file nor the super user. 99.El 100.Sh SEE ALSO 101.Xr close 2 102.Sh HISTORY 103The 104.Fn revoke 105function was introduced in 106.Bx 4.3 Reno . | 96.It Bq Er EPERM 97The caller is neither the owner of the file nor the super user. 98.El 99.Sh SEE ALSO 100.Xr close 2 101.Sh HISTORY 102The 103.Fn revoke 104function was introduced in 105.Bx 4.3 Reno . |