URL
https://opencores.org/ocsvn/openrisc_me/openrisc_me/trunk
Subversion Repositories openrisc_me
Compare Revisions
- This comparison shows the changes necessary to convert path
/openrisc/trunk/rtos/ecos-2.0/packages/net/common/v2_0/doc/manpages/gen
- from Rev 27 to Rev 174
- ↔ Reverse comparison
Rev 27 → Rev 174
/gethostname.3
0,0 → 1,114
.\" $OpenBSD: gethostname.3,v 1.18 2001/01/21 23:30:04 aaron Exp $ |
.\" |
.\" Copyright (c) 1983, 1991, 1993 |
.\" 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. |
.\" |
.Dd June 4, 1993 |
.Dt GETHOSTNAME 3 |
.Os |
.Sh NAME |
.Nm gethostname , |
.Nm sethostname |
.Nd get/set name of current host |
.Sh SYNOPSIS |
.Fd #include <unistd.h> |
.Ft int |
.Fn gethostname "char *name" "size_t namelen" |
.Ft int |
.Fn sethostname "const char *name" "size_t namelen" |
.Sh DESCRIPTION |
The |
.Fn gethostname |
function returns the standard host name for the current |
processor, as previously set by |
.Fn sethostname . |
The parameter |
.Fa namelen |
specifies the size of the |
.Fa name |
array. |
If insufficient space is provided, the returned name is truncated. |
The returned name is always null terminated. |
.Pp |
.Fn sethostname |
sets the name of the host machine to be |
.Fa name , |
which has length |
.Fa namelen . |
This call is restricted to the superuser 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 variable |
.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 hostname and was not the superuser. |
.El |
.Sh SEE ALSO |
.Xr hostname 1 , |
.Xr getdomainname 3 , |
.Xr gethostid 3 , |
.Xr sysctl 3 , |
.Xr sysctl 8 , |
.Xr yp 8 |
.Sh STANDARDS |
The |
.Fn gethostname |
function call conforms to |
.St -xpg4.2 . |
.Sh HISTORY |
The |
.Fn gethostname |
function call appeared in |
.Bx 4.2 . |
.Sh BUGS |
Host names are limited to |
.Dv MAXHOSTNAMELEN |
(from |
.Ao Pa sys/param.h Ac ) |
characters, currently 256. |
This includes the terminating NUL character. |
.Pp |
If the buffer passed to |
.Fn gethostname |
is smaller than |
.Dv MAXHOSTNAMELEN , |
other operating systems may not guarantee termination with NUL. |
/getdomainname.3
0,0 → 1,108
.\" $OpenBSD: getdomainname.3,v 1.18 2000/12/24 00:30:48 aaron Exp $ |
.\" |
.\" Copyright (c) 1983, 1991, 1993 |
.\" 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. |
.\" |
.Dd May 6, 1994 |
.Dt GETDOMAINNAME 3 |
.Os |
.Sh NAME |
.Nm getdomainname , |
.Nm setdomainname |
.Nd get/set YP domain name of current host |
.Sh SYNOPSIS |
.Fd #include <unistd.h> |
.Ft int |
.Fn getdomainname "char *name" "size_t namelen" |
.Ft int |
.Fn setdomainname "const char *name" "size_t namelen" |
.Sh DESCRIPTION |
The |
.Fn getdomainname |
function returns the YP domain name for the current processor, as |
previously set by |
.Fn setdomainname . |
The parameter |
.Fa namelen |
specifies the size of the |
.Fa name |
array. |
If insufficient space is provided, the returned name is truncated. |
The returned name is always null terminated. |
.Pp |
.Fn setdomainname |
sets the domain name of the host machine to be |
.Fa name , |
which has length |
.Fa namelen . |
This call is restricted to the superuser 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 variable |
.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 domain name and was not the superuser. |
.El |
.Sh SEE ALSO |
.Xr domainname 1 , |
.Xr gethostid 3 , |
.Xr gethostname 3 , |
.Xr sysctl 3 , |
.Xr sysctl 8 , |
.Xr yp 8 |
.Sh BUGS |
Domain names are limited to |
.Dv MAXHOSTNAMELEN |
(from |
.Ao Pa sys/param.h Ac ) |
characters, currently 256. |
This includes the terminating NUL character. |
.Pp |
If the buffer passed to |
.Fn getdomainname |
is too small, other operating systems may not guarantee termination with NUL. |
.Sh HISTORY |
The |
.Nm |
function call appeared in |
SunOS 3.x. |