'\" t .\" Title: \fBkabcclient\fR .\" Author: Kevin Krammer .\" Generator: DocBook XSL Stylesheets v1.78.1 .\" Date: 2005-09-08 .\" Manual: KDE-Benutzerhandbuch .\" Source: K Desktop Environment .\" Language: German .\" .TH "\FBKABCCLIENT\FR" "1" "2005\-09\-08" "K Desktop Environment" "KDE-Benutzerhandbuch" .\" ----------------------------------------------------------------- .\" * Define some portability stuff .\" ----------------------------------------------------------------- .\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ .\" http://bugs.debian.org/507673 .\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html .\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ .ie \n(.g .ds Aq \(aq .el .ds Aq ' .\" ----------------------------------------------------------------- .\" * set default formatting .\" ----------------------------------------------------------------- .\" disable hyphenation .nh .\" disable justification (adjust text to left margin only) .ad l .\" ----------------------------------------------------------------- .\" * MAIN CONTENT STARTS HERE * .\" ----------------------------------------------------------------- .SH "NAME" kabcclient \- Befehlszeilenprogramm f\(:ur das KDE\-Adressbuch .SH "\(:UBERSICHT" .HP \w'\fBkabcclient\fR\ 'u \fBkabcclient\fR [[\-A] | [\-R] | [\-M] | [\-S] | [\-L]] [\-\-match\-case] [\-\-nosave] [\-ic\ \fIcodec\fR] [\-if\ \fIformat\fR] [\-if\-opts\ \fIformat\-options\fR] [\-oc\ \fIcodec\fR] [\-of\ \fIformat\fR] [\-of\-opts\ \fIformat\-options\fR] [input\-data] .SH "BESCHREIBUNG" .PP Das Programm \fBkabcclient\fR erlaubt den Zugriff auf das KDE\-Adressbuch auf der Befehlszeile, zum Beispiel in Shell\-Skripten\&. Eingaben k\(:onnen \(:uber stdin (Standardeingabe) oder \(:uber zus\(:atzliche Befehlszeilenargumente gelesen werden\&. Daten werden immer auf die Standardausgabe (stdout) ausgegeben\&. .SH "OPTIONEN" .PP \fIArbeitsmodi\fR .RS 4 .PP \fB\-A, \-\-add\fR .RS 4 F\(:ugt einen Kontakt in das Adressbuch ein .RE .PP \fB\-R, \-\-remove\fR .RS 4 Entfernt einen vorhandenen Kontakt aus dem Adressbuch .RE .PP \fB\-M, \-\-merge\fR .RS 4 Eingabedaten mit Daten von vorhandenen Eintr\(:agen des Adressbuchs zusammenf\(:uhren\&. Jede zus\(:atzliche neue Information wird an die bereits vorhandenen Daten angef\(:ugt\&. .RE .PP \fB\-S, \-\-search\fR .RS 4 Sucht im Adressbuch nach passenden Kontakten .RE .PP \fB\-L, \-\-list\fR .RS 4 Zeigt alle Kontakte aus dem Adressbuch an .RE .RE .PP \fIOptionen f\(:ur die Eingabe\fR .RS 4 .PP \fB\-ic, \-\-input\-codec\fR .RS 4 Filtert die Eingabedaten durch die vorgegebene Textkodierung\&. Weitere Informationen \(:uber Eingabekodierungen werden mit der Option \fB\-ic\fR\fI help\fR angezeigt\&. Standard\-Eingabekodierung ist \fIlocal\fR, damit wird die Kodierung der aktuellen Einstellung aus \fBlocale\fR(5) verwendet .RE .PP \fB\-if, \-\-input\-format\fR .RS 4 Filtert die Eingabedaten durch die vorgegebenen Formatierungsregeln\&. Weitere Informationen verf\(:ugbare Formate werden mit der Option \fB\-if\fR\fI help\fR angezeigt\&. Die Standardeinstellung ist \fIsearch\fR .RE .PP W\(:ahlt Kontakte in einem Dialog aus anstelle des Einlesens von Textdaten .RS 4 \fIdialog\fR .RE .PP \fB\-if\-opts, \-\-input\-format\-options\fR .RS 4 Zus\(:atzliche Optionen f\(:ur das gew\(:ahlte Eingabeformat\&. Abh\(:angig vom Format k\(:onnen diese Optionen optional, aber auch erforderlich sein\&. Weitere Informationen \(:uber verf\(:ugbare Formatoptionen werden mit \fB\-if\-opts\fR\fI help\fR angezeigt\&. .RE .RE .PP \fIOptionen f\(:ur die Ausgabe\fR .RS 4 .PP \fB\-oc, \-\-output\-codec\fR .RS 4 Filtert die Ausgabedaten durch die vorgegebene Textkodierung\&. Weitere Informationen \(:uber Ausgabekodierungen werden mit der Option \fB\-oc\fR\fI help\fR angezeigt\&. Standard\-Ausgabekodierung ist \fIlocal\fR, damit wird die Kodierung der aktuellen Einstellung aus \fBlocale\fR(5) verwendet\&. .RE .PP \fB\-of, \-\-output\-format\fR .RS 4 Filtert die Ausgabedaten durch die vorgegebenen Formatierungsregeln\&. Weitere Informationen \(:uber verf\(:ugbare Formate werden mit der Option \fB\-if\fR\fI help\fR angezeigt\&. Die Standardeinstellung ist \fIvcard\fR\&. .RE .PP \fB\-of\-opts, \-\-output\-format\-options\fR .RS 4 Zus\(:atzliche Optionen f\(:ur das gew\(:ahlte Ausgabeformat\&. Abh\(:angig vom Format k\(:onnen diese Optionen optional, aber auch erforderlich sein\&. Weitere Informationen \(:uber verf\(:ugbare Formatoptionen werden mit \fB\-of\-opts\fR\fI help\fR angezeigt\&. .RE .RE .PP \fIWeitere Optionen\fR .RS 4 .PP \fB\-\-match\-case\fR .RS 4 Verwendet Gro\(ss\-/Kleinschreibung, wenn der Eingabetext mit den Kontakteintr\(:agen verglichen wird .RE .PP \fB\-\-nosave\fR .RS 4 F\(:uhrt Operationen wie \fB\-A, \-R\fR oder \fB\-M\fR, die Daten ver\(:andern, nur im Arbeitsspeicher aus, die \(:Anderungen werden aber nicht im Adressbuch gespeichert\&. .RE .RE .SH "DIAGNOSE" .PP Wie in Unix \(:ublich, wird bei erfolgreicher Ausf\(:uhrung einer Operation der Wert Null zur\(:uckgegeben\&. Abh\(:angig von der Arbeitsweise zeigt ein R\(:uckgabewert > 0 ein Problem an\&. das bei der Ausf\(:uhrung aufgetreten ist\&. .PP \fIADD\fR .RS 4 .PP 1 .RS 4 Das Lesen des Eingabetextes fehlgeschlagen .RE .PP 2 .RS 4 Die Erstellung eines passenden Kontakteintrags aus den Eingabedaten ist fehlgeschlagen, z\&.\ \&B\&. weil nicht gen\(:ugend Daten eingeben wurden oder weil die Eingabe f\(:ur das gew\(:ahlte Format falsch formatiert ist .RE .PP 3 .RS 4 Die Speicherung des Adressbuchs ist fehlgeschlagen\&. Die Ursache f\(:ur diesen Fehler kann zum Beispiel darin liegen, dass das Adressbuch aktuell durch andere Programme gesperrt ist\&. .RE .RE .PP \fIREMOVE\fR .RS 4 .PP 1 .RS 4 Das Lesen des Eingabetextes fehlgeschlagen .RE .PP 2 .RS 4 Das Programm kann keinem Kontakteintrag aus dem Adressbuch entfernen\&. Die Ursache daf\(:ur kann bei einem Fehler beim Lesen der Eingabedaten liegen oder weil es keinen oder mehrere passende Kontakteintr\(:age im Adressbuch gibt\&. Im letzten Fall wird eine Fehlermeldung auf der Standardausgabe angezeigt\&. .RE .PP 3 .RS 4 Die Speicherung des Adressbuchs ist fehlgeschlagen\&. Die Ursache f\(:ur diesen Fehler kann zum Beispiel darin liegen, dass das Adressbuch aktuell durch andere Programme gesperrt ist\&. .RE .RE .PP \fIMERGE\fR .RS 4 .PP 1 .RS 4 Das Lesen des Eingabetextes fehlgeschlagen .RE .PP 2 .RS 4 Das Programm kann die Eingabe nicht mit einem Kontakteintrag aus dem Adressbuch zusammenf\(:uhren\&. Die Ursache daf\(:ur kann bei einem Fehler beim Lesen der Eingabedaten liegen oder weil es keinen oder mehrere passende Kontakteintr\(:age im Adressbuch gibt\&. Im letzten Fall wird eine Fehlermeldung auf der Standardausgabe angezeigt\&. .RE .PP 3 .RS 4 Die Speicherung des Adressbuchs ist fehlgeschlagen\&. Die Ursache f\(:ur diesen Fehler kann zum Beispiel darin liegen, dass das Adressbuch aktuell durch andere Programme gesperrt ist\&. .RE .PP \fISEARCH\fR, 1 .RS 4 Das Lesen des Eingabetextes fehlgeschlagen .RE .PP 2 .RS 4 Das Programm kann keinen passenden Kontakteintrag im Adressbuch finden\&. Die Ursache kann beim Einlesefehler des Eingabetextes oder bei einem Fehler bei der Suche nach einem passenden Kontakteintrag im Adressbuch liegen\&. .RE .RE .SH "BEISPIELE" .PP \fISuche nach Kontakten mit \(BqJoe\(lq im Namen oder der E\-Mail\-Adresse\fR .sp .if n \{\ .RS 4 .\} .nf kabcclient \-S Joe .fi .if n \{\ .RE .\} .PP \fIDie gleiche Suche mit Beachtung von Gro\(ss\-/Kleinschreibung\&.\fR .sp .if n \{\ .RS 4 .\} .nf kabcclient \-\-match\-case \-S Joe .fi .if n \{\ .RE .\} .PP \fIDie gleiche Suche mit Einlesen des Eingabetexts aus der Standardeingabe\fR .sp .if n \{\ .RS 4 .\} .nf echo \(BqJoe\(lq | kabcclient \-\-match\-case \-S .fi .if n \{\ .RE .\} .PP \fIHinzuf\(:ugen eines neuen Kontakteintrags mit Daten aus einer formatierten E\-Mail\-Adresse\fR .sp .if n \{\ .RS 4 .\} .nf kabcclient \-\-nosave \-\-add \-if email \(BqMarilyn Monroe \(lq .fi .if n \{\ .RE .\} .PP \fIDas Gleiche, aber mit Speicherung der ge\(:anderten Daten des Adressbuchs\fR .sp .if n \{\ .RS 4 .\} .nf kabcclient \-\-add \-if email \(BqMarilyn Monroe \(lq .fi .if n \{\ .RE .\} .PP \fIAnzeige aller verf\(:ugbaren Eingabeformate\fR .sp .if n \{\ .RS 4 .\} .nf kabcclient \-if help .fi .if n \{\ .RE .\} .PP \fIAnzeige aller verf\(:ugbaren Ausgabeformate\fR .sp .if n \{\ .RS 4 .\} .nf kabcclient \-of help .fi .if n \{\ .RE .\} .PP \fIAnzeige aller verf\(:ugbaren Optionen f\(:ur das \*(Aqemail\*(Aq\-Ausgabeformat\fR .sp .if n \{\ .RS 4 .\} .nf kabcclient \-of email \-of\-opts help .fi .if n \{\ .RE .\} .PP \fIAusgabe aller E\-Mail\-Adressen der Kontakte, die den Text \*(AqMarilyn\*(Aq enthalten\fR .sp .if n \{\ .RS 4 .\} .nf kabcclient \-of email \-of\-opts allemails \-S Marilyn .fi .if n \{\ .RE .\} .PP \fIEntfernen aller Kontakte, die im Dialog Kontaktauswahl markiert wurden\&.\fR .sp .if n \{\ .RS 4 .\} .nf kabcclient \-\-remove \-if dialog .fi .if n \{\ .RE .\} .PP \fIExportieren der ausgew\(:ahlten Kontakte in eine vCard\-Datei, das Standardausgabeformat\fR .sp .if n \{\ .RS 4 .\} .nf kabcclient \-S \-if dialog > contacts\&.vcf .fi .if n \{\ .RE .\} .SH "AUTHOR" .PP Diese Handbuchseite wurde von Kevin Krammer geschrieben\&. Es ist erlaubt, dieses Dokument nach den Regeln der GNU General Public License, Version 2 oder einer sp\(:ateren von der Free Software Foundation herausgegebenen Lizenz zu kopieren, zu verbreiten oder zu ver\(:andern\&. .PP Auf Debian\-Systemen kann der gesamte Text der GNU General Public License im Ordner /usr/share/common\-licenses/GPL gefunden werden\&. .SH "AUTOR" .PP \fBKevin Krammer\fR <\&kevin\&.krammer@gmx\&.at\&> .RS 4 Author .RE