carta
pamu2fcfg(1)

pamu2fcfg1

Configuration tool for the u2f pam module.

Usage

pamu2fcfg [OPTION] ...

Overview

Perform a FIDO2/U2F registration procedure using a connected authenticator and output a configuration line that can be used with the U2F PAM module.

Options

-d, --debug

Print debug information (highly verbose)

-h, --help

Print help and exit

-o, --origin=STRING

Set the FIDO2 relying party ID to use during registration. Defaults to pam://hostname. Before pamu2fcfg v1.1.0, this set the U2F origin URL.

-i, --appid=STRING

Set the FIDO2 relying party name to use during registration. Defaults to origin. Before pamu2fcfg v1.1.0, this set the U2F application ID.

-r, --resident

Generate a resident credential. Defaults to off.

-t, --type=STRING

COSE type to use during registration (ES256, EDDSA, or RS256). Defaults to ES256.

-P, --no-user-presence

Allow using the credential without ensuring the user’s presence. Defaults to off.

-N, --pin-verification

Require PIN verification during authentication. Defaults to off.

-V, --user-verification

Require user verification during authentication. Defaults to off.

--version: Print version and exit

-u, --username=STRING

The name of the user registering the device. Defaults to the current user name.

-n, --nouser

Print only registration information (key handle, public key, and options). Useful for appending.

History

  • Arch Linux 2026-11-01: the text shown here
  • Debian 13 (Trixie)
  • Debian 12 (Bookworm) to Debian 11 (Bullseye)
  • Debian 10 (Buster)
  • Debian 9 (Stretch)

--no-user-presence since Debian 11 (Bullseye); --pin-verification since Debian 11 (Bullseye); --resident since Debian 11 (Bullseye); --type since Debian 11 (Bullseye); --user-verification since Debian 11 (Bullseye); -N since Debian 11 (Bullseye); -P since Debian 11 (Bullseye); -V since Debian 11 (Bullseye); -r since Debian 11 (Bullseye); -t since Debian 11 (Bullseye).

Bugs

Report pamu2fcfg bugs in the issue tracker: https://github.com/Yubico/pam-u2f/issues

From pam-u2f 1.4.0-2 in Arch Linux 2026-11-01. Parsed by carta from the page's man source.