Add missing getdomainname manual page.
Reviewed by: Submitted by: Obtained from: 1.1.5.1 with a few modifictaions.
This commit is contained in:
Guido van Rooij
parent
66ecebed58
commit
4e32be0fb7
@ -1,5 +1,5 @@
|
||||
# From: @(#)Makefile.inc 8.3 (Berkeley) 4/16/94
|
||||
# $Id: Makefile.inc,v 1.13 1994/10/25 14:04:32 bde Exp $
|
||||
# $Id: Makefile.inc,v 1.14 1994/11/13 20:47:41 phk Exp $
|
||||
|
||||
# machine-independent gen sources
|
||||
.PATH: ${.CURDIR}/${MACHINE}/gen ${.CURDIR}/gen
|
||||
@ -40,8 +40,9 @@ MAN3+= gen/alarm.3 gen/clock.3 gen/confstr.3 gen/config_open.3 \
|
||||
gen/crypt.3 gen/ctermid.3 \
|
||||
gen/daemon.3 gen/devname.3 gen/directory.3 gen/err.3 gen/exec.3 \
|
||||
gen/fnmatch.3 gen/frexp.3 gen/fts.3 gen/getbsize.3 gen/getbootfile.3 \
|
||||
gen/getcap.3 gen/getcwd.3 gen/getdiskbyname.3 gen/getfsent.3 \
|
||||
gen/getgrent.3 gen/getgrouplist.3 gen/gethostname.3 gen/getloadavg.3 \
|
||||
gen/getcap.3 gen/getcwd.3 gen/getdiskbyname.3 gen/getdomainname.3 \
|
||||
gen/getfsent.3 gen/getgrent.3 gen/getgrouplist.3 gen/gethostname.3 \
|
||||
gen/getloadavg.3 \
|
||||
gen/getmntinfo.3 gen/getnetgrent.3 gen/getpagesize.3 gen/getpass.3 \
|
||||
gen/getpwent.3 gen/getttyent.3 gen/getvfsent.3 gen/getusershell.3 \
|
||||
gen/glob.3 \
|
||||
@ -75,6 +76,7 @@ MLINKS+=getfsent.3 endfsent.3 getfsent.3 getfsfile.3 getfsent.3 getfsspec.3 \
|
||||
MLINKS+=getgrent.3 endgrent.3 getgrent.3 setgroupent.3 getgrent.3 getgrgid.3 \
|
||||
getgrent.3 getgrnam.3 getgrent.3 setgrent.3 getgrent.3 setgrfile.3
|
||||
MLINKS+=gethostname.3 sethostname.3
|
||||
MLINKS+=getdomainname.3 setdomainname.3
|
||||
MLINKS+=getnetgrent.3 endnetgrent.3 getnetgrent.3 setnetgrent.3 \
|
||||
getnetgrent.3 innetgr.3
|
||||
MLINKS+=getpwent.3 endpwent.3 getpwent.3 setpassent.3 getpwent.3 getpwnam.3 \
|
||||
|
||||
98
lib/libc/gen/getdomainname.3
Normal file
98
lib/libc/gen/getdomainname.3
Normal file
@ -0,0 +1,98 @@
|
||||
.\" Copyright (c) 1983, 1991 The Regents of the University of California.
|
||||
.\" 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.
|
||||
.\" 3. All advertising materials mentioning features or use of this software
|
||||
.\" must display the following acknowledgement:
|
||||
.\" This product includes software developed by the University of
|
||||
.\" California, Berkeley and its contributors.
|
||||
.\" 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.
|
||||
.\"
|
||||
.\" from: @(#)getdomainname.2 6.7 (Berkeley) 3/10/91
|
||||
.\" $Id: getdomainname.2,v 1.1 1993/10/25 03:11:30 rgrimes Exp $
|
||||
.\"
|
||||
.Dd March 10, 1991
|
||||
.Dt GETDOMAINNAME 3
|
||||
.Os BSD 4.2
|
||||
.Sh NAME
|
||||
.Nm getdomainname ,
|
||||
.Nm setdomainname
|
||||
.Nd get/set name of current host
|
||||
.Sh SYNOPSIS
|
||||
.Fd #include <unistd.h>
|
||||
.Ft int
|
||||
.Fn getdomainname "char *name" "int namelen"
|
||||
.Ft int
|
||||
.Fn setdomainname "const char *name" "int namelen"
|
||||
.Sh DESCRIPTION
|
||||
.Fn Getdomainname
|
||||
returns the standard host name for the current processor, as
|
||||
previously set by
|
||||
.Fn setdomainname .
|
||||
The parameter
|
||||
.Fa namelen
|
||||
specifies the size of the
|
||||
.Fa name
|
||||
array. The returned name is null-terminated unless insufficient
|
||||
space is provided.
|
||||
.Pp
|
||||
.Fn Setdomainname
|
||||
sets the name of the host machine to be
|
||||
.Fa name ,
|
||||
which has length
|
||||
.Fa namelen .
|
||||
This call is restricted to the super-user and
|
||||
is normally used only when the system is bootstrapped.
|
||||
.Sh RETURN VALUES
|
||||
If the call succeeds a value of 0 is returned. If the call
|
||||
fails, a value of -1 is returned and an error code is
|
||||
placed in the global location
|
||||
.Va errno .
|
||||
.Sh ERRORS
|
||||
The following errors may be returned by these calls:
|
||||
.Bl -tag -width Er
|
||||
.It Bq Er EFAULT
|
||||
The
|
||||
.Fa name
|
||||
or
|
||||
.Fa namelen
|
||||
parameter gave an
|
||||
invalid address.
|
||||
.It Bq Er EPERM
|
||||
The caller tried to set the domainname and was not the super-user.
|
||||
.El
|
||||
.Sh SEE ALSO
|
||||
.Xr sysctl 2
|
||||
.Xr gethostid 3
|
||||
.Sh BUGS
|
||||
Host names are limited to
|
||||
.Dv MAXHOSTNAMELEN
|
||||
(from
|
||||
.Ao Pa sys/param.h Ac )
|
||||
characters, currently 256.
|
||||
.Sh HISTORY
|
||||
The
|
||||
.Nm
|
||||
function call appeared in
|
||||
.Bx 4.2 .
|
||||
Loading…
x
Reference in New Issue
Block a user