---
name: "command.reg"
section: "1"
platform: "linux"
package: "groupkit"
version: "3.2-1"
release: "Debian 1.3 (Bo)"
platforms: ["linux"]
url: "https://new.carta.tech/command.reg"
---

# command.reg(1)

simple GroupKit command line registration interface

## NAME

command.reg - simple GroupKit command line registration interface

## SYNOPSIS

- **command.reg ?-p***port*? ?-h*host*? ?*confname*

  ## DESCRIPTION

Command.reg provides a very light-weight command line registrar client.  The idea with command.reg is to allow joining  "standard" conferences very easily, such as a PostIt note conference which would allow placing notes on other users'  screens.  As such, this registrar client could be started up in a .xinitrc file.

If *confname* is omitted, this registrar client will list the names of the currently running conferences.  If *confname* is instead specified, and a conference with that name exists, the user will be joined to that conference. Finally, if the named conference does not exist, command.reg assumes that *confname* is the name of a conference type (e.g. "Brainstorming Tool") and creates a new conference of that type using *confname* as its name.

This registrar client connects to the central registrar, which it locates by examining the "host" and "port" keys in the "registrar" environment, which are usually specified in the user's .groupkitrc file.  If the port is not specified, it defaults to 9068.  The registrar's host and port can be overridden on the command line by specifying the *-h* or *-p* options.

This registrar client remains running until the conference that it spawns terminates.

## BUGS

When creating a new conference, command.reg does not check to see if the specified *confname* corresponds to a valid  conference type, but blindly tries to create it anyway.  This  gets cleaned up when the non-existent conference fails to connect back to the registrar client, but things should not get this far in the first place.

## SEE ALSO

[registrar(1)](/registrar/1.md), gk\_initGenericRC(n)

## AUTHOR

Mark Roseman (roseman@cpsc.ucalgary.ca)
