1SYSTEMD-ID128(1)                 systemd-id128                SYSTEMD-ID128(1)
2
3
4

NAME

6       systemd-id128 - Generate and print sd-128 identifiers
7

SYNOPSIS

9       systemd-id128 [OPTIONS...] new
10
11       systemd-id128 [OPTIONS...] machine-id
12
13       systemd-id128 [OPTIONS...] boot-id
14
15       systemd-id128 [OPTIONS...] invocation-id
16

DESCRIPTION

18       id128 may be used to conveniently print sd-id128(3) UUIDs. What
19       identifier is printed depends on the specific verb.
20
21       With new, a new random identifier will be generated.
22
23       With machine-id, the identifier of the current machine will be printed.
24       See machine-id(5).
25
26       With boot-id, the identifier of the current boot will be printed.
27
28       Both machine-id and boot-id may be combined with the
29       --app-specific=app-id switch to generate application-specific IDs. See
30       sd_id128_get_machine(3) for the discussion when this is useful.
31
32       With invocation-id, the identifier of the current service invocation
33       will be printed. This is available in systemd services. See
34       systemd.exec(5).
35
36       With show, well-known UUIDs are printed. When no arguments are
37       specified, all known UUIDs are shown. When arguments are specified,
38       they must be the names or values of one or more known UUIDs, which are
39       then printed.
40

OPTIONS

42       The following options are understood:
43
44       -p, --pretty
45           Generate output as programming language snippets.
46
47       -a app-id, --app-specific=app-id
48           With this option, an identifier that is the result of hashing the
49           application identifier app-id and the machine identifier will be
50           printed. The app-id argument must be a valid sd-id128 string
51           identifying the application.
52
53       -u, --uuid
54           Generate output as an UUID formatted in the "canonical
55           representation", with five groups of digits separated by hyphens.
56           See the wikipedia[1] for more discussion.
57
58       -h, --help
59           Print a short help text and exit.
60
61       --version
62           Print a short version string and exit.
63

EXIT STATUS

65       On success, 0 is returned, a non-zero failure code otherwise.
66

SEE ALSO

68       systemd(1), sd-id128(3), sd_id128_get_machine(3)
69

NOTES

71        1. wikipedia
72           https://en.wikipedia.org/wiki/Universally_unique_identifier#Format
73
74
75
76systemd 248                                                   SYSTEMD-ID128(1)