1. NAME

mc-tool - manipulate Mission Control accounts from the command line

2. SYNOPSIS

mc-tool list

mc-tool add PROFILE DISPLAY-NAME "" [ PARAMETER-SETTINGS ...]

mc-tool add MANAGER / PROTOCOL " [" PARAMETER-SETTINGS ...]

mc-tool update ACCOUNT " [" PARAMETER-SETTINGS ...]

mc-tool display ACCOUNT DISPLAY-NAME

mc-tool nick ACCOUNT NICKNAME

mc-tool icon ACCOUNT ICON

mc-tool show ACCOUNT

mc-tool get ACCOUNT PARAMETER " [" PARAMETER ...]

mc-tool auto-presence ACCOUNT " " STATUS " [" MESSAGE ]

mc-tool request ACCOUNT " " STATUS " [" MESSAGE ]

mc-tool auto-connect ACCOUNT

R on | off

mc-tool remove ACCOUNT

3. DESCRIPTION

R mc-tool 's usage depends on its first argument (the "command")

3.1. SPECIFYING ACCOUNTS

Where an account name is needed, it may be given as a full object path (e.g.

R /org/freedesktop/Telepathy/Account/gabble/jabber/example ), or as the unique account-specific suffix (e.g.

R gabble/jabber/example ).

3.2. SPECIFYING PARAMETER SETTINGS

Many commands take arguments that represent Telepathy connection manager parameters (see the Telepathy Specification for details of these). Each argument has the following form:

.IB TYPE : NAME = VALUE

where TYPE is either

R int

R string (other parameter types exist, but are currently unsupported by

R mc-tool ), NAME is the name of the connection manager parameter (e.g.

R account and VALUE is the parameter's value (with integers in decimal, and booleans as

R 0

The

update command also accepts arguments of the form clear: NAME which delete the named parameter from the account configuration.

3.3. LIST

mc-tool list lists the available accounts.

3.4. ADD

mc-tool add adds an account. The connection manager and protocol can either be given as the name of a Mission Control profile , (e.g.

R gtalk ), or as a slash-separated connection manager name and protocol (e.g.

R gabble/jabber ).

3.5. DISPLAY

mc-tool display ACCOUNT DISPLAY-NAME sets the

DisplayName property of ACCOUNT " to " DISPLAY-NAME.

3.6. NICK

mc-tool nick ACCOUNT NICKNAME sets the

Nickname property of ACCOUNT " to " NICKNAME .

3.7. ICON

mc-tool icon ACCOUNT ICON sets the

Icon property of ACCOUNT " to " ICON .

3.8. SHOW

mc-tool show ACCOUNT shows information about ACCOUNT .

3.9. GET

mc-tool get ACCOUNT PARAMETER " [" PARAMETER ...] shows the values of the given parameters of ACCOUNT .

3.10. ENABLE

mc-tool enable ACCOUNT sets the

Enabled property of ACCOUNT " to"

R True .

3.11. DISABLE

mc-tool disable ACCOUNT sets the

Enabled property of ACCOUNT " to"

R False .

3.12. AUTO-PRESENCE

mc-tool auto-presence ACCOUNT " " STATUS " [" MESSAGE ] sets the

AutomaticPresence property of ACCOUNT " to" STATUS " with optional message " MESSAGE .

3.13. REQUEST

mc-tool request ACCOUNT " " STATUS " [" MESSAGE ] sets the

RequestedPresence property of ACCOUNT " to" STATUS " with optional message " MESSAGE ; this is how you tell an account to connect or go offline, for example.

3.14. AUTO-CONNECT

mc-tool auto-connect ACCOUNT

on sets the

ConnectAutomatically property of ACCOUNT " to"

R True .

mc-tool auto-connect ACCOUNT

off sets it to

R False .