Attachment 147031 Details for Bug 193442 – The patch for the documentation

[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:

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

Actions: View | Diff

Attachments on bug 193442: 147031