Changes in doc/user-guide/commands.xml [1febf5c:903a2fc]
- File:
-
- 1 edited
-
doc/user-guide/commands.xml (modified) (5 diffs)
Legend:
- Unmodified
- Added
- Removed
-
doc/user-guide/commands.xml
r1febf5c r903a2fc 244 244 </description> 245 245 </bitlbee-command> 246 247 <bitlbee-command name="otr"> 248 <short-description>Off-the-Record encryption control</short-description> 249 <syntax>otr <subcommand> [<arguments>]</syntax> 250 251 <description> 252 253 <para> 254 Available subcommands: connect, disconnect, smp, trust, info, keygen, and forget. See <emphasis>help otr <subcommand></emphasis> for more information. 255 </para> 256 257 </description> 258 259 <bitlbee-command name="connect"> 260 <syntax>otr connect <nick></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 <nick></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 <nick> <secret></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 <nick> <fp1> <fp2> <fp3> <fp4> <fp5></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 <nick></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 <account-no></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 <thing> <arguments></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 <thing></emphasis> for more information. 349 </para> 350 351 </description> 352 353 <bitlbee-command name="fingerprint"> 354 <syntax>otr forget fingerprint <nick> <fingerprint></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 <nick></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> 246 382 247 383 <bitlbee-command name="set"> … … 398 534 </bitlbee-setting> 399 535 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 400 547 <bitlbee-setting name="debug" type="boolean" scope="global"> 401 548 <default>false</default> … … 464 611 </bitlbee-setting> 465 612 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 466 629 <bitlbee-setting name="lcnicks" type="boolean" scope="global"> 467 630 <default>true</default> … … 486 649 </bitlbee-setting> 487 650 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 &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. 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 &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 &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. 499 697 </para> 500 698 </description> … … 680 878 </para> 681 879 </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 682 896 </bitlbee-setting> 683 897
Note: See TracChangeset
for help on using the changeset viewer.
