Ignore:
File:
1 edited

Legend:

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

    r903a2fc 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 and context. 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>
    380                
    381         </bitlbee-command>
    382246
    383247        <bitlbee-command name="set">
     
    534398        </bitlbee-setting>
    535399
    536         <bitlbee-setting name="color_encrypted" type="boolean" scope="global">
    537                 <default>true</default>
    538 
    539                 <description>
    540                         <para>
    541                                 If set to true, BitlBee will color incoming encrypted messages according to their fingerprint trust level: untrusted=red, trusted=green.
    542                         </para>
    543                 </description>
    544 
    545         </bitlbee-setting>
    546 
    547400        <bitlbee-setting name="debug" type="boolean" scope="global">
    548401                <default>false</default>
     
    611464        </bitlbee-setting>
    612465
    613         <bitlbee-setting name="halfop_buddies" type="string" scope="global">
    614                 <default>encrypted</default>
    615                 <possible-values>encrypted, trusted, notaway, false</possible-values>
    616 
    617                 <description>
    618                         <para>
    619                                 Specifies under which circumstances BitlBee should give the "halfop" mode flag (+h) to buddies.
    620                         </para>
    621                        
    622                         <para>
    623                                 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.
    624                         </para>
    625                 </description>
    626 
    627         </bitlbee-setting>
    628 
    629466        <bitlbee-setting name="lcnicks" type="boolean" scope="global">
    630467                <default>true</default>
     
    649486        </bitlbee-setting>
    650487
    651         <bitlbee-setting name="op_buddies" type="string" scope="global">
    652                 <default>trusted</default>
    653                 <possible-values>encrypted, trusted, notaway, false</possible-values>
    654 
    655                 <description>
    656                         <para>
    657                                 Specifies under which circumstances BitlBee should give the "op" mode flag (+o) to buddies.
    658                         </para>
    659                        
    660                         <para>
    661                                 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.
    662                         </para>
    663                 </description>
    664 
    665         </bitlbee-setting>
    666 
    667         <bitlbee-setting name="op_root" type="bool" scope="global">
    668                 <default>true</default>
    669 
    670                 <description>
    671                         <para>
    672                                 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.
    673                         </para>
    674                 </description>
    675         </bitlbee-setting>
    676 
    677         <bitlbee-setting name="op_user" type="bool" scope="global">
    678                 <default>true</default>
    679 
    680                 <description>
    681                         <para>
    682                                 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.
    683                         </para>
    684                 </description>
    685         </bitlbee-setting>
    686 
    687         <bitlbee-setting name="otr_policy" type="string" scope="global">
    688                 <default>opportunistic</default>
    689                 <possible-values>never, opportunistic, manual, always</possible-values>
    690 
    691                 <description>
    692                         <para>
    693                                 This setting controls the policy for establishing Off-the-Record connections.
    694                         </para>
    695                         <para>
    696                                 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.
    697499                        </para>
    698500                </description>
     
    878680                        </para>
    879681                </description>
    880         </bitlbee-setting>
    881 
    882         <bitlbee-setting name="voice_buddies" type="string" scope="global">
    883                 <default>trusted</default>
    884                 <possible-values>encrypted, trusted, notaway, false</possible-values>
    885 
    886                 <description>
    887                         <para>
    888                                 Specifies under which circumstances BitlBee should give the "voice" mode flag (+v) to buddies.
    889                         </para>
    890                        
    891                         <para>
    892                                 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.
    893                         </para>
    894                 </description>
    895 
    896682        </bitlbee-setting>
    897683
Note: See TracChangeset for help on using the changeset viewer.