Copyright (c) 2002-2005
  NMM work group,
  Computer Graphics Lab,
  Saarland University, Germany,
  http://www.networkmultimedia.org

Permission is granted to copy, distribute and/or modify this document under
the terms of the GNU Free Documentation License, Version 1.2 or any later
version published by the Free Software Foundation; with no Invariant Sections,
no Front-Cover Texts, and no Back-Cover Texts. A copy of the license can be
found in the file COPYING.FDL.

1. Introduction

To manage hardware and software components available on a system, like cameras, TV cards or software decoder, NMM uses an application called serverregistry. The serverregistry enables applications to search and reserve available plugins and prevents requesting already used devices. Furthermore the serverregistry implements some additional features like transactions, or automatic node releasing, if they are not released by the application.

The information about available plugins is stored in a configuration file, that can be found in ~/.nmm/plugins.hostname. This information is used from NMM applications to load required plugins on demand. If you start an NMM application for the first time, this information is created automatically, but you must recreate it whenever you change your hardware configuration or update to another NMM version. Therefore you can either delete the file ~/.nmm/plugins.hostname or you can start the serverregistry with switch -s. ./server_regisry -s.

To start the serverregistry for device managements you must enter ./serverregistry. The serverregistry starts listening on port 22801 to accept incoming connections from applications. If the serverregistry is started the message "serverregistry successfully started!" appears and it accepts some commands from console that are described in section 2. To stop the serverregistry enter 'q' or 'exit' and press enter. If you start the serverregistry application, it accepts the following options:

• -p, --port : Sets the port used by the serverregistry to accept incoming connections

• -s, --save : (Re)creates the plugin information, stores it in the file ~/.nmm/plugins.hostname and exits.

• -l, --load : Loads information about plugins from a specific file.

• -f, --force : Forces loading of all available plugins.

• -d, --debug : Enables the debug stream.

• -e, --error : Enables the error stream.

• -w, --warning : Enables the warning stream.

• -m, --message : Enables the message stream.

• -v, --verbose : Verbose mode (lots of messages!)

• -h, --help : Shows a help message and exits.