usr/src/man/man1m/domainname.1m

   1 '\" te
   2 .\" Copyright (c) 2004, Sun Microsystems, Inc. All Rights Reserved
   3 .\" Copyright 1989 AT&T
   4 .\" The contents of this file are subject to the terms of the Common Development and Distribution License (the "License").  You may not use this file except in compliance with the License.
   5 .\" You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE or http://www.opensolaris.org/os/licensing.  See the License for the specific language governing permissions and limitations under the License.
   6 .\" When distributing Covered Code, include this CDDL HEADER in each file and include the License file at usr/src/OPENSOLARIS.LICENSE.  If applicable, add the following below this CDDL HEADER, with the fields enclosed by brackets "[]" replaced with your own identifying information: Portions Copyright [yyyy] [name of copyright owner]
   7 .TH DOMAINNAME 1M "May 13, 2017"
   8 .SH NAME
   9 domainname \- set or display name of the current domain
  10 .SH SYNOPSIS
  11 .LP
  12 .nf
  13 \fBdomainname\fR [\fIname-of-domain\fR]
  14 .fi
  15
  16 .SH DESCRIPTION
  17 .LP
  18 Without an argument, \fBdomainname\fR displays the name of the current domain
  19 name used in RPC exchanges, usually referred to as the NIS domain name.
  20 This name typically encompasses a group of \fBhosts\fR or \fBpasswd\fR entries
  21 under the same administration. The \fBdomainname\fR command is used by various
  22 components of Solaris to resolve names for entries such as are found in
  23 \fBpasswd\fR, \fBhosts\fR and \fBaliases\fR. By default, naming services such
  24 as \fBNIS\fR use \fBdomainname\fR to resolve names.
  25 .sp
  26 .LP
  27 With appropriate privileges (root or an equivalent role [see \fBrbac\fR(5)]),
  28 you can set the name of the domain by specifying the name as an argument to the
  29 \fBdomainname\fR command.
  30 .sp
  31 .LP
  32 The domain name for various naming services can also be set by other means. For
  33 example, \fBypinit\fR can be used to specify a different domain for all
  34 \fBNIS\fR calls. The domain name of the machine is usually set during boot time
  35 through the \fBdomainname\fR command by the \fBsvc:/system/identity:domain\fR
  36 service. If the new domain name is not saved in the \fB/etc/defaultdomain\fR
  37 file, the machine reverts to the old domain after it reboots.
  38 .sp
  39 .LP
  40 The \fBsendmail\fR(1M) daemon, as shipped with Solaris, and the \fBsendmail\fR
  41 implementation provided by \fBsendmail.org\fR (formerly referred to as
  42 "Berkeley 8.x sendmail") both attempt to determine a local host's fully
  43 qualified host name at startup and both pursue follow-up actions if the initial
  44 search fails. It is in these follow-up actions that the two implementations
  45 differ.
  46 .sp
  47 .LP
  48 Both implementations use a standard Solaris or Unix system call to determine
  49 its fully qualified host name at startup, following the name service priorities
  50 specified in \fBnsswitch.conf\fR(4). To this point, the Solaris and
  51 \fBsendmail.org\fR versions behave identically.
  52 .sp
  53 .LP
  54 If the request for a fully qualified host name fails, the \fBsendmail.org\fR
  55 \fBsendmail\fR sleeps for 60 seconds, tries again, and, upon continuing
  56 failure, resorts to a short name. The Solaris version of \fBsendmail\fR makes
  57 the same initial request, but then, following initial failure, calls
  58 \fBdomainname\fR. If successful, the sleep is avoided.
  59 .sp
  60 .LP
  61 On a Solaris machine, if you run the \fBsendmail.org\fR version of sendmail,
  62 you get the startup behavior (omitting the \fBdomainname\fR call) described
  63 above. If you run the Solaris \fBsendmail\fR, the \fBdomainname\fR call is made
  64 if needed.
  65 .sp
  66 .LP
  67 If the Solaris \fBsendmail\fR cannot determine the fully qualified host name,
  68 use \fBcheck-hostname\fR(1M) as a troubleshooting aid. This script can offer
  69 guidance as to appropriate corrective action.
  70 .SH FILES
  71 .ne 2
  72 .na
  73 \fB\fB/etc/defaultdomain\fR\fR
  74 .ad
  75 .RS 22n
  76
  77 .RE
  78
  79 .sp
  80 .ne 2
  81 .na
  82 \fB\fB/etc/nsswitch.conf\fR\fR
  83 .ad
  84 .RS 22n
  85
  86 .RE
  87
  88 .SH SEE ALSO
  89 .LP
  90 \fBsvcs\fR(1),
  91 \fBcheck-hostname\fR(1M), \fBhostconfig\fR(1M), \fBnamed\fR(1M),
  92 \fBsendmail\fR(1M), \fBsvcadm\fR(1M), \fBypinit\fR(1M),
  93 \fBaliases\fR(4), \fBdefaultdomain\fR(4),
  94 \fBhosts\fR(4), \fBnsswitch.conf\fR(4), \fBpasswd\fR(4), \fBattributes\fR(5),
  95 \fBrbac\fR(5), \fBsmf\fR(5)
  96 .SH NOTES
  97 .LP
  98 The \fBdomainname\fR service is managed by the service management facility,
  99 \fBsmf\fR(5), under the service identifier:
 100 .sp
 101 .in +2
 102 .nf
 103 svc:/system/identity:domain
 104 .fi
 105 .in -2
 106 .sp
 107
 108 .sp
 109 .LP
 110 Administrative actions on this service, such as enabling, disabling, or
 111 requesting restart, can be performed using \fBsvcadm\fR(1M). The service's
 112 status can be queried using the \fBsvcs\fR(1) command.