How to Use USB Redirector for Linux in USB Server Mode

Installing USB Redirector for Linux in USB server mode

To install USB Redirector for Linux in USB server mode on your computer, you should download and extract an installation package, then execute the following command:

./installer.sh install-server



If you faced any problems during the installation, please read our installation troubleshooting guide.

When installation has completed, usbsrvd daemon should be running in your system. To share or unshare USB devices use usbsrv command-line utility. All further operations are executed with the help of this utility.

usbsrv command-line syntax:

usbsrv <command>

where <command> is one of the following:

-s, -share <device>

Share USB device.

-t, -unshare <device>

Unshare USB device.

-addexclude <device>

Add specified device to exclusion list.

-remexclude <device>

Remove specified device from exclusion list.

-l, -list

Show a list of all USB devices currently present on USB server.

-i, -info

Show current USB server state.

-clients

Show a list of connected USB clients.

-n, -settcpport <port>

Change TCP port number which is used to accept incoming connections.

-autoshareon

Switch to auto-sharing mode.

-autoshareoff

Switch to manual-sharing mode.

<device> is <deviceid> | -vid <vendorid> -pid <productid> -usbport <port>

deviceid

Specific number of USB device in device list.

-vid

USB device Vendor ID.

-pid

USB device Product ID.

-usbport

USB port number as displayed by -list command.

How to get a list of USB devices:

To get a list of USB devices on your USB server, you should execute:


usbsrv -list



Each USB device has its own status:

plugged - USB device is plugged into the computer.

not plugged - USB device is shared, but not currently plugged into the USB port.

initializing - USB device is in pre-sharing state. It should become shared in a moment.

shared - USB device is shared and available for connection by clients.

in use by ... - USB device is shared and connected to the remote client.

in exclusion list - USB device is in the exclusion list and can not be shared.

Sharing a USB device:

As an example, we will share a Flash Disk USB / USB Mass Storage Device that was listed by usbsrv -l command above. To do this, you should execute:


usbsrv -share -vid 0ea0 -pid 2168 -usbport 1-4



Please note! If you plug this device into another USB port, the port number will change.

To share USB device by device id: (1) Flash Disk USB / USB Mass Storage Device you can execute:


usbsrv -share 1



When USB device is shared, it will remain shared even after reboot. Shared devices are not accessible on the local system because they are acquired by USB Redirector to make them available for remote clients. To unshare a device use -unshare command.

Unsharing a USB device:

To unshare a USB Human Interface - Mouse Device, listed on the screenshot above, you need to execute:


usbsrv -unshare -vid 1241 -pid 1166 -port 2-1



To unshare USB device by device id: (18) USB Human Interface - Mouse Device you can execute:


usbsrv -unshare 18



Changing a TCP port which USB Redirector uses to accept incoming connections:

By default USB Redirector accepts incoming connections from clients on 32032 TCP port. To change the port number you can execute:


usbsrv -settcpport <new TCP port number>



Home | Products | Downloads | Purchase | Support | About | Contacts Us