NAME¶

zgenhostid — generate and store a hostid in /etc/hostid

SYNOPSIS¶

DESCRIPTION¶

Creates /etc/hostid file and stores hostid in it. If the user provides [hostid] on the command line, validates and stores that value. Otherwise, randomly generates a value to store.

-h

Display a summary of the command-line options.

-f

Force file overwrite.

-o filename

Write to filename instead of default /etc/hostd

hostid

Specifies the value to be placed in /etc/hostid. It should be a number with a value between 1 and 2^32-1. If it is 0, zgenhostid will generate a random hostid. This value must be unique among your systems. It must be expressed in hexadecimal and be exactly 8 digits long, optionally prefixed by 0x.

FILES¶

/etc/hostid

EXAMPLES¶

Generate a random hostid and store it

# zgenhostid

Record the libc-generated hostid in /etc/hostid

# zgenhostid "$(hostid)"

Record a custom hostid (0xdeadbeef) in /etc/hostid

# zgenhostid deadbeef

Record a custom hostid (0x01234567) in /tmp/hostid

and ovewrite the file if it exists

# zgenhostid -f -o /tmp/hostid 0x01234567

SEE ALSO¶

genhostid(1), hostid(1), sethostid(3), spl-module-parameters(5)

HISTORY¶

zgenhostid emulates the genhostid(1) utility and is provided for use on systems which do not include the utility or do not provide sethostid(3) call.