GSP
Quick Navigator

Search Site

Unix VPS
A - Starter
B - Basic
C - Preferred
D - Commercial
MPS - Dedicated
Previous VPSs
* Sign Up! *

Support
Contact Us
Online Help
Handbooks
Domain Status
Man Pages

FAQ
Virtual Servers
Pricing
Billing
Technical

Network
Facilities
Connectivity
Topology Map

Miscellaneous
Server Agreement
Year 2038
Credits
 

USA Flag

 

 

Man Pages


Manual Reference Pages  -  SETDOMAINNAME (3)

NAME

getdomainname, setdomainname - get/set the NIS domain name of current host

CONTENTS

Library
Synopsis
Description
Return Values
Errors
See Also
History
Bugs

LIBRARY


.Lb libc

SYNOPSIS


.In unistd.h int getdomainname char *name int namelen int setdomainname const char *name int namelen

DESCRIPTION

The getdomainname function returns the standard NIS domain name for the current host, as previously set by setdomainname. The namelen argument specifies the size of the name array. The returned name is null-terminated unless insufficient space is provided.

The setdomainname function sets the NIS domain name of the host machine to be name, which has length namelen. This call is restricted to the super-user and is normally used only when the system is bootstrapped.

RETURN VALUES


.Rv -std

ERRORS

The following errors may be returned by these calls:
[EFAULT]
  The name or namelen argument gave an invalid address.
[EPERM]
  The caller tried to set the hostname and was not the super-user.

SEE ALSO

gethostid(3), gethostname(3), sysctl(3)

HISTORY

The getdomainname function appeared in BSD 4.2 .

BUGS

Domain names are limited to MAXHOSTNAMELEN (from
.In sys/param.h ) characters, currently 256.
Search for    or go to Top of page |  Section 3 |  Main Index


Powered by GSP Visit the GSP FreeBSD Man Page Interface.
Output converted with manServer 1.07.