.\" $Id: micq.7,v 1.22 2005/12/11 20:57:34 kuhlmann Exp $ -*- nroff -*- .\" EN: micq.7,v 1.49 .TH MICQ 7 mICQ DE .SH NAME .B mICQ \- interaktive Befehle .SH BESCHREIBUNG Diese Hilfeseite beschreibt die Befehle, die aus mICQ heraus verwendet werden k\(:onnen. Diese Seite enth\(:alt prinzipiell dieselben Informationen wie die Hilfe innerhalb von mICQ, nur pr\(:aziser und umfangreicher. Notationen: eckige Klammern .RB ( [] ) zeigen optionale Argumente an, w\(:ahrend spitze Klammern .RB ( <> ) Argumente (im Gegensatz zu Schl\(:usselw\(:ortern) anzeigen. Insbesondere bedeutet .I immer eine beliebige UIN, w\(:ahrend .I eine Komma-separierte Liste von Kontakten, d.h. UIN und Spitznamen, bedeutet. Ist dies das letzte Argument, d\(:urfen die Kontakte auch durch Leerzeichen getrennt sein. .SH BEFEHLE ZUM SENDEN VON NACHRICHTEN .TP .BI msg \ \ [] Schickt eine Nachricht an alle .IR Kontakte . Ohne .I Nachricht wird der Mehr-Zeilen-Modus aktiviert. Um eine Mehr-Zeilen-Nachricht abzuschicken, gebe man einen Punkt .RB ( . ) auf einer Zeile f\(:ur sich ein. Um die Nachricht abzubrechen, gebe man ein Doppelkreuz .RB ( # ) auf einer Zeile f\(:ur sich ein. .br Ausgehende und eingehende Nachrichten werden unterschiedlich je nach Transport markiert. .B \(Fo\(Fo\(Fo und .B \(Fc\(Fc\(Fc bezeichnet Nachrichten, die \(:uber eine direkte Verbindung versandt wurden. .B \(Fo%\(Fo und .B \(Fc%\(Fc bezeichnet Nachrichten, die verschl\(:usselt \(:uber eine direkte Verbindung versandt wurden (ben\(:otigt GnuTLS oder OpenSSL bei der \(:Ubersetzung). .B \(Fo<< und .B >>\(Fc bezeichnen "icq8"- (genannt auch "type-2"-) Nachrichten. Zuletzt bezeichnen .B <<< und .B >>> "icq5"-Nachrichten, welche auch "type-"-, "type-4"- oder "Offline"-Nachrichten genannt werden. Diese Art von Nachrichten werden nicht best\(:atigt. .br Eine Nachricht wird zun\(:achst versucht, \(:uber eine vorher bestehende direkte Verbindung verschickt zu werden; ist keine vorhanden, wird im Hintergrund versucht, eine solche f\(:ur sp\(:atere Nachrichten aufzubauen. In diesem Falle, oder wenn die Nachricht nach einer Weile immer noch nicht best\(:atigt wurde, wird die Verbindung als fehlgeschlagen abgebaut, und der n\(:achste Transport probiert: das Verschicken als type-2-Nachricht. Dieser Schritt wird \(:ubersprungen, wenn das Gegen\(:uber nicht durch geeignete "capabilities" die F\(:ahigkeit signalisiert hat, solche Nachrichten zu Empfangen. Wenn dieser Schritt \(:ubersprungen wird, ein Fehler auftaucht oder die Nachricht ebenfalls nicht best\(:atigt wird, z.B. wenn sich das Gegen\(:uber in der Zwischenzeit ausgeloggt hat, wird die Nachricht als normale type-4-Nachricht verschickt. .br Wenn das Gegen\(:uber die F\(:ahigkeit, solche zu empfangen, signalisiert hat, werden Nachrichten UTF-8-kodiert \(:ubertragen und entsprechend markiert. Andernfalls wird die Nachricht mit der f\(:ur das Gegen\(:uber eingestellten Kodierung, oder, falls keine eingestellt ist, mit der als Standard f\(:ur andere eingestellten Kodierung verschickt. type-1, type-4 und Offline-Nachrichten k\(:onnen nicht mit ihrer Kodierung markiert werden, deshalb h\(:angt die korrekte \(:Ubertragung von 8bit-Zeichen (also insbesondere Umlauten) von der korrekten Einstellung ab. .TP .BI a \ [] Schickt eine Nachricht zur gleichen Person wie die letzte Nachricht. Auto-expandierendes Alias f\(:ur .BR msg\ %a . .TP .BI r \ [] Antwortet auf die zuletzt empfangene Nachricht. Auto-expandierendes Alias f\(:ur .BR msg\ %r . .TP .BI url \ \ \ Schickt eine .I Nachricht \(:uber die Seite .I URL an alle .IR Kontakte . .TP .BI sms \ []\ []\ Verschickt eine SMS-Nachricht .I Nachricht an die Handy-Nummer .IR HandyNr , die in der Form + sein mu\(ss, oder an die Handy-Nummer von .IR Kontakt , die auf .IR HandyNR gesetzt wird, falls diese noch nicht gesetzt ist. Es ist nicht zul\(:asslig, .IR HandyNr anzugeben, wenn .IR Kontakt bereits eine Handy-Nummer zugeordnet bekommen hat. Ung\(:ultige Handy-Nummern werden von den Meta-Daten eines Kontaktes entfernt. .TP .BI chat \ \ [] Sendet eine Nachricht .I Nachricht an Kontakte .I Kontakte genau wie bei dem .BR msg - Kommando. Nachdem die Nachricht gesendet (oder abgebrochen) wurde, wird der Mehr-Zeilen-Modus aktiviert und Nachrichten gesendet, bis eine leere Nachricht abgebrochen wurde. Wird eine nicht-leere Nachricht abgebrochen, dann wird nur diese Nachricht selber nicht gesendet, aber der Mehr-Zeilen-Modus bleibt aktiviert und weitere Nachrichten k\(:onnen gesendet werden. .TP .BI getauto \ [auto|away|na|dnd|occ|ffc]\ [] Holt automatische Antworten aller .IR Kontakte f\(:ur den angegebenen Status, der .B away f\(:ur abwesend, .B na f\(:ur nicht verf\(:ugbar, .B dnd f\(:ur nicht st\(:oren, .B occ f\(:ur besch\(:aftigt und .B ffc f\(:ur f\(:ur Plaudereien frei sein kann. Wenn .B auto oder gar nichts angegeben ist, wird die automatische Antwort f\(:ur den Kontakt f\(:ur dessen jeweiligen Status geholt. Kontakte, die dabei nicht einen der genannten Stati haben, werden \(:ubersprungen. Neu seit 0.4.10. .TP .BI auth \ [req|grant|deny|add]\ Erlaubt es allen .IR , Sie zu ihrer Kontaktliste hinzuzuf\(:ugen .RB ( grant ), verbietet dies .RB ( deny ), beantragt dies .RB ( req ) oder teilt das Hinzuf\(:ugen nach Autorisierung mit .RB ( add ). .TP .BI resend \ Schickt die letzte Nachricht erneut an weitere .IR Kontakte . .TP .BI last \ [] Zeigt die zuletzt empfangene Nachricht aller .IR Kontakte oder von allen, die bisher eine Nachricht geschickt haben. .TP .BI h \ \ [\ []] .TP .BI history \ \ [\ []] Zeigt Nachrichten von und an .I aus den Logdateien. Starte mit der .IR Start -letzten Nachricht, oder der .IR \-Start -ten Nachricht wenn .I Start negativ ist, oder, wenn nicht angegeben, bei der 20. Nachricht von hinten, und zeige .I Anzahl Nachrichten, oder 20, wenn nicht angegeben. .TP .BI historyd \ \ \ [] Zeige Nachrichten von .I aus den Logdateien. Starte beim Datum .IR Datum , welches im ISO-8601-Format angegeben sein mu\(ss, entweder .RB JJJJ \- MM \- TT\ oder\ JJJJ \- MM \- TT T HH : MM : SS, und zeige .I Anzahl Nachrichten, oder 20, wenn nicht angegeben. .TP .BI find \ \ Suche nach dem Suchmuster .I Muster ohne Beachtung der Gro\(ss-/Kleinschreibung in der Logdatei von .IR Kontakt . .TP .BI finds \ \ Suche nach dem Suchmuster .I Muster mit Beachtung der Gro\(ss-/Kleinschreibung in der Logdatei von .IR Kontakt . .TP .B tabs Zeigt eine Liste von Benutzern, zu denen man bereits Nachrichten geschickt hat bzw. von denen man bereits welche Empfangen hat, und die man mittels das -Taste durchgehen kann. .SH BEFEHLE BEZ\(:UGLICH DES STATUS .TP .B login Eingebaute Abk\(:urzung f\(:ur .IR conn\ login . \(:Offnet die erste Server-Verbindung. .TP .B online Wechsel in den Status "verbunden". .TP .BI away \ [] Wechselt in den Status "abwesend". Setzt optional die automatische Antwort tempor\(:ar auf .IR Nachricht . .TP .BI na \ [] Wechselt in den Status "nicht verf\(:ugbar". Setzt optional die automatische Antwort tempor\(:ar auf .IR Nachricht . .TP .BI occ \ [] Wechselt in den Status "besch\(:aftigt". Setzt optional die automatische Antwort tempor\(:ar auf .IR Nachricht . .TP .BI dnd \ [] Wechselt in den Status "nicht st\(:oren". Setzt optional die automatische Antwort tempor\(:ar auf .IR Nachricht . .TP .BI ffc \ [] Wechselt in den Status "frei f\(:ur Plaudereien". Setzt optional die automatische Antwort tempor\(:ar auf .IR Nachricht . .TP .B inv Wechselt in den Status "unsichtbar". .TP .BI change \ [\ []] Wechselt in den Status .IR Nummer , und setze optional die automatische Antwort f\(:ur diesen Status auf .IR Nachricht . Ohne eine Nummer: liste die verf\(:ugbaren Nummern auf. .SH BEFEHLE ZUM SUCHEN UND ANZEIGEN ANDERER BENUTZER .TP .BI f \ .TP .BI finger \ Zeigt alle Meta-Daten \(:uber alle .IR Kontakte . .TP .TP .BI ss \ Zeigt alle lokal gespeicherten Meta-Daten \(:uber alle .IR Kontakte . .TP .B i Zeigt alle Kontakte auf der Ignorieren-Liste. .TP .BI s \ [] Zeigt den aktuellen Status, oder die Details zu den angegebenen Kontakten an, inklusive dessen Zweit-Namen. .TP .BR e ,\ ee ,\ eg ,\ eeg ,\ ev ,\ eev ,\ egv ,\ eegv ,\ w ,\ ww ,\ wg ,\ wwg ,\ wv ,\ wwv ,\ wgv ,\ wwgv Liste Teile der Kontaktliste auf. Die folgenden Zeichen werden dabei in der ersten Spalte angezeigt: .RS .TP .B + Dieser Eintrag ist kein Kontakt, sondern lediglich ein Zweit-Name f\(:ur den vorhergehenden. Nur mit .BR ww . .TP .B # Dieser Eintrag ist nicht auf der Kontaktliste, aber die Benutzernummer wurde schonmal verwendet. Nur mit .B w und .BR ww . .TP .B * Dieser Kontakt ist auf der Sichtbarkeitsliste, d.h. kann den Status auch im Falle von unsichtbar sehen. .TP .B \- Dieser Kontakt ist auf der Unsichtbarkeitsliste, d.h. kann als Status nur als ausgeloggt sehen. .TP .B ^ Dieser Kontakt wird ignoriert: keine Nachrichten und keine Statuswechsel werden angezeigt. .PP Die Befehle, die mit .B ww und .B ee beginnen, geben eine weitere Spalte mit Zeichen aus. Wenn die erste Spalte sonst leer w\(:are, wird das entsprechende Zeichen aus dieser Spalte auch dort ausgegeben, solange es kein .BR ^ ist. .TP .B & Eine direkte Verbindung wurde aufgebaut. .TP .B \(ba Eine direkte Verbindung wurde versucht, aufzubauen, dies schlug jedoch fehl. .TP .B : Eine direkte Verbindung wird gerade aufgebaut. .TP .B ^ Keine direkte Verbindung aufgebaut, aber die IP-Adresse und der Port sind bekannt. .PP Eine weitere Spalte wird von den Befehlen, die mit .B ww und .B ee beginnen, ausgegeben, die Informationen \(:uber die serverseitige Kontaktliste ausgeben, soweit dies bekannt ist: .TP .B S Der Kontakt ist auf der serverseitigen Kontaktliste, und soll da auch sein. .TP .B s Der Kontakt ist auf der serverseitigen Kontaktliste, soll da aber nicht sein. .TP .B . Der Kontakt ist nicht auf der serverseitigen Kontaktliste, soll da aber sein. Das bedeutet meistens "Autorisierung erforderlich". .TP .B \'\ \' Der Kontakt ist nicht auf der serverseitigen Kontaktliste, und soll da auch nicht sein. .RE .TP .BI e \ [] Zeigt alle Kontakte auf der Kontaktliste, die verbunden sind. Zeigt auch den eigenen Status an. .TP .BI ee \ [] Zeigt alle Kontakte auf der Kontaktliste, die verbunden sind, mit mehr Details. .TP .BR eg ,\ eeg Wie oben, aber sortiere nach Gruppen. Neu seit mICQ 0.4.10. .TP .BR w ,\ ww ,\ wg ,\ wwg Wie oben, aber zeige auch Kontakte an, die gerade nicht verbunden sind. .TP .BR ev ,\ eev ,\ egv ,\ eegv ,\ wv ,\ wwv ,\ wgv ,\ wwgv Wie oben, aber zeige auch versteckte Kontakte an, also solche, die die .B shadow effektiv gesetzt haben. Neu seit mICQ 0.5. .TP .B ewide Zeigt alle Kontakte auf der Kontaktliste, die verbunden sind, in einem breiten Format. .TP .B wide Zeigt alle Kontakte auf der Kontaktliste in einem breiten Format. .TP .B search .TP .BI search \ .TP .BI search \ .TP .BI search \ \ Sucht nach einem Benutzer mit der eMail-Adresse .IR eM@il , mit dem Spitznamen .IR Spitzname , der kein @ enthalten darf, oder mit .I Vorname als Vor- und .I Nachname als Nachname. Ist kein Argument gegeben, frage nach Spitznamen, Vornamen, Nachnamen, eMail-Adresse und einem Haufen anderer Daten, nach denen man suchen kann. .TP .BI rand \ [] Findet einen zuf\(:alligen Kontakt in der Interessengruppe .IR Nummer , oder zeigt alle Interessengruppen an. .SH BEFEHLE ZUM VERWALTEN DER KONTAKTLISTE .TP .BI add \ \ F\(:ugt den Benutzer mit Benutzernummer .I Benutzernummer zur Kontaktliste unter dem Namen .IR Spitzname hinzu. .br Hinweis: Sie m\(:ussen mit .B save abspeichern, um diese \(:Anderungen dauerhaft zu machen. .TP .BI add \ \ .TP .BI addalias \ \ Vergibt einen Zweit-Namen .I Zweit-Name f\(:ur .IR Spitzname . Neu (addalias) seit 0.4.10. .br Hinweis: Sie m\(:ussen mit .B save abspeichern, um diese \(:Anderungen dauerhaft zu machen. .TP .BI add \ \ [] .TP .BI addgroup \ \ [] F\(:uge alle Kontakte in .IR Kontakte zur Kontaktgruppe .IR Gruppe hinzu, welche erforderlichenfalls neu angelegt wird, falls man den Befehl als .B addgroup aufruft. Neu seit 0.4.10. .br Hinweis: Sie m\(:ussen mit .B save abspeichern, um diese \(:Anderungen dauerhaft zu machen. .TP .BI rem \ [all]\ .TP .BI remalias \ [all]\ Entfernt alle in .IR Kontakte angegebenen Zweit-Namen. Wenn dies der einzige Name ist, oder wenn .B all angegeben wurde, entferne den jeweiligen Kontakt von der Kontaktliste. Neu seit 0.4.10. .br Hinweis: Sie m\(:ussen mit .B save abspeichern, um diese \(:Anderungen dauerhaft zu machen. .TP .BI rem \ [all]\ .TP .BI rem \ \ .TP .BI remgroup \ [all]\ .TP .BI remgroup \ \ Entferne alle Kontakte in .IR Kontakte aus der Kontaktgruppe .IR Gruppe , oder entferne diese Gruppe vollst\(:andig, falls .B all angegeben ist. Neu seit 0.4.10. .br Hinweis: Sie m\(:ussen mit .B save abspeichern, um diese \(:Anderungen dauerhaft zu machen. .TP .BI togig \ \(:Andert, ob Nachrichten und Status\(:anderungen der Kontakte .I Kontakte ignoriert werden sollen. .TP .BI toginvis \ \(:Andert f\(:ur jeden Kontakt aus .IR Kontakte , ob er Sie niemals sehen kann. .TP .BI togvis \ \(:Andert f\(:ur jeden Kontakt aus .IR Kontakte , ob er Sie sehen kann, wenn Sie unsichtbar sind. .SH BEFEHLE BEZ\(:UGLICH IHRES ICQ-KONTOS .TP .BI pass \ Setzt das Pa\(sswort auf .IR Pa\(sswort . .br Hinweis: das Pa\(sswort darf nicht mit einem \('o (Byte 0xf3) beginnen. .br Hinweis: Sie m\(:ussen danach mit .B save abspeichern, um diese \(:Anderung dauerhaft zu machen, falls Sie Ihr Pa\(sswort in Ihrem .I ~/.micq/micqrc abspeichern (siehe .BR micqrc (7), oder Ihr Pa\(sswort wird beim n\(:achsten Login fehlerhaft sein. .TP .B update Aktualisiert die auf dem Server gespeicherten Benutzerinformationen (eMail-Adresse, Spitzname, und so weiter). .TP .B other Aktualisiert weitergehende Benutzerinformationen wie Alter und Geschlecht. .TP .B about Aktualisiert den Punkt "\(:Uber" der Benutzerinformationen. .TP .BI setr \ [] Setzt die Interessengruppe f\(:ur zuf\(:allige Kontakte auf .IR Nummer . Ohne Argumente: listet m\(:ogliche Interessengruppen auf. .TP .BI reg \ Erzeugt eine neue Benutzernummer mit dem Pa\(sswort .IR Pa\(sswort . .SH BEFEHLE ZUM KONFIGURIEREN DES MICQ ICQ-PROGRAMMS .TP .BI verbose \ [] Setzt die Ausf\(:uhrlichkeit der Ausgaben von mICQ auf .IR verb , oder zeigt die aktuelle Ausf\(:uhrlichkeit an. Die Ausf\(:uhrlichkeit ist eine Menge von Werten, die aufaddiert werden: .RS .TP .B 8 Zeige Protokoll-Fehler. .TP .B 16 Zeige Erzeugung und Entfernung von Paketen. .TP .B 32 Zeige hinzugef\(:ugte und entfernte Warteschlangen-Ereignisse. .TP .B 64 Zeige Erzeugung und Entfernung von Verbindungen. .TP .B 256 Zeige Version-6-Pakete mit hexadezimalem Abbild. .TP .B 4096 Zeige Version-7/8-Pakete. .TP .B 8192 Zeige zus\(:atzlich das hexadezimale Abbild. .TP .B 16284 Speichere diese Pakete in eine Datei. .TP .B 65536 Zeige Direktverbindungs-Pakete. .TP .B 131072 Zeige zus\(:atzlich das hexadezimale Abbild. .TP .B 262144 Speichere diese Pakete in eine Datei. .TP .B 2097152 Zeige den Direktverbindungs-Handschlag. .TP .B 4194304 Zeige den Verbindungsaufbau von Verbindungen. .PP In jedem Fall bewirkt eine Ausf\(:uhlichkeit gr\(:o\(sser als 0 die Ausgabe von mehr Informationen, und eine gr\(:o\(sser als 1 von noch mehr. .RE .TP .B clear L\(:oscht den Bildschirm. .TP .BI sound \ [on|off|event] Schaltet Piepsen ein .RB ( on ) oder aus .RB ( off ), oder verwendet stattdessen das Ereignis-Skript .RB ( event ). Neue Syntax seit 0.4.10. .TP .BI autoaway \ [|on|off] Gehe nach .I Zeit Sekunden automatisch in den Status "abwesend" bzw. "nicht verf\(:ugbar", oder schaltet dies an (\fBon\fR) (mit der letzten verwendeten Zeit) oder ab (\fBoff\fR). Eine Zeit von 0 schaltet dies ebenfalls ab. Ist kein Argument gegeben, zeigt es die aktuelle Einstellung an. .TP .BI alias\ [auto[expand]] \ [\ ] Erzeuge ein neues Alias mit dem Namen .IR Alias , das durch .IR Erweiterung ersetzt wird. Wird kein .I Alias angegeben, dann liste alle Aliase auf. Wird keine .I Erweiterung angegeben, dann liste das bestehende .I Alias auf. Anderfalls erzeuge ein neues .IR Alias . Ist das Schl\(:usselwort .I auto oder .I autoexpand angegeben, dann erzeuge ein auto-expandierendes Alias, d.h. ein Alias, das sofort expandiert wird, wenn die Leertaste oder die Eingabetaste direkt nach dem Alias eingegeben wird. .br Wenn die Zeichenkette .B %s in der .I Erweiterung vorhanden ist, wird jedes Auftreten durch die beim Aufruf des Alias angegebenen Argumente ersetzt, andernfalls werden diese an das Ende angeh\(:angt. Wenn die Zeichenkette .B %r in der .I Erweiterung vorhanden ist, wird jedes Auftreten ersetzt durch den Spitznamen, falls vorhanden, oder die UIN des Kontaktes ersetzt, von dem die letzte Nachricht empfangen wurde, oder durch die leere Zeichenkette, falls es noch keinen solchen gibt. Wenn die Zeichenkette .B %a in der .I Erweiterung vorhanden ist, wird jedes Auftreten ersetzt durch den Spitznamen, falls vorhanden, oder die UIN des Kontaktes ersetzt, an den die letzte Nachricht gesendet wurde, oder durch die leere Zeichenkette, falls es noch keinen solchen gibt. .br Neu seit 0.4.10. Auto-expandierende Aliase neu seit 0.5.0.4. .TP .BI unalias \ L\(:osche den Alias mit dem Namen .IR Alias . Neu seit 0.4.10. .TP .BI lang \ [|]\ ... Wechsle zur Sprache .IR Sprache , gegeben durch ihren ISO-Sprachcode, oder gibt die \(:Ubersetzung der Textes mit der Nummer .I Nr aus. Um die durch die Umgebungsvariablen .BR LANG , .B LC_ALL und .B LC_MESSAGES bestimmte Sprache auszuw\(:ahlen, kann .BR ! , .B auto oder .B default verwendet werden. Um \(:uberhaupt keine \(:Ubersetzung auszuw\(:ahlen, kann man .BR . , .B none oder .B unload verwenden. Um zur Fehlersuche die Nummern der \(:ubersetzten Texte mitauszugeben, kann man .B debug voranstellen. .sp Die Dateien aus ~/.micq/i18n/*.i18n haben Vorrang \(:uber die globalen Dateien, die Dateien aus BASIS/i18n/*.i18n haben Vorrang \(:uber die aus ~/.micq/i18n/*.i18n, w\(:ahrend die "lustigen" Texte \(:uber die normalen Vorrang haben. .sp Tats\(:achlich kann man sogar soviele Argumente angeben, wie man will, um z.B. den 117. Text in Deutsch auszugeben und dann zur Standardsprache zur\(:uckzukehren, gebe man "trans de 117 default" ein. .TP .B uptime Zeigt an, wie lange mICQ bereits l\(:auft, sowie einige Statistiken. .TP .BI set \