1SYSTEMD-ID128(1) systemd-id128 SYSTEMD-ID128(1)
2
3
4
6 systemd-id128 - Generate and print sd-128 identifiers
7
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
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
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
65 On success, 0 is returned, a non-zero failure code otherwise.
66
68 systemd(1), sd-id128(3), sd_id128_get_machine(3)
69
71 1. wikipedia
72 https://en.wikipedia.org/wiki/Universally_unique_identifier#Format
73
74
75
76systemd 249 SYSTEMD-ID128(1)