Give fhopen, fhstat, and fhstatfs a man page.
This commit is contained in:
parent
811a6162c3
commit
1d74ac18fa
|
@ -1,4 +1,4 @@
|
|||
# $NetBSD: Makefile.inc,v 1.93 1999/06/29 22:22:06 wrstuden Exp $
|
||||
# $NetBSD: Makefile.inc,v 1.94 1999/06/30 01:32:14 wrstuden Exp $
|
||||
# @(#)Makefile.inc 8.3 (Berkeley) 10/24/94
|
||||
|
||||
# sys sources
|
||||
|
@ -173,8 +173,9 @@ LintSysPseudoNoerr.c: ${.CURDIR}/sys/makelintstub \
|
|||
|
||||
MAN+= accept.2 access.2 acct.2 adjtime.2 bind.2 brk.2 chdir.2 \
|
||||
chflags.2 chmod.2 chown.2 chroot.2 clock_settime.2 close.2 connect.2 \
|
||||
dup.2 execve.2 _exit.2 fcntl.2 fdatasync.2 flock.2 fork.2 fsync.2 \
|
||||
getdents.2 getdirentries.3 getfh.2 getfsstat.2 getgid.2 getgroups.2 \
|
||||
dup.2 execve.2 _exit.2 fcntl.2 fdatasync.2 fhopen.2 \
|
||||
flock.2 fork.2 fsync.2 getdents.2 getdirentries.3 \
|
||||
getfh.2 getfsstat.2 getgid.2 getgroups.2 \
|
||||
getitimer.2 getlogin.2 getpeername.2 getpgrp.2 getpid.2 \
|
||||
getpriority.2 getrlimit.2 getrusage.2 getsid.2 getsockname.2 \
|
||||
getsockopt.2 gettimeofday.2 getuid.2 intro.2 ioctl.2 kill.2 \
|
||||
|
@ -200,6 +201,7 @@ MLINKS+=chmod.2 fchmod.2 chmod.2 lchmod.2
|
|||
MLINKS+=chown.2 fchown.2 chown.2 lchown.2
|
||||
MLINKS+=clock_settime.2 clock_gettime.2
|
||||
MLINKS+=clock_settime.2 clock_getres.2
|
||||
MLINKS+=fhopen.2 fhstat.2 fhopen.2 fhstatfs.2
|
||||
MLINKS+=getgid.2 getegid.2
|
||||
MLINKS+=getitimer.2 setitimer.2
|
||||
MLINKS+=getlogin.2 setlogin.2
|
||||
|
|
|
@ -0,0 +1,128 @@
|
|||
.\" $NetBSD: fhopen.2,v 1.1 1999/06/30 01:32:15 wrstuden Exp $
|
||||
.\"
|
||||
.\" Copyright (c) 1999 National Aeronautics & Space Administration
|
||||
.\" All rights reserved.
|
||||
.\"
|
||||
.\" This software was written by William Studenmund of the
|
||||
.\" Numerical Aerospace Similation Facility, NASA Ames Research Center.
|
||||
.\"
|
||||
.\" Redistribution and use in source and binary forms, with or without
|
||||
.\" modification, are permitted provided that the following conditions
|
||||
.\" are met:
|
||||
.\" 1. Redistributions of source code must retain the above copyright
|
||||
.\" notice, this list of conditions and the following disclaimer.
|
||||
.\" 2. Redistributions in binary form must reproduce the above copyright
|
||||
.\" notice, this list of conditions and the following disclaimer in the
|
||||
.\" documentation and/or other materials provided with the distribution.
|
||||
.\" 3. Neither the the name of the National Aeronautics & Space Administration
|
||||
.\" nor the names of its contributors may be used to endorse or promote
|
||||
.\" products derived from this software without specific prior written
|
||||
.\" permission.
|
||||
.\"
|
||||
.\" THIS SOFTWARE IS PROVIDED BY THE NATIONAL AERONAUTICS & SPACE ADMINISTRATION
|
||||
.\" ``AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED
|
||||
.\" TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
|
||||
.\" PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE ADMINISTRATION OR CONTRIB-
|
||||
.\" UTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY,
|
||||
.\" OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
|
||||
.\" SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
|
||||
.\" INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
|
||||
.\" CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
|
||||
.\" ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
|
||||
.\" POSSIBILITY OF SUCH DAMAGE.
|
||||
.\"/
|
||||
.Dd June 29, 1999
|
||||
.Dt FHOPEN 2
|
||||
.Os
|
||||
.Sh NAME
|
||||
.Nm fhopen ,
|
||||
.Nm fhstat ,
|
||||
.Nm fhstatfs
|
||||
.Nd access file via file handle
|
||||
.Sh SYNOPSIS
|
||||
.Fd #include <sys/types.h>
|
||||
.Fd #include <sys/stat.h>
|
||||
.Ft int
|
||||
.Fn fhopen "const fhandle_t *fhp" "int flags"
|
||||
.Ft int
|
||||
.Fn fhstat "const fhandle_t *fhp" "struct stat *sb"
|
||||
.Ft int
|
||||
.Fn fhstatfs "const fhandle_t *fhp" "struct statfs *buf"
|
||||
.Sh DESCRIPTION
|
||||
These functions provide a means to access a file given the file handle
|
||||
.Fa fhp.
|
||||
As this method bypasses directory access restrictions, these calls are
|
||||
restricted to the superuser.
|
||||
.Pp
|
||||
.Fn fhopen
|
||||
opens the file referenced by
|
||||
.Fa fhp
|
||||
for reading and/or writing as specified by the argument
|
||||
.Fa flags
|
||||
and returns the file descriptor to the calling process. The
|
||||
.Fa flags
|
||||
are specified by
|
||||
.Em or Ns 'ing
|
||||
together the flags used for the
|
||||
.Xr open 2
|
||||
call. All said flags are valid except for
|
||||
.Dv O_CREAT .
|
||||
.Pp
|
||||
.Fn fhstat
|
||||
and
|
||||
.Fn fhstatfs
|
||||
provide the functionality of the
|
||||
.Xr fstat 2
|
||||
and
|
||||
.Xr fstatfs 2
|
||||
calls except that they return information for the file refered to by
|
||||
.Fa fhp
|
||||
rather than an open file.
|
||||
.Sh RETURN VALUES
|
||||
Upon successful completion,
|
||||
.Fn fhopen
|
||||
returns the file descriptor for the opened file, while
|
||||
.Fn fhstat
|
||||
and
|
||||
.Fn fhstatfs
|
||||
return 0.
|
||||
Otherwise, -1 is returned and
|
||||
.Va errno
|
||||
is set to indicate the error.
|
||||
.Sh ERRORS
|
||||
In addition to the errors returned by
|
||||
.Xr open 2 ,
|
||||
.Xr fstat 2 ,
|
||||
and
|
||||
.Xr fstatfs 2
|
||||
respectivly,
|
||||
.Fn fhopen ,
|
||||
.Fn fhstat ,
|
||||
and
|
||||
.Fn fhstatfs
|
||||
will return
|
||||
.Bl -tag -width Er
|
||||
.It Bq Er EINVAL
|
||||
Calling
|
||||
.Fn fhopen
|
||||
with
|
||||
.Dv O_CREAT
|
||||
set.
|
||||
.It Bq Er ESTALE
|
||||
The file handle
|
||||
.Fa fhp
|
||||
is no longer valid.
|
||||
.El
|
||||
.Sh SEE ALSO
|
||||
.Xr getfh 2 ,
|
||||
.Xr open 2 ,
|
||||
.Xr fstat 2 ,
|
||||
.Xr fstatfs 2
|
||||
.Sh HISTORY
|
||||
The
|
||||
.Fn fhopen ,
|
||||
.Fn fhstat ,
|
||||
and
|
||||
.Fn fhstatfs
|
||||
functions first appeared in
|
||||
.Nx 1.5 .
|
Loading…
Reference in New Issue