domainname(1M)						  System Administration Commands					    domainname(1M)

NAME

       domainname - set or display name of the current domain

SYNOPSIS

       domainname [name-of-domain]

DESCRIPTION

       Without	an argument, domainname displays the name of the current domain name used in RPC exchanges, usually referred to as the NIS or NIS+
       domain name. This name typically encompasses a group of hosts or passwd entries under the same administration. The  domainname  command	is
       used  by various components of Solaris to resolve names for entries such as are found in passwd, hosts and aliases. By default, naming ser-
       vices such as NIS and NIS+ use domainname to resolve names.

       With appropriate privileges (root or an equivalent role [see rbac(5)]), you can set the name of the domain by specifying  the  name  as	an
       argument to the domainname command.

       The  domain  name for various naming services can also be set by other means. For example, ypinit can be used to specify a different domain
       for all NIS calls. The domain name of the machine is usually set during boot time through the domainname command by  the  svc:/system/iden-
       tity:domain  service.  If  the  new domain name is not saved in the /etc/defaultdomain file, the machine reverts to the old domain after it
       reboots.

       The sendmail(1M) daemon, as shipped with Solaris, and the sendmail implementation provided by sendmail.org (formerly referred to as "Berke-
       ley  8.x  sendmail") both attempt to determine a local host's fully qualified host name at startup and both pursue follow-up actions if the
       initial search fails. It is in these follow-up actions that the two implementations differ.

       Both implementations use a standard Solaris or Unix system call to determine its fully qualified host name at startup, following  the  name
       service priorities specified in nsswitch.conf(4). To this point, the Solaris and sendmail.org versions behave identically.

       If  the	request  for a fully qualified host name fails, the sendmail.org sendmail sleeps for 60 seconds, tries again, and, upon continuing
       failure, resorts to a short name. The Solaris version of sendmail makes the same initial request,  but  then,  following  initial  failure,
       calls domainname. If successful, the sleep is avoided.

       On  a  Solaris  machine,  if  you  run  the  sendmail.org  version of sendmail, you get the startup behavior (omitting the domainname call)
       described above. If you run the Solaris sendmail, the domainname call is made if needed.

       If the Solaris sendmail cannot determine the fully qualified host name, use check-hostname(1M) as a troubleshooting aid.  This  script  can
       offer guidance as to appropriate corrective action.

FILES

       /etc/defaultdomain

       /etc/nsswitch.conf

ATTRIBUTES

       See attributes(5) for descriptions of the following attributes:

       +-----------------------------+-----------------------------+
       |      ATTRIBUTE TYPE	     |	    ATTRIBUTE VALUE	   |
       +-----------------------------+-----------------------------+
       |Availability		     |SUNWcsu			   |
       +-----------------------------+-----------------------------+

SEE ALSO

       NIS+(1),  nischown(1),  nispasswd(1),  svcs(1),	check-hostname(1M),  hostconfig(1M),  named(1M), nisaddcred(1M), sendmail(1M), svcadm(1M),
       ypinit(1M), sys-unconfig(1M), aliases(4), defaultdomain(4), hosts(4), nsswitch.conf(4), passwd(4), attributes(5), rbac(5), smf(5)

NOTES

       The domainname service is managed by the service management facility, smf(5), under the service identifier:

	 svc:/system/identity:domain

       Administrative actions on this service, such as enabling, disabling, or requesting restart, can be performed  using  svcadm(1M).  The  ser-
       vice's status can be queried using the svcs(1) command.

SunOS 5.11							    8 Mar 2006							    domainname(1M)