pamusb-check(1)

Usage

Usage: pamusb-check [--help] [--debug] [--config=path] [--service=name] [--dump] [--quiet] <username>

Overview

pamusb-check can simulate authentication through the pam_usb engine. It is useful for both testing purposes (to check the pam_usb configuration without having to try with a real program), but also for scripting. pamusb-check's exit code is 0 if the authentication was successful, 1 otherwise. It is used by pamusb-agent to check the device.

Examples

$ pamusb-check scox

•: Authentication request for user "scox" (pamusb-check)

•: Device "creative" is connected (good).

•: Access granted.

$ pamusb-check --service=su scox

•: Authentication request for user "scox" (su)

•: Device "creative" is connected (good).

•: Access granted.

$ pamusb-check --dump scox

Configuration dump for user scox (service: pamusb-check):

enable: : true

debug: : false

quiet: : false

color_log: : true

one_time_pad: : true

probe_timeout: : 10

hostname: : helium

system_pad_directory: : .pamusb

device_pad_directory: : .pamusb

Options

--help, -h: Show summary of options.

--debug, -D: Shows debug messages.

--config, -c: Use the given configuration file (defaults to /etc/pamusb.conf). --service, -s Service name to be used for authentication (defaults to pamusb-check)

--dump, -d: Dump the configuration, but do not try to authenticate

--quiet, -q: Quiet mode