From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: (qmail 129602 invoked by alias); 28 Nov 2018 06:31:47 -0000 Mailing-List: contact gdb-patches-help@sourceware.org; run by ezmlm Precedence: bulk List-Id: List-Subscribe: List-Archive: List-Post: List-Help: , Sender: gdb-patches-owner@sourceware.org Received: (qmail 129183 invoked by uid 89); 28 Nov 2018 06:31:46 -0000 Authentication-Results: sourceware.org; auth=none X-Spam-SWARE-Status: No, score=-26.9 required=5.0 tests=BAYES_00,GIT_PATCH_0,GIT_PATCH_1,GIT_PATCH_2,GIT_PATCH_3,SPF_PASS autolearn=ham version=3.3.2 spammy=Hx-languages-length:1419, facility X-HELO: eggs.gnu.org Received: from eggs.gnu.org (HELO eggs.gnu.org) (208.118.235.92) by sourceware.org (qpsmtpd/0.93/v0.84-503-g423c35a) with ESMTP; Wed, 28 Nov 2018 06:31:45 +0000 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1gRtNo-0007nZ-Gm for gdb-patches@sourceware.org; Wed, 28 Nov 2018 01:31:42 -0500 Received: from fencepost.gnu.org ([2001:4830:134:3::e]:52064) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1gRtNm-0007n0-Ho; Wed, 28 Nov 2018 01:31:35 -0500 Received: from [176.228.60.248] (port=1077 helo=home-c4e4a596f7) by fencepost.gnu.org with esmtpsa (TLS1.2:RSA_AES_256_CBC_SHA1:256) (Exim 4.82) (envelope-from ) id 1gRtNk-0006TU-N6; Wed, 28 Nov 2018 01:31:34 -0500 Date: Wed, 28 Nov 2018 06:31:00 -0000 Message-Id: <83pnupg1bl.fsf@gnu.org> From: Eli Zaretskii To: John Baldwin CC: palves@redhat.com, gdb-patches@sourceware.org In-reply-to: <650590ef-3036-57a8-6cd5-abaa5654add3@FreeBSD.org> (message from John Baldwin on Tue, 27 Nov 2018 13:53:54 -0800) Subject: Re: [PATCH v3 2/3] Add an optional "alias" attribute to syscall entries. References: <20181109200432.84491-1-jhb@FreeBSD.org> <20181109200432.84491-3-jhb@FreeBSD.org> <83efbuattx.fsf@gnu.org> <650590ef-3036-57a8-6cd5-abaa5654add3@FreeBSD.org> X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.2.x-3.x [generic] X-Received-From: 2001:4830:134:3::e X-IsSubscribed: yes X-SW-Source: 2018-11/txt/msg00510.txt.bz2 > Cc: gdb-patches@sourceware.org > From: John Baldwin > Date: Tue, 27 Nov 2018 13:53:54 -0800 > > diff --git a/gdb/doc/gdb.texinfo b/gdb/doc/gdb.texinfo > index 944a2c4383..ab4fad3c36 100644 > --- a/gdb/doc/gdb.texinfo > +++ b/gdb/doc/gdb.texinfo > @@ -4683,6 +4683,22 @@ Catchpoint 2 (syscall 764) > (@value{GDBP}) > @end smallexample > > +On some operating systems, a system call name may map to more than one > +system call number. For example, the FreeBSD kernel allocates new > +system call numbers when changing the ABI of an existing system call. > +The kernel also includes a compatibility system call using the old ABI > +and number. FreeBSD's system call XML file includes aliases for > +compatibility system calls that are used to catch all versions of a > +system call. For example, FreeBSD 12 introduced a new variant of the > +@code{kevent} system call. Both system calls are caught when catching > +the @code{kevent} system call: > + > +@smallexample > +(@value{GDBP}) catch syscall kevent > +Catchpoint 1 (syscalls 'freebsd11_kevent' [363] 'kevent' [560]) > +(@value{GDBP}) > +@end smallexample This text is okay, but is it likely that any other OS will use this facility? If not, we are better off describing it in the "Native" section (adding a new subsection if needed), as a FreeBSD-only feature. Thanks.