freebsd-dev/bin/domainname/domainname.1

.\"-
.\" Copyright (c) 1983, 1988, 1990, 1993
.\"	The Regents of the University of California.  All rights reserved.
.\"
.\" Redistribution and use in source and binary forms, with or without
.\" modification, are permitted provided that the following conditions
.\" are met:
.\" 1. Redistributions of source code must retain the above copyright
.\"    notice, this list of conditions and the following disclaimer.
.\" 2. Redistributions in binary form must reproduce the above copyright
.\"    notice, this list of conditions and the following disclaimer in the
.\"    documentation and/or other materials provided with the distribution.
.\" 3. Neither the name of the University nor the names of its contributors
.\"    may be used to endorse or promote products derived from this software
.\"    without specific prior written permission.
.\"
.\" THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND
.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
.\" ARE DISCLAIMED.  IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE
.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
.\" SUCH DAMAGE.
.\"
.\"	From: @(#)hostname.1	8.1 (Berkeley) 5/31/93
.\" $FreeBSD$
.\"
.Dd April 22, 2013
.Dt DOMAINNAME 1
.Os
.Sh NAME
.Nm domainname
.Nd set or print name of current YP/NIS domain
.Sh SYNOPSIS
.Nm
.Op Ar ypdomain
.Sh DESCRIPTION
The
.Nm
utility prints the name of the current YP/NIS domain.
The super-user can
set the domain name by supplying an argument; this is usually done with the
.Va nisdomainname
variable in the
.Pa /etc/rc.conf
file, normally run at boot
time.
.Sh NOTES
The YP/NIS (formerly ``Yellow Pages'' but renamed for legal reasons)
domain name does not necessarily have anything to do with the Domain
Name System domain name, although they are often set equal for administrative
convenience.
.Sh SEE ALSO
.Xr getdomainname 3 ,
.Xr rc.conf 5
.Sh HISTORY
The
.Nm
command appeared in
.Fx 1.1 ,
based on a similar command in
.Tn SunOS .
/*- or .\"- or #- to begin license clauses. 2005-01-10 08:39:26 +00:00			`.\"-`
A new domainname(1) command based on hostname(1), this time with a correct manual page. 1994-09-18 21:23:37 +00:00			`.\" Copyright (c) 1983, 1988, 1990, 1993`
			`.\" The Regents of the University of California. All rights reserved.`
			`.\"`
			`.\" Redistribution and use in source and binary forms, with or without`
			`.\" modification, are permitted provided that the following conditions`
			`.\" are met:`
			`.\" 1. Redistributions of source code must retain the above copyright`
			`.\" notice, this list of conditions and the following disclaimer.`
			`.\" 2. Redistributions in binary form must reproduce the above copyright`
			`.\" notice, this list of conditions and the following disclaimer in the`
			`.\" documentation and/or other materials provided with the distribution.`
Renumber copyright clause 4 Renumber cluase 4 to 3, per what everybody else did when BSD granted them permission to remove clause 3. My insistance on keeping the same numbering for legal reasons is too pedantic, so give up on that point. Submitted by: Jan Schaumann <jschauma@stevens.edu> Pull Request: https://github.com/freebsd/freebsd/pull/96 2017-02-28 23:42:47 +00:00			`.\" 3. Neither the name of the University nor the names of its contributors`
A new domainname(1) command based on hostname(1), this time with a correct manual page. 1994-09-18 21:23:37 +00:00			`.\" may be used to endorse or promote products derived from this software`
			`.\" without specific prior written permission.`
			`.\"`
			.\" THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND
			`.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE`
			`.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE`
			`.\" ARE DISCLAIMED. IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE`
			`.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL`
			`.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS`
			`.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)`
			`.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT`
			`.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY`
			`.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF`
			`.\" SUCH DAMAGE.`
			`.\"`
			`.\" From: @(#)hostname.1 8.1 (Berkeley) 5/31/93`
$Id$ -> $FreeBSD$ 1999-08-27 23:15:48 +00:00			`.\" $FreeBSD$`
A new domainname(1) command based on hostname(1), this time with a correct manual page. 1994-09-18 21:23:37 +00:00			`.\"`
Point users towards nisdomainname and rc.conf. PR: 144630 Submitted by: Stefan Krueger <stadtkind2@gmx.de>, Fel <wtfcrap@mail.ru> 2013-04-22 17:55:12 +00:00			`.Dd April 22, 2013`
A new domainname(1) command based on hostname(1), this time with a correct manual page. 1994-09-18 21:23:37 +00:00			`.Dt DOMAINNAME 1`
mdoc(7) police: removed HISTORY info from the .Os call. 2001-07-10 10:04:09 +00:00			`.Os`
A new domainname(1) command based on hostname(1), this time with a correct manual page. 1994-09-18 21:23:37 +00:00			`.Sh NAME`
			`.Nm domainname`
			`.Nd set or print name of current YP/NIS domain`
			`.Sh SYNOPSIS`
mdoc(7) police: use the new features of the Nm macro. 2000-11-20 11:39:41 +00:00			`.Nm`
A new domainname(1) command based on hostname(1), this time with a correct manual page. 1994-09-18 21:23:37 +00:00			`.Op Ar ypdomain`
			`.Sh DESCRIPTION`
Use `The .Nm utility' 2002-04-16 20:08:06 +00:00			`The`
			`.Nm`
Mechanically kill hard sentence breaks. 2004-07-02 21:04:19 +00:00			`utility prints the name of the current YP/NIS domain.`
			`The super-user can`
Point users towards nisdomainname and rc.conf. PR: 144630 Submitted by: Stefan Krueger <stadtkind2@gmx.de>, Fel <wtfcrap@mail.ru> 2013-04-22 17:55:12 +00:00			`set the domain name by supplying an argument; this is usually done with the`
			`.Va nisdomainname`
			`variable in the`
			`.Pa /etc/rc.conf`
			`file, normally run at boot`
A new domainname(1) command based on hostname(1), this time with a correct manual page. 1994-09-18 21:23:37 +00:00			`time.`
Use a standard section name. 2006-12-18 15:45:01 +00:00			`.Sh NOTES`
A new domainname(1) command based on hostname(1), this time with a correct manual page. 1994-09-18 21:23:37 +00:00			The YP/NIS (formerly ``Yellow Pages'' but renamed for legal reasons)
			`domain name does not necessarily have anything to do with the Domain`
			`Name System domain name, although they are often set equal for administrative`
			`convenience.`
			`.Sh SEE ALSO`
Point users towards nisdomainname and rc.conf. PR: 144630 Submitted by: Stefan Krueger <stadtkind2@gmx.de>, Fel <wtfcrap@mail.ru> 2013-04-22 17:55:12 +00:00			`.Xr getdomainname 3 ,`
			`.Xr rc.conf 5`
A new domainname(1) command based on hostname(1), this time with a correct manual page. 1994-09-18 21:23:37 +00:00			`.Sh HISTORY`
			`The`
Remove whitespace at EOL. 2001-07-15 07:53:42 +00:00			`.Nm`
A new domainname(1) command based on hostname(1), this time with a correct manual page. 1994-09-18 21:23:37 +00:00			`command appeared in`
mdoc(7) police: join OS version with the corresponding macro. 2001-10-19 14:44:13 +00:00			`.Fx 1.1 ,`
			`based on a similar command in`
A new domainname(1) command based on hostname(1), this time with a correct manual page. 1994-09-18 21:23:37 +00:00			`.Tn SunOS .`