From patchwork Fri Jul 17 11:36:22 2020 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Florian Weimer X-Patchwork-Id: 40132 Return-Path: X-Original-To: patchwork@sourceware.org Delivered-To: patchwork@sourceware.org Received: from server2.sourceware.org (localhost [IPv6:::1]) by sourceware.org (Postfix) with ESMTP id F35E7393B041; Fri, 17 Jul 2020 11:36:30 +0000 (GMT) DKIM-Filter: OpenDKIM Filter v2.11.0 sourceware.org F35E7393B041 DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=sourceware.org; s=default; t=1594985791; bh=pfAMt5lS2PDSK09b3O5D21FoWwXF4Y+nGDVT67nAzF0=; h=To:Subject:Date:List-Id:List-Unsubscribe:List-Archive:List-Post: List-Help:List-Subscribe:From:Reply-To:From; b=QdHytiAd6kIyj0ewDyLAs5gY3ebNQhHWC36jZm7U2BbRz2NAF32rWlR2w6ayOBR7y KzFge7iSFay21IVM/Re/tl2uDN05/4EdAdD34CWyn6MuCWqt5rAAAm3b/HvV50X4mS K22OqyvHTm71EzC2ZCoeV8qN+gphKZZYSSqFBWtU= X-Original-To: libc-alpha@sourceware.org Delivered-To: libc-alpha@sourceware.org Received: from us-smtp-1.mimecast.com (us-smtp-delivery-1.mimecast.com [205.139.110.120]) by sourceware.org (Postfix) with ESMTP id 57328393A075 for ; Fri, 17 Jul 2020 11:36:29 +0000 (GMT) DMARC-Filter: OpenDMARC Filter v1.3.2 sourceware.org 57328393A075 Received: from mimecast-mx01.redhat.com (mimecast-mx01.redhat.com [209.132.183.4]) (Using TLS) by relay.mimecast.com with ESMTP id us-mta-14-rGCWx_tiO_uZ5aevbtbYZg-1; Fri, 17 Jul 2020 07:36:25 -0400 X-MC-Unique: rGCWx_tiO_uZ5aevbtbYZg-1 Received: from smtp.corp.redhat.com (int-mx06.intmail.prod.int.phx2.redhat.com [10.5.11.16]) (using TLSv1.2 with cipher AECDH-AES256-SHA (256/256 bits)) (No client certificate requested) by mimecast-mx01.redhat.com (Postfix) with ESMTPS id 81D591005268; Fri, 17 Jul 2020 11:36:24 +0000 (UTC) Received: from oldenburg2.str.redhat.com (ovpn-112-136.ams2.redhat.com [10.36.112.136]) by smtp.corp.redhat.com (Postfix) with ESMTPS id D2C945C1D3; Fri, 17 Jul 2020 11:36:23 +0000 (UTC) To: libc-alpha@sourceware.org Subject: [PATCH] manual: New signal and errno string functions are AS-safe Date: Fri, 17 Jul 2020 13:36:22 +0200 Message-ID: <87mu3yqsp5.fsf@oldenburg2.str.redhat.com> User-Agent: Gnus/5.13 (Gnus v5.13) Emacs/26.3 (gnu/linux) MIME-Version: 1.0 X-Scanned-By: MIMEDefang 2.79 on 10.5.11.16 X-Mimecast-Spam-Score: 0 X-Mimecast-Originator: redhat.com X-Spam-Status: No, score=-12.3 required=5.0 tests=BAYES_00, DKIMWL_WL_HIGH, DKIM_SIGNED, DKIM_VALID, DKIM_VALID_AU, DKIM_VALID_EF, GIT_PATCH_0, RCVD_IN_DNSWL_NONE, RCVD_IN_MSPIKE_H2, SPF_HELO_NONE, SPF_PASS, TXREP autolearn=ham autolearn_force=no version=3.4.2 X-Spam-Checker-Version: SpamAssassin 3.4.2 (2018-09-13) on server2.sourceware.org X-BeenThere: libc-alpha@sourceware.org X-Mailman-Version: 2.1.29 Precedence: list List-Id: Libc-alpha mailing list List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-Patchwork-Original-From: Florian Weimer via Libc-alpha From: Florian Weimer Reply-To: Florian Weimer Errors-To: libc-alpha-bounces@sourceware.org Sender: "Libc-alpha" The annotations for sigabbrev_np, sigdescr_np, strerrordesc_np, strerrorname_np are not preliminary. These functions were added precisely because they are AS-safe. Reviewed-by: Carlos O'Donell --- manual/errno.texi | 4 ++-- manual/signal.texi | 4 ++-- 2 files changed, 4 insertions(+), 4 deletions(-) diff --git a/manual/errno.texi b/manual/errno.texi index 1834339220..6ca566522d 100644 --- a/manual/errno.texi +++ b/manual/errno.texi @@ -1209,7 +1209,7 @@ The function @code{perror} is declared in @file{stdio.h}. @deftypefun void strerrorname_np (int @var{errnum}) @standards{GNU, string.h} -@safety{@prelim{}@mtsafe{}@assafe{}@acsafe{}} +@safety{@mtsafe{}@assafe{}@acsafe{}} This function returns the name describing the error @var{errnum} or @code{NULL} if there is no known constant with this value (e.g "EINVAL" for @code{EINVAL}). @@ -1220,7 +1220,7 @@ This function is a GNU extension, declared in the header file @file{string.h}. @deftypefun void strerrordesc_np (int @var{errnum}) @standards{GNU, string.h} -@safety{@prelim{}@mtsafe{}@assafe{}@acsafe{}} +@safety{@mtsafe{}@assafe{}@acsafe{}} This function returns the message describing the error @var{errnum} or @code{NULL} if there is no known constant with this value (e.g "Invalid argument" for @code{EINVAL}). Different than @code{strerror} the returned diff --git a/manual/signal.texi b/manual/signal.texi index 4009ff48a4..c300a3c9df 100644 --- a/manual/signal.texi +++ b/manual/signal.texi @@ -882,7 +882,7 @@ This function is a BSD feature, declared in the header file @file{signal.h}. @deftypefun void sigdescr_np (int @var{signum}) @standards{GNU, string.h} -@safety{@prelim{}@mtsafe{}@assafe{}@acsafe{}} +@safety{@mtsafe{}@assafe{}@acsafe{}} This function returns the message describing the signal @var{signum} or @code{NULL} for invalid signal number (e.g "Hangup" for @code{SIGHUP}). Different than @code{strsignal} the returned description is not translated. @@ -895,7 +895,7 @@ This function is a GNU extension, declared in the header file @file{string.h}. @deftypefun void sigabbrev_np (int @var{signum}) @standards{GNU, string.h} -@safety{@prelim{}@mtsafe{}@assafe{}@acsafe{}} +@safety{@mtsafe{}@assafe{}@acsafe{}} This function returns the abbreviation describing the signal @var{signum} or @code{NULL} for invalid signal number. The message points to a static storage whose lifetime is the whole lifetime of the program.