NAME

ros - Command line utility to list information from RouterOS devices


SYNOPSIS

  ros [options] <host> <command> [arguments]


DESCRIPTION

ros is a command line utility which uses librouteros to connect to a device running RouterOS and issue a command on the device. The result is received and displayed on standard output. The tool was initially written as a simple test application for librouteros but may evolve into something usable.


OPTIONS

The following options are understood:

-u username

Use username when authenticating rather than ``admin'', the default.

-h

Display some usage information and exit.


COMMANDS

You can use one of two possibilities to issue commands. Generic commands start with a slash and follow the low-level syntax closely. For example:

  ros router.example.com '/ip/address/print'

Besides this generic approach, ros can also handle the high-level interfaces provided by librouteros. Currently the following special ``built-in'' commands are available:

interface

Display information about each interface, including byte counters.

registration-table

Display information about current wireless connections.

system-resource

Display generic system information, such as memory used and CPU load.


LICENSE

ros is licensed under the GPLv2. No other version of the license is applicable.


AUTHOR

ros is written by Florian octo Forster <octo at verplant.org>. Its homepage can be found at http://verplant.org/librouteros/.

(c) 2009 by Florian octo Forster.