pamusb-check(1) PAM_USB pamusb-check(1)
NAME
pamusb-check - 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 configu-
ration without having to try with a real program), but also for scripting. pamusb-check's exit code is 0 if the authentication was success-
ful, 1 otherwise. It is used by pamusb-agent to check the device.
EXAMPLES
$ pamusb-check scox
o Authentication request for user "scox" (pamusb-check)
o Device "creative" is connected (good).
o Access granted.
$ pamusb-check --service=su scox
o Authentication request for user "scox" (su)
o Device "creative" is connected (good).
o 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 <scox@sig11.org>
September 12, 2007 pamusb-check(1)
