FreeBSD Bugzilla – Attachment 147031 Details for
Bug 193442
[PATCH] libs/libc/sys: unimplemented(2): Document network filesystem and locking system calls
Home
|
New
|
Browse
|
Search
|
[?]
|
Reports
|
Help
|
New Account
|
Log In
Remember
[x]
|
Forgot Password
Login:
[x]
[patch]
The patch for the documentation
bsd.patch (text/plain), 6.25 KB, created by
Steven Stewart-Gallus
on 2014-09-07 20:09:09 UTC
(
hide
)
Description:
The patch for the documentation
Filename:
MIME Type:
Creator:
Steven Stewart-Gallus
Created:
2014-09-07 20:09:09 UTC
Size:
6.25 KB
patch
obsolete
>Index: lib/libc/sys/unimplemented.2 >=================================================================== >--- lib/libc/sys/unimplemented.2 (revision 0) >+++ lib/libc/sys/unimplemented.2 (revision 0) >@@ -0,0 +1,57 @@ >+.\" Copyright (c) 2014, Steven Stewart-Gallus. >+.\" All rights reserved. >+.\" >+.\" 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. >+.\" >+.\" THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND >+.\" CONTRIBUTORS "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 COPYRIGHT HOLDER OR CONTRIBUTORS >+.\" 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. >+.\" >+.\" @(#)unimplemented.2 8.2 (Berkeley) 1/09/14 >+.\" $FreeBSD$ >+.\" >+.Dd September 7, 2014 >+.Dt UNIMPLEMENTED 2 >+.Os >+.Sh NAME >+.Nm nnpfs_syscall, afs3_syscall >+.Nd unimplemented system calls >+.Sh SYNOPSIS >+Unimplemented system calls. >+.Sh DESCRIPTION >+These system calls are not implemented in the standard FreeBSD kernel >+and are reserved for the use of third parties. >+ >+The >+.Fn nnpfs_syscall >+system call was added for the use of the third party "Arla" AFS >+client. >+ >+The >+.Fn afs3_syscall >+system call was intended for the use of the third party "OpenAFS" AFS >+client although unfortunately for compatibility reasons the client >+actually uses the nnpfs_syscall sytem call. >+ >+.Sh RETURN VALUES >+These calls return \-1 and set errno to ENOSYS. >Index: lib/libc/sys/nlm_syscall.2 >=================================================================== >--- lib/libc/sys/nlm_syscall.2 (revision 0) >+++ lib/libc/sys/nlm_syscall.2 (revision 0) >@@ -0,0 +1,97 @@ >+.\" Copyright (c) 2014, Steven Stewart-Gallus. >+.\" All rights reserved. >+.\" >+.\" 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. >+.\" >+.\" THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND >+.\" CONTRIBUTORS "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 COPYRIGHT HOLDER OR CONTRIBUTORS >+.\" 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. >+.\" >+.\" @(#)nlm_syscall.2 8.2 (Berkeley) 1/09/14 >+.\" $FreeBSD$ >+.\" >+.Dd September 7, 2014 >+.Dt NLM_SYSCALL 2 >+.Os >+.Sh NAME >+.Nm nlm_syscall >+.Nd Network Lock Manager server entry point. >+.Sh SYNOPSIS >+.Ft int >+.Fn nlm_syscall "int debug_level" "int grace_period" "int addr_count" "char ** addrs" >+.Sh DESCRIPTION >+Registers NLM services with the local NSM and then services >+requests. Does not return until the server is interrupted by a >+signal. This system call should probably only be used by >+.Xr rpc.lockd 8 >+ >+The argument >+.Fa debug_level >+is a value between 0 and 5 where 5 is most verbose and 0 is least >+verbose. The right to add higher debug levels in the future is reserved. >+ >+The argument >+.Fa grace_period >+is a number of seconds allowed for which the server only accepts >+requests from hosts reinitializing locks which existed before the >+server restart. >+ >+The argument >+.Fa addrs >+is a list of addresses to bind to. >+ >+.Sh RETURN VALUES >+This call will block until an error occurs and it returns with \-1. >+.Sh ERRORS >+The >+.Fn nlm_syscall >+system call fails if: >+.Bl -tag -width Er >+.It Bq Er EINTR >+The >+.Fn nlm_syscall >+operation was interrupted. >+.It Bq Er EPERM >+The caller does not have the privilege PRIV_NFS_LOCKD. >+.It Bq Er EPERM >+Another caller is already using the system call. >+.It Bq Er EINVAL >+The system is not able to contact the NSM. >+.It Bq Er EINVAL >+The system cannot look up a netid. >+.It Bq Er EINVAL >+The system cannot create or register a NLM program. >+.It Bq Er EFAULT >+.Fa addrs >+do not point to accessible memory. >+.El >+ >+The >+.Fn nlm_syscall >+function may also fail and set errno for any of the errors specified >+for the routine >+.Xr socket 2 >+ >+.Sh SEE ALSO >+.Xr rpc.lockd 8 >+ >Index: lib/libc/sys/Makefile.inc >=================================================================== >--- lib/libc/sys/Makefile.inc (revision 270737) >+++ lib/libc/sys/Makefile.inc (working copy) >@@ -270,7 +270,9 @@ > uuidgen.2 \ > vfork.2 \ > wait.2 \ >- write.2 >+ write.2 \ >+ nlm_syscall.2 \ >+ unimplemented.2 > > MLINKS+=accept.2 accept4.2 > MLINKS+=access.2 eaccess.2 \ >@@ -407,3 +409,5 @@ > MLINKS+=write.2 pwrite.2 \ > write.2 pwritev.2 \ > write.2 writev.2 >+MLINKS+=unimplemented.2 nnpfs_syscall.2\ >+ unimplemented.2 afs3_syscall.2 >\ No newline at end of file
You cannot view the attachment while viewing its details because your browser does not support IFRAMEs.
View the attachment on a separate page
.
View Attachment As Diff
View Attachment As Raw
Actions:
View
|
Diff
Attachments on
bug 193442
: 147031