Manual Pages for UNIX Operating System command usage for man domainname

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 domain name. This name typically encompasses a
     group  of hosts or passwd entries under the same administra-
     tion. 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 services  such
     as 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 domain-
     name command by the svc:/system/identity: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 "Berkeley  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



SunOS 5.11          Last change: 11 Dec 2009                    1






System Administration Commands                     domainname(1M)



     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 domain-
     name 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  attri-
     butes:



     ____________________________________________________________
    |       ATTRIBUTE TYPE        |       ATTRIBUTE VALUE       |
    |_____________________________|_____________________________|
    | Availability                | SUNWcs                      |
    |_____________________________|_____________________________|


SEE ALSO
     svcs(1),  check-hostname(1M),   hostconfig(1M),   named(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








SunOS 5.11          Last change: 11 Dec 2009                    2






System Administration Commands                     domainname(1M)



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



















































SunOS 5.11          Last change: 11 Dec 2009                    3