SYSTEMD-ID128(1)

  .SH "NAME" systemd-id128 - Generate and print sd-128 identifiers
  .SH "SYNOPSIS"
    .HP u
      systemd-id128
       [OPTIONS...]
       new

    .HP u
      systemd-id128
       [OPTIONS...]
       machine-id

    .HP u
      systemd-id128
       [OPTIONS...]
       boot-id

    .HP u
      systemd-id128
       [OPTIONS...]
       invocation-id

  .SH "DESCRIPTION"

    .PP id128 may be used to conveniently print sd-id128(3) UUIDs. What identifier is printed depends on the specific verb.
    .PP With new, a new random identifier will be generated.
    .PP With machine-id, the identifier of the current machine will be printed. See machine-id(5).
    .PP With boot-id, the identifier of the current boot will be printed.
    .PP Both machine-id and boot-id may be combined with the --app-specific=app-id switch to generate application-specific IDs. See sd_id128_get_machine(3) for the discussion when this is useful.
    .PP With invocation-id, the identifier of the current service invocation will be printed. This is available in systemd services. See systemd.exec(5).

  .SH "OPTIONS"

    .PP The following options are understood:

      .PP -p, --pretty

            Generate output as programming language snippets.
          .RE
          .PP -a app-id, --app-specific=app-id

                With this option, an identifier that is the result of hashing the application identifier app-id and the machine identifier will be printed. The app-id argument must be a valid sd-id128 string identifying the application.

              .RE
              .PP -h, --help

                  Print a short help text and exit.
              .RE
                  .PP --version

                      Print a short version string and exit.

                  .RE

                  .SH "EXIT STATUS"

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

                  .SH "SEE ALSO"

                    .PP systemd(1), sd-id128(3), sd_id128_get_machine(3)