This directory contains a Docker container for running CmdpcProx.
It is based on the Debian 9.5-slim Docker base image.
This is a very bare-bones image, only intended to offer some isolation around
the CmdpcProx utility (such as disabling host network and filesystem access).
Note: This will only work on native Docker for Linux. It will not run in a virtualised or cloud Docker environment, nor non-Linux platforms, nor architectures other than amd64 and i686.
- Install Docker on your system.
- Download CmdpcProx for Linux into this directory.
- Build the image:
docker build -t cmdpcprox .
Note: Building the image requires an internet connection to fetch the Docker images, and to also fetch a dependency from Debian's apt repository.
Connect the pcProx to your PC, and find it's USB device node using lsusb:
$ lsusb
Bus 001 Device 002: ID 0c27:3bfa RFIDeas, Inc pcProx Card Reader
The bus and device numbers shown here will be different for your computer. They will also change if the pcProx is reconnected.
Then, run the container using the absolute path to the USB device node
(/dev/bus/usb/$BUS/$DEVICE):
$ docker run --network none --device /dev/bus/usb/001/002 -it pcprox
You'll then get a (root) shell from which you can interact with CmdpcProx:
root@1a2b3c4d:/# CmdpcProx
------------------------------------------------------------------------------
CmdpcProx for USB devices Version 0.9.0a (Beta) Copyright 2010 RFIDeas. For Linux
Usage: switch=value ...
CmdpcProx -version
When you're done, exit that shell.
Note: Docker will automatically delete any modified files after you exit the shell. If you want to back up your configuration, you should copy it out of the container first.
All pcProx configuration files are plain text, and can be displayed in
cat.
You can sniff communications between CmdpcProx and the pcProx using the
usbmon kernel module. Wireshark offers a good GUI front-end to this.