System Reference

From Ndiyo

This page will soon have information on the options to:

• ndiyoadmin
• nivo2vnc
• nivomac2vnc

Until then, running each of the above with a '-h' option should tell you a bit more.

[edit] nivo2vnc

You can run nivo2vnc without any arguments to see the up-to-date list of options. The basic syntax is:

 nivo2vnc -nivo <nivo> -server <vncserver>

A typical example being

 nivo2vnc -nivo 192.168.0.10 -server :30

Options for nivo2vnc:

-nivo nivo

The nivo to use. This can be a dotted IP address or a DNS name.

-server vncserver

The VNC session to display on the nivo. This is of the form host:display as is the convention with VNC. The host may be omitted if it is the local machine. The :display may be omitted if it is :0. Display numbers less than 100 correspond to ports 59xx on the host. Numbers greater than 100 will be taken to be full port numbers.

-passwordfile filename

The name of a file containing the VNC password in encrypted form. This is the same format used on unix machines for the ~/.vnc/passwd file, and can be generated with the vncpasswd command. If your VNC server expects a password, this is how you specify it.

-geometry wxh+x+y

The area of the VNC session which should be displayed on the Nivo. Normally it will be assumed that the Nivo is able to display the resolution of the VNC session, and this can be used to override that by specifying a subsection of the session to display. This is of most use when using multiple nivos to create a multi-screen view onto a single large VNC session.

-locate

List the nivos than can be seen on the network

-locateverbose

List the nivos than can be seen on the network with a little more information

-nivo1

If you have an early Nivo, in the oval aluminium case, you will need to specify this flag.

-keymap filename

This allows you finer control of how Nivo keystrokes becomes VNC keystrokes. See Nivo2vnc Keymap Format for more detailed information.

-reportkeycodes

Shows the key codes that you might need to put into your keymap

[edit] About nivomac2vnc

To use the normal nivo2vnc utility, you need to know the IP address of the Nivo you want to connect to. You can look it up by using nivo2vnc -locate, but unless you have configured your DHCP server to allocate a static one, the IP address of the nivo may change over time, which can be awkward.

The nivomac2vnc utility is a wrapper around nivo2vnc which allows you to use the MAC address of the Nivo, which doesn't change, in place of the IP address. Since many users will not have control over static IP allocation, this is what we use in the standard Upstart scripts.

Other arguments are passed on to nivo2vnc.