=============================================================================
        Usage
=============================================================================

First start the USB over Network Server:

  $ sudo /opt/ftusbnet/sbin/ftusbnetd

Normally, the server starts in a non-debug mode and is not daemonized.  In this
mode you can stop the server by pressing Ctrl+C in your terminal window. 

To start server in daemon mode use '-d' option.  You will normally need this
option in shell scripts (e.g. if you'd like to start the server every time on
system boot). To learn how to run the server automatically on system start
please refer to your Linux distribution manual.

To see the list of all supported options, run:

  $ /opt/ftusbnet/sbin/ftusbnetd -h

Daemon settings initialization can be done with a configuration file. Further 
daemon management can be done via the graphical user interface application or 
command line utility.

=============================================================================
        Graphical User Interface Application
=============================================================================

GTK+ 3 is required.

To launch the application, just run:

  $ /opt/ftusbnet/bin/ftusbnetgui

=============================================================================
        Command Line Utility
=============================================================================

Run the command line utility:

  $ /opt/ftusbnet/bin/ftusbnetctl <command> [options]

To see the list of all supported commands, run:

  $ /opt/ftusbnet/bin/ftusbnetctl help

To see the list of the devices available:

  $ /opt/ftusbnet/bin/ftusbnetctl list 
  ID         VID: PID: REV           Location  Device name and status 
  107        07d1:3c03:0001               1-2  802.11 bg WLAN /Shared/ 
  202        046d:c045:2730               2-1  USB Optical Mouse /Unshared/

Here the columns are:

  ID - unique device identifier 
  VID:PID:REV - device hardware identifier (vendor ID, product ID, revision)
	Location - USB device topology (can be "unknown" if your system cannot report
             the device topology)
	Device name and status  - displays the name of the device and its current
	           status (shared/unshared/connected)

You can share the device by its unique ID (an example below shows how to share
USB Optical Mouse from the list above):

  $ /opt/ftusbnet/bin/ftusbnetctl share 202

NOTE: Sharing by the device ID allows you to share separately one of the
devices that have identical VID:PID:REV.

To unshare the device use "unshare" command with the same syntax as "share":

  $ /opt/ftusbnet/bin/ftusbnetctl unshare 202


=============================================================================
        Configuration File
=============================================================================

See the configuration file usage details in the default configuration file
"ftusbnet.conf" that is included in the product package.

To import settings from configuration file, start daemon with '-i' option:

  $ sudo /opt/ftusbnet/sbin/ftusbnetd -i ftusbnet.conf

Alternatively, to reinitialize daemon, you can use command line utility:

  $ sudo /opt/ftusbnet/bin/ftusbnetctl import ftusbnet.conf

To export current daemon settings to configuration file:

  $ /opt/ftusbnet/bin/ftusbnetctl export ftusbnet.conf

=============================================================================
        Converting Trial to Full Version
=============================================================================

By default "ftusbnetd" daemon searches for the license key in the following
file "/etc/ftusbnet.key". You should create this file and paste your license
key in it (including the "BEGIN" and "END" lines). Alternatively, you can
specify a custom location of the license key file with the help of '-k'
option:

  $ sudo /opt/ftusbnet/sbin/ftusbnetd -k license.key.file

We can also provide our corporate customers with the License Server, which
allows to add, remove and administrate license keys for FabulaTech products
and allows to use the Floating Licensing model.

To connect to the License Server, start daemon with the -l option:

  $ sudo /opt/ftusbnet/sbin/ftusbnetd -l SERVER
or
  $ sudo /opt/ftusbnet/sbin/ftusbnetd -l SERVER:TCP_PORT

Here:
  SERVER - License Server IP or network name;
  TCP_PORT - TCP port, optional. Default port is 33033.
