.
1. NAME▲
mc-tool - manipulate Mission Control accounts from the command line
2. SYNOPSIS ▲
mc-tool list
mc-tool add PROFILEDISPLAY-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 TYPEis either
R int
R string (other parameter types exist, but are currently unsupported by
R mc-tool ), NAMEis the name of the connection manager parameter (e.g.
R account and VALUEis 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-NAMEsets the
DisplayName property of ACCOUNT " to " DISPLAY-NAME.
3.6. NICK ▲
mc-tool nick ACCOUNT NICKNAMEsets the
Nickname property of ACCOUNT " to " NICKNAME .
3.7. ICON ▲
mc-tool icon ACCOUNT ICONsets the
Icon property of ACCOUNT " to " ICON .
3.8. SHOW ▲
mc-tool show ACCOUNTshows 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 ACCOUNTsets the
Enabled property of ACCOUNT " to"
R True .
3.11. DISABLE ▲
mc-tool disable ACCOUNTsets 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 .
