2017-07-19 01:11:08 +00:00
|
|
|
.\"
|
|
|
|
.\" CDDL HEADER START
|
|
|
|
.\"
|
|
|
|
.\" 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.
|
|
|
|
.\"
|
|
|
|
.\" 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.
|
|
|
|
.\"
|
|
|
|
.\" 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]
|
|
|
|
.\"
|
|
|
|
.\" CDDL HEADER END
|
|
|
|
.\"
|
|
|
|
.\"
|
|
|
|
.\" Copyright (c) 2017 by Lawrence Livermore National Security, LLC.
|
|
|
|
.\"
|
2021-05-26 12:04:48 +00:00
|
|
|
.Dd May 26, 2021
|
2017-07-19 01:11:08 +00:00
|
|
|
.Dt ZGENHOSTID 8 SMM
|
2020-08-21 18:55:47 +00:00
|
|
|
.Os
|
2017-07-19 01:11:08 +00:00
|
|
|
.Sh NAME
|
|
|
|
.Nm zgenhostid
|
|
|
|
.Nd generate and store a hostid in
|
|
|
|
.Em /etc/hostid
|
|
|
|
.Sh SYNOPSIS
|
|
|
|
.Nm
|
2020-09-16 19:25:12 +00:00
|
|
|
.Op Fl f
|
|
|
|
.Op Fl o Ar filename
|
2017-07-19 01:11:08 +00:00
|
|
|
.Op Ar hostid
|
|
|
|
.Sh DESCRIPTION
|
2020-09-16 19:25:12 +00:00
|
|
|
Creates
|
|
|
|
.Pa /etc/hostid
|
|
|
|
file and stores hostid in it.
|
|
|
|
If the user provides
|
2017-07-19 01:11:08 +00:00
|
|
|
.Op Ar hostid
|
2020-09-16 19:25:12 +00:00
|
|
|
on the command line, validates and stores that value.
|
|
|
|
Otherwise, randomly generates a value to store.
|
|
|
|
.Bl -tag -width "hostid"
|
|
|
|
.It Fl h
|
|
|
|
Display a summary of the command-line options.
|
|
|
|
.It Fl f
|
|
|
|
Force file overwrite.
|
|
|
|
.It Fl o Ar filename
|
|
|
|
Write to
|
|
|
|
.Pa filename
|
|
|
|
instead of default
|
2021-03-20 05:39:42 +00:00
|
|
|
.Pa /etc/hostid
|
2020-09-16 19:25:12 +00:00
|
|
|
.It Ar hostid
|
2017-07-19 01:11:08 +00:00
|
|
|
Specifies the value to be placed in
|
2020-09-16 19:25:12 +00:00
|
|
|
.Pa /etc/hostid .
|
zgenhostid: accept hostid arguments equal to zero.
A common usage pattern for zgenhostid, including in the ZFS dracut
module, is running it as:
zgenhostid $(hostid)
However, zgenhostid only accepted hostid arguments greater than 0, which
meant that, when the output of hostid(1) was "00000000", zgenhostid
would error out, even though 0 is a possible return value for the
gethostid(3) function used by hostid(1):
- On current musl libc, gethostid(3) is a stub that always returns 0.
- On glibc, gethostid(3) will return 0 if /etc/hostid exists but is
smaller than 4 bytes.
In these cases, it makes more sense for zgenhostid to treat a value of 0
as other parts of the zfs codebase do, meaning that a hostid value
couldn't be determined; therefore, it should attempt to generate a
random value to write into /etc/hostid.
The manpage and usage output have been updated to reflect this.
Whitespace has also been fixed in the usage output.
Reviewed-by: Brian Behlendorf <behlendorf1@llnl.gov>
Reviewed-by: Georgy Yakovlev <gyakovlev@gentoo.org>
Reviewed-by: Andrew J. Hesford <ajh@sideband.org>
Signed-off-by: Érico Rolim <erico.erc@gmail.com>
Closes #11174
Closes #11189
2020-11-10 14:22:27 +00:00
|
|
|
It should be a number with a value between 1 and 2^32-1.
|
|
|
|
If it is 0, zgenhostid will generate a random hostid.
|
2020-09-16 19:25:12 +00:00
|
|
|
This value
|
2017-07-19 01:11:08 +00:00
|
|
|
.Sy must
|
2020-09-16 19:25:12 +00:00
|
|
|
be unique among your systems.
|
|
|
|
It
|
|
|
|
.Sy must
|
|
|
|
be expressed in hexadecimal and be exactly
|
|
|
|
.Em 8
|
|
|
|
digits long, optionally prefixed by
|
|
|
|
.Em 0x .
|
|
|
|
.El
|
|
|
|
.Sh FILES
|
|
|
|
.Pa /etc/hostid
|
2017-07-19 01:11:08 +00:00
|
|
|
.Sh EXAMPLES
|
2020-09-16 19:25:12 +00:00
|
|
|
.Bl -tag -width Bd
|
2017-07-19 01:11:08 +00:00
|
|
|
.It Generate a random hostid and store it
|
2021-05-26 12:04:48 +00:00
|
|
|
.Dl # zgenhostid
|
2020-09-16 19:25:12 +00:00
|
|
|
.It Record the libc-generated hostid in Pa /etc/hostid
|
2021-05-26 12:04:48 +00:00
|
|
|
.Dl # zgenhostid "$(hostid)"
|
2020-09-16 19:25:12 +00:00
|
|
|
.It Record a custom hostid (0xdeadbeef) in Pa /etc/hostid
|
2021-05-26 12:04:48 +00:00
|
|
|
.Dl # zgenhostid deadbeef
|
|
|
|
.It Record a custom hostid (0x01234567) in Pa /tmp/hostid No and ovewrite the file if it exists
|
|
|
|
.Dl # zgenhostid -f -o /tmp/hostid 0x01234567
|
2017-07-19 01:11:08 +00:00
|
|
|
.El
|
|
|
|
.Sh SEE ALSO
|
|
|
|
.Xr genhostid 1 ,
|
2017-09-16 17:51:24 +00:00
|
|
|
.Xr hostid 1 ,
|
2020-09-16 19:25:12 +00:00
|
|
|
.Xr sethostid 3 ,
|
2021-06-04 20:29:26 +00:00
|
|
|
.Xr spl 4
|
2020-09-16 19:25:12 +00:00
|
|
|
.Sh HISTORY
|
|
|
|
.Nm
|
|
|
|
emulates the
|
|
|
|
.Xr genhostid 1
|
|
|
|
utility and is provided for use on systems which
|
2021-05-26 12:04:48 +00:00
|
|
|
do not include the utility or do not provide the
|
2020-09-16 19:25:12 +00:00
|
|
|
.Xr sethostid 3
|
|
|
|
call.
|