diff --git a/man/systemd-id128.xml b/man/systemd-id128.xml
index 6cb51fa777f..c4521ea945f 100644
--- a/man/systemd-id128.xml
+++ b/man/systemd-id128.xml
@@ -44,6 +44,13 @@
OPTIONSinvocation-id
+
+
+ systemd-id128
+ OPTIONS
+ show
+ NAME|UUID
+
@@ -76,9 +83,10 @@
With show, well-known IDs are printed (for now, only GPT partition type UUIDs),
along with brief identifier strings. When no arguments are specified, all known IDs are shown. When
- arguments are specified, they must be the identifiers or ID values of one or more known IDs, which are
- then printed. Combine with to list the IDs in UUID style, i.e. the way GPT
- partition type UUIDs are usually shown.
+ arguments are specified, they may be the identifiers or ID values of one or more known IDs, which are
+ then printed with their name, or arbitrary IDs, which are then printed with a placeholder name. Combine
+ with to list the IDs in UUID style, i.e. the way GPT partition type UUIDs are
+ usually shown.
@@ -137,7 +145,26 @@
Exit status
- On success, 0 is returned, a non-zero failure code otherwise.
+ On success 0 is returned, and a non-zero failure code otherwise.
+
+
+
+ Examples
+
+
+ Show a well-known UUID
+
+$ systemd-id128 show -P user-home
+773f91ef66d449b5bd83d683bf40ad16
+
+$ systemd-id128 show -Pu user-home
+773f91ef-66d4-49b5-bd83-d683bf40ad16
+
+$ systemd-id128 show 773f91ef-66d4-49b5-bd83-d683bf40ad16
+NAME ID
+user-home 773f91ef66d449b5bd83d683bf40ad16
+
+
diff --git a/src/id128/id128.c b/src/id128/id128.c
index c22376d4fcd..0ec2df059a5 100644
--- a/src/id128/id128.c
+++ b/src/id128/id128.c
@@ -166,7 +166,7 @@ static int help(void) {
" machine-id Print the ID of current machine\n"
" boot-id Print the ID of current boot\n"
" invocation-id Print the ID of current invocation\n"
- " show [NAME] Print one or more well-known GPT partition type IDs\n"
+ " show [NAME|UUID] Print one or more UUIDs\n"
" help Show this help\n"
"\nOptions:\n"
" -h --help Show this help\n"