pamusb-check(1) simulates pam_usb authentication

SYNOPSIS


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

DESCRIPTION

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

BUGS

Please send bug reports to the pam_usb mailing list.

AUTHOR

Andrea Luzzardi <[email protected]>