From owner-freebsd-doc@FreeBSD.ORG Thu Feb 9 20:00:23 2012 Return-Path: Delivered-To: freebsd-doc@hub.freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:4f8:fff6::34]) by hub.freebsd.org (Postfix) with ESMTP id C33DB1065674 for ; Thu, 9 Feb 2012 20:00:23 +0000 (UTC) (envelope-from gnats@FreeBSD.org) Received: from freefall.freebsd.org (freefall.freebsd.org [IPv6:2001:4f8:fff6::28]) by mx1.freebsd.org (Postfix) with ESMTP id 78EA58FC12 for ; Thu, 9 Feb 2012 20:00:23 +0000 (UTC) Received: from freefall.freebsd.org (localhost [127.0.0.1]) by freefall.freebsd.org (8.14.5/8.14.5) with ESMTP id q19K0NWW031189 for ; Thu, 9 Feb 2012 20:00:23 GMT (envelope-from gnats@freefall.freebsd.org) Received: (from gnats@localhost) by freefall.freebsd.org (8.14.5/8.14.5/Submit) id q19K0N48031186; Thu, 9 Feb 2012 20:00:23 GMT (envelope-from gnats) Resent-Date: Thu, 9 Feb 2012 20:00:23 GMT Resent-Message-Id: <201202092000.q19K0N48031186@freefall.freebsd.org> Resent-From: FreeBSD-gnats-submit@FreeBSD.org (GNATS Filer) Resent-To: freebsd-doc@FreeBSD.org Resent-Reply-To: FreeBSD-gnats-submit@FreeBSD.org, Niclas Zeising Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:4f8:fff6::34]) by hub.freebsd.org (Postfix) with ESMTP id 2CDCC1065670 for ; Thu, 9 Feb 2012 19:57:07 +0000 (UTC) (envelope-from zeising@daemonic.se) Received: from mail.lysator.liu.se (mail.lysator.liu.se [IPv6:2001:6b0:17:f0a0::3]) by mx1.freebsd.org (Postfix) with ESMTP id 9BF7A8FC16 for ; Thu, 9 Feb 2012 19:57:06 +0000 (UTC) Received: from mail.lysator.liu.se (localhost [127.0.0.1]) by mail.lysator.liu.se (Postfix) with ESMTP id E841A40009 for ; Thu, 9 Feb 2012 20:57:05 +0100 (CET) Received: by mail.lysator.liu.se (Postfix, from userid 1004) id DD8364000D; Thu, 9 Feb 2012 20:57:05 +0100 (CET) Received: from mx.daemonic.se (mx.daemonic.se [IPv6:2001:470:dca9:0:1::3]) (using TLSv1 with cipher DHE-RSA-AES256-SHA (256/256 bits)) (No client certificate requested) by mail.lysator.liu.se (Postfix) with ESMTPSA id 664E740009 for ; Thu, 9 Feb 2012 20:57:05 +0100 (CET) Received: from mailscanner.daemonic.se (mailscanner.daemonic.se [IPv6:2001:470:dca9:0:1::6]) by mx.daemonic.se (Postfix) with ESMTPS id 36CBF119C1B for ; Thu, 9 Feb 2012 20:57:05 +0100 (CET) Received: from mx.daemonic.se ([IPv6:2001:470:dca9:0:1::3]) (using TLS with cipher CAMELLIA256-SHA) by mailscanner.daemonic.se (mailscanner.daemonic.se [2001:470:dca9:0:1::6]) (amavisd-new, port 10025) with ESMTPS id QpM1HjkBrfyc for ; Thu, 9 Feb 2012 20:57:03 +0100 (CET) Received: from mail.daemonic.se (mail.daemonic.se [IPv6:2001:470:dca9:0:1::4]) by mx.daemonic.se (Postfix) with ESMTPS id 18827119C17 for ; Thu, 9 Feb 2012 20:57:03 +0100 (CET) Received: from vincent.daemonic.se (login.daemonic.se [IPv6:2001:470:dca9:0:1::10]) by mail.daemonic.se (Postfix) with ESMTPS id 0E82412B20D for ; Thu, 9 Feb 2012 20:57:03 +0100 (CET) Received: (from zeising@localhost) by vincent.daemonic.se (8.14.5/8.14.5/Submit) id q19Jv3DI064093; Thu, 9 Feb 2012 20:57:03 +0100 (CET) (envelope-from zeising) Message-Id: <201202091957.q19Jv3DI064093@vincent.daemonic.se> Date: Thu, 9 Feb 2012 20:57:03 +0100 (CET) From: Niclas Zeising To: FreeBSD-gnats-submit@FreeBSD.org X-Send-Pr-Version: 3.113 Cc: Subject: docs/164939: [PATCH] add a standards section to err.3 X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.5 Precedence: list Reply-To: Niclas Zeising List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Thu, 09 Feb 2012 20:00:23 -0000 >Number: 164939 >Category: docs >Synopsis: [PATCH] add a standards section to err.3 >Confidential: no >Severity: non-critical >Priority: low >Responsible: freebsd-doc >State: open >Quarter: >Keywords: >Date-Required: >Class: doc-bug >Submitter-Id: current-users >Arrival-Date: Thu Feb 09 20:00:23 UTC 2012 >Closed-Date: >Last-Modified: >Originator: Niclas Zeising >Release: FreeBSD 9.0-BETA2 amd64 >Organization: >Environment: System: FreeBSD vincent.daemonic.se 9.0-BETA2 FreeBSD 9.0-BETA2 #0 r225368: Sat Sep 3 22:13:26 CEST 2011 root@vincent.daemonic.se:/usr/obj/usr/src/sys/VINCENT amd64 >Description: The err() and warn() family of functions are part of our libc, but not part of the ISO C99 standard. >How-To-Repeat: >Fix: The attached patch adds a STANDARDS section to err.3 mentioning that these functions are not part of the ISO C99 standard, and truly portable code should avoid using them. --- lib.libc.gen.err.3.diff begins here --- Index: head/lib/libc/gen/err.3 =================================================================== --- head/lib/libc/gen/err.3 (revision 231033) +++ head/lib/libc/gen/err.3 (working copy) @@ -212,6 +212,17 @@ .Xr printf 3 , .Xr strerror 3 , .Xr sysexits 3 +.Sh STANDARDS +The +.Fn err +and +.Fn warn +functions are extensions and not part of +.St -isoC-99 . +As such they should not be used in truly portable code. +Use +.Fn strerror +or similar functions instead. .Sh HISTORY The .Fn err --- lib.libc.gen.err.3.diff ends here --- >Release-Note: >Audit-Trail: >Unformatted: