From owner-freebsd-hackers@FreeBSD.ORG Thu Sep 4 22:50:36 2014 Return-Path: Delivered-To: freebsd-hackers@freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [8.8.178.115]) (using TLSv1 with cipher ADH-AES256-SHA (256/256 bits)) (No client certificate requested) by hub.freebsd.org (Postfix) with ESMTPS id F092FB2F for ; Thu, 4 Sep 2014 22:50:36 +0000 (UTC) Received: from dmz-mailsec-scanner-5.mit.edu (dmz-mailsec-scanner-5.mit.edu [18.7.68.34]) by mx1.freebsd.org (Postfix) with ESMTP id 919C31213 for ; Thu, 4 Sep 2014 22:50:36 +0000 (UTC) X-AuditID: 12074422-f79436d000000c21-7d-5408eb89ee9f Received: from mailhub-auth-2.mit.edu ( [18.7.62.36]) (using TLS with cipher AES256-SHA (256/256 bits)) (Client did not present a certificate) by dmz-mailsec-scanner-5.mit.edu (Symantec Messaging Gateway) with SMTP id D3.39.03105.98BE8045; Thu, 4 Sep 2014 18:45:29 -0400 (EDT) Received: from outgoing.mit.edu (outgoing-auth-1.mit.edu [18.9.28.11]) by mailhub-auth-2.mit.edu (8.13.8/8.9.2) with ESMTP id s84MjS8o027020; Thu, 4 Sep 2014 18:45:29 -0400 Received: from multics.mit.edu (system-low-sipb.mit.edu [18.187.2.37]) (authenticated bits=56) (User authenticated as kaduk@ATHENA.MIT.EDU) by outgoing.mit.edu (8.13.8/8.12.4) with ESMTP id s84MjQMe008877 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-SHA bits=256 verify=NOT); Thu, 4 Sep 2014 18:45:28 -0400 Received: (from kaduk@localhost) by multics.mit.edu (8.12.9.20060308) id s84MjQdt010307; Thu, 4 Sep 2014 18:45:26 -0400 (EDT) Date: Thu, 4 Sep 2014 18:45:26 -0400 (EDT) From: Benjamin Kaduk X-X-Sender: kaduk@multics.mit.edu To: Steven Stewart-Gallus Subject: Re: Can anyone help clarify details about the FreeBSD system call interface? In-Reply-To: Message-ID: References: User-Agent: Alpine 1.10 (GSO 962 2008-03-14) MIME-Version: 1.0 Content-Type: TEXT/PLAIN; charset=US-ASCII X-Brightmail-Tracker: H4sIAAAAAAAAA+NgFmpmleLIzCtJLcpLzFFi42IRYrdT0e18zRFicGiPoMX2zf8YLWZ+nsfu wOQx49N8Fo+T/96yBDBFcdmkpOZklqUW6dslcGWsWXqVueCzeMW7junMDYyThbsYOTkkBEwk Fl37wgJhi0lcuLeerYuRi0NIYDaTxN/bCxhBEkICGxgl7ncxQ9gHmSR+fPeCsOslTje3gsVZ BLQktn89zgpiswmoSTze28wKMVRRYvOpSWA1IgI2Ev/aZrCB2MwC8hIXNh8Cmy8sEC6xaecq sCM4BQwljh1bCFbDK+Ao8XPHDKgbMiW+rV3NBGKLCuhIrN4/hQWiRlDi5MwnLBAztSSWT9/G MoFRaBaS1CwkqQWMTKsYZVNyq3RzEzNzilOTdYuTE/PyUot0TfVyM0v0UlNKNzGCw9dFaQfj z4NKhxgFOBiVeHhPvGIPEWJNLCuuzD3EKMnBpCTKu/4FR4gQX1J+SmVGYnFGfFFpTmrxIUYJ DmYlEd4Pd4FyvCmJlVWpRfkwKWkOFiVx3rfWVsFCAumJJanZqakFqUUwWRkODiUJXsdXQI2C RanpqRVpmTklCGkmDk6Q4TxAw6NAaniLCxJzizPTIfKnGHU51nV+62cSYsnLz0uVEued8xKo SACkKKM0D24OLO28YhQHekuYtxxkFA8wZcFNegW0hAloiVsOK8iSkkSElFQD44KAWZHR51Xf Zbzu+7P1uNaMzWu82ENziiKVK9Yvk9c8nxB3avHRcA5ld8Wq+IWv56uecyh/pPgip2bhBoGE +2f2L7yWavXk16rN7n8tTY6VVqmZmZr6vmY8kBl3ieXh24mrW99csrv9u2tRXPLl86uWrEt5 s6BH4QOPpd+rjD1Rwm9YuZ3+CimxFGckGmoxFxUnAgC8fPwLFgMAAA== Cc: freebsd-hackers@freebsd.org X-BeenThere: freebsd-hackers@freebsd.org X-Mailman-Version: 2.1.18-1 Precedence: list List-Id: Technical Discussions relating to FreeBSD List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Thu, 04 Sep 2014 22:50:37 -0000 On Thu, 4 Sep 2014, Steven Stewart-Gallus wrote: > Eg) > > .\" Copyright (c) 2014 > .\" The Regents of the University of California. All rights reserved. I suggest that you retain the copyright on your own works and not assign it to the Regents :) > .\" 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. > .\" 4. Neither the name of the University nor the names of its contributors > .\" may be used to endorse or promote products derived from this software > .\" without specific prior written permission. Also, we are trying to move to the two-clause license as much as possible. > .\" THIS SOFTWARE IS PROVIDED BY THE REGENTS 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 REGENTS 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 1, 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. I might say what organization requested them; I believe that that information is included in the commit logs when they were added. > .Sh RETURN VALUES > These calls return \-1 and set errno to ENOSYS. > > I've also already started work on an nlm_syscall man page but I'm > starting to think that if symlinks are supported it should just > symlink to rpc.lockd.8. Also if symlinks in the doc system are > supported then I can just symlink nnpfs_syscall.2 and afs3_syscall to > unimplemented.2. I'm not sure if I want to wait until I've documented > umtx_syscall or just submit the patch ealier. The MLINKS variable in the corresponding Makefile will do the linking (they are hardlinks actually, not symlinks). -Ben