GSMPB(8)						      System Manager's Manual							  GSMPB(8)

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.  Charac-
       ters  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  con-
	      tain  indices for every entry. Additionally, these indices must be unique, ie. it is not allowed to assign one entry twice to a spe-
	      cific 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 phone-
	      books 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 con-
	      text means:

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

	      - 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 con-
	      tain the	special  characters  '',  '|',  carriage
	      return  (ASCII  code  13), or line feed (ASCII code
	      10). These must be written "\", "|", "
",  "
",
	      respectively.  The text should only contain charac-
	      ters 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 repro-
       duced, and say which version of gsmpb you are using.

COPYRIGHT

       Copyright (C) 1999 Peter Hofmann

       gsmpb is free software; you  can  redistribute  it  and/or
       modify  it under the terms of the GNU Library General Pub-
       lic 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  war-
       ranty  of MERCHANTABILITY or FITNESS FOR A PARTICULAR PUR-
       POSE.  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),  gsmsms-
       store(1).

gsmpb v1.10						   Sat Jun 16 22:10:00 UTC 2012 						  GSMPB(8)