Configuration file
During normal operation, the daemon stores all user actions and does not require a configuration file at every launch. Configuration file can be used for daemon reinitialization (all settings are reset and default ones are imported from the config). An example configuration file is included in the product package as ftusbrdp.conf.
To reinitialize the daemon, start it with -i option:
$ sudo /opt/ftusbrdp/sbin/ftusbrdpd -i /opt/ftusbrdp/doc/ftusbrdp.conf
Alternatively, you can use command line utility:
$ sudo /opt/ftusbrdp/bin/ftusbrdpctl import /opt/ftusbrdp/doc/ftusbrdp.conf
To export current daemon settings to the configuration file:
$ /opt/ftusbrdp/bin/ftusbrdpctl export /opt/ftusbrdp/doc/ftusbrdp.conf
Example configuration file:
#
# This is the default configuration file for USB for Remote Desktop
# Workstation.
#
# This configuration file is INI formatted file. It is composed of sections,
# properties and values. Section "daemon options" describes general server
# settings. Each other section describes a device or a group of devices.
# The following properties serve as a key of a device description and are
# presented in the order of priority, from the most priority to the least
# priority: serial, port, vid (hwid), pid (hwid), revision (hwid),
# class (class-code), subclass (class-code), protocol (class-code).
#
# For example, if there are two sections for the same device, one with serial
# and the other with hwid, the section with serial wins and the properties that
# describe device behavior will be applied to the device.
# The value of hwid property must be specified in hex separating vid, pid and
# revision with ":". Revision and pid values may be omitted. Values of
# class-code must be specified in hex separating class, subclass and protocol
# with ":". Subclass and protocol values may be omitted. The value of port
# property has the following format: bus_number.[port[.port...]]. It is
# possible to use "-" as separator.
#
# The following properties change the behavior of the device: share, postpone,
# takeaway, no-reset, override-serial, override-name, password. The meaning
# of them is given in the example below.
#
# Care must be taken with sharing HID devices. They will be shared if their
# hardware Id (hwid) is specified explicitly:
# hwid = vid:pid
# It is done with the purpose not to lose keyboards and mice connected to the
# server host.
#
# Here is an example. Uncomment to change the default behavior.
#
# [daemon options]
# keepalive-timeout=45 # Override network keepalive timeout in seconds
# keepalive-interval=15 # Override network keepalive tick interval in seconds
#
# [the device]
# hwid=0930:6545
# serial="12345678"
# port=1.2.3
# class-code=08:06:50
# share=true # Make the device available for connecting
# share-interface=0x03 # Make only selected interface of composite device
# available for connecting
# postpone=true # Allow local use of the device until Client
# # connects (take the device away from the system
# # only on network connection)
# takeaway=true # Allow Client to withdraw the device (if occupied by
# # another Client)
# password="secret" # Restrict access to the device with the password
# override-serial="87654321" # Assign new serial number
# override-name="My Thumb Drive" # Assign new device description
# no-reset=true # Don't reset the device after disconnect
# ignore-set-same-configuration=true # Avoid issuing USB device configuration
# # requests when the device is already
# # operating with the specified
# # configuration
# Other examples.
#
# [my microphones]
# class-code=01 # Audio
# share=true
# postpone=true
# takeaway=true
#
# [my flash drive]
# hwid=046d:08c1
# serial="FFB5566754"
# share=true
# no-reset=true
# override-name="My Disk"
# override-serial="AACC56789"
#
# [raspberry pi network card]
# hwid=0424:ec00:0200
# share=false
#
# [all]
# share=true
#
# [shared port]
# port=2-2.6
# share=true
[all]
postpone=true
share=true