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 @@ OPTIONS invocation-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"