From owner-cvs-all Fri Dec 20 0:13:33 2002 Delivered-To: cvs-all@freebsd.org Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125]) by hub.freebsd.org (Postfix) with ESMTP id 1965B37B401 for ; Fri, 20 Dec 2002 00:13:31 -0800 (PST) Received: from whale.sunbay.crimea.ua (whale.sunbay.crimea.ua [212.110.138.65]) by mx1.FreeBSD.org (Postfix) with ESMTP id 027E243EE5 for ; Fri, 20 Dec 2002 00:13:28 -0800 (PST) (envelope-from ru@whale.sunbay.crimea.ua) Received: from whale.sunbay.crimea.ua (root@localhost) by whale.sunbay.crimea.ua (8.12.6/8.12.6/Sunbay) with SMTP id gBK8DFXa072771 for ; Fri, 20 Dec 2002 10:13:15 +0200 (EET) (envelope-from ru@whale.sunbay.crimea.ua) Received: from whale.sunbay.crimea.ua (ru@localhost [127.0.0.1]) by whale.sunbay.crimea.ua (8.12.6/8.12.6/Sunbay) with ESMTP id gBK8DDEO072740 (version=TLSv1/SSLv3 cipher=EDH-RSA-DES-CBC3-SHA bits=168 verify=NO); Fri, 20 Dec 2002 10:13:15 +0200 (EET) (envelope-from ru@whale.sunbay.crimea.ua) Received: (from ru@localhost) by whale.sunbay.crimea.ua (8.12.6/8.12.6/Submit) id gBK8DDcc072735; Fri, 20 Dec 2002 10:13:13 +0200 (EET) Date: Fri, 20 Dec 2002 10:13:13 +0200 From: Ruslan Ermilov To: "M. Warner Losh" Cc: bde@zeta.org.au, wollman@lcs.mit.edu, cvs-committers@freebsd.org, cvs-all@freebsd.org Subject: Re: cvs commit: src/lib/libc/sys _exit.2 accept.2 access.2 acct.2 adjtime.2 aio_cancel.2 aio_error.2 aio_read.2 aio_return.2 aio_suspend.2 aio_waitcomplete.2 aio_write.2 bind.2 brk.2 chdir Message-ID: <20021220081313.GC70051@sunbay.com> References: <20021219095247.GA79372@sunbay.com> <20021219.211701.128866860.imp@bsdimp.com> <20021220080144.GB70051@sunbay.com> <20021220.010540.103018236.imp@bsdimp.com> Mime-Version: 1.0 Content-Type: multipart/signed; micalg=pgp-sha1; protocol="application/pgp-signature"; boundary="ncSAzJYg3Aa9+CRW" Content-Disposition: inline In-Reply-To: <20021220.010540.103018236.imp@bsdimp.com> User-Agent: Mutt/1.5.1i Sender: owner-cvs-all@FreeBSD.ORG Precedence: bulk List-ID: List-Archive: (Web Archive) List-Help: (List Instructions) List-Subscribe: List-Unsubscribe: X-Loop: FreeBSD.ORG --ncSAzJYg3Aa9+CRW Content-Type: text/plain; charset=us-ascii Content-Disposition: inline Content-Transfer-Encoding: quoted-printable On Fri, Dec 20, 2002 at 01:05:40AM -0700, M. Warner Losh wrote: > In message: <20021220080144.GB70051@sunbay.com> > Ruslan Ermilov writes: > : On Thu, Dec 19, 2002 at 09:17:01PM -0700, M. Warner Losh wrote: > : > In message: <20021219095247.GA79372@sunbay.com> > : > Ruslan Ermilov writes: > : > : If the consensus is to refer to syscalls as functions, there > : > : is also no reason to keep section 2. > : >=20 > : > Actually, there is. System calls live in section 2, even if they > : > aren't called system calls. > : >=20 > : Not enough quoted context: > :=20 > : wollman> since the interfaces may move from one side of the boundary > : wollman> to the other. > :=20 > : If an interface moves from a syscall to a library call level, > : we should also move its manpage from section 2 to section 3. > : If we call syscalls just functions, there's not much point in > : keeping a separate section, as it would only give us an > : overhead of changing the manpage's section every time an > : interface moves. >=20 > I think that the overhead is worth it. We rarely move these things, > so optimizing for that case is less useful than knowing what's a > system call and what's a library call. >=20 > System calls live in section 2 and library calls live in section 3. > Even if we call them all functions, and have to move them around from > time to time, that's a good thing and something I would actively fight > against changing. >=20 Good. :-) Now, why wouldn't we call them system calls then if we know they are? Actually, there are a few manpages that describe both functions and syscalls. Look at the latest send(2) manpage for one example: : DESCRIPTION : The send() function, and sendto() and sendmsg() system calls are use= d to : transmit a message to another socket. There are also a few section 3 manpages that document syscalls, and I intend to fix this soon. Cheers, --=20 Ruslan Ermilov Sysadmin and DBA, ru@sunbay.com Sunbay Software AG, ru@FreeBSD.org FreeBSD committer, +380.652.512.251 Simferopol, Ukraine http://www.FreeBSD.org The Power To Serve http://www.oracle.com Enabling The Information Age --ncSAzJYg3Aa9+CRW Content-Type: application/pgp-signature Content-Disposition: inline -----BEGIN PGP SIGNATURE----- Version: GnuPG v1.2.1 (FreeBSD) iD8DBQE+AtEZUkv4P6juNwoRAhNfAJ94rMWSQe54AX1ESI0WF0sk2FZWkACfWS7p eVhLkCbBKFoCuBzV8sUtB/I= =xEBL -----END PGP SIGNATURE----- --ncSAzJYg3Aa9+CRW-- To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe cvs-all" in the body of the message