Ignore:
File:
1 edited

Legend:

Unmodified
Added
Removed
  • doc/user-guide/commands.xml

    rd0faf62 r1febf5c  
    244244                </description>
    245245        </bitlbee-command>
    246        
    247         <bitlbee-command name="otr">
    248                 <short-description>Off-the-Record encryption control</short-description>
    249                 <syntax>otr &lt;subcommand&gt; [&lt;arguments&gt;]</syntax>
    250 
    251                 <description>
    252 
    253                         <para>
    254                                 Available subcommands: connect, disconnect, smp, trust, info, keygen, and forget. See <emphasis>help otr &lt;subcommand&gt;</emphasis> for more information.
    255                         </para>
    256 
    257                 </description>
    258                
    259                 <bitlbee-command name="connect">
    260                         <syntax>otr connect &lt;nick&gt;</syntax>
    261                        
    262                         <description>
    263                        
    264                                 <para>
    265                                         Attempts to establish an encrypted connection with the specified user by sending a magic string.
    266                                 </para>
    267                                
    268                         </description>
    269                
    270                 </bitlbee-command>
    271                
    272                 <bitlbee-command name="disconnect">
    273                         <syntax>otr disconnect &lt;nick&gt;</syntax>
    274                        
    275                         <description>
    276                        
    277                                 <para>
    278                                         Resets the connection with the specified user to cleartext.
    279                                 </para>
    280                                
    281                         </description>
    282                
    283                 </bitlbee-command>
    284                
    285                 <bitlbee-command name="smp">
    286                         <syntax>otr smp &lt;nick&gt; &lt;secret&gt;</syntax>
    287                        
    288                         <description>
    289                        
    290                                 <para>
    291                                         Attempts to authenticate the given user's active fingerprint via the Socialist Millionaires' Protocol.
    292                                 </para>
    293                                
    294                                 <para>
    295                                         If an SMP challenge has already been received from the given user, responds with the specified secret. Otherwise, a challenge for the secret will be sent. If the protocol succeeds (i.e. both parties gave the same secret), the fingerprint will be trusted.
    296                                 </para>
    297                                
    298                         </description>
    299                
    300                 </bitlbee-command>
    301                
    302                 <bitlbee-command name="trust">
    303                         <syntax>otr trust &lt;nick&gt; &lt;fp1&gt; &lt;fp2&gt; &lt;fp3&gt; &lt;fp4&gt; &lt;fp5&gt;</syntax>
    304                        
    305                         <description>
    306                        
    307                                 <para>
    308                                         Manually affirms trust in the specified fingerprint, given as five blocks of precisely eight (hexadecimal) digits each.
    309                                 </para>
    310                                
    311                         </description>
    312                
    313                 </bitlbee-command>
    314                
    315                 <bitlbee-command name="info">
    316                         <syntax>otr info</syntax>
    317                         <syntax>otr info &lt;nick&gt;</syntax>
    318                        
    319                         <description>
    320                        
    321                                 <para>
    322                                         Shows information about the OTR state. The first form lists our private keys and current OTR contexts. The second form displays information about the connection with a given user, including the list of their known fingerprints.
    323                                 </para>
    324                                
    325                         </description>
    326                
    327                 </bitlbee-command>
    328                
    329                 <bitlbee-command name="keygen">
    330                         <syntax>otr keygen &lt;account-no&gt;</syntax>
    331                        
    332                         <description>
    333                        
    334                                 <para>
    335                                         Generates a new OTR private key for the given account.
    336                                 </para>
    337                                
    338                         </description>
    339                
    340                 </bitlbee-command>
    341                
    342                 <bitlbee-command name="forget">
    343                         <syntax>otr forget &lt;thing&gt; &lt;arguments&gt;</syntax>
    344                        
    345                         <description>
    346                        
    347                                 <para>
    348                                         Forgets some part of our OTR userstate. Available things: fingerprint, context, and key. See <emphasis>help otr forget &lt;thing&gt;</emphasis> for more information.
    349                                 </para>
    350                        
    351                         </description>
    352                        
    353                         <bitlbee-command name="fingerprint">
    354                                 <syntax>otr forget fingerprint &lt;nick&gt; &lt;fingerprint&gt;</syntax>
    355                                
    356                                 <description>
    357                                
    358                                         <para>
    359                                                 Drops the specified fingerprint from the given user's OTR connection context. It is allowed to specify only a (unique) prefix of the desired fingerprint.
    360                                         </para>
    361                                        
    362                                 </description>
    363                                
    364                         </bitlbee-command>
    365                                
    366                         <bitlbee-command name="context">
    367                                 <syntax>otr forget context &lt;nick&gt;</syntax>
    368                                
    369                                 <description>
    370                                
    371                                         <para>
    372                                                 Forgets the entire OTR context associated with the given user. This includes current message and protocol states, as well as any fingerprints for that user.
    373                                         </para>
    374                                        
    375                                 </description>
    376                                
    377                         </bitlbee-command>
    378 
    379                         <bitlbee-command name="key">
    380                                 <syntax>otr forget key &lt;fingerprint&gt;</syntax>
    381                                
    382                                 <description>
    383                                
    384                                         <para>
    385                                                 Forgets an OTR private key matching the specified fingerprint. It is allowed to specify only a (unique) prefix of the fingerprint.
    386                                         </para>
    387                                        
    388                                 </description>
    389                                
    390                         </bitlbee-command>
    391                
    392                 </bitlbee-command>
    393                
    394         </bitlbee-command>
    395246
    396247        <bitlbee-command name="set">
     
    547398        </bitlbee-setting>
    548399
    549         <bitlbee-setting name="color_encrypted" type="boolean" scope="global">
    550                 <default>true</default>
    551 
    552                 <description>
    553                         <para>
    554                                 If set to true, BitlBee will color incoming encrypted messages according to their fingerprint trust level: untrusted=red, trusted=green.
    555                         </para>
    556                 </description>
    557 
    558         </bitlbee-setting>
    559 
    560400        <bitlbee-setting name="debug" type="boolean" scope="global">
    561401                <default>false</default>
     
    624464        </bitlbee-setting>
    625465
    626         <bitlbee-setting name="halfop_buddies" type="string" scope="global">
    627                 <default>encrypted</default>
    628                 <possible-values>encrypted, trusted, notaway, false</possible-values>
    629 
    630                 <description>
    631                         <para>
    632                                 Specifies under which circumstances BitlBee should give the "halfop" mode flag (+h) to buddies.
    633                         </para>
    634                        
    635                         <para>
    636                                 If "false", the flag is never set. On "notaway", the flag is removed for users marked as "away" and set for all others. On "encrypted", the flag is set for users with whom we have an encrypted connection. On "trusted", it is set only for encrypted connections using a trusted key.
    637                         </para>
    638                 </description>
    639 
    640         </bitlbee-setting>
    641 
    642466        <bitlbee-setting name="lcnicks" type="boolean" scope="global">
    643467                <default>true</default>
     
    662486        </bitlbee-setting>
    663487
    664         <bitlbee-setting name="op_buddies" type="string" scope="global">
    665                 <default>trusted</default>
    666                 <possible-values>encrypted, trusted, notaway, false</possible-values>
    667 
    668                 <description>
    669                         <para>
    670                                 Specifies under which circumstances BitlBee should give the "op" mode flag (+o) to buddies.
    671                         </para>
    672                        
    673                         <para>
    674                                 If "false", the flag is never set. On "notaway", the flag is removed for users marked as "away" and set for all others. On "encrypted", the flag is set for users with whom we have an encrypted connection. On "trusted", it is set only for encrypted connections using a trusted key.
    675                         </para>
    676                 </description>
    677 
    678         </bitlbee-setting>
    679 
    680         <bitlbee-setting name="op_root" type="bool" scope="global">
    681                 <default>true</default>
    682 
    683                 <description>
    684                         <para>
    685                                 Some people prefer themself and root to have operator status in &amp;bitlbee, other people don't. You can set the desired state for root using this setting.
    686                         </para>
    687                 </description>
    688         </bitlbee-setting>
    689 
    690         <bitlbee-setting name="op_user" type="bool" scope="global">
    691                 <default>true</default>
    692 
    693                 <description>
    694                         <para>
    695                                 Some people prefer themself and root to have operator status in &amp;bitlbee, other people don't. You can set the desired state for yourself using this setting.
    696                         </para>
    697                 </description>
    698         </bitlbee-setting>
    699 
    700         <bitlbee-setting name="otr_policy" type="string" scope="global">
    701                 <default>opportunistic</default>
    702                 <possible-values>never, opportunistic, manual, always</possible-values>
    703 
    704                 <description>
    705                         <para>
    706                                 This setting controls the policy for establishing Off-the-Record connections.
    707                         </para>
    708                         <para>
    709                                 A value of "never" effectively disables the OTR subsystem. In "opportunistic" mode, a magic whitespace pattern will be appended to the first message sent to any user. If the peer is also running opportunistic OTR, an encrypted connection will be set up automatically. On "manual", on the other hand, OTR connections must be established explicitly using <emphasis>otr connect</emphasis>. Finally, the setting "always" enforces encrypted communication by causing BitlBee to refuse to send any cleartext messages at all.
     488        <bitlbee-setting name="ops" type="string" scope="global">
     489                <default>both</default>
     490                <possible-values>both, root, user, none</possible-values>
     491
     492                <description>
     493                        <para>
     494                                Some people prefer themself and root to have operator status in &amp;bitlbee, other people don't. You can change these states using this setting.
     495                        </para>
     496
     497                        <para>
     498                                The value "both" means both user and root get ops. "root" means, well, just root. "user" means just the user. "none" means nobody will get operator status.
    710499                        </para>
    711500                </description>
     
    891680                        </para>
    892681                </description>
    893         </bitlbee-setting>
    894 
    895         <bitlbee-setting name="voice_buddies" type="string" scope="global">
    896                 <default>trusted</default>
    897                 <possible-values>encrypted, trusted, notaway, false</possible-values>
    898 
    899                 <description>
    900                         <para>
    901                                 Specifies under which circumstances BitlBee should give the "voice" mode flag (+v) to buddies.
    902                         </para>
    903                        
    904                         <para>
    905                                 If "false", the flag is never set. On "notaway", the flag is removed for users marked as "away" and set for all others. On "encrypted", the flag is set for users with whom we have an encrypted connection. On "trusted", it is set only for encrypted connections using a trusted key.
    906                         </para>
    907                 </description>
    908 
    909682        </bitlbee-setting>
    910683
Note: See TracChangeset for help on using the changeset viewer.