1MC-TOOL(1)                         Utilities                        MC-TOOL(1)
2
3
4

NAME

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

SYNOPSIS

9       mc-tool list
10
11       mc-tool add PROFILE DISPLAY-NAME [PARAMETER-SETTINGS...]
12
13       mc-tool add MANAGER/PROTOCOL [PARAMETER-SETTINGS...]
14
15       mc-tool update ACCOUNT [PARAMETER-SETTINGS...]
16
17       mc-tool display ACCOUNT DISPLAY-NAME
18
19       mc-tool nick ACCOUNT NICKNAME
20
21       mc-tool service ACCOUNT SERVICE-NAME
22
23       mc-tool icon ACCOUNT ICON
24
25       mc-tool show ACCOUNT
26
27       mc-tool get ACCOUNT PARAMETER [PARAMETER...]
28
29       mc-tool auto-presence ACCOUNT STATUS [MESSAGE]
30
31       mc-tool request ACCOUNT STATUS [MESSAGE]
32
33       mc-tool auto-connect ACCOUNT on|off
34
35       mc-tool remove ACCOUNT
36

DESCRIPTION

38       mc-tool's usage depends on its first argument (the "command")
39
40
41   SPECIFYING ACCOUNTS
42       Where  an account name is needed, it may be given as a full object path
43       (e.g.  /org/freedesktop/Telepathy/Account/gabble/jabber/example), or as
44       the unique account-specific suffix (e.g.  gabble/jabber/example).
45
46
47   SPECIFYING PARAMETER SETTINGS
48       Many  commands  take arguments that represent Telepathy connection man‐
49       ager parameters (see the Telepathy Specification for details of these).
50       Each argument has the following form:
51
52       TYPE:NAME=VALUE
53
54       where  TYPE is either int, uint, bool, or string (other parameter types
55       exist, but are currently unsupported by mc-tool), NAME is the  name  of
56       the connection manager parameter (e.g.  account or password), and VALUE
57       is the parameter's value (with integers in decimal, and booleans  as  0
58       or 1).
59
60       The  update command also accepts arguments of the form clear:NAME which
61       delete the named parameter from the account configuration.
62
63   LIST
64       mc-tool list lists the available accounts.
65
66
67   ADD
68       mc-tool add adds an account. The connection manager  and  protocol  can
69       either  be  given  as  the  name  of  a  Mission Control profile, (e.g.
70       gtalk), or as a slash-separated connection manager  name  and  protocol
71       (e.g.  gabble/jabber).
72
73
74   DISPLAY
75       mc-tool  display  ACCOUNT DISPLAY-NAME sets the DisplayName property of
76       ACCOUNT to DISPLAY-NAME.
77
78
79   NICK
80       mc-tool nick ACCOUNT NICKNAME sets the Nickname property of ACCOUNT  to
81       NICKNAME.
82
83
84   SERVICE
85       mc-tool  service  ACCOUNT  SERVICE-NAME  sets  the  Service property of
86       ACCOUNT to SERVICE-NAME.
87
88
89   ICON
90       mc-tool icon ACCOUNT ICON sets the Icon property of ACCOUNT to ICON.
91
92
93   SHOW
94       mc-tool show ACCOUNT shows information about ACCOUNT.
95
96
97   GET
98       mc-tool get ACCOUNT PARAMETER [PARAMETER...]  shows the values  of  the
99       given parameters of ACCOUNT.
100
101
102   ENABLE
103       mc-tool enable ACCOUNT sets the Enabled property of ACCOUNT to True.
104
105
106   DISABLE
107       mc-tool disable ACCOUNT sets the Enabled property of ACCOUNT to False.
108
109
110   AUTO-PRESENCE
111       mc-tool  auto-presence ACCOUNT STATUS [MESSAGE] sets the AutomaticPres‐
112       ence property of ACCOUNT to STATUS with optional message MESSAGE.
113
114
115   REQUEST
116       mc-tool request ACCOUNT STATUS  [MESSAGE]  sets  the  RequestedPresence
117       property  of  ACCOUNT  to STATUS with optional message MESSAGE; this is
118       how you tell an account to connect or go offline, for example.
119
120
121   AUTO-CONNECT
122       mc-tool auto-connect ACCOUNT on sets the ConnectAutomatically  property
123       of ACCOUNT to True.  mc-tool auto-connect ACCOUNT off sets it to False.
124
125
126
127Telepathy                          July 2009                        MC-TOOL(1)
Impressum