[apple/shell_cmds.git] / hostname / hostname.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.
.\" 4. 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.
.\"
.\"	@(#)hostname.1	8.2 (Berkeley) 4/28/95
.\" $FreeBSD: src/bin/hostname/hostname.1,v 1.21 2006/12/08 07:47:08 kientzle Exp $
.\"
.Dd December 7, 2006
.Dt HOSTNAME 1
.Os
.Sh NAME
.Nm hostname
.Nd set or print name of current host system
.Sh SYNOPSIS
.Nm
.Op Fl fs
.Op Ar name-of-host
.Sh DESCRIPTION
The
.Nm
utility prints the name of the current host.
The super-user can
set the hostname by supplying an argument.
To keep the hostname between reboots, run
.Sq scutil --set HostName Ar name-of-host .
.Pp
Options:
.Bl -tag -width flag
.It Fl f
Include domain information in the printed name.
This is the default behavior.
.It Fl s
Trim off any domain information from the printed
name.
.El
.Sh SEE ALSO
.Xr gethostname 3 ,
.Xr scutil 8
.Sh HISTORY
The
.Nm
command appeared in
.Bx 4.2 .
Commit	Line	Data
ddb4a88b	1	.\"-
44bd5ea7 A	2	.\" Copyright (c) 1983, 1988, 1990, 1993
	3	.\" The Regents of the University of California. All rights reserved.
	4	.\"
	5	.\" Redistribution and use in source and binary forms, with or without
	6	.\" modification, are permitted provided that the following conditions
	7	.\" are met:
	8	.\" 1. Redistributions of source code must retain the above copyright
	9	.\" notice, this list of conditions and the following disclaimer.
	10	.\" 2. Redistributions in binary form must reproduce the above copyright
	11	.\" notice, this list of conditions and the following disclaimer in the
	12	.\" documentation and/or other materials provided with the distribution.
44bd5ea7 A	13	.\" 4. Neither the name of the University nor the names of its contributors
	14	.\" may be used to endorse or promote products derived from this software
	15	.\" without specific prior written permission.
	16	.\"
	17	.\" THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND
	18	.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
	19	.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
	20	.\" ARE DISCLAIMED. IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE
	21	.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
	22	.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
	23	.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
	24	.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
	25	.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
	26	.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
	27	.\" SUCH DAMAGE.
	28	.\"
	29	.\" @(#)hostname.1 8.2 (Berkeley) 4/28/95
ddb4a88b	30	.\" $FreeBSD: src/bin/hostname/hostname.1,v 1.21 2006/12/08 07:47:08 kientzle Exp $
44bd5ea7	31	.\"
ddb4a88b	32	.Dd December 7, 2006
44bd5ea7	33	.Dt HOSTNAME 1
9bafe280	34	.Os
44bd5ea7 A	35	.Sh NAME
	36	.Nm hostname
	37	.Nd set or print name of current host system
	38	.Sh SYNOPSIS
	39	.Nm
ddb4a88b	40	.Op Fl fs
44bd5ea7 A	41	.Op Ar name-of-host
44bd5ea7 A	42	.Sh DESCRIPTION
9bafe280	43	The
44bd5ea7	44	.Nm
9bafe280	45	utility prints the name of the current host.
ddb4a88b A	46	The super-user can
	47	set the hostname by supplying an argument.
	48	To keep the hostname between reboots, run
	49	.Sq scutil --set HostName Ar name-of-host .
44bd5ea7 A	50	.Pp
	51	Options:
	52	.Bl -tag -width flag
ddb4a88b A	53	.It Fl f
	54	Include domain information in the printed name.
	55	This is the default behavior.
44bd5ea7	56	.It Fl s
9bafe280	57	Trim off any domain information from the printed
44bd5ea7 A	58	name.
	59	.El
	60	.Sh SEE ALSO
ddb4a88b A	61	.Xr gethostname 3 ,
ddb4a88b A	62	.Xr scutil 8
44bd5ea7 A	63	.Sh HISTORY
	64	The
	65	.Nm
9bafe280	66	command appeared in
44bd5ea7	67	.Bx 4.2 .