Provided by: gsm-utils_1.10+20120414.gita5e5ae9a-2_amd64 bug

NAME

       gsmpb - GSM mobile phone phonebook manipulation program

SYNOPSIS

       gsmpb [ -b baudrate ] [ --baudrate baudrate ] [ -c ] [ --copy ] [ -d destination device or
       file ] [ --destination destination device or file ] [ -h ] [ --help ] [ -i ] [ --index ] [
       -I init string ] [ --init init string ] [ -p phonebook name ] [ --phonebook phonebook name
       ] [ -s source device or file ] [ --source source device or file ] [ -t character set  ]  [
       --charset character set ] [ -v ] [ --version ] [ -V ] [ --verbose ] [ -X ] [ --xonxoff ] [
       -y ] [ --synchronize ]

DESCRIPTION

       gsmpb can store or retrieve phonebook entries residing in a GSM mobile  phone's  phonebook
       to or from a file. A synchronization mode is also available.

       gsmpb  reads  entries from the source which can be a mobile phone (if a serial device file
       is given) or a file (if a file name is given). The source is never modified. gsmpb  writes
       phonebook  entries  to  a destination file or device.  Depending on the mode the source is
       copied to the destination file, thus overwriting the destination, or  the  destination  is
       synchronized with regard to the source which is the default (details see below).

       If  "-" is given as the parameter for the --source or --destination options, the phonebook
       is read from standard input and/or written to standard output, respectively.

       Phonebook entries names are encoded using the GSM default alphabet in  the  mobile  phone,
       whereas  they  are  stored  using  the  Latin-1  encoding in phonebook files. When reading
       phonebook entries from a mobile phone entry names are converted from the  GSM  default  to
       Latin-1. Characters that can not be converted to Latin-1 are encoded as character code 172
       (Latin-1 boolean "not"). When writing file-based phonebook entries to  a  mobile  phone  a
       conversion  to  the GSM default alphabet takes place. Characters that can not be converted
       are encoded as GSM delta (code 16). If the default character set has  been  changed  using
       the --charset option no conversion takes place.

       Error  messages  are  printed  to  the standard error output. If the program terminates on
       error the error code 1 is returned.

OPTIONS

       -b baudrate, --baudrate baudrate
              The baud rate to use. The default baudrate is 38400.

       -c, --copy
              This causes the contents of the source to be copied to the destination. After  this
              operation the destination has exactly the same contents as the source.

       -d destination, --destination destination
              The destination device or file.

       -h, --help
              Prints an option summary.

       -I init string, --init init string
              Initialization  string  to  send  to the TA (default: "E0"). Note that the sequence
              "ATZ" is sent first.

       -i, --index
              If the index position is given, gsmpb preserves the assignment of entries to memory
              slots in the mobile phone's phonebook. This can be used to backup phonebook entries
              with their position into a phonebook file or to change the position of  entries  by
              editing a phonebook file and writing them back to the mobile phone.  If this option
              is given the phonebook file used as the  source  must  contain  indices  for  every
              entry.  Additionally, these indices must be unique, ie. it is not allowed to assign
              one entry twice to a specific position in the mobile phone's phonebook.

       -p phonebook, --phonebook phonebook
              The name of the phonebook to read from or write to. This is only  used  for  device
              sources and destinations. Commonly available phonebooks are:

              FD SIM fixdialling-phonebook

              LD SIM last-dialling-phonebook

              ME ME phonebook

              MT combined ME and SIM phonebook

              SM SIM phonebook

              TA TA phonebook

       -s source, --source source
              The source device or file.

       -t character set, --charset character set
              Set the character set to use for phonebook operations (default is the
              GSM default alphabet).

       -v, --version
              Prints the program version.

       -V, --verbose
              Prints out a detailed progress report.

       -X, --xonxoff
              Uses software handshaking (XON/XOFF) for accessing the device.

       -y, --synchronize
              This causes the contents of the source to be  synchronized  with  the
              destination (default). Synchronization in this context means:

              - If  the source contains an entry with a name that does not exist in
                the destination this entry is added to the destination.

              - If the source contains an entry with a name that can also be  found
                in  the  destination,  the  entry in the destination is overwritten
                (ie. the telephone number is updated).  Exception:  More  then  one
                entry with the name exists in the destination. In this case the new
                entry ist just added.

              - Entries in the destination that do not  exist  in  the  source  are
                deleted.

              Note  that  synchronization  has the following properties that differ
              from  copying:  This  algorithm  does  not  change  the  location  of
              unchanged  entries  in the destination phonebook. The synchronization
              function is not case-sensitive when comparing names.

PHONEBOOK FILE FORMAT

       Phonebook entries are stored in phonebook files  that  are
       meant  to  be  human-readable  and -editable. There is one
       phonebook entry per line, and each line has the format:

       index|text|phone number

       The fields have the following meanings:

       index  The index of the entry which  must  be  a  positive
              number. The index may also be empty. Indices can be
              used in conjunction  with  the  --index  option  to
              store  the  entry  into  a specific position in the
              mobile phone.

       text   Descriptive  text  for  the  entry.  The  text  may
              contain  the  special characters '\', '|', carriage
              return (ASCII code 13), or line  feed  (ASCII  code
              10).  These must be written "\\", "\|", "\r", "\n",
              respectively.  The   text   should   only   contain
              characters  that  can  be  encoded  using  the  GSM
              default alphabet (see comments above).

       phone number
              Phone numbers can only contains the digits 0-9  and
              the  '+'  sign. A '+' sign denotes an international
              number.

EXAMPLES

       The following invocation of gsmpb synchronizes the  mobile
       phone's SIM phonebook with the file $HOME/.phonebook:

       gsmpb --synchronize -b 19200 -d /dev/mobilephone \
             -s $HOME/.phonebook -p "SM"

AUTHOR

       Peter Hofmann <software@pxh.de>

BUGS

       Report bugs to software@pxh.de.  Include a complete, self-
       contained  example  that  will  allow  the   bug   to   be
       reproduced, and say which version of gsmpb you are using.

COPYRIGHT

       Copyright © 1999 Peter Hofmann

       gsmpb  is  free  software;  you can redistribute it and/or
       modify it under the  terms  of  the  GNU  Library  General
       Public   License   as   published  by  the  Free  Software
       Foundation; either version 2,  or  (at  your  option)  any
       later version.

       gsmpb  is  distributed in the hope that it will be useful,
       but  WITHOUT  ANY  WARRANTY;  without  even  the   implied
       warranty  of  MERCHANTABILITY  or FITNESS FOR A PARTICULAR
       PURPOSE.  See the GNU Library General Public  License  for
       more details.

       You should have received a copy of the GNU Library General
       Public License along with gsmpb; see the file COPYING.  If
       not,  write to the Free Software Foundation, 675 Mass Ave,
       Cambridge, MA 02139, USA.

SEE ALSO

       gsminfo(7),    gsmctl(1),    gsmsendsms(1),    gsmsmsd(8),
       gsmsmsstore(1).