---
name: "pamusb-check"
section: "1"
platform: "linux"
package: "pamusb-common"
version: "0.5.0-4"
release: "Debian 8 (Jessie)"
platforms: ["linux"]
url: "https://new.carta.tech/pamusb-check"
---

# pamusb-check(1)

simulates pam\_usb authentication

## 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 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 \<scox@sig11.org\>