Package: tlscli
==========================Telecom Log Service Client==========================Telecom Log Service Client (``tlscli``) is a Python command-line client forCORBA Telecom Log Service.Using it you can:* create a new log* query a log* add or remove log recordsFor more information on the TelecomLogService, see:http://www.omg.org/spec/TLOG/The project is hosted on Launchpad:https://launchpad.net/tlscliExample=======Here's an example session, assuming a Telecom Log Service is running::me@mymachine$ tlscli -ORBInitRef LogMgr=`cat /var/run/corba/tls.ior` listme@mymachine$ tlscli -ORBInitRef LogMgr=`cat /var/run/corba/tls.ior` create0me@mymachine$ tlscli -ORBInitRef LogMgr=`cat /var/run/corba/tls.ior` list0me@mymachine$ tlscli -ORBInitRef LogMgr=`cat /var/run/corba/tls.ior` info 0id: 0QoS: nonemax-record-life: infinitemax-size: unlimitedcurrent-size: 56 bytesrecords: 1log-full-action: wrapadministrative-state: unlockedforwarding-state: onoperational-state: enabledinterval: now - foreveravailability-status: { off-duty: False; full: False }capacity-alarm-thresholds: [100]week-mask:------------------------------------------------------------------------------me@mymachine$ tlscli -ORBInitRef LogMgr=`cat /var/run/corba/tls.ior` write 'Hello world!' to 0me@mymachine$ tlscli -ORBInitRef LogMgr=`cat /var/run/corba/tls.ior` info 0id: 0QoS: nonemax-record-life: infinitemax-size: unlimitedcurrent-size: 57 bytesrecords: 1log-full-action: wrapadministrative-state: unlockedforwarding-state: onoperational-state: enabledinterval: now - foreveravailability-status: { off-duty: False; full: False }capacity-alarm-thresholds: [100]week-mask:------------------------------------------------------------------------------me@mymachine$ tlscli -ORBInitRef LogMgr=`cat /var/run/corba/tls.ior` retrieve 10 after `date +%Y%m%d` from 0id: 1time: Sat Dec 25 17:11:57 2010attributes: []info: Hello world!------------------------------------------------------------------------------This creates a new log with id 0, then write a new log record to it with text ``Hello world``.Prerequisites=============To install ``tlscli``, you need:* a working installation of`omniORBpy <http://omniorb.sourceforge.net/>`_, or a working installation of`PyORBit <https://github.com/GNOME/pyorbit>`_.* `python-dateutil <http://niemeyer.net/python-dateutil>`_To proceed to installation, run the following command from where you unpacked``tlscli``::me@mymachine$ python setup.py install --userThis will automatically install everything needed intoyour ``$HOME/.local`` (``tlscli`` itself will be in ``$HOME/.local/bin``).To run ``tlscli``, you need a Telecom Log Service running somewhere.``tlscli`` is known to work with the following implementations:* ``tao_tls_basic``, ``tao_tls_event`` and ``tao_tls_notify`` providedwith `TAO <http://www.cs.wustl.edu/~schmidt/TAO.html>`_* ``tlserl``, an Erlang implementation available on`bitbucket <https://bitbucket.org/tgg/tlserl/>`_Running=======When invoking ``tlscli`` you need to specify how to connect to the LogMgr.The LogMgr is the object to use to access (or create) logs.This is achieved by specifying an initial reference for the LogMgr, using oneof the three following methods:* add ``-ORBInitRef LogMgr=corbaname:iiop:1.2@MACHINE:PORT#NAME``* add ``-ORBInitRef LogMgr=corbaloc:iiop:1.2@MACHINE:PORT/NAME``* add ``-ORBInitRef LogMgr=IOR:IOR``where ``MACHINE:PORT`` specify where to find a Telecom Log Service (ora Name Service for ``corbaname``), and ``NAME`` is the name to usefor the service (or the Name Service for ``corbaname``).Please read `The corbaloc and corbaname URLs chapter<http://www.ciaranmchale.com/corba-explained-simply/the-corbaloc-and-corbaname-urls.html>`_in the great online free book`CORBA Explained Simply <http://www.ciaranmchale.com/corba-explained-simply/>`_.Commands========Creating a new log------------------To create a new log, use ``tlscli create``. This will return the id of thenewly created log.Querying an existing log------------------------* ``list`` will return the id of all logs available from the given LogMgr.This is the default command if none is specified* ``info`` will return information about an existing log, such as size,record count and current status* ``query`` can be used to search for log records matching a given constraint* ``retrieve`` retrieves a given count of log records before or after thespecified dateModifying an existing log-------------------------* ``write`` adds a new log record to an existing log* ``delete`` removes log records matching a given constraint from an existinglogFor more information on commands, use ``tlscli --help``.