From owner-freebsd-bugs@FreeBSD.ORG Tue Sep 3 18:20:03 2013 Return-Path: Delivered-To: freebsd-bugs@smarthost.ysv.freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [8.8.178.115]) (using TLSv1 with cipher ADH-AES256-SHA (256/256 bits)) (No client certificate requested) by hub.freebsd.org (Postfix) with ESMTP id 1F157946 for ; Tue, 3 Sep 2013 18:20:03 +0000 (UTC) (envelope-from gnats@FreeBSD.org) Received: from freefall.freebsd.org (freefall.freebsd.org [IPv6:2001:1900:2254:206c::16:87]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by mx1.freebsd.org (Postfix) with ESMTPS id F1C7129DD for ; Tue, 3 Sep 2013 18:20:02 +0000 (UTC) Received: from freefall.freebsd.org (localhost [127.0.0.1]) by freefall.freebsd.org (8.14.7/8.14.7) with ESMTP id r83IK2Ul020738 for ; Tue, 3 Sep 2013 18:20:02 GMT (envelope-from gnats@freefall.freebsd.org) Received: (from gnats@localhost) by freefall.freebsd.org (8.14.7/8.14.7/Submit) id r83IK2jF020737; Tue, 3 Sep 2013 18:20:02 GMT (envelope-from gnats) Resent-Date: Tue, 3 Sep 2013 18:20:02 GMT Resent-Message-Id: <201309031820.r83IK2jF020737@freefall.freebsd.org> Resent-From: FreeBSD-gnats-submit@FreeBSD.org (GNATS Filer) Resent-To: freebsd-bugs@FreeBSD.org Resent-Reply-To: FreeBSD-gnats-submit@FreeBSD.org, "Kevin P. Neal" Received: from mx1.freebsd.org (mx1.freebsd.org [8.8.178.115]) (using TLSv1 with cipher ADH-AES256-SHA (256/256 bits)) (No client certificate requested) by hub.freebsd.org (Postfix) with ESMTP id 7E45833C for ; Tue, 3 Sep 2013 18:12:33 +0000 (UTC) (envelope-from kpn@neutralgood.org) Received: from mail.neutralgood.org (gunsight1.neutralgood.org [206.196.19.100]) (using TLSv1 with cipher DHE-RSA-AES256-SHA (256/256 bits)) (No client certificate requested) by mx1.freebsd.org (Postfix) with ESMTPS id 451752886 for ; Tue, 3 Sep 2013 18:12:32 +0000 (UTC) Received: from gunsight1.neutralgood.org (localhost [127.0.0.1]) by mail.neutralgood.org (8.14.4/8.14.4) with ESMTP id r83I4SAn071276 for ; Tue, 3 Sep 2013 14:04:28 -0400 (EDT) (envelope-from kpn@gunsight1.neutralgood.org) Received: (from kpn@localhost) by gunsight1.neutralgood.org (8.14.4/8.14.4/Submit) id r83I4Sed071275; Tue, 3 Sep 2013 14:04:28 -0400 (EDT) (envelope-from kpn) Message-Id: <201309031804.r83I4Sed071275@gunsight1.neutralgood.org> Date: Tue, 3 Sep 2013 14:04:28 -0400 (EDT) From: "Kevin P. Neal" To: FreeBSD-gnats-submit@freebsd.org X-Send-Pr-Version: 3.113 Subject: bin/181785: Man page for tmpfile() is inconsistent X-BeenThere: freebsd-bugs@freebsd.org X-Mailman-Version: 2.1.14 Precedence: list Reply-To: "Kevin P. Neal" List-Id: Bug reports List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Tue, 03 Sep 2013 18:20:03 -0000 >Number: 181785 >Category: bin >Synopsis: Man page for tmpfile() is inconsistent >Confidential: no >Severity: non-critical >Priority: medium >Responsible: freebsd-bugs >State: open >Quarter: >Keywords: >Date-Required: >Class: doc-bug >Submitter-Id: current-users >Arrival-Date: Tue Sep 03 18:20:01 UTC 2013 >Closed-Date: >Last-Modified: >Originator: Kevin P. Neal >Release: FreeBSD 8.2-RELEASE amd64 >Organization: >Environment: System: FreeBSD gunsight1.neutralgood.org 8.2-RELEASE FreeBSD 8.2-RELEASE #1: Thu Dec 8 21:58:59 UTC 2011 root@:/usr/obj/usr/src/sys/GENERIC amd64 >Description: The manual page for tmpfile(), which is shared with tmpnam() and tempnam(), describes how tmpfile() respects the TMPDIR environment variable. It then later on says: TMPDIR [tempnam() only] If set, the directory in which the temporary file is stored. TMPDIR is ignored for processes for which issetugid(2) is true. Well, if tmpfile() respects TMPDIR then why does it say it doesn't? Especially since it already went to the trouble of saying it did. >How-To-Repeat: man tmpfile Scratch head and then check source. While I'm on the subject, it may be a good idea to change the description to state that at least some of these functions are part of POSIX. Or, perhaps just remove the line that states: These interfaces are provided from System V and ANSI compatibility only. >Fix: *** /usr/src/lib/libc/stdio/tmpnam.3.orig 2013-09-03 13:51:31.000000000 -0400 --- /usr/src/lib/libc/stdio/tmpnam.3 2013-09-03 13:52:48.000000000 -0400 *************** *** 156,161 **** --- 156,163 ---- .Bl -tag -width Ds .It Ev TMPDIR .Pf [ Fn tempnam + and + .Fn tmpfile only] If set, the directory in which the temporary file is stored. >Release-Note: >Audit-Trail: >Unformatted: