From owner-freebsd-standards@FreeBSD.ORG Wed Jan 10 09:00:39 2007 Return-Path: X-Original-To: freebsd-standards@hub.freebsd.org Delivered-To: freebsd-standards@hub.freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [69.147.83.52]) by hub.freebsd.org (Postfix) with ESMTP id DFF4116A417 for ; Wed, 10 Jan 2007 09:00:38 +0000 (UTC) (envelope-from gnats@FreeBSD.org) Received: from freefall.freebsd.org (freefall.freebsd.org [69.147.83.40]) by mx1.freebsd.org (Postfix) with ESMTP id C235A13C458 for ; Wed, 10 Jan 2007 09:00:38 +0000 (UTC) (envelope-from gnats@FreeBSD.org) Received: from freefall.freebsd.org (gnats@localhost [127.0.0.1]) by freefall.freebsd.org (8.13.4/8.13.4) with ESMTP id l0A90cfJ041735 for ; Wed, 10 Jan 2007 09:00:38 GMT (envelope-from gnats@freefall.freebsd.org) Received: (from gnats@localhost) by freefall.freebsd.org (8.13.4/8.13.4/Submit) id l0A90bME041734; Wed, 10 Jan 2007 09:00:37 GMT (envelope-from gnats) Date: Wed, 10 Jan 2007 09:00:37 GMT Message-Id: <200701100900.l0A90bME041734@freefall.freebsd.org> To: freebsd-standards@FreeBSD.org From: jau@iki.fi (Jukka A. Ukkonen) Cc: Subject: Re: standards/107561: Missing SUS function tcgetsid() X-BeenThere: freebsd-standards@freebsd.org X-Mailman-Version: 2.1.5 Precedence: list Reply-To: "Jukka A. Ukkonen" List-Id: Standards compliance List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Wed, 10 Jan 2007 09:00:39 -0000 The following reply was made to PR standards/107561; it has been noted by GNATS. From: jau@iki.fi (Jukka A. Ukkonen) To: freebsd-standards@FreeBSD.ORG, bug-followup@FreeBSD.ORG Cc: Subject: Re: standards/107561: Missing SUS function tcgetsid() Date: Wed, 10 Jan 2007 10:33:31 +0200 (EET) Quoting Oliver Fromme: > > The proposed implementation looks good to me (we would > also need an appropriate manual page, though). Right, find attached at the end an initial version of the manual page. If you wish to publish my name as the author in the HISTORY or AUTHOR sections, you are welcome to do so, but, please, do not include my e-mail address in there. I get quite a load of spam already every day. Though it makes perfect sense to always publish the names of authors, I would like it to be done in a way that does not increase my spam levels. Cheers, // jau .--- ..- -.- -.- .- .- .-.-.- ..- -.- -.- --- -. . -. / Jukka A. Ukkonen, Oxit Ltd, Finland /__ M.Sc. (sw-eng & cs) (Phone) +358-500-606-671 / Internet: Jukka.Ukkonen(a)Oxit.Fi (Home) +358-9-6215-280 / Internet: jau(a)iki.fi v .--- .- ..- ...-.- .. -.- .. .-.-.- ..-. .. + + + + My opinions are mine and mine alone, not my employers. + + + + o \ / - X ------------------------- clip clip ------------------------------ / \ O .\" Copyright (C) 1992-2007 .\" The FreeBSD Project. All rights reserved. .\" .\" Redistribution and use in source and binary forms, with or without .\" modification, are permitted provided that the following conditions .\" are met: .\" 1. Redistributions of source code must retain the above copyright .\" notice, this list of conditions and the following disclaimer. .\" 2. Redistributions in binary form must reproduce the above copyright .\" notice, this list of conditions and the following disclaimer in the .\" documentation and/or other materials provided with the distribution. .\" .\" THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND .\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE .\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE .\" ARE DISCLAIMED. IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE .\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL .\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS .\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) .\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT .\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF .\" SUCH DAMAGE. .\" .\" $Id: tcgetsid.3,v 1.3 2007/01/10 06:45:53 jau Exp jau $ .\" .Dd January 10, 2007 .Dt TCGETSID 3 .Os Standard C Library Functions .Sh NAME .Nm tcgetsid .Nd get session ID for controlling terminal .Sh LIBRARY .Lb libc .Sh SYNOPSIS .In termios.h .Ft pid_t .Fn tcgetsid "int fd" .Sh DESCRIPTION The .Fn tcgetsid function obtains the session ID of the session for which the terminal specified by fd is the controlling terminal. .Pp This function is a convenience function only and in practice it is equal to calling .Nm getsid ( .Nm tcgetpgrp ( .Ar "int fd" )). .Pp The session ID is equal to the process group ID (and the process ID) for the session leader for the controlling terminal. .Sh RETURN VALUES Upon successful completion, tcgetsid() returns the process group ID associated with the terminal. Otherwise, a value of (pid_t)-1 is returned and errno is set to indicate the error. .Sh ERRORS The .Fn tcgetsid function may fail with .Nm errno set to the following values: .Bl -tag -width Er .It Bq Er EACCES The .Fa fd argument is not associated with a controlling terminal. .It Bq Er EBADF The .Fa fd argument is not a valid file descriptor. .It Bq Er ENOTTY The file associated with .Fa fd is not a terminal. .It Bq Er ESRCH There is no process with a process ID equal to the process group ID of the terminal. .Pp Note that an implementation may restrict the availability of this function to processes within the same session ID as the calling process. .El .Sh SEE ALSO .Xr getsid 2 , .Xr tcgetpgrp 3 .Sh STANDARDS The .Fn tcgetsid function is expected to be compliant with the .St -p1003.1-2001 .Sh AUTHOR Jukka A. Ukkonen, 2007 .Sh HISTORY This manual page was adapted from SunOS 5.9 29 Dec 1996 tcgetsid(3C).