share/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 "Feb 25, 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 .SH FILES
  40 .ne 2
  41 .na
  42 \fB\fB/etc/defaultdomain\fR\fR
  43 .ad
  44 .RS 22n
  45
  46 .RE
  47
  48 .sp
  49 .ne 2
  50 .na
  51 \fB\fB/etc/nsswitch.conf\fR\fR
  52 .ad
  53 .RS 22n
  54
  55 .RE
  56
  57 .SH SEE ALSO
  58 .LP
  59 \fBsvcs\fR(1),
  60 \fBcheck-hostname\fR(1M), \fBhostconfig\fR(1M), \fBnamed\fR(1M),
  61 \fBsvcadm\fR(1M), \fBypinit\fR(1M),
  62 \fBsys-unconfig\fR(1M), \fBdefaultdomain\fR(4), \fBhosts\fR(4),
  63 \fBnsswitch.conf\fR(4), \fBpasswd\fR(4), \fBattributes\fR(5),
  64 \fBrbac\fR(5), \fBsmf\fR(5)
  65 .SH NOTES
  66 .LP
  67 The \fBdomainname\fR service is managed by the service management facility,
  68 \fBsmf\fR(5), under the service identifier:
  69
  70 .sp
  71 .in +2
  72 .nf
  73 svc:/system/identity:domain
  74 .fi
  75 .in -2
  76 .sp
  77
  78 .sp
  79 .LP
  80 Administrative actions on this service, such as enabling, disabling, or
  81 requesting restart, can be performed using \fBsvcadm\fR(1M). The service's
  82 status can be queried using the \fBsvcs\fR(1) command.