xref: /freebsd/share/man/man9/VOP_REVOKE.9 (revision fa9896e082a1046ff4fbc75fcba4d18d1f2efc19)
1a15fa068SBrian Feldman.\" -*- nroff -*-
2a15fa068SBrian Feldman.\"
3b45deeb2SRobert Watson.\" Copyright (c) 2002 Networks Associates Technology, Inc.
4a15fa068SBrian Feldman.\" All rights reserved.
5a15fa068SBrian Feldman.\"
6c3c2d89dSBrian Feldman.\" This software was developed for the FreeBSD Project by NAI Labs, the
7c3c2d89dSBrian Feldman.\" Security Research Division of Network Associates, Inc. under
8c3c2d89dSBrian Feldman.\" DARPA/SPAWAR contract N66001-01-C-8035 ("CBOSS"), as part of the DARPA
9c3c2d89dSBrian Feldman.\" CHATS research program.
10a15fa068SBrian Feldman.\"
11a15fa068SBrian Feldman.\" Redistribution and use in source and binary forms, with or without
12a15fa068SBrian Feldman.\" modification, are permitted provided that the following conditions
13a15fa068SBrian Feldman.\" are met:
14a15fa068SBrian Feldman.\" 1. Redistributions of source code must retain the above copyright
15a15fa068SBrian Feldman.\"    notice, this list of conditions and the following disclaimer.
16a15fa068SBrian Feldman.\" 2. Redistributions in binary form must reproduce the above copyright
17a15fa068SBrian Feldman.\"    notice, this list of conditions and the following disclaimer in the
18a15fa068SBrian Feldman.\"    documentation and/or other materials provided with the distribution.
19c3c2d89dSBrian Feldman.\" 3. The names of the authors may not be used to endorse or promote
20c3c2d89dSBrian Feldman.\"    products derived from this software without specific prior written
21c3c2d89dSBrian Feldman.\"    permission.
22a15fa068SBrian Feldman.\"
23c3c2d89dSBrian Feldman.\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS IS'' AND
24c3c2d89dSBrian Feldman.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
25c3c2d89dSBrian Feldman.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
26c3c2d89dSBrian Feldman.\" ARE DISCLAIMED.  IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE
27c3c2d89dSBrian Feldman.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
28c3c2d89dSBrian Feldman.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
29c3c2d89dSBrian Feldman.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
30c3c2d89dSBrian Feldman.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
31c3c2d89dSBrian Feldman.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
32c3c2d89dSBrian Feldman.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
33c3c2d89dSBrian Feldman.\" SUCH DAMAGE.
34a15fa068SBrian Feldman.\"
35*67056e3dSAlan Somers.Dd June 20, 2019
36a15fa068SBrian Feldman.Dt VOP_REVOKE 9
37aa12cea2SUlrich Spörlein.Os
38a15fa068SBrian Feldman.Sh NAME
39a15fa068SBrian Feldman.Nm VOP_REVOKE
4021bb400dSRuslan Ermilov.Nd "revoke access to a device and its aliases"
41a15fa068SBrian Feldman.Sh SYNOPSIS
42a15fa068SBrian Feldman.In sys/param.h
43a15fa068SBrian Feldman.In sys/vnode.h
44a15fa068SBrian Feldman.Ft int
4521bb400dSRuslan Ermilov.Fn VOP_REVOKE "struct vnode *vp" "int flags"
46a15fa068SBrian Feldman.Sh DESCRIPTION
4721bb400dSRuslan Ermilov.Fn VOP_REVOKE
48a15fa068SBrian Feldmanwill administratively revoke access to the device specified by
4921bb400dSRuslan Ermilov.Fa vp ,
50a15fa068SBrian Feldmanas well as any aliases created via
51a15fa068SBrian Feldman.Xr make_dev_alias 9 .
5221bb400dSRuslan ErmilovFurther file operations on any of these devices by processes
5321bb400dSRuslan Ermilovwhich have them open will nominally fail.
54a15fa068SBrian FeldmanThe
5521bb400dSRuslan Ermilov.Fa flags
56a15fa068SBrian Feldmanmust be set to
57a15fa068SBrian Feldman.Dv REVOKEALL
58a15fa068SBrian Feldmanto signify that all access will be revoked; any other value is invalid.
59a15fa068SBrian Feldman.Sh LOCKS
60a15fa068SBrian FeldmanThe
6121bb400dSRuslan Ermilov.Fa vp
62*67056e3dSAlan Somersmust be exclusively locked on entry, and will remain locked upon return.
63a15fa068SBrian Feldman.Sh SEE ALSO
64a15fa068SBrian Feldman.Xr make_dev_alias 9 ,
65a15fa068SBrian Feldman.Xr vnode 9
66a15fa068SBrian Feldman.Sh AUTHORS
67571dba6eSHiten PandyaThis manual page was written by
68a15fa068SBrian Feldman.An Brian Fundakowski Feldman .
69