From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: X-Spam-Checker-Version: SpamAssassin 3.4.2 (2018-09-13) on dcvr.yhbt.net X-Spam-Level: X-Spam-ASN: AS31976 209.132.180.0/23 X-Spam-Status: No, score=-4.0 required=3.0 tests=AWL,BAYES_00,DKIMWL_WL_HIGH, DKIM_SIGNED,DKIM_VALID,DKIM_VALID_AU,DKIM_VALID_EF, HEADER_FROM_DIFFERENT_DOMAINS,MAILING_LIST_MULTI,RCVD_IN_DNSWL_MED, RCVD_IN_MSPIKE_H3,RCVD_IN_MSPIKE_WL,SPF_HELO_PASS,SPF_PASS shortcircuit=no autolearn=ham autolearn_force=no version=3.4.2 Received: from sourceware.org (server1.sourceware.org [209.132.180.131]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by dcvr.yhbt.net (Postfix) with ESMTPS id 28C111F619 for ; Mon, 24 Feb 2020 19:07:55 +0000 (UTC) DomainKey-Signature: a=rsa-sha1; c=nofws; d=sourceware.org; h=list-id :list-unsubscribe:list-subscribe:list-archive:list-post :list-help:sender:from:to:subject:date:message-id:mime-version :content-type:content-transfer-encoding; q=dns; s=default; b=Mx7 NjsJ9I3VDrdGg9r5RPwDxtOLYtQpmXzWI/2BX1Yv3I6xJzqH72EnjG7tJ6q6EBgu G5TLrctVTGmk1sPwDV6F82Z4WhZtXXwlERxqTtz8MWeyvMeaOD9P1q4UXz8mfO9S RYzCsgqU4mTXGXa9vtuvw52jyJXMmy80SG3750cY= DKIM-Signature: v=1; a=rsa-sha1; c=relaxed; d=sourceware.org; h=list-id :list-unsubscribe:list-subscribe:list-archive:list-post :list-help:sender:from:to:subject:date:message-id:mime-version :content-type:content-transfer-encoding; s=default; bh=afvHs32ft U1/ebXcBr+xbr0r7xY=; b=q0oMjKRwe5tS+9fvlbGoct6S4Odmr9mTErqvio+pi 5G00rEC/oKkIL3yCFtFP9KaHRuyLW2zQbsITAFUGhAvt11Rjtp8QzjZu6W89nfHh 1II/pD7xPxXBheyrv32lVSR34gxnlfRGRpwdYicQyHD5/HyTI1Dhn/MzTgyyJTNz Vk= Received: (qmail 14671 invoked by alias); 24 Feb 2020 19:07:50 -0000 Mailing-List: contact libc-alpha-help@sourceware.org; run by ezmlm Precedence: bulk List-Id: List-Unsubscribe: List-Subscribe: List-Archive: List-Post: List-Help: , Sender: libc-alpha-owner@sourceware.org Received: (qmail 14613 invoked by uid 89); 24 Feb 2020 19:07:49 -0000 Authentication-Results: sourceware.org; auth=none X-HELO: us-smtp-1.mimecast.com DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=redhat.com; s=mimecast20190719; t=1582571266; h=from:from:reply-to:subject:subject:date:date:message-id:message-id: to:to:cc:mime-version:mime-version:content-type:content-type: content-transfer-encoding:content-transfer-encoding; bh=RpB9UtRRdqucFVfkjNPRE/VW2ORBCQHk7ZWOYOxeHko=; b=WF7um12e0F6VF5JEdwnMkdjlOJA9QySawUo6qkrumc+jF1kCIq7+bPT3N9ohffW30S3w09 OiVBAkn4qqQoQXi7snmimuBDyR1/YyJMeADEBRr630DdFUDKmlS4OyCwoD7t9VoVa2kyMe qeeq4roSkWvBXYVmSO7KGXmbwrDxJhY= From: Florian Weimer To: libc-alpha@sourceware.org Subject: [PATCH] manual: Document the System V sigpause function Date: Mon, 24 Feb 2020 20:07:41 +0100 Message-ID: <87h7zfn6rm.fsf@oldenburg2.str.redhat.com> User-Agent: Gnus/5.13 (Gnus v5.13) Emacs/26.3 (gnu/linux) MIME-Version: 1.0 X-Mimecast-Spam-Score: 0 X-Mimecast-Originator: redhat.com Content-Type: text/plain Content-Transfer-Encoding: quoted-printable currently provides only the System V variant of sigpause. Update the documentation of the function and move it to its own node. ----- manual/signal.texi | 35 ++++++++++++++++++++--------------- 1 file changed, 20 insertions(+), 15 deletions(-) diff --git a/manual/signal.texi b/manual/signal.texi index 33e6646975..62cec48450 100644 --- a/manual/signal.texi +++ b/manual/signal.texi @@ -39,6 +39,8 @@ and synchronize. * Signal Stack:: Using a Separate Signal Stack. * BSD Signal Handling:: Additional functions for backward =09=09=09 compatibility with BSD. +* Obsolete Signal Handling::=09Deprecated functions for compatibility with + other sytems. @end menu =20 @node Concepts of Signals @@ -3295,19 +3297,22 @@ the calling process's signal mask to @var{mask}. T= he return value is the previous set of blocked signals. @end deftypefun =20 -@deftypefun int sigpause (int @var{mask}) -@standards{BSD, signal.h} -@safety{@prelim{}@mtunsafe{@mtasurace{:sigprocmask/!bsd!linux}}@asunsafe{@= asulock{/hurd}}@acunsafe{@aculock{/hurd}}} -@c sigpause @mtasurace:sigprocmask/!bsd!linux @asulock/hurd @aculock/hurd -@c [posix] -@c __sigpause @mtasurace:sigprocmask/!bsd!linux @asulock/hurd @aculock/hu= rd -@c do_sigpause @mtasurace:sigprocmask/!bsd!linux @asulock/hurd @aculock/= hurd -@c sigprocmask(0) dup @asulock/hurd @aculock/hurd [no @mtasurace:sigpro= cmask/bsd(SIG_UNBLOCK)] -@c sigdelset dup ok -@c sigset_set_old_mask dup ok -@c sigsuspend dup @mtasurace:sigprocmask/!bsd!linux @asulock/hurd @acul= ock/hurd -This function is the equivalent of @code{sigsuspend} (@pxref{Waiting -for a Signal}): it sets the calling process's signal mask to @var{mask}, -and waits for a signal to arrive. On return the previous set of blocked -signals is restored. +@node Obsolete Signal Handling +@section Obsolete Signal Handling + +This section describes deprecated signal handling functions which are +provided for compatibility with other systems. + +@deftypefun int sigpause (int @var{signal}) +@standards{XOPEN, signal.h} +@safety{@prelim{}@mtunsafe{@mtasurace{:sigprocmask}}@asunsafe{@asulock{/hu= rd}}@acunsafe{@aculock{/hurd}}} +This deprecated function is a precursor to the @code{sigsuspend} +function (@pxref{Waiting for a Signal}): it removes @var{signal} from +the thread's signal mask, and waits for a signal to arrive. On return +the previous set of blocked signals is restored. + +New code should use the @code{sigsuspend} function directly. + +The @code{sigpause} function in @theglibc{} is the @w{System V} +variant. The BSD variant is no longer provided by @theglibc{}. @end deftypefun