4 .\" The contents of this file are subject to the terms of the
5 .\" Common Development and Distribution License (the "License").
6 .\" You may not use this file except in compliance with the License.
8 .\" You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE
9 .\" or http://www.opensolaris.org/os/licensing.
10 .\" See the License for the specific language governing permissions
11 .\" and limitations under the License.
13 .\" When distributing Covered Code, include this CDDL HEADER in each
14 .\" file and include the License file at usr/src/OPENSOLARIS.LICENSE.
15 .\" If applicable, add the following below this CDDL HEADER, with the
16 .\" fields enclosed by brackets "[]" replaced with your own identifying
17 .\" information: Portions Copyright [yyyy] [name of copyright owner]
22 .\" Copyright (c) 2017 by Lawrence Livermore National Security, LLC.
29 .Nd generate and store a hostid in
37 does not exist, create it and store a hostid in it. If the user provides
39 on the command line, store that value. Otherwise, randomly generate a
44 utility and is provided for use on systems which do not include the utility.
47 Specifies the value to be placed in
49 It must be a number with a value between 1 and 2^32-1. This value
51 be unique among your systems. It must be expressed in hexadecimal and be
52 exactly 8 digits long.
55 .It Generate a random hostid and store it
59 .It Record the libc-generated hostid in Em /etc/hostid
61 # zgenhostid $(hostid)
63 .It Record a custom hostid (0xdeadbeef) in Em etc/hostid
71 .Xr spl-module-parameters 5