Archive-Team
/
zfs
2
0
Fork 0
Code Issues Pull Requests Packages Projects Releases 103 Wiki Activity

zgenhostid.8: revisit 

Reviewed-by: Richard Laager <rlaager@wiktel.com>
Reviewed-by: Brian Behlendorf <behlendorf1@llnl.gov>
Signed-off-by: Ahelenia Ziemiańska <nabijaczleweli@nabijaczleweli.xyz>
Closes #12212
This commit is contained in:
наб 2021-06-04 22:43:21 +02:00 committed by Brian Behlendorf
parent 1b37cc1abe
commit 4b7ed6a286
1 changed files with 33 additions and 27 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

60
man/man8/zgenhostid.8
View File

@ -18,72 +18,78 @@
.\" .\"
.\" CDDL HEADER END .\" CDDL HEADER END
.\" .\"
.\"
.\" Copyright (c) 2017 by Lawrence Livermore National Security, LLC. .\" Copyright (c) 2017 by Lawrence Livermore National Security, LLC.
.\" .\"
.Dd May 26, 2021 .Dd May 26, 2021
.Dt ZGENHOSTID 8 SMM .Dt ZGENHOSTID 8
.Os .Os
.
.Sh NAME .Sh NAME
.Nm zgenhostid .Nm zgenhostid
.Nd generate and store a hostid in .Nd generate host ID into /etc/hostid
.Em /etc/hostid
.Sh SYNOPSIS .Sh SYNOPSIS
.Nm .Nm
.Op Fl f .Op Fl f
.Op Fl o Ar filename .Op Fl o Ar filename
.Op Ar hostid .Op Ar hostid
.
.Sh DESCRIPTION .Sh DESCRIPTION
Creates Creates
.Pa /etc/hostid .Pa /etc/hostid
file and stores hostid in it. file and stores the host ID in it.
If the user provides If
.Op Ar hostid .Ar hostid
on the command line, validates and stores that value. was provided, validate and store that value.
Otherwise, randomly generates a value to store. Otherwise, randomly generate an ID.
.Bl -tag -width "hostid" .
.Sh OPTIONS
.Bl -tag -width "-o filename"
.It Fl h .It Fl h
Display a summary of the command-line options. Display a summary of the command-line options.
.It Fl f .It Fl f
Force file overwrite. Allow output overwrite.
.It Fl o Ar filename .It Fl o Ar filename
Write to Write to
.Pa filename .Pa filename
instead of default instead of the default
.Pa /etc/hostid .Pa /etc/hostid .
.It Ar hostid .It Ar hostid
Specifies the value to be placed in Specifies the value to be placed in
.Pa /etc/hostid . .Pa /etc/hostid .
It should be a number with a value between 1 and 2^32-1. It should be a number with a value between 1 and 2^32-1.
If it is 0, zgenhostid will generate a random hostid. If
.Sy 0 ,
generate a random ID.
This value This value
.Sy must .Em must
be unique among your systems. be unique among your systems.
It It
.Sy must .Em must
be expressed in hexadecimal and be exactly be an 8-digit-long hexadecimal number, optionally prefixed by
.Em 8 .Qq 0x .
digits long, optionally prefixed by
.Em 0x .
.El .El
.
.Sh FILES .Sh FILES
.Pa /etc/hostid .Pa /etc/hostid
.
.Sh EXAMPLES .Sh EXAMPLES
.Bl -tag -width Bd .Bl -tag -width Bd
.It Generate a random hostid and store it .It Generate a random hostid and store it
.Dl # zgenhostid .Dl # Nm
.It Record the libc-generated hostid in Pa /etc/hostid .It Record the libc-generated hostid in Pa /etc/hostid
.Dl # zgenhostid "$(hostid)" .Dl # Nm Qq $ Ns Pq Nm hostid
.It Record a custom hostid (0xdeadbeef) in Pa /etc/hostid .It Record a custom hostid Po Ar 0xdeadbeef Pc in Pa /etc/hostid
.Dl # zgenhostid deadbeef .Dl # Nm Ar deadbeef
.It Record a custom hostid (0x01234567) in Pa /tmp/hostid No and ovewrite the file if it exists .It Record a custom hostid Po Ar 0x01234567 Pc in Pa /tmp/hostid No and ovewrite the file if it exists
.Dl # zgenhostid -f -o /tmp/hostid 0x01234567 .Dl # Nm Fl f o Ar /tmp/hostid 0x01234567
.El .El
.
.Sh SEE ALSO .Sh SEE ALSO
.Xr genhostid 1 , .Xr genhostid 1 ,
.Xr hostid 1 , .Xr hostid 1 ,
.Xr sethostid 3 , .Xr sethostid 3 ,
.Xr spl 4 .Xr spl 4
.
.Sh HISTORY .Sh HISTORY
.Nm .Nm
emulates the emulates the
@ -91,4 +97,4 @@ emulates the
utility and is provided for use on systems which utility and is provided for use on systems which
do not include the utility or do not provide the do not include the utility or do not provide the
.Xr sethostid 3 .Xr sethostid 3
call. function.