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