svn commit: r254410 - in head/lib/libc: gen sys

[Benjamin Kaduk]

On Fri, Aug 16, 2013 at 9:16 AM, Jilles Tjoelker <jilles at freebsd.org> wrote:

> Author: jilles
> Date: Fri Aug 16 13:16:27 2013
> New Revision: 254410
> URL: http://svnweb.freebsd.org/changeset/base/254410
>
> Log:
>   Add man page dup3(3).
>
> Added: head/lib/libc/gen/dup3.3
>
> ==============================================================================
> --- /dev/null   00:00:00 1970   (empty, because file is newly added)
> +++ head/lib/libc/gen/dup3.3    Fri Aug 16 13:16:27 2013        (r254410)
> @@ -0,0 +1,120 @@
> +.\" Copyright (c) 1980, 1991, 1993
> +.\"    The Regents of the University of California.  All rights reserved.
>

You are donating the work to the Regents?  And it was done twenty years ago?


> +.\"
> +.\" 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.
> +.\" 4. Neither the name of the University nor the names of its
> contributors
> +.\"    may be used to endorse or promote products derived from this
> software
> +.\"    without specific prior written permission.
> +.\"
> +.\" 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.
> +.\"
> +.\"     @(#)dup.2      8.1 (Berkeley) 6/4/93
>

This file is not named dup.2...


> +.\" $FreeBSD$
> +.\"
> +.Dd August 16, 2013
> +.Dt DUP3 3
> +.Os
> +.Sh NAME
> +.Nm dup3
> +.Nd duplicate an existing file descriptor
> +.Sh LIBRARY
> +.Lb libc
> +.Sh SYNOPSIS
> +.In fcntl.h
> +.In unistd.h
> +.Ft int
> +.Fn dup3 "int oldd" "int newd" "int flags"
> +.Sh DESCRIPTION
> +The
> +.Fn dup3
>

Hmm, I guess .Nm is not quite appropriate here, so this is okay.

-Ben


> +function
> +duplicates an existing object descriptor
> +while allowing the value of the new descriptor to be specified.