Hsolinkcontrol an Internet connection utility

Hsolinkcontrol is a command line support utility for HSOconnect. It is an executable with limited features to minimise risks. It's purpose is to control the state of the Internet connection.

hsolinkcontrol needs you to give it root privileges. This is because it controls some system resources every time you connect and disconnect from the Internet.

The Debian package will set this for you. For the RPM and TAR.GZ packages please type the following command in a console:

sudo chmod +s `which hsolinkcontrol`

If you install the source package (tar.gz) and also the RPM or DEB packages then you will have two copies of hsolinkcontrol installed. The DEB and RPM packages install it in /usr/bin/hsolinkcontrol but the tar.gz package installs in to /usr/local/bin/hsolinkcontrol. Your $PATH environment variable will determine which is executed.

Visit the HSOconnect Support Forum

Download the latest version

Compiling from Source

If you are running a 32-bit system that uses Debian package management or RPMs  you do not need to compile this progam!

To compile the program these are the steps to follow:

Download the tar.gz package to a directory on your machine and open up a console. Change to the download directory and as the root user run the following commands:

hsolinkcontrol man page

NAME
       hsolinkcontrol - application helper to manage the Option hso interface

SYNOPSIS
       hsolinkcontrol [down port_num | up port_num dns1 dns2 ip ]

DESCRIPTION
       hsolinkcontrol  manages the hso IP link on behalf of connection manager
       programs; handling the low level tasks of  bringing  up  the  link  and
       tearing it down again.  hsolinkcontrol controls the update of the rout-
       ing table, resolv.conf and calls ifconfig for hso?.

       If resolvconf(8)
        is installed it will use that program instead of directly manipulating
       /etc/resolv.conf.

OPTIONS
       down port_num
              Bring  down hso[port_num] link. If resolvconf was used then also
              delete hso[port_num] from routing  table.   E.g.  hsolinkcontrol
              down 0 Which brings down the hso[port_num] link if it exists.

       up port_num dns1 dns2 ip
              Start up hso[port_num] link,  calling ifconfig then updating the
              routing table and  /etc/resolv.conf.  By the time hsolinkcontrol
              is  called  by  a connection manager application the network PDP
              context  has already been defined and started.  E.g. hsolinkcon-
              trol up 1

       unbind driver end-point
              Where      driver      is      typically      the      directory
              "/sys/bus/usb/drivers/hso/" and end-point is one of those listed
              in  the  directory. The purpose is to disconnect the driver from
              the end point. This may help unblock the  driver  (not  sure  if
              this is required).

       bind driver end-point
              Where      driver      is      typically      the      directory
              "/sys/bus/usb/drivers/hso/" and end-point is one of those listed
              in  the directory. The purpose is to re-assign the driver to the
              end point following a corresponding unbind.

FILES
       If hsolinkcontrol directly manages the /etc/resolv.conf  file  then  it
       will   create   /etc/resolv.conf.hsoc.tmp  to  hold  the  old  copy  of
       /etc/resolv.conf which is restored when the link is brought down.

ENVIRONMENT
       None

DIAGNOSTICS
: