Differences between current version and revision by previous author of getdomainname(2).
Other diffs: Previous Major Revision, Previous Revision, or view the Annotated Edit History
| Newer page: | version 2 | Last edited on Monday, December 30, 2002 3:25:19 am | by PerryLorier | |
| Older page: | version 1 | Last edited on Tuesday, June 4, 2002 12:23:41 am | by perry | Revert |
@@ -1,77 +1,21 @@
-GETDOMAINNAME
-!!!GETDOMAINNAME
-NAME
-SYNOPSIS
-DESCRIPTION
-RETURN VALUE
-ERRORS
-CONFORMING TO
-SEE ALSO
-----
!!NAME
-
-
-, setdomainname
- get/set
domain name
+getdomainname -
- get domain name
!!SYNOPSIS
+ __#include <unistd.h>__
-__#include __
-
-
-
-''len''__);
-int setdomainname(const char *__''name''__, size_t__
-
+
__int getdomainname(char *__''name''__, size_t__ ''len''__);__
!!DESCRIPTION
+This function is used to access or to change the domain name of the current machine. If the NUL-terminated domain name requires more than ''len'' bytes, getdomainname(2) returns the first ''len'' bytes (glibc) or returns an error (libc).
-
-These functions are used to access or to change the domain
-name of the current processor. If the NUL-terminated domain
-name requires more than ''len'' bytes,
-__getdomainname__ returns the first ''len'' bytes
-(glibc) or returns an error (libc).
!!RETURN VALUE
+On success, zero is returned. On error, -1 is returned, and ''errno'' is set appropriately.
-
-On success, zero is returned. On error, -1 is returned, and
-''errno'' is set appropriately.
!!ERRORS
+;[EINVAL]: Under libc: ''name'' is __NULL__ or ''name'' is longer than ''len'' bytes.
-
-__EINVAL__
-
-
-For __getdomainname__ under libc: ''name'' is
-__NULL__ or ''name'' is longer than ''len''
-bytes.
-
-
-__EINVAL__
-
-
-For __setdomainname__: ''len'' was negative or too
-large.
-
-
-__EPERM__
-
-
-For __setdomainname__: the caller was not the
-superuser.
-
-
-__EFAULT__
-
-
-For __setdomainname__: ''name'' pointed outside of
-user address space.
!!CONFORMING TO
+[POSIX.1] does not specify these calls. [POSIX.3] does. Who knows about [POSIX.2]
-
-POSIX does not specify these calls.
!!SEE ALSO
-
-
-
-
-----
+getdomainname(2),
gethostname(2), sethostname(2), uname(2)
