Provided by: gammu_1.27.92-3_i386 bug

NAME

       Gammu - Does some neat things with your cellular phone or modem.

SYNOPSIS

       Usage: gammu [parameters] <command> [options]

DESCRIPTION

       This  program  is a tool for mobile phones. Many vendors and phones are
       supported, for actual listing see <http://wammu.eu/phones/>.

OPTIONS

       Parameters before command configure gammu behaviour:
       -c / --config <filename> ... name of configuration file
       -s / --section <confign> ... section of config file to use, eg. 42
       -d / --debug <level> ...  debug  level  (see  gammurc(5)  for  possible
       values)
       -f / --debug-file <filename> ... file for logging debug messages

   Commands
       Commands can be specified with or without leading --.

   Calls
       answercall [id]
              Answer incoming call.

       cancelcall [id]
              Cancel incoming call

       canceldiverts
              Cancel all existing call diverts.

       conferencecall id
              Initiates a conference call.

       dialvoice number [show|hide]
              Make voice call from SIM card line set in phone.

              show|hide  -  optional  parameter whether to disable call number
              indication.

       divert  get|set  all|busy|noans|outofreach  all|voice|fax|data  [number
       timeout]
              Manage or display call diverts.

              get|set - whether to get divert information or to set it.

              all|busy|noans|outofreach - condition when apply divert

              all|voice|fax|data - call type when apply divert

              number - number where to divert

              timeout - timeout when the diversion will happen

       getspeeddial start [stop]
              Gets speed dial choices.

       getussd code
              Retrieves USSD information - dials a service  number  and  reads
              response.

       holdcall id
              Holds call.

       maketerminatedcall number length [show|hide]
              Make  voice  call  from SIM card line set in phone which will be
              terminated after length seconds.

       monitor [times]
              Get phone status and writes  continuously  to  standard  output.
              Press Ctrl+C to break this state.

       senddtmf sequence
              Plays DTMF sequence. In some phones available only during calls

       splitcall id
              Splits call.

       switchcall [id]
              Switches call.

       transfercall [id]
              Transfers call.

       unholdcall id
              Unholds call.

   SMS and EMS
       Sending  messages might look a bit complicated on first attempt to use.
       But be patient, the command line has been written  in  order  to  allow
       almost every usage. See EXAMPLE section for some hints on usage.

       There  is  also an option to use gammu-smsd(1) when you want to send or
       receive more messages and process them automatically.

       Common parameters for sendsms and savesms

              -smscset number - SMSC will be taken from  set  number.  Default
              set: 1

              -smscnumber number - SMSC number

              -reply - reply SMSC is set

              -maxnum  number - Limit maximal number of messages which will be
              created. If there are more messages, Gammu will  terminate  with
              failure.

              -folder number - save to specified folder.

              Folders are numerated from 1.

              The  most  often  folder  1  =  "Inbox",  2  = "Outbox",etc. Use
              getsmsfolders to get folder list.

              -unread - makes message unread. In some phones (like  6210)  you
              won’t  see  unread  sms  envelope after saving such sms. In some
              phones with internal SMS memory (like 6210) after using it  with
              folder 1 SIM SMS memory will be used

              -read  -  makes  message  read. In some phones with internal SMS
              memory (like 6210) after using it with folder 1 SIM  SMS  memory
              will be used

              -unsent - makes message unsent

              -sent - makes message sent

              -sender number - set sender number

              -smsname name - set message name

              -sender number - set sender number (default: "Gammu")

              -report - request delivery report for message

              -validity HOUR|6HOURS|DAY|3DAYS|WEEK|MAX - sets how long will be
              the message valid (SMSC will the discard the message after  this
              time if it could not deliver it).

              -save - will also save message which is being sent

       Introduction to SMS formats

              Gammu has support for many SMS formats like:

               * Nokia Smart Messaging (used for monochromatic picture images,
              downloadable    profiles,    monochromatic    operator    logos,
              monochromatic caller logos and monophonic ringtones)
               *  Linked SMS (both with 8 and 16-bit identification numbers in
              headers)
               * EMS (this is SMS format used for saving monochromatic images,
              monophonic ringtones, animations, text formatting and others)
               * MMS notifications
               * Alcatel logo messages

              You  need  to ensure that the target phone supports message type
              you want to send. Otherwise  the  phone  will  not  be  able  to
              display it or will even crash, because firmware of phone did not
              expect this possibility.

       Encoding chars in SMS text

              Text in SMS can be coded using two ways:

              * with GSM Default  Alphabet  -  in  single  SMS  you  can  have
              maximally  160  chars  (Gammu  doesn’t  support compressing such
              texts according to  GSM  standards,  but  it  isn’t  big  limit,
              because  there  are no phones supporting them), but they’re from
              limited set:
                * all Latin small and large
                * all digits
                * some Greek
                * some other national
                * some symbols like  @! " # & / ( )% * + = - , .:; < >?
                * few others

              * with Unicode - in single SMS you can save at  most  70  chars,
              but  these  can  be any chars including all national and special
              ones. Please note, that some older phones  might  have  problems
              displaying such message.

              Gammu  tries  to  do  the best to handle non ASCII characters in
              your message.  Everything is internally handled in Unicode  (the
              input  is converted depending on your locales configuration) and
              in case message uses Unicode the text will be given as  such  to
              the message.

              Should  the  message be sent in GSM Default Alphabet, Gammu will
              try to convert all characters to keep  message  readable.  Gammu
              does  support  multi  byte  encoding  for some characters in GSM
              Default Alphabet (it is needed for ^  {  }  \  [  ]  ~  |).  The
              characters  which  are  not  present in GSM Default Alphabet are
              transliterated  to  closest  ASCII   equivalent   (accents   are
              removed).   Remaining  not  known  characters  are  replaced  by
              question mark.

       addsms folder file [-yes]
              Adds SMSes from file (format like backupsms  uses)  to  selected
              folder in phone.

       addsmsfolder name

       backupsms file [-yes|-all]
              Stores all SMSes from phone to file.

              Use -yes for answering yes to all questions (backup all messages
              and delete them from phone), or -all to just backup all  folders
              while keeping messages in phone.

       deleteallsms folder
              Delete all SMS from specified SMS folder.

       deletesms folder start [stop]
              Delete SMS from phone. See description for getsms for info about
              sms folders naming convention.

              Locations are numerated from 1.

       displaysms ... (options like in sendsms)

              Displays PDU data of  encoded  SMS  messages.  It  accepts  same
              parameters and behaves same like sendsms.

       getallsms -pbk
              Get  all  SMS  from phone. In some phones you will have also SMS
              templates and info about locations used to save Picture  Images.
              With each sms you will see location. If you want to get such sms
              from phone alone, use gammu getsms 0 location

       geteachsms -pbk
              Similiary  to  getallsms.  Difference   is,   that   links   all
              concatenated sms

       getsms folder start [stop]
              Get SMS.

              Locations are numerated from 1.

              Folder  0  means  that sms is being read from "flat" memory (all
              sms from  all  folders  have  unique  numbers).  It’s  sometimes
              emulated by Gammu. You can use it with all phones.

              Other  folders  like  1,  2, etc. match folders in phone such as
              Inbox, Outbox, etc.  and each  sms  has  unique  number  in  his
              folder. Name of folders can depend on your phone (the most often
              1="Inbox", 2="Outbox", etc.).  This method is not  supported  by
              all  phones  (for  example,  not  supported by Nokia 3310, 5110,
              6110). If work with your phone, use getsmsfolders to get folders
              list.

       getsmsc [start [stop]]
              Get SMSC settings from SIM card.

              Locations are numerated from 1.

       getsmsfolders
              Get names for SMS folders in phone

       nokiagett9
              This  option  should  display  T9  dictionary  content from DCT4
              phones.

       restoresms file [-yes]
              Restores  SMSes  from  file  (format  like  backupsms  uses)  to
              selected  folder  in  phone.  Please  note  that this overwrites
              existing messages in phone (if it supports it).

       savesms ANIMATION frames file1 file2... [-folder id] [-unread]  [-read]
       [-unsent]  [-sent]  [-sender  number] [-smsname name] [-smscset number]
       [-smscnumber number] [-reply] [-maxsms num]
              Save an animation as a SMS. You need to give  number  of  frames
              and  picture  for each frame. Each picture can be in any picture
              format which Gammu supports (B/W bmp, gif, wbmp, nol, nlm...).

              For description of shared parameters see Common  parameters  for
              sendsms and savesms.

       savesms BOOKMARK file location [-folder id] [-unread] [-read] [-unsent]
       [-sent] [-sender number] [-smsname name] [-smscset number] [-smscnumber
       number] [-reply] [-maxsms num]
              Read  WAP  bookmark from file created by backup option and saves
              in Nokia format as SMS

              For description of shared parameters see Common  parameters  for
              sendsms and savesms.

       savesms CALENDAR file location [-folder id] [-unread] [-read] [-unsent]
       [-sent] [-sender number] [-smsname name] [-smscset number] [-smscnumber
       number] [-reply] [-maxsms num]
              Read  calendar note from file created by backup option and saves
              in VCALENDAR 1.0 format as SMS. The location identifies position
              of  calendar  item to be read in backup file (usually 1, but can
              be useful in case the backup contains more items).

              For description of shared parameters see Common  parameters  for
              sendsms and savesms.

       savesms  CALLER  file  [-folder id] [-unread] [-read] [-unsent] [-sent]
       [-sender number] [-smsname name] [-smscset number] [-smscnumber number]
       [-reply] [-maxsms num]
              Save caller logo as sms in Nokia (Smart Messaging) format - size
              72x14, two colors.

              Please note, that it isn’t designed for colour  logos  available
              for  example  in  DCT4/TIKU  - you need to put bitmap file there
              inside phone using filesystem commands.

              For description of shared parameters see Common  parameters  for
              sendsms and savesms.

       savesms  EMS  [-folder id] [-unread] [-read] [-unsent] [-sent] [-sender
       number] [-smsname name] [-smscset number] [-smscnumber number] [-reply]
       [-maxsms  num]  [-unicode]  [-16bit]  [-format  lcrasbiut] [-text text]
       [-unicodefiletext file]  [-defsound  ID]  [-defanimation  ID]  [-tone10
       file]  [-tone10long  file]  [-tone12  file] [-tone12long file] [-toneSE
       file] [-toneSElong file]  [-fixedbitmap  file]  [-variablebitmap  file]
       [-variablebitmaplong  file]  [-animation  frames file1 ...] [-protected
       number]

              Saves   EMS   sequence.   All  parameters  after  -unread  (like
              -defsound) can be used few times.

              -text - adds text

              -unicodefiletext - adds text from Unicode file

              -defanimation - adds default  animation  with  ID  specified  by
              user.ID for different phones are different.

              -animation - adds "frames" frames read from file1, file2, etc.

              -defsound - adds default sound with ID specified by user. ID for
              different phones are different.

              -tone10 - adds IMelody version  1.0  read  from  RTTL  or  other
              compatible file

              -tone10long  -  IMelody version 1.0 saved in one of few SMS with
              UPI. Phones compatible with UPI (like SonyEricsson phones)  will
              read such ringtone as one

              -tone12  -  adds  IMelody  version  1.2  read from RTTL or other
              compatible file

              -tone12long - IMelody version 1.2 saved in one of few  SMS  with
              UPI.  Phones compatible with UPI (like SonyEricsson phones) will
              read such ringtone as one

              -toneSE - adds IMelody in "short" form supported by SonyEricsson
              phones

              -toneSElong  -  add SonyEricsson IMelody saved in one or few SMS
              with UPI

              -variablebitmap - bitmap in any size saved in one SMS

              -variablebitmaplong - bitmap with maximal size 96x128  saved  in
              one or few sms

              -fixedbitmap - bitmap 16x16 or 32x32

              -protected  -  all  ringtones  and  bitmaps after this parameter
              (excluding default ringtones and logos) will be "protected"  (in
              phones  compatible  with ODI like SonyEricsson products it won’t
              be possible to forward them from phone menu)

              -16bit - Gammu uses SMS headers with 16-bit numbers  for  saving
              linking  info  in SMS (it means less chars available for user in
              each SMS)

              -format lcrasbiut - last text will be  formatted.  You  can  use
              combinations of chars:
                  l - left aligned
                  c - centered
                  r - right aligned
                  a - large font
                  s - small font
                  b - bold font
                  i - italic font
                  u - underlined font
                  t - strikethrough font

              Example:  gammu  savesms EMS -text "Greetings" -defsound 1 -text
              "from Gammu" -tone10 axelf.txt -animation 2 file1.bmp file2.bmp

              will create EMS sequence with text "Greetings" and default sound
              1  and  text  "from  Gammu"  and  ringtone axelf.txt and 2 frame
              animation read from (1’st  frame)  file1.bmp  and  (2’nd  frame)
              file2.bmp

              Example:  gammu  savesms  EMS  -protected  2 -variablebitmaplong
              ala.bmp -toneSElong axelf.txt -toneSE ring.txt

              ala.bmp and axelf.txt will be "protected"

              For description of shared parameters see Common  parameters  for
              sendsms and savesms.

       savesms  MMSINDICATOR  URL  Title Sender [-folder id] [-unread] [-read]
       [-unsent] [-sent] [-sender number] [-smsname  name]  [-smscset  number]
       [-smscnumber number] [-reply] [-maxsms num]

              Saves  a  message  with MMS indication. The recipient phone will
              then download MMS from given URL and display it.

              Please note that you should provide valid smil data on that URL.

              For  description  of shared parameters see Common parameters for
              sendsms and savesms.

       savesms MMSSETTINGS  file  location   [-folder  id]  [-unread]  [-read]
       [-unsent]  [-sent]  [-sender  number] [-smsname name] [-smscset number]
       [-smscnumber number] [-reply] [-maxsms num]
              Saves a message with MMS configuration. The  configuration  will
              be read from Gammu backup file from given location.

              For  description  of shared parameters see Common parameters for
              sendsms and savesms.

       savesms OPERATOR file [-folder id] [-unread] [-read] [-unsent]  [-sent]
       [-sender number] [-smsname name] [-smscset number] [-smscnumber number]
       [-reply] [-maxsms num] [-netcode netcode] [-biglogo]
              Save operator logo as sms in Nokia (Smart  Messaging)  format  -
              size 72x14 or 78x21 after using -biglogo, all in two colors.

              Please  note,  that it isn’t designed for colour logos available
              for example in DCT4/TIKU - you need to  put  bitmap  file  there
              inside phone using filesystem commands.

              For  description  of shared parameters see Common parameters for
              sendsms and savesms.

       savesms PICTURE file [-folder id] [-unread] [-read]  [-unsent]  [-sent]
       [-sender number] [-smsname name] [-smscset number] [-smscnumber number]
       [-reply] [-maxsms num] [-text text] [-unicode] [-alcatelbmmi]

              Read bitmap from 2 colors file (bmp, nlm, nsl, ngg,  nol,  wbmp,
              etc.),  format  into bitmap in Smart Messaging (72x28, 2 colors,
              called often Picture Image  and  saved  with  text)  or  Alcatel
              format and send/save over SMS.

              For  description  of shared parameters see Common parameters for
              sendsms and savesms.

       savesms  PROFILE  [-folder  id]  [-unread]  [-read]  [-unsent]  [-sent]
       [-sender number] [-smsname name] [-smscset number] [-smscnumber number]
       [-reply]  [-maxsms  num]  [-name  name]  [-bitmap  bitmap]   [-ringtone
       ringtone]

              Read ringtone (RTTL) format, bitmap  (Picture  Image  size)  and
              name,  format into Smart Messaging profile and send/save as SMS.
              Please  note,  that  this  format  is  abandomed  by  Nokia  and
              supported by some (older) devices only like Nokia 3310.

              For  description  of shared parameters see Common parameters for
              sendsms and savesms.

       savesms RINGTONE file [-folder id] [-unread] [-read] [-unsent]  [-sent]
       [-sender number] [-smsname name] [-smscset number] [-smscnumber number]
       [-reply] [-maxsms num] [-long] [-scale]
              Read RTTL ringtone from file and  save  as  SMS  into  SIM/phone
              memory. Ringtone is saved in Nokia (Smart Messaging) format.

              -long  - ringtone is saved using Profile style. It can be longer
              (and saved in 2 SMS), but decoded only  by  newer  phones  (like
              33xx)

              -scale  -  ringtone  will have Scale info for each note. It will
              allow to edit it correctly later in phone composer (for example,
              in 33xx)

              For  description  of shared parameters see Common parameters for
              sendsms and savesms.

       savesms SMSTEMPLATE [-folder id] [-unread]  [-read]  [-unsent]  [-sent]
       [-sender number] [-smsname name] [-smscset number] [-smscnumber number]
       [-reply] [-maxsms num] [-unicode] [-text text] [-unicodefiletext  file]
       [-defsound  ID]  [-defanimation  ID]  [-tone10 file] [-tone10long file]
       [-tone12 file] [-tone12long file]  [-toneSE  file]  [-toneSElong  file]
       [-variablebitmap  file]  [-variablebitmaplong  file] [-animation frames
       file1 ...]
              Saves a SMS template (for Alcatel phones).

              For description of shared parameters see Common  parameters  for
              sendsms and savesms.

       savesms  TEXT [-folder id] [-unread] [-read] [-unsent] [-sent] [-sender
       number] [-smsname name] [-smscset number] [-smscnumber number] [-reply]
       [-maxsms  num]  [-inputunicode]  [-16bit] [-flash] [-len len] [-autolen
       len]    [-unicode]    [-enablevoice]    [-disablevoice]    [-enablefax]
       [-disablefax]       [-enableemail]      [-disableemail]      [-voidsms]
       [-replacemessages ID] [-replacefile file]  [-text  msgtext]  [-textutf8
       msgtext]
              Take  text  from  stdin  (or commandline if -text specified) and
              save as text SMS into SIM/phone memory.

              -flash - Class 0 SMS (should be  displayed  after  receiving  on
              recipients’  phone  display  after  receiving  without  entering
              Inbox)

              -len len - specify, how many chars will be read. When  use  this
              option  and  text  will be longer than 1 SMS, will be split into
              more linked SMS

              -autolen len - specify, how many chars will be  read.  When  use
              this  option  and  text will be longer than 1 SMS, will be split
              into more linked SMS.Coding type (SMS default  alphabet/Unicode)
              is set according to input text

              -enablevoice  |  -disablevoice  |  -enablefax   | -disablefax  |
              -enableemail  | -disableemail  - sms will set  such  indicators.
              Text will be cut to 1 sms.

              -voidsms   -  many  phones  after  receiving  it  won’t  display
              anything, only beep, vibrate or turn on light. Text will be  cut
              to 1 sms.

              -unicode - SMS will be saved in Unicode format

              -inputunicode - input text is in Unicode.

              -text - get text from command line instead of stdin.

              -textutf8  -  get  text  in  UTF-8  from command line instead of
              stdin.

              -16bit - Gammu uses SMS headers with 16-bit numbers  for  saving
              linking  info  in SMS (it means less chars available for user in
              each SMS)

              TIP: You can  create  Unicode  file  using  WordPad  in  Windows
              (during  saving  select "Unicode Text Document" format). In Unix
              can use for example YUdit.

              -replacemessages ID - ID can be 1..7. When you will  use  option
              and send more single SMS to one recipient with the same ID, each
              another SMS will replace each previous with the same ID

              -replacefile file  - when you want, you can make  file  in  such
              format:          src_unicode_char1,          dest_unicode_char1,
              src_unicode_char2, dest_unicode_char2 (everything in one  line).
              After  reading  text  for  SMS  from  stdin  there  will be made
              translation and each src char will be converted to dest char. In
              docs  there is example file (replace.txt), which will change all
              "a" chars to "1"

              TIP: when use ~ char in sms text and  -unicode  option  (Unicode
              coding  required),  text  of sms after ~ char will blink in some
              phones (like N33xx)

              Example: echo some_text | gammu savesms TEXT

              For description of shared parameters see Common  parameters  for
              sendsms and savesms.

       savesms  TODO  file  location  [-folder id] [-unread] [-read] [-unsent]
       [-sent] [-sender number] [-smsname name] [-smscset number] [-smscnumber
       number] [-reply] [-maxsms num]
              Saves a message with a todo entry. The content will be read from
              any backup format which Gammu supports and from given  location.

              For  description  of shared parameters see Common parameters for
              sendsms and savesms.

       savesms VCARD10|VCARD21  file  SM|ME  location  [-nokia]  [-folder  id]
       [-unread]  [-read]  [-unsent]  [-sent] [-sender number] [-smsname name]
       [-smscset number] [-smscnumber number] [-reply] [-maxsms num]
              Read phonebook entry from file  created  by  backup  option  and
              saves  in  VCARD 1.0 (only name and default number) or VCARD 2.1
              (all entry details with all numbers, text and  name)  format  as
              SMS. The location identifies position of contact item to be read
              in backup file (usually 1, but can be useful in case the  backup
              contains more items).

              For  description  of shared parameters see Common parameters for
              sendsms and savesms.

       savesms WAPINDICATOR URL Title [-folder id] [-unread] [-read] [-unsent]
       [-sent] [-sender number] [-smsname name] [-smscset number] [-smscnumber
       number] [-reply] [-maxsms num]
              Saves a SMS with a WAP indication for given URL and title.

              For description of shared parameters see Common  parameters  for
              sendsms and savesms.

       savesms  WAPSETTINGS  file  location  DATA|GPRS  [-folder id] [-unread]
       [-read] [-unsent] [-sent] [-sender number]  [-smsname  name]  [-smscset
       number] [-smscnumber number] [-reply] [-maxsms num]
              Read  WAP  settings from file created by backup option and saves
              in Nokia format as SMS

              For description of shared parameters see Common  parameters  for
              sendsms and savesms.

       sendsms   ANIMATION   destination   frames   file1  file2...  [-report]
       [-validity  HOUR|6HOURS|DAY|3DAYS|WEEK|MAX]  [-save  [-folder  number]]
       [-smscset number] [-smscnumber number] [-reply] [-maxsms num]
              Sends  a message, for description of message specific parameters
              see savesms ANIMATION.

              For description of shared parameters see Common  parameters  for
              sendsms and savesms.

       sendsms   BOOKMARK   destination  file  location  [-report]  [-validity
       HOUR|6HOURS|DAY|3DAYS|WEEK|MAX]  [-save  [-folder  number]]   [-smscset
       number] [-smscnumber number] [-reply] [-maxsms num]
              Sends  a message, for description of message specific parameters
              see savesms BOOKMARK.

              For description of shared parameters see Common  parameters  for
              sendsms and savesms.

       sendsms   CALENDAR   destination  file  location  [-report]  [-validity
       HOUR|6HOURS|DAY|3DAYS|WEEK|MAX]  [-save  [-folder  number]]   [-smscset
       number] [-smscnumber number] [-reply] [-maxsms num]
              Sends  a message, for description of message specific parameters
              see savesms CALENDAR.

              For description of shared parameters see Common  parameters  for
              sendsms and savesms.

       sendsms     CALLER     destination     file     [-report]    [-validity
       HOUR|6HOURS|DAY|3DAYS|WEEK|MAX]  [-save  [-folder  number]]   [-smscset
       number] [-smscnumber number] [-reply] [-maxsms num]
              Sends  a message, for description of message specific parameters
              see savesms CALLER.

              For description of shared parameters see Common  parameters  for
              sendsms and savesms.

       sendsms        EMS        destination        [-report]       [-validity
       HOUR|6HOURS|DAY|3DAYS|WEEK|MAX]  [-save  [-folder  number]]   [-smscset
       number] [-smscnumber number] [-reply] [-maxsms num] [-unicode] [-16bit]
       [-format lcrasbiut] [-text text] [-unicodefiletext file] [-defsound ID]
       [-defanimation  ID]  [-tone10  file]  [-tone10long file] [-tone12 file]
       [-tone12long file]  [-toneSE  file]  [-toneSElong  file]  [-fixedbitmap
       file]  [-variablebitmap  file]  [-variablebitmaplong  file] [-animation
       frames file1 ...] [-protected number]
              Sends  a message, for description of message specific parameters
              see savesms EMS.

              For description of shared parameters see Common  parameters  for
              sendsms and savesms.

       sendsms  MMSINDICATOR destination URL Title Sender [-report] [-validity
       HOUR|6HOURS|DAY|3DAYS|WEEK|MAX]  [-save  [-folder  number]]   [-smscset
       number] [-smscnumber number] [-reply] [-maxsms num]
              Sends  a message, for description of message specific parameters
              see savesms MMSINDICATOR.

              For description of shared parameters see Common  parameters  for
              sendsms and savesms.

       sendsms  MMSSETTINGS  destination  file  location  [-report] [-validity
       HOUR|6HOURS|DAY|3DAYS|WEEK|MAX]  [-save  [-folder  number]]   [-smscset
       number] [-smscnumber number] [-reply] [-maxsms num]
              Sends  a message, for description of message specific parameters
              see savesms MMSSETTINGS.

              For description of shared parameters see Common  parameters  for
              sendsms and savesms.

       sendsms     OPERATOR     destination    file    [-report]    [-validity
       HOUR|6HOURS|DAY|3DAYS|WEEK|MAX]  [-save  [-folder  number]]   [-smscset
       number]  [-smscnumber number] [-reply] [-maxsms num] [-netcode netcode]
       [-biglogo]
              Sends  a message, for description of message specific parameters
              see savesms OPERATOR.

              For description of shared parameters see Common  parameters  for
              sendsms and savesms.

       sendsms     PICTURE     destination     file    [-report]    [-validity
       HOUR|6HOURS|DAY|3DAYS|WEEK|MAX]  [-save  [-folder  number]]   [-smscset
       number]  [-smscnumber  number]  [-reply]  [-maxsms  num]  [-text  text]
       [-unicode] [-alcatelbmmi]
              Sends  a message, for description of message specific parameters
              see savesms PICTURE.

              For description of shared parameters see Common  parameters  for
              sendsms and savesms.

       sendsms       PROFILE       destination       [-report]      [-validity
       HOUR|6HOURS|DAY|3DAYS|WEEK|MAX]  [-save  [-folder  number]]   [-smscset
       number]  [-smscnumber  number]  [-reply]  [-maxsms  num]  [-name  name]
       [-bitmap bitmap] [-ringtone ringtone]
              Sends  a message, for description of message specific parameters
              see savesms PROFILE.

              For description of shared parameters see Common  parameters  for
              sendsms and savesms.

       sendsms     RINGTONE     destination    file    [-report]    [-validity
       HOUR|6HOURS|DAY|3DAYS|WEEK|MAX]  [-save  [-folder  number]]   [-smscset
       number] [-smscnumber number] [-reply] [-maxsms num] [-long] [-scale]
              Sends  a message, for description of message specific parameters
              see savesms RINGTONE.

              For description of shared parameters see Common  parameters  for
              sendsms and savesms.

       sendsms      SMSTEMPLATE      destination      [-report]     [-validity
       HOUR|6HOURS|DAY|3DAYS|WEEK|MAX]  [-save  [-folder  number]]   [-smscset
       number]  [-smscnumber  number] [-reply] [-maxsms num] [-unicode] [-text
       text]  [-unicodefiletext  file]  [-defsound  ID]   [-defanimation   ID]
       [-tone10  file]  [-tone10long  file]  [-tone12 file] [-tone12long file]
       [-toneSE    file]    [-toneSElong    file]    [-variablebitmap    file]
       [-variablebitmaplong file] [-animation frames file1 ...]
              Sends  a message, for description of message specific parameters
              see savesms SMSTEMPLATE.

              For description of shared parameters see Common  parameters  for
              sendsms and savesms.

       sendsms        TEXT        destination       [-report]       [-validity
       HOUR|6HOURS|DAY|3DAYS|WEEK|MAX]  [-save  [-folder  number]]   [-smscset
       number]  [-smscnumber  number]  [-reply]  [-maxsms num] [-inputunicode]
       [-16bit] [-flash] [-len len] [-autolen len]  [-unicode]  [-enablevoice]
       [-disablevoice]      [-enablefax]      [-disablefax]     [-enableemail]
       [-disableemail] [-voidsms] [-replacemessages  ID]  [-replacefile  file]
       [-text msgtext] [-textutf8 msgtext]
              Sends  a message, for description of message specific parameters
              see savesms TEXT.

              For description of shared parameters see Common  parameters  for
              sendsms and savesms.

       sendsms   TODO   destination   file   location   [-report]   [-validity
       HOUR|6HOURS|DAY|3DAYS|WEEK|MAX]  [-save  [-folder  number]]   [-smscset
       number] [-smscnumber number] [-reply] [-maxsms num]
              Sends  a message, for description of message specific parameters
              see savesms TODO.

              For description of shared parameters see Common  parameters  for
              sendsms and savesms.

       sendsms   VCARD10|VCARD21  destination  file  SM|ME  location  [-nokia]
       [-report] [-validity  HOUR|6HOURS|DAY|3DAYS|WEEK|MAX]  [-save  [-folder
       number]] [-smscset number] [-smscnumber number] [-reply] [-maxsms num]
              Sends  a message, for description of message specific parameters
              see savesms VCARD10|VCARD21.

              For description of shared parameters see Common  parameters  for
              sendsms and savesms.

       sendsms   WAPINDICATOR   destination  URL  Title  [-report]  [-validity
       HOUR|6HOURS|DAY|3DAYS|WEEK|MAX]  [-save  [-folder  number]]   [-smscset
       number] [-smscnumber number] [-reply] [-maxsms num]
              Sends  a message, for description of message specific parameters
              see savesms WAPINDICATOR.

              For description of shared parameters see Common  parameters  for
              sendsms and savesms.

       sendsms  WAPSETTINGS  destination  file  location  DATA|GPRS  [-report]
       [-validity  HOUR|6HOURS|DAY|3DAYS|WEEK|MAX]  [-save  [-folder  number]]
       [-smscset number] [-smscnumber number] [-reply] [-maxsms num]
              Sends  a message, for description of message specific parameters
              see savesms WAPSETTINGS.

              For description of shared parameters see Common  parameters  for
              sendsms and savesms.

       setsmsc location number
              Set SMSC settings on SIM card. This keeps all SMSC configuration
              intact, it just changes the SMSC number.

              Locations are numerated from 1.

   Memory (phonebooks and calls)
       addcategory TODO|PHONEBOOK text

       addnew file [-yes] [-memory ME|SM|..]
              Adds data written in  file  created  using  backup  option.  All
              things  backup’ed by backup can be restored (when made backup to
              Gammu text file).

              Please note that this adds all content of backup file  to  phone
              and does not care about current data in the phone (no duplicates
              are detected).

              Use -yes parameter to answer yes to all questions (you  want  to
              automatically restore all data).

              Use  -memory parameter to force usage of defined memory type for
              storing entries regardless what backu format says.

       backup file [-yes]
              Backup your phone to file. It’s possible to backup  (depends  on
              phone and backup format):

              * phonebook from SIM and phone memory
              * calendar notes
              * SMSC settings
              * operator logo
              * startup (static) logo or startup text
              * WAP bookmarks
              * WAP settings
              * caller logos and groups
              * user ringtones

              There are various backup formats supported and the backup format
              is guessed based on file extension:

              * .lmb - Nokia  backup,  supports  contacts,  caller  logos  and
              startup logo.
              * .vcs - vCalendar, supports calendar and todo.
              * .vcf - vCard, supports contacts.
              * .ldif - LDAP import, supports contacts.
              * .ics - iCalendar, supports calendar and todo.
              *  Any  other extension is Gammu backup file and it supports all
              data mentioned above.

              See EXAMPLE section for some hints on manipulating Gammu  backup
              format.

       clearall
              Deletes all private data from the phone.

       deleteallmemory DC|MC|RC|ON|VM|SM|ME|MT|FD|SL
              Deletes all entries from specified memory type.

       deletememory DC|MC|RC|ON|VM|SM|ME|MT|FD|SL start [stop]
              Deletes entries in specified range from specified memory type.

       getallcategory TODO|PHONEBOOK

       getallmemory DC|MC|RC|ON|VM|SM|ME|MT|FD|SL
              Get  all  memory  locations  from  phone.  For  memory types see
              getmemory.

       getcategory TODO|PHONEBOOK start [stop]

       getmemory DC|MC|RC|ON|VM|SM|ME|MT|FD|SL start [stop [-nonempty]]
              Get memory location from phone.

              Locations are numerated from 1.

              DC = Dialled calls
              MC = Missed calls
              RC = Received calls
              ON = Own numbers
              VM = voice mailbox
              SM = SIM phonebook
              ME = phone internal phonebook
              FD = fixed dialling
              SL = sent SMS log

       getspeeddial start [stop]
              Gets speed dial choices.

       listmemorycategory text|number

       nokiagetpbkfeatures memorytype

       restore file [-yes]
              Restore settings written in file created using backup option.

              Please note that restoring deletes all current content in phone.
              If you want only to add entries to phone, use addnew.

              In some phones restoring calendar notes will not show error, but
              won’t be done, when phone doesn’t have set clock inside.

       savefile VCARD10|VCARD21 target.vcf file SM|ME location
              Allows to convert between various  backup  formats  which  gammu
              supports  for  phonebook  events.  The file type is guessed (for
              input file guess is based on extension  and  file  content,  for
              output solely on extension).

              For  example  if  you  want  to  convert single entry from gammu
              native backup to vCard, you need following command:

                  gammu savefile CALENDAR output.vcf myPhonebook.backup ME 42

       savesms VCARD10|VCARD21  file  SM|ME  location  [-nokia]  [-folder  id]
       [-unread]  [-read]  [-unsent]  [-sent] [-sender number] [-smsname name]
       [-smscset number] [-smscnumber number] [-reply] [-maxsms num]
              Read phonebook entry from file  created  by  backup  option  and
              saves  in  VCARD 1.0 (only name and default number) or VCARD 2.1
              (all entry details with all numbers, text and  name)  format  as
              SMS. The location identifies position of contact item to be read
              in backup file (usually 1, but can be useful in case the  backup
              contains more items).

              For  description  of shared parameters see Common parameters for
              sendsms and savesms.

       searchmemory text
              Scans all memory  entries  for  given  text.  It  performs  case
              insensitive  substring  lookup.  You  can interrupt searching by
              pressing Ctrl+C.

       sendsms  VCARD10|VCARD21  destination  file  SM|ME  location   [-nokia]
       [-report]  [-validity  HOUR|6HOURS|DAY|3DAYS|WEEK|MAX]  [-save [-folder
       number]] [-smscset number] [-smscnumber number] [-reply] [-maxsms num]
              Sends a message, for description of message specific  parameters
              see savesms VCARD10|VCARD21.

              For  description  of shared parameters see Common parameters for
              sendsms and savesms.

   Filesystem
       Gammu allows to access phones using native protocol (Nokias)  or  OBEX.
       Your  phone  can  also  support  usb  storage,  which is handled on the
       operating system level and Gammu does not use that.

       addfile folderID name [-type JAR|BMP|PNG|GIF|JPG|MIDI|WBMP|AMR|3GP|NRT]
       [-readonly] [-protected] [-system] [-hidden] [-newtime]
              Add file with specified name to folder with specified folder ID.

              -type  - file type was required for filesystem 1 in Nokia phones
              (current filesystem 2 doesn’t need this)

              -readonly, -protected, -system, -hidden - you can set  readonly,
              protected (file can’t be for example forwarded from phone menu),
              system  and  hidden  (file  is  hidden  from  phone  menu)  file
              attributes

              -newtime - after using it date/time of file modification will be
              set to moment of uploading

       addfolder parentfolderID name
              Create a folder in phone with specified name in  a  folder  with
              specified folder ID.

       deletefiles fileID
              Delete files with given IDs.

       deletefolder name
              Delete folder with given ID.

       getfilefolder fileID, fileID, ...
              Retrieve  files  or  all files from folder with given IDs from a
              phone filesytem.

       getfiles fileID, fileID, ...
              Retrieve files with given IDs from a phone filesytem.

       getfilesystem [-flatall|-flat]
              Display info about all folders and files in phone  memory/memory
              card. By default there is tree displayed, you can change it:

              -flatall  there  are  displayed full file/folder details like ID
              (first parameter in line)

              -flat

              Please note, that in some phones (like N6230)  content  of  some
              folders (with more files) can be cut (only part of files will be
              displayed) for example on infrared connection. This is not Gammu
              issue, but phone firmware problem.

       getfilesystemstatus
              Display info filesystem status - number of bytes available, used
              or used by some specific content.

       getfolderlisting folderID

              Display files and folders available in folder with given  folder
              ID. You can get ID’s using getfilesystem -flatall.

              Please  note,  that  in some phones (like N6230) content of some
              folders (with more files) can be cut (only part of files will be
              displayed) for example on infrared connection. This is not Gammu
              issue, but phone firmware problem.

       getrootfolders

              Display info about drives available in phone/memory card.

       nokiaaddfile    APPLICATION|GAME    file    [-readonly]    [-overwrite]
       [-overwriteall]
              Install the *.jar/*.jad file pair of a midlet in the application
              or  game menu of the phone. You need to specify filename without
              the jar/jad suffix, both will be added automatically.

              The option -overwrite deletes the application’s  .jad  and  .jar
              files bevor installing, but doesn’t delete the application data.
              Option -overwriteall will  also  delete  all  data.  Both  these
              options work only for Application or Game upload.

              Example:   gammu   nokiaaddfile   Application  Alien  will  read
              Alien.JAD and Alien.JAR and add to Applications

              Example: gammu nokiaaddfile Tones file.mid  will  read  file.mid
              and add to Tones folder

              You  can  use  jadmaker(1)  to  generate a .jad file from a .jar
              file.

       nokiaaddfile
       GALLERY|GALLERY2|CAMERA|TONES|TONES2|RECORDS|VIDEO|PLAYLIST|MEMORYCARD
       file  [-name  name]  [-protected]   [-readonly]   [-system]   [-hidden]
       [-newtime]

       nokiaaddplaylists

              Goes through phone memory and generated playlist for  all  music
              files found.

              To manually manage playlists:

                  gammu addfile a:\predefplaylist filename.m3u

              Will add playlist filename.m3u

                  gammu getfilesystem

              Will  get  list  of  all  files  (including  names of files with
              playlists)

                  gammu deletefiles a:\predefplaylist\filename.m3u

              Will delete playlist filename.m3u

              Format of m3u playlist is easy (standard mp3 playlist):

              First line is  #EXTM3U,  next  lines  contain   names  of  files
              (b:\file1.mp3,  b:\folder1\file2.mp3,  etc.).  File needs t have
              ’\r\n’ terminated lines. So just run unix2dos on  the  resulting
              file before uploading it your your phone.

       sendfile name
              Sends file to a phone. It’s up to phone to decide where to store
              this file and how to handle it (for example when you send  vCard
              or vCalendar, most of phones will offer you to import it.

       setfileattrib folderID [-system] [-readonly] [-hidden] [-protected]

   Logo and pictures
       These  options  are mainly (there are few expections) for monochromatic
       logos and images available in older phones.  Recognized  file  formats:
       xpm  (only  saving),  2-colors  bmp, nlm, nsl, ngg, nol, wbmp, gif (for
       Samsung).

       In new models all bitmaps are saved in filesystem and  should  go  into
       filesystem section

       copybitmap inputfile [outputfile [OPERATOR|PICTURE|STARTUP|CALLER]]
              Allow  to  convert  logos  files  to  another.  When  give  ONLY
              inputfile, output will be written to  stdout  using  ASCII  art.
              When  give  output  file  and format, in some file formats (like
              NLM) will be set indicator informing about logo type to given.

       getbitmap CALLER location [file]
              Get caller group logo from phone. Locations 1-5.

       getbitmap DEALER
              In some models it’s possible to save dealer welcome note -  text
              displayed  during  enabling  phone,  which  can’t be edited from
              phone menu.  Here you can get it.

       getbitmap OPERATOR [file]
              Get operator logo (picture displayed instead of  operator  name)
              from phone.

       getbitmap PICTURE location [file]
              Get Picture Image from phone.

       getbitmap STARTUP [file]
              Get static startup logo from phone. Allow to save it in file.

       getbitmap TEXT
              Get startup text from phone.

       savesms  ANIMATION frames file1 file2... [-folder id] [-unread] [-read]
       [-unsent] [-sent] [-sender number] [-smsname  name]  [-smscset  number]
       [-smscnumber number] [-reply] [-maxsms num]
              Save  an  animation  as a SMS. You need to give number of frames
              and picture for each frame. Each picture can be in  any  picture
              format which Gammu supports (B/W bmp, gif, wbmp, nol, nlm...).

              For  description  of shared parameters see Common parameters for
              sendsms and savesms.

       savesms CALLER file [-folder id] [-unread]  [-read]  [-unsent]  [-sent]
       [-sender number] [-smsname name] [-smscset number] [-smscnumber number]
       [-reply] [-maxsms num]
              Save caller logo as sms in Nokia (Smart Messaging) format - size
              72x14, two colors.

              Please  note,  that it isn’t designed for colour logos available
              for example in DCT4/TIKU - you need to  put  bitmap  file  there
              inside phone using filesystem commands.

              For  description  of shared parameters see Common parameters for
              sendsms and savesms.

       savesms OPERATOR file [-folder id] [-unread] [-read] [-unsent]  [-sent]
       [-sender number] [-smsname name] [-smscset number] [-smscnumber number]
       [-reply] [-maxsms num] [-netcode netcode] [-biglogo]
              Save operator logo as sms in Nokia (Smart  Messaging)  format  -
              size 72x14 or 78x21 after using -biglogo, all in two colors.

              Please  note,  that it isn’t designed for colour logos available
              for example in DCT4/TIKU - you need to  put  bitmap  file  there
              inside phone using filesystem commands.

              For  description  of shared parameters see Common parameters for
              sendsms and savesms.

       savesms PICTURE file [-folder id] [-unread] [-read]  [-unsent]  [-sent]
       [-sender number] [-smsname name] [-smscset number] [-smscnumber number]
       [-reply] [-maxsms num] [-text text] [-unicode] [-alcatelbmmi]

              Read bitmap from 2 colors file (bmp, nlm, nsl, ngg,  nol,  wbmp,
              etc.),  format  into bitmap in Smart Messaging (72x28, 2 colors,
              called often Picture Image  and  saved  with  text)  or  Alcatel
              format and send/save over SMS.

              For  description  of shared parameters see Common parameters for
              sendsms and savesms.

       sendsms  ANIMATION  destination   frames   file1   file2...   [-report]
       [-validity  HOUR|6HOURS|DAY|3DAYS|WEEK|MAX]  [-save  [-folder  number]]
       [-smscset number] [-smscnumber number] [-reply] [-maxsms num]
              Sends a message, for description of message specific  parameters
              see savesms ANIMATION.

              For  description  of shared parameters see Common parameters for
              sendsms and savesms.

       sendsms    CALLER     destination     file     [-report]     [-validity
       HOUR|6HOURS|DAY|3DAYS|WEEK|MAX]   [-save  [-folder  number]]  [-smscset
       number] [-smscnumber number] [-reply] [-maxsms num]
              Sends a message, for description of message specific  parameters
              see savesms CALLER.

              For  description  of shared parameters see Common parameters for
              sendsms and savesms.

       sendsms    OPERATOR    destination    file     [-report]     [-validity
       HOUR|6HOURS|DAY|3DAYS|WEEK|MAX]   [-save  [-folder  number]]  [-smscset
       number] [-smscnumber number] [-reply] [-maxsms num] [-netcode  netcode]
       [-biglogo]
              Sends a message, for description of message specific  parameters
              see savesms OPERATOR.

              For  description  of shared parameters see Common parameters for
              sendsms and savesms.

       sendsms    PICTURE    destination     file     [-report]     [-validity
       HOUR|6HOURS|DAY|3DAYS|WEEK|MAX]   [-save  [-folder  number]]  [-smscset
       number]  [-smscnumber  number]  [-reply]  [-maxsms  num]  [-text  text]
       [-unicode] [-alcatelbmmi]
              Sends a message, for description of message specific  parameters
              see savesms PICTURE.

              For  description  of shared parameters see Common parameters for
              sendsms and savesms.

       setbitmap CALLER location [file]
              Set caller logo.

       setbitmap COLOUROPERATOR [fileID [netcode]]
              Sets color operator logo in phone.

       setbitmap COLOURSTARTUP [fileID]

       setbitmap DEALER text
              Sets welcome message configured by dealer, which usually can not
              be changed in phone menus.

       setbitmap OPERATOR [file [netcode]]
              Set  operator  logo  in phone. When won’t give file and netcode,
              operator logo will be removed from phone. When  will  give  only
              filename,  operator  logo will be displayed for your current GSM
              operator. When  give  additionally  network  code,  it  will  be
              displayed  for this operator: gammu setbitmap OPERATOR file "260
              02"

       setbitmap PICTURE file location [text]
              Sets picture image in phone.

       setbitmap STARTUP file|1|2|3
              Set startup logo in phone. It can be static (then you will  have
              to  give  file  name)  or  one of predefined animated (only some
              phones like Nokia 3310 or 3330 supports it, use location 1, 2 or
              3 for these).

       setbitmap TEXT text
              Sets startup text in phone.

       setbitmap WALLPAPER fileID
              Sets wallpaper in phone.

   Ringtones
       Ringtones are mostly supported only for older phones. For recent phones
       you usually just upload them to some folder in phone filesystem.

       There are recognized various file formats by options  described  below:
       rttl, binary format created for Gammu, mid (saving), re (reading), ott,
       communicator, ringtones format found in fkn.pl, wav  (saving),  ime/imy
       (saving), rng, mmf (for Samsung).

       addnew file [-yes] [-memory ME|SM|..]
              Adds  data  written  in  file  created  using backup option. All
              things backup’ed by backup can be restored (when made backup  to
              Gammu text file).

              Please  note  that this adds all content of backup file to phone
              and does not care about current data in the phone (no duplicates
              are detected).

              Use  -yes  parameter to answer yes to all questions (you want to
              automatically restore all data).

              Use -memory parameter to force usage of defined memory type  for
              storing entries regardless what backu format says.

       backup file [-yes]
              Backup  your  phone to file. It’s possible to backup (depends on
              phone and backup format):

              * phonebook from SIM and phone memory
              * calendar notes
              * SMSC settings
              * operator logo
              * startup (static) logo or startup text
              * WAP bookmarks
              * WAP settings
              * caller logos and groups
              * user ringtones

              There are various backup formats supported and the backup format
              is guessed based on file extension:

              *  .lmb  -  Nokia  backup,  supports  contacts, caller logos and
              startup logo.
              * .vcs - vCalendar, supports calendar and todo.
              * .vcf - vCard, supports contacts.
              * .ldif - LDAP import, supports contacts.
              * .ics - iCalendar, supports calendar and todo.
              * Any other extension is Gammu backup file and it  supports  all
              data mentioned above.

              See  EXAMPLE section for some hints on manipulating Gammu backup
              format.

       clearall
              Deletes all private data from the phone.

       copyringtone source destination [RTTL|BINARY]
              Copy source ringtone to destination.

       getphoneringtone location [file]

              Get one of "default" ringtones and saves into file

       getringtone location [file]
              Get ringtone from phone in RTTL or BINARY format.

              Locations are numerated from 1.

       getringtoneslist

       nokiacomposer file
              Show, how to enter RTTL ringtone in composer  existing  in  many
              Nokia phones (and how should it look like).

       playringtone file
              Play  aproximation of ringtone over phone buzzer. File can be in
              RTTL or BINARY (Nokia DCT3) format.

       playsavedringtone number

              Play one of "built" ringtones. This option is available for DCT4
              phones. For getting ringtones list use getringtoneslist.

       restore file [-yes]
              Restore settings written in file created using backup option.

              Please note that restoring deletes all current content in phone.
              If you want only to add entries to phone, use addnew.

              In some phones restoring calendar notes will not show error, but
              won’t be done, when phone doesn’t have set clock inside.

       savesms  RINGTONE file [-folder id] [-unread] [-read] [-unsent] [-sent]
       [-sender number] [-smsname name] [-smscset number] [-smscnumber number]
       [-reply] [-maxsms num] [-long] [-scale]
              Read  RTTL  ringtone  from  file  and save as SMS into SIM/phone
              memory. Ringtone is saved in Nokia (Smart Messaging) format.

              -long - ringtone is saved using Profile style. It can be  longer
              (and  saved  in  2  SMS), but decoded only by newer phones (like
              33xx)

              -scale - ringtone will have Scale info for each  note.  It  will
              allow to edit it correctly later in phone composer (for example,
              in 33xx)

              For description of shared parameters see Common  parameters  for
              sendsms and savesms.

       sendsms     RINGTONE     destination    file    [-report]    [-validity
       HOUR|6HOURS|DAY|3DAYS|WEEK|MAX]  [-save  [-folder  number]]   [-smscset
       number] [-smscnumber number] [-reply] [-maxsms num] [-long] [-scale]
              Sends  a message, for description of message specific parameters
              see savesms RINGTONE.

              For description of shared parameters see Common  parameters  for
              sendsms and savesms.

       setringtone file [-location location] [-scale] [-name name]
              Set  ringtone  in  phone.  When  don’t give location, it will be
              written "with preview" (in phones supporting this  feature  like
              61xx  or  6210).  When use RTTL ringtones, give location and use
              -scale, there will be written scale info with each note. It will
              avoid  scale  problems  available  during  editing  ringtone  in
              composer from phone menu (for example, in N33xx).

              TIP: when use ~ char in ringtone  name,  in  some  phones  (like
              33xx) name will blink later in phone menus

   Calendar notes
       In  Nokia 3310, 3315 and 3330 these are named "Reminders" and have some
       limitations (depending on phone firmware version).

       addnew file [-yes] [-memory ME|SM|..]
              Adds data written in  file  created  using  backup  option.  All
              things  backup’ed by backup can be restored (when made backup to
              Gammu text file).

              Please note that this adds all content of backup file  to  phone
              and does not care about current data in the phone (no duplicates
              are detected).

              Use -yes parameter to answer yes to all questions (you  want  to
              automatically restore all data).

              Use  -memory parameter to force usage of defined memory type for
              storing entries regardless what backu format says.

       backup file [-yes]
              Backup your phone to file. It’s possible to backup  (depends  on
              phone and backup format):

              * phonebook from SIM and phone memory
              * calendar notes
              * SMSC settings
              * operator logo
              * startup (static) logo or startup text
              * WAP bookmarks
              * WAP settings
              * caller logos and groups
              * user ringtones

              There are various backup formats supported and the backup format
              is guessed based on file extension:

              * .lmb - Nokia  backup,  supports  contacts,  caller  logos  and
              startup logo.
              * .vcs - vCalendar, supports calendar and todo.
              * .vcf - vCard, supports contacts.
              * .ldif - LDAP import, supports contacts.
              * .ics - iCalendar, supports calendar and todo.
              *  Any  other extension is Gammu backup file and it supports all
              data mentioned above.

              See EXAMPLE section for some hints on manipulating Gammu  backup
              format.

       clearall
              Deletes all private data from the phone.

       deletecalendar start [stop]
              Deletes selected calendar entries in phone.

       getallcalendar
              Retrieves all calendar entries from phone.

       getcalendar start [stop]
              Retrieves selected calendar entries from phone.

       getcalendarsettings
              Displays  calendar  settings like first day of week or automatic
              deleting of old entries.

       restore file [-yes]
              Restore settings written in file created using backup option.

              Please note that restoring deletes all current content in phone.
              If you want only to add entries to phone, use addnew.

              In some phones restoring calendar notes will not show error, but
              won’t be done, when phone doesn’t have set clock inside.

       savefile CALENDAR target.vcs file location
              Allows to convert between various  backup  formats  which  gammu
              supports  for  calendar  events.  The  file type is guessed (for
              input file guess is based on extension  and  file  content,  for
              output solely on extension).

              For  example  if  you  want  to  convert single entry from gammu
              native backup to vCalendar, you need following command:

                  gammu savefile CALENDAR output.vcs myCalendar.backup 260

       savesms CALENDAR file location [-folder id] [-unread] [-read] [-unsent]
       [-sent] [-sender number] [-smsname name] [-smscset number] [-smscnumber
       number] [-reply] [-maxsms num]
              Read calendar note from file created by backup option and  saves
              in VCALENDAR 1.0 format as SMS. The location identifies position
              of calendar item to be read in backup file (usually 1,  but  can
              be useful in case the backup contains more items).

              For  description  of shared parameters see Common parameters for
              sendsms and savesms.

       sendsms  CALENDAR  destination  file  location   [-report]   [-validity
       HOUR|6HOURS|DAY|3DAYS|WEEK|MAX]   [-save  [-folder  number]]  [-smscset
       number] [-smscnumber number] [-reply] [-maxsms num]
              Sends a message, for description of message specific  parameters
              see savesms CALENDAR.

              For  description  of shared parameters see Common parameters for
              sendsms and savesms.

   To do lists
       addcategory TODO|PHONEBOOK text

       addnew file [-yes] [-memory ME|SM|..]
              Adds data written in  file  created  using  backup  option.  All
              things  backup’ed by backup can be restored (when made backup to
              Gammu text file).

              Please note that this adds all content of backup file  to  phone
              and does not care about current data in the phone (no duplicates
              are detected).

              Use -yes parameter to answer yes to all questions (you  want  to
              automatically restore all data).

              Use  -memory parameter to force usage of defined memory type for
              storing entries regardless what backu format says.

       backup file [-yes]
              Backup your phone to file. It’s possible to backup  (depends  on
              phone and backup format):

              * phonebook from SIM and phone memory
              * calendar notes
              * SMSC settings
              * operator logo
              * startup (static) logo or startup text
              * WAP bookmarks
              * WAP settings
              * caller logos and groups
              * user ringtones

              There are various backup formats supported and the backup format
              is guessed based on file extension:

              * .lmb - Nokia  backup,  supports  contacts,  caller  logos  and
              startup logo.
              * .vcs - vCalendar, supports calendar and todo.
              * .vcf - vCard, supports contacts.
              * .ldif - LDAP import, supports contacts.
              * .ics - iCalendar, supports calendar and todo.
              *  Any  other extension is Gammu backup file and it supports all
              data mentioned above.

              See EXAMPLE section for some hints on manipulating Gammu  backup
              format.

       clearall
              Deletes all private data from the phone.

       deletetodo start [stop]
              Deletes selected todo entries in phone.

       getallcategory TODO|PHONEBOOK

       getalltodo
              Retrieves all todo entries from phone.

       getcategory TODO|PHONEBOOK start [stop]

       gettodo start [stop]
              Retrieves selected todo entries from phone.

       listtodocategory text|number

       restore file [-yes]
              Restore settings written in file created using backup option.

              Please note that restoring deletes all current content in phone.
              If you want only to add entries to phone, use addnew.

              In some phones restoring calendar notes will not show error, but
              won’t be done, when phone doesn’t have set clock inside.

       savefile TODO target.vcs file location
              Allows  to  convert  between  various backup formats which gammu
              supports for todo events. The file type is  guessed  (for  input
              file  guess  is  based on extension and file content, for output
              solely on extension).

              For example if you want  to  convert  single  entry  from  gammu
              native backup to vCalendar, you need following command:

                  gammu savefile CALENDAR output.vcs myCalendar.backup 260

       savesms  TODO  file  location  [-folder id] [-unread] [-read] [-unsent]
       [-sent] [-sender number] [-smsname name] [-smscset number] [-smscnumber
       number] [-reply] [-maxsms num]
              Saves a message with a todo entry. The content will be read from
              any backup format which Gammu supports and from given  location.

              For  description  of shared parameters see Common parameters for
              sendsms and savesms.

       sendsms   TODO   destination   file   location   [-report]   [-validity
       HOUR|6HOURS|DAY|3DAYS|WEEK|MAX]   [-save  [-folder  number]]  [-smscset
       number] [-smscnumber number] [-reply] [-maxsms num]
              Sends a message, for description of message specific  parameters
              see savesms TODO.

              For  description  of shared parameters see Common parameters for
              sendsms and savesms.

   Notes
       getallnotes
              Reads all notes from the phone.

              Note: Not all phones supports  this  function,  especially  most
              Sony Ericsson phones even if they have notes inside phone.

   Date, time and alarms
       getalarm [start]
              Get alarm from phone, if no location is specified, 1 is used.

       getdatetime
              Get date and time from phone

       setalarm hour minute
              Sets repeating alarm in phone on selected time.

       setdatetime [HH:MM[:SS]] [YYYY/MM/DD]
              Set  date  and  time  in phone to date and time set in computer.
              Please note, that  this  option  doesn’t  show  clock  on  phone
              screen. It only set date and time.

              TIP:  you  can  make  such  synchronization each time, when will
              connect your phone and use Gammu. See gammurc(5) for details.

   Categories
       addcategory TODO|PHONEBOOK text

       addnew file [-yes] [-memory ME|SM|..]
              Adds data written in  file  created  using  backup  option.  All
              things  backup’ed by backup can be restored (when made backup to
              Gammu text file).

              Please note that this adds all content of backup file  to  phone
              and does not care about current data in the phone (no duplicates
              are detected).

              Use -yes parameter to answer yes to all questions (you  want  to
              automatically restore all data).

              Use  -memory parameter to force usage of defined memory type for
              storing entries regardless what backu format says.

       backup file [-yes]
              Backup your phone to file. It’s possible to backup  (depends  on
              phone and backup format):

              * phonebook from SIM and phone memory
              * calendar notes
              * SMSC settings
              * operator logo
              * startup (static) logo or startup text
              * WAP bookmarks
              * WAP settings
              * caller logos and groups
              * user ringtones

              There are various backup formats supported and the backup format
              is guessed based on file extension:

              * .lmb - Nokia  backup,  supports  contacts,  caller  logos  and
              startup logo.
              * .vcs - vCalendar, supports calendar and todo.
              * .vcf - vCard, supports contacts.
              * .ldif - LDAP import, supports contacts.
              * .ics - iCalendar, supports calendar and todo.
              *  Any  other extension is Gammu backup file and it supports all
              data mentioned above.

              See EXAMPLE section for some hints on manipulating Gammu  backup
              format.

       clearall
              Deletes all private data from the phone.

       getallcategory TODO|PHONEBOOK

       getcategory TODO|PHONEBOOK start [stop]

       listmemorycategory text|number

       listtodocategory text|number

       restore file [-yes]
              Restore settings written in file created using backup option.

              Please note that restoring deletes all current content in phone.
              If you want only to add entries to phone, use addnew.

              In some phones restoring calendar notes will not show error, but
              won’t be done, when phone doesn’t have set clock inside.

   Backing up and restoring
       addnew file [-yes] [-memory ME|SM|..]
              Adds  data  written  in  file  created  using backup option. All
              things backup’ed by backup can be restored (when made backup  to
              Gammu text file).

              Please  note  that this adds all content of backup file to phone
              and does not care about current data in the phone (no duplicates
              are detected).

              Use  -yes  parameter to answer yes to all questions (you want to
              automatically restore all data).

              Use -memory parameter to force usage of defined memory type  for
              storing entries regardless what backu format says.

       addsms folder file [-yes]
              Adds  SMSes  from  file (format like backupsms uses) to selected
              folder in phone.

       backup file [-yes]
              Backup your phone to file. It’s possible to backup  (depends  on
              phone and backup format):

              * phonebook from SIM and phone memory
              * calendar notes
              * SMSC settings
              * operator logo
              * startup (static) logo or startup text
              * WAP bookmarks
              * WAP settings
              * caller logos and groups
              * user ringtones

              There are various backup formats supported and the backup format
              is guessed based on file extension:

              * .lmb - Nokia  backup,  supports  contacts,  caller  logos  and
              startup logo.
              * .vcs - vCalendar, supports calendar and todo.
              * .vcf - vCard, supports contacts.
              * .ldif - LDAP import, supports contacts.
              * .ics - iCalendar, supports calendar and todo.
              *  Any  other extension is Gammu backup file and it supports all
              data mentioned above.

              See EXAMPLE section for some hints on manipulating Gammu  backup
              format.

       backupsms file [-yes|-all]
              Stores all SMSes from phone to file.

              Use -yes for answering yes to all questions (backup all messages
              and delete them from phone), or -all to just backup all  folders
              while keeping messages in phone.

       restore file [-yes]
              Restore settings written in file created using backup option.

              Please note that restoring deletes all current content in phone.
              If you want only to add entries to phone, use addnew.

              In some phones restoring calendar notes will not show error, but
              won’t be done, when phone doesn’t have set clock inside.

       restoresms file [-yes]
              Restores  SMSes  from  file  (format  like  backupsms  uses)  to
              selected folder in  phone.  Please  note  that  this  overwrites
              existing messages in phone (if it supports it).

       savefile BOOKMARK target.url file location
              Converts backup format supported by Gammu to vBookmark file.

       savefile CALENDAR target.vcs file location
              Allows  to  convert  between  various backup formats which gammu
              supports for calendar events. The  file  type  is  guessed  (for
              input  file  guess  is  based on extension and file content, for
              output solely on extension).

              For example if you want  to  convert  single  entry  from  gammu
              native backup to vCalendar, you need following command:

                  gammu savefile CALENDAR output.vcs myCalendar.backup 260

       savefile TODO target.vcs file location
              Allows  to  convert  between  various backup formats which gammu
              supports for todo events. The file type is  guessed  (for  input
              file  guess  is  based on extension and file content, for output
              solely on extension).

              For example if you want  to  convert  single  entry  from  gammu
              native backup to vCalendar, you need following command:

                  gammu savefile CALENDAR output.vcs myCalendar.backup 260

       savefile VCARD10|VCARD21 target.vcf file SM|ME location
              Allows  to  convert  between  various backup formats which gammu
              supports for phonebook events. The file  type  is  guessed  (for
              input  file  guess  is  based on extension and file content, for
              output solely on extension).

              For example if you want  to  convert  single  entry  from  gammu
              native backup to vCard, you need following command:

                  gammu savefile CALENDAR output.vcf myPhonebook.backup ME 42

   Nokia specific
       nokiaaddfile    APPLICATION|GAME    file    [-readonly]    [-overwrite]
       [-overwriteall]
              Install the *.jar/*.jad file pair of a midlet in the application
              or game menu of the phone. You need to specify filename  without
              the jar/jad suffix, both will be added automatically.

              The  option  -overwrite  deletes the application’s .jad and .jar
              files bevor installing, but doesn’t delete the application data.
              Option  -overwriteall  will  also  delete  all  data. Both these
              options work only for Application or Game upload.

              Example:  gammu  nokiaaddfile  Application   Alien   will   read
              Alien.JAD and Alien.JAR and add to Applications

              Example:  gammu  nokiaaddfile  Tones file.mid will read file.mid
              and add to Tones folder

              You can use jadmaker(1) to generate a  .jad  file  from  a  .jar
              file.

       nokiaaddfile
       GALLERY|GALLERY2|CAMERA|TONES|TONES2|RECORDS|VIDEO|PLAYLIST|MEMORYCARD
       file   [-name   name]   [-protected]  [-readonly]  [-system]  [-hidden]
       [-newtime]

       nokiaaddplaylists

              Goes  through  phone memory and generated playlist for all music
              files found.

              To manually manage playlists:

                  gammu addfile a:\predefplaylist filename.m3u

              Will add playlist filename.m3u

                  gammu getfilesystem

              Will get list of  all  files  (including  names  of  files  with
              playlists)

                  gammu deletefiles a:\predefplaylist\filename.m3u

              Will delete playlist filename.m3u

              Format of m3u playlist is easy (standard mp3 playlist):

              First  line  is  #EXTM3U,  next  lines  contain   names of files
              (b:\file1.mp3, b:\folder1\file2.mp3, etc.). File  needs  t  have
              ’\r\n’  terminated  lines. So just run unix2dos on the resulting
              file before uploading it your your phone.

       nokiacomposer file
              Show, how to enter RTTL ringtone in composer  existing  in  many
              Nokia phones (and how should it look like).

       nokiadebug filename [[v11-22] [,v33-44]...]

       nokiadisplayoutput

       nokiadisplaytest number

       nokiagetadc

       nokiagetoperatorname
              6110.c  phones  have  place  for  name  for  one GSM network (of
              course, with flashing it’s possible to  change  all  names,  but
              Gammu  is  not  flasher  ;-)).  You can get this name using this
              option.

       nokiagetpbkfeatures memorytype

       nokiagetscreendump

       nokiagett9
              This option should  display  T9  dictionary  content  from  DCT4
              phones.

       nokiagetvoicerecord location

              Get  voice  record  from  location and save to WAV file. File is
              coded using GSM 6.10 codec (available  for  example  in  win32).
              Name of file is like name of voice record in phone.

              Created WAV files require GSM 6.10 codec to be played. In Win XP
              it’s included by Microsoft. If you deleted  it  by  accident  in
              this operating system, make such steps:

              1. Control Panel
              2. Add hardware
              3. click Next
              4. select "Yes. I have already connected the hardware"
              5. select "Add a new hardware device"
              6.  select  "Install  the hardware that I manually select from a
              list"
              7. select "Sound, video and game controllers"
              8. select "Audio codecs"
              9.  select "windowstem32" directory and file "mmdriver.inf"
              10. if You  will  be  asked  for  file  msgsm32.acm,  it  should
              unpacked from Windows CD
              11.  now  You  can  be  asked if want to install unsigned driver
              (YES), about select codec configuration (select what  you  want)
              and rebotting PC (make it)

       nokiamakecamerashoot

       nokianetmonitor test
              Takes output or set netmonitor for Nokia DCT3 phones.

              TIP:   For   more   info   about   this   option,  please  visit
              http://www.mwiacek.com and read netmonitor manual.

              TIP: test 243 enables  all  tests  (after  using  command  gammu
              nokianetmonitor  243  in  some  phones like 6210 or 9210 have to
              reboot them to see netmonitor menu)

       nokianetmonitor36
              Reset counters from netmonitor test 36 in Nokia DCT3 phones.

              TIP:  For  more   info   about   this   option,   please   visit
              http://www.mwiacek.com and read netmonitor manual.

       nokiasecuritycode
              Get/reset to "12345" security code

       nokiaselftests

              Perform tests for Nokia DCT3 phones.

              Note:  EEPROM  test  can  show  an  error when your phone has an
              EEPROM in flash (like 82xx/7110/62xx/33xx). The clock test  will
              show  an  error  when the phone doesn?t have an internal battery
              for the clock (like 3xxx).

       nokiasetlights keypad|display|torch on|off

       nokiasetoperatorname [networkcode name]

       nokiasetphonemenus
              Enable all (?) possible menus for DCT3 Nokia phones:

              1. ALS (Alternative Line Service) option menu
              2. vibra menu for 3210
              3. 3315 features in 3310 5.45 and higher
              4. two additional games (React and  Logic)  for  3210  5.31  and
              higher
              5. WellMate menu for 6150
              6. NetMonitor

              and for DCT4:

              1. ALS (Alternative Line Service) option menu
              2. Bluetooth, WAP bookmarks and settings menu, ... (6310i)
              3. GPRS Always Online
               ...

       nokiasetvibralevel level
              Set vibra power to "level" (given in percent)

       nokiatuneradio

       nokiavibratest

   Siemens specific
       siemensnetmonact netmon_type

              Enables network monitor in Siemens phone. Currently known values
              for type are 1 for full and 2 for simple mode.

       siemensnetmonitor test

       siemenssatnetmon

   Network
       getgprspoint start [stop]

       listnetworks [country]
              Show names/codes of GSM networks known for Gammu

       monitor [times]
              Get phone status and writes  continuously  to  standard  output.
              Press Ctrl+C to break this state.

       networkinfo
              Show information about network status from the phone.

       nokiadebug filename [[v11-22] [,v33-44]...]

       nokiagetoperatorname
              6110.c  phones  have  place  for  name  for  one GSM network (of
              course, with flashing it’s possible to  change  all  names,  but
              Gammu  is  not  flasher  ;-)).  You can get this name using this
              option.

       nokianetmonitor test
              Takes output or set netmonitor for Nokia DCT3 phones.

              TIP:  For  more   info   about   this   option,   please   visit
              http://www.mwiacek.com and read netmonitor manual.

              TIP:  test  243  enables  all  tests  (after using command gammu
              nokianetmonitor 243 in some phones like 6210  or  9210  have  to
              reboot them to see netmonitor menu)

       nokiasetoperatorname [networkcode name]

       setautonetworklogin

       siemensnetmonact netmon_type

              Enables network monitor in Siemens phone. Currently known values
              for type are 1 for full and 2 for simple mode.

       siemensnetmonitor test

       siemenssatnetmon

   WAP settings and bookmarks
       addnew file [-yes] [-memory ME|SM|..]
              Adds data written in  file  created  using  backup  option.  All
              things  backup’ed by backup can be restored (when made backup to
              Gammu text file).

              Please note that this adds all content of backup file  to  phone
              and does not care about current data in the phone (no duplicates
              are detected).

              Use -yes parameter to answer yes to all questions (you  want  to
              automatically restore all data).

              Use  -memory parameter to force usage of defined memory type for
              storing entries regardless what backu format says.

       backup file [-yes]
              Backup your phone to file. It’s possible to backup  (depends  on
              phone and backup format):

              * phonebook from SIM and phone memory
              * calendar notes
              * SMSC settings
              * operator logo
              * startup (static) logo or startup text
              * WAP bookmarks
              * WAP settings
              * caller logos and groups
              * user ringtones

              There are various backup formats supported and the backup format
              is guessed based on file extension:

              * .lmb - Nokia  backup,  supports  contacts,  caller  logos  and
              startup logo.
              * .vcs - vCalendar, supports calendar and todo.
              * .vcf - vCard, supports contacts.
              * .ldif - LDAP import, supports contacts.
              * .ics - iCalendar, supports calendar and todo.
              *  Any  other extension is Gammu backup file and it supports all
              data mentioned above.

              See EXAMPLE section for some hints on manipulating Gammu  backup
              format.

       clearall
              Deletes all private data from the phone.

       deletewapbookmark start [stop]
              Delete WAP bookmarks from phone.

              Locations are numerated from 1.

       getchatsettings start [stop]

       getsyncmlsettings start [stop]

       getwapbookmark start [stop]
              Get WAP bookmarks from phone.

              Locations are numerated from 1.

       getwapsettings start [stop]
              Get WAP settings from phone.

              Locations are numerated from 1.

       restore file [-yes]
              Restore settings written in file created using backup option.

              Please note that restoring deletes all current content in phone.
              If you want only to add entries to phone, use addnew.

              In some phones restoring calendar notes will not show error, but
              won’t be done, when phone doesn’t have set clock inside.

       savefile BOOKMARK target.url file location
              Converts backup format supported by Gammu to vBookmark file.

       savesms BOOKMARK file location [-folder id] [-unread] [-read] [-unsent]
       [-sent] [-sender number] [-smsname name] [-smscset number] [-smscnumber
       number] [-reply] [-maxsms num]
              Read  WAP  bookmark from file created by backup option and saves
              in Nokia format as SMS

              For description of shared parameters see Common  parameters  for
              sendsms and savesms.

       savesms WAPINDICATOR URL Title [-folder id] [-unread] [-read] [-unsent]
       [-sent] [-sender number] [-smsname name] [-smscset number] [-smscnumber
       number] [-reply] [-maxsms num]
              Saves a SMS with a WAP indication for given URL and title.

              For  description  of shared parameters see Common parameters for
              sendsms and savesms.

       savesms WAPSETTINGS file  location  DATA|GPRS  [-folder  id]  [-unread]
       [-read]  [-unsent]  [-sent]  [-sender number] [-smsname name] [-smscset
       number] [-smscnumber number] [-reply] [-maxsms num]
              Read WAP settings from file created by backup option  and  saves
              in Nokia format as SMS

              For  description  of shared parameters see Common parameters for
              sendsms and savesms.

       sendsms  BOOKMARK  destination  file  location   [-report]   [-validity
       HOUR|6HOURS|DAY|3DAYS|WEEK|MAX]   [-save  [-folder  number]]  [-smscset
       number] [-smscnumber number] [-reply] [-maxsms num]
              Sends a message, for description of message specific  parameters
              see savesms BOOKMARK.

              For  description  of shared parameters see Common parameters for
              sendsms and savesms.

       sendsms  WAPINDICATOR  destination  URL  Title   [-report]   [-validity
       HOUR|6HOURS|DAY|3DAYS|WEEK|MAX]   [-save  [-folder  number]]  [-smscset
       number] [-smscnumber number] [-reply] [-maxsms num]
              Sends a message, for description of message specific  parameters
              see savesms WAPINDICATOR.

              For  description  of shared parameters see Common parameters for
              sendsms and savesms.

       sendsms  WAPSETTINGS  destination  file  location  DATA|GPRS  [-report]
       [-validity  HOUR|6HOURS|DAY|3DAYS|WEEK|MAX]  [-save  [-folder  number]]
       [-smscset number] [-smscnumber number] [-reply] [-maxsms num]
              Sends a message, for description of message specific  parameters
              see savesms WAPSETTINGS.

              For  description  of shared parameters see Common parameters for
              sendsms and savesms.

   MMS and MMS settings
       getallmms [-save]

       geteachmms [-save]

       getmmsfolders

       getmmssettings start [stop]

       readmmsfile file [-save]

       savesms MMSINDICATOR URL Title Sender [-folder  id]  [-unread]  [-read]
       [-unsent]  [-sent]  [-sender  number] [-smsname name] [-smscset number]
       [-smscnumber number] [-reply] [-maxsms num]

              Saves a message with MMS indication. The  recipient  phone  will
              then download MMS from given URL and display it.

              Please note that you should provide valid smil data on that URL.

              For description of shared parameters see Common  parameters  for
              sendsms and savesms.

       savesms  MMSSETTINGS  file  location   [-folder  id]  [-unread] [-read]
       [-unsent] [-sent] [-sender number] [-smsname  name]  [-smscset  number]
       [-smscnumber number] [-reply] [-maxsms num]
              Saves  a  message with MMS configuration. The configuration will
              be read from Gammu backup file from given location.

              For description of shared parameters see Common  parameters  for
              sendsms and savesms.

       sendsms  MMSINDICATOR destination URL Title Sender [-report] [-validity
       HOUR|6HOURS|DAY|3DAYS|WEEK|MAX]  [-save  [-folder  number]]   [-smscset
       number] [-smscnumber number] [-reply] [-maxsms num]
              Sends  a message, for description of message specific parameters
              see savesms MMSINDICATOR.

              For description of shared parameters see Common  parameters  for
              sendsms and savesms.

       sendsms  MMSSETTINGS  destination  file  location  [-report] [-validity
       HOUR|6HOURS|DAY|3DAYS|WEEK|MAX]  [-save  [-folder  number]]   [-smscset
       number] [-smscnumber number] [-reply] [-maxsms num]
              Sends  a message, for description of message specific parameters
              see savesms MMSSETTINGS.

              For description of shared parameters see Common  parameters  for
              sendsms and savesms.

   Phone tests
       nokiadisplaytest number

       nokiagetadc

       nokiaselftests

              Perform tests for Nokia DCT3 phones.

              Note:  EEPROM  test  can  show  an  error when your phone has an
              EEPROM in flash (like 82xx/7110/62xx/33xx). The clock test  will
              show  an  error  when the phone doesn?t have an internal battery
              for the clock (like 3xxx).

       nokiasetlights keypad|display|torch on|off

       nokiavibratest

   FM radio
       addnew file [-yes] [-memory ME|SM|..]
              Adds data written in  file  created  using  backup  option.  All
              things  backup’ed by backup can be restored (when made backup to
              Gammu text file).

              Please note that this adds all content of backup file  to  phone
              and does not care about current data in the phone (no duplicates
              are detected).

              Use -yes parameter to answer yes to all questions (you  want  to
              automatically restore all data).

              Use  -memory parameter to force usage of defined memory type for
              storing entries regardless what backu format says.

       backup file [-yes]
              Backup your phone to file. It’s possible to backup  (depends  on
              phone and backup format):

              * phonebook from SIM and phone memory
              * calendar notes
              * SMSC settings
              * operator logo
              * startup (static) logo or startup text
              * WAP bookmarks
              * WAP settings
              * caller logos and groups
              * user ringtones

              There are various backup formats supported and the backup format
              is guessed based on file extension:

              * .lmb - Nokia  backup,  supports  contacts,  caller  logos  and
              startup logo.
              * .vcs - vCalendar, supports calendar and todo.
              * .vcf - vCard, supports contacts.
              * .ldif - LDAP import, supports contacts.
              * .ics - iCalendar, supports calendar and todo.
              *  Any  other extension is Gammu backup file and it supports all
              data mentioned above.

              See EXAMPLE section for some hints on manipulating Gammu  backup
              format.

       clearall
              Deletes all private data from the phone.

       getfmstation start [stop]
              Show info about FM stations in phone

       nokiatuneradio

       restore file [-yes]
              Restore settings written in file created using backup option.

              Please note that restoring deletes all current content in phone.
              If you want only to add entries to phone, use addnew.

              In some phones restoring calendar notes will not show error, but
              won’t be done, when phone doesn’t have set clock inside.

   Phone information
       checkfirmware

              Gammu  connects  to www.gammu.org and checks for latest firmware
              versions    available    for    the     device.     The     file
              <http://www.gammu.org/support/phones/phonedbxml.php?model=x>
              will be downloaded and all phone details will be read  from  it.
              No  private  data  are  sent  to  server. Internet connection to
              www.gammu.org on port 80 required.

       getdisplaystatus

       getlocation
              Gets network information from phone (same  as  networkinfo)  and
              prints  location  (latitude  and longitude) based on information
              from OpenCellID <http://opencellid.org>.

       getsecuritystatus
              Show, if phone wait for security code (like PIN, PUK,  etc.)  or
              not

       identify
              Show the most important phone data.

       monitor [times]
              Get  phone  status  and  writes continuously to standard output.
              Press Ctrl+C to break this state.

       nokiasecuritycode
              Get/reset to "12345" security code

   Phone settings
       getcalendarsettings
              Displays calendar settings like first day of week  or  automatic
              deleting of old entries.

       getprofile start [stop]

       resetphonesettings PHONE|DEV|UIF|ALL|FACTORY
              Reset phone settings. BE CAREFULL !!!!

              PHONE:

              DEV:

              ALL:

              Clear user settings
              * removes or set logos to default
              * set default phonebook and other menu settings
              * clear T9 words,
              * clear call register info
              * set default profiles settings
              * clear user ringtones

              UIF:
              * changes like after ALL
              * disables netmon and PPS (all "hidden" menus)

              FACTORY:
              * changes like after UIF
              * clear date/time

       savesms  PROFILE  [-folder  id]  [-unread]  [-read]  [-unsent]  [-sent]
       [-sender number] [-smsname name] [-smscset number] [-smscnumber number]
       [-reply]   [-maxsms  num]  [-name  name]  [-bitmap  bitmap]  [-ringtone
       ringtone]

              Read  ringtone  (RTTL)  format,  bitmap (Picture Image size) and
              name, format into Smart Messaging profile and send/save as  SMS.
              Please  note,  that  this  format  is  abandomed  by  Nokia  and
              supported by some (older) devices only like Nokia 3310.

              For description of shared parameters see Common  parameters  for
              sendsms and savesms.

       sendsms       PROFILE       destination       [-report]      [-validity
       HOUR|6HOURS|DAY|3DAYS|WEEK|MAX]  [-save  [-folder  number]]   [-smscset
       number]  [-smscnumber  number]  [-reply]  [-maxsms  num]  [-name  name]
       [-bitmap bitmap] [-ringtone ringtone]
              Sends  a message, for description of message specific parameters
              see savesms PROFILE.

              For description of shared parameters see Common  parameters  for
              sendsms and savesms.

   Dumps decoding
       decodebinarydump file [phonemodel]
              Decodes  a  dump  made by Gammu with logformat se to binary (see
              README for info about this method of reporting bugs).

              This option  is  available  only  if  Gammu  was  compiled  with
              debuging options.

       decodesniff MBUS2|IRDA file [phonemodel]
              Option  available only, if Gammu was compiled with debug. Allows
              to  decode  sniffs.  See  /docs/develop/develop.txt   for   more
              details.

       makeconverttable file

   Functions that dont fit elsewhere
       batch [file]
              Starts Gammu in a batch mode. In this mode you can issue several
              commands each on one line. Lines starting with # are treated  as
              a comments.

              By  default,  commands are read from standard input, but you can
              optionally specify a file from where they would be read (special
              case - means standard input).

       entersecuritycode PIN|PUK|PIN2|PUK2|PHONE|NETWORK code|-
              Allow to enter security code from PC. When code is -, it is read
              from stdin.

       nokiagetscreendump

       nokiagetvoicerecord location

              Get voice record from location and save to  WAV  file.  File  is
              coded  using  GSM  6.10  codec (available for example in win32).
              Name of file is like name of voice record in phone.

              Created WAV files require GSM 6.10 codec to be played. In Win XP
              it’s  included  by  Microsoft.  If you deleted it by accident in
              this operating system, make such steps:

              1. Control Panel
              2. Add hardware
              3. click Next
              4. select "Yes. I have already connected the hardware"
              5. select "Add a new hardware device"
              6. select "Install the hardware that I manually  select  from  a
              list"
              7. select "Sound, video and game controllers"
              8. select "Audio codecs"
              9.  select "windowstem32" directory and file "mmdriver.inf"
              10.  if  You  will  be  asked  for  file  msgsm32.acm, it should
              unpacked from Windows CD
              11. now You can be asked if  want  to  install  unsigned  driver
              (YES),  about  select codec configuration (select what you want)
              and rebotting PC (make it)

       nokiamakecamerashoot

       nokiasetphonemenus
              Enable all (?) possible menus for DCT3 Nokia phones:

              1. ALS (Alternative Line Service) option menu
              2. vibra menu for 3210
              3. 3315 features in 3310 5.45 and higher
              4. two additional games (React and  Logic)  for  3210  5.31  and
              higher
              5. WellMate menu for 6150
              6. NetMonitor

              and for DCT4:

              1. ALS (Alternative Line Service) option menu
              2. Bluetooth, WAP bookmarks and settings menu, ... (6310i)
              3. GPRS Always Online
               ...

       nokiasetvibralevel level
              Set vibra power to "level" (given in percent)

       presskeysequence mMnNpPuUdD+-123456789*0#gGrR<>[]hHcCjJfFoOmMdD@
              Press specified key sequence on phone keyboard

              mM - Menu
              nN - Names key
              pP - Power
              uU - Up
              dD - Down
              +- - +-
              gG - Green
              rR - Red
              123456789*0# is numeric keyboard

       reset SOFT|HARD
              Make  phone  reset:  soft (without asking for PIN) or hard (with
              PIN).

              Note: some phones will make hard reset even with SOFT option.

       searchphone [-debug]
              Attempts to search for a connected phone. Please note that  this
              can  take  a very long time, but in case you have no clue how to
              configure phone connection, this is a  convenient  way  to  find
              working setup for Gammu.

   Gammu information
       checkversion [STABLE]
              Checks whether there is newer Gammu version available online (if
              Gammu has been compiled  with  CURL).  If  you  pass  additional
              parameter STABLE, only stable versions will be checked.

       features
              Print information about compiled in features.

       help [topic]
              Print help. By default general help is printed, but you can also
              specify a help category to get more detailed help on some topic.

       version
              Print version information and license.

FILES

       ~/.gammurc
       /usr/share/doc/gammu/*
       /dev/ircomm?
       /dev/ttyS?
       /dev/ttyACM?

RETURN VALUES

       gammu  returns  0  on  success.  In  case  of  failure non zero code is
       returned.

   1
       Out of memory or other critical error.

   2
       Invalid command line parameters.

   3
       Failed to open file specified on command line.

   4
       Program was interrupted.

   98
       Gammu library version mismatch.

   99
       Functionality has been moved. For example to gammu-smsd(1).

       Errors codes greater than 100 map to the GSM_Error values increased  by
       100:

   101
       No error.

   102
       Error opening device. Unknown, busy or no permissions.

   103
       Error opening device, it is locked.

   104
       Error opening device, it doesn’t exist.

   105
       Error opening device, it is already opened by other application.

   106
       Error opening device, you don’t have permissions.

   107
       Error opening device. No required driver in operating system.

   108
       Error opening device. Some hardware not connected/wrongly configured.

   109
       Error setting device DTR or RTS.

   110
       Error setting device speed. Maybe speed not supported.

   111
       Error writing to the device.

   112
       Error during reading from the device.

   113
       Can’t set parity on the device.

   114
       No response in specified timeout. Probably phone not connected.

   115
       Frame  not requested right now. See <http://wammu.eu/support/bugs/> for
       information how to report it.

   116
       Unknown response from phone.  See  <http://wammu.eu/support/bugs/>  for
       information how to report it.

   117
       Unknown  frame. See <http://wammu.eu/support/bugs/> for information how
       to report it.

   118
       Unknown connection type string. Check config file.

   119
       Unknown model type string. Check config file.

   120
       Some functions not available for your system (disabled in config or not
       implemented).

   121
       Function not supported by phone.

   122
       Entry is empty.

   123
       Security error. Maybe no PIN?

   124
       Invalid location. Maybe too high?

   125
       Functionality not implemented. You are welcome to help authors with it.

   126
       Memory full.

   127
       Unknown error.

   128
       Can not open specified file.

   129
       More memory required...

   130
       Operation not allowed by phone.

   131
       Empty SMSC number. Set in phone or use -smscnumber.

   132
       You’re inside phone menu (maybe editing?). Leave it and try again.

   133
       Phone is not connected.

   134
       Function is currently being implemented. If you want  to  help,  please
       contact authors.

   135
       Phone is disabled and connected to charger.

   136
       File format not supported by Gammu.

   137
       Nobody is perfect, some bug appeared in protocol implementation. Please
       contact authors.

   138
       Transfer was canceled by phone, maybe you pressed cancel on phone.

   139
       Phone module need to send another answer frame.

   140
       Current connection type doesn’t support called function.

   141
       CRC error.

   142
       Invalid date or time specified.

   143
       Phone memory error, maybe it is read only.

   144
       Invalid data given to phone.

   145
       File with specified name already exists.

   146
       File with specified name doesn’t exist.

   147
       You have to give folder name and not file name.

   148
       You have to give file name and not folder name.

   149
       Can not access SIM card.

   150
       Wrong GNAPPLET version in phone. Use version from currently used Gammu.

   151
       Only part of folder has been listed.

   152
       Folder must be empty.

   153
       Data were converted.

   154
       Gammu is not configured.

   155
       Wrong folder used.

   156
       Internal phone error.

   157
       Error writing file to disk.

   158
       No such section exists.

   159
       Using default values.

   160
       Corrupted data returned by phone.

   161
       Bad feature string in configuration.

   162
       Desired functionality has been disabled on compile time.

   163
       Bluetooth configuration requires channel option.

   164
       Service is not runnig.

   165
       Service configuration is missing.

   166
       Command rejected because device was busy. Wait and restart.

   167
       Could not connect to the server.

   168
       Could not resolve the host name.

EXAMPLE

   Configuration
       To  check  it  out,  you need to have configuration file for gammu, see
       gammurc(5) for more details about it.

   Sending messages
       Save text message up to standard 160 chars:

              echo "All your base are belong to us" | gammu savesms TEXT

       or

              gammu savesms TEXT -text "All your base are belong to us"

       Save long text message:

              echo "All your base are belong to us" | gammu savesms TEXT -len 400

       or

              gammu savesms TEXT -len 400 -text "All your base are belong to us"

       or

              gammu savesms EMS -text "All your base are belong to us"

       Save some funky message with predefined  sound  and  animation  from  2
       bitmaps:

              gammu savesms EMS -text "Greetings" -defsound 1 -text "from Gammu"
              -tone10 axelf.txt -animation 2 file1.bmp file2.bmp

       Save protected message with ringtone:

              gammu savesms EMS -protected 2 -variablebitmaplong ala.bmp
              -toneSElong axelf.txt -toneSE ring.txt

   Backups
       If you will backup settings to Gammu text file, it will be possible  to
       edit  it.  It’s easy: many things in this file will be written double -
       once in Unicode, once in ASCII. When you will  remove  Unicode  version
       Gammu  will use ASCII on restore (and you can easy edit ASCII text) and
       will convert it according to your OS locale.  When  will  be  available
       Unicode  version of text, it will be used instead of ASCII (useful with
       Unicode phones - it isn’t important, what locale is set in computer and
       no conversion Unicode -> ASCII and ASCII -> Unicode is done).

       You can use any editor with regular expressions function to edit backup
       text file. Examples of such editors can be vim <http://www.vim.org/> or
       TextPad   <http://www.textpad.com/>   which  both  do  support  regular
       expressions.

       Remove info about voice tags

              Find: ^Entry\([0-9][0-9]\)VoiceTag = \(.*\)\n

              Replace:

       Change all numbers starting from +3620, +3630, +3660, +3670 to +3620

              Find:   Type    =    NumberGeneral\nEntry\([0-9][0-9]\)Text    =
              "\+36\(20\|30\|60\|70\)\n

              Replace: Type = NumberMobile\nEntry\1Text = "\+3620

       Change  phone  numbers  type to mobile for numbers starting from +3620,
       +3630,... and removing the corresponding TextUnicode line

              Find:    Type    =    NumberGeneral\nEntry\([0-9][0-9]\)Text   =
              "\+36\([2367]0\)\([^\"]*\)"\nEntry\([0-9][0-9]\)TextUnicode    =
              \([^\n]*\)\n

              Replace: Type = NumberMobile\nEntry\1Text = "\+36\2\3"\n

COPYRIGHT

       Copyright  © 2003 - 2010 Marcin Wiacek, Michal Cihar and other authors.
       License        GPLv2:         GNU         GPL         version         2
       <http://www.gnu.org/licenses/old-licenses/gpl-2.0.html>
       This  is  free  software:  you  are free to change and redistribute it.
       There is NO WARRANTY, to the extent permitted by law.

REPORTING BUGS

       There are definitely many bugs, reporting to author is welcome.  Please
       include  some  useful  information when sending bug reports (especially
       debug logs, operating system, it’s version and  phone  information  are
       needed).

       To  generate  debug log, enable it in gammurc (alternatively you can do
       it on command line using -d textall -f /tmp/gammu.log):

              [gammu]
              YOUR CONNECTION SETTINGS
              logfile = /tmp/gammu.log
              logformat = textall

       With this settings, Gammu generates /tmp/gammu.log on  each  connection
       to phone and stores dump of communication there. You can also find some
       hints for improving support for your phone in this log.

       See <http://wammu.eu/support/bugs/> for more information  on  reporting
       bugs.

       Please report bugs to <http://bugs.cihar.com>.

AUTHOR

       You can contact authors on <gammu-users@lists.sourceforge.net>.

       Michal  Cihar  <michal@cihar.com>  is  current  project  maintainer and
       contributor of most of AT and OBEX code.

       Marcin Wiacek <marcin@mwiacek.com> is project iniciator and contributor
       of most Nokia code.

       As  this  project  grew from Gnokii, we would like to thanks all Gnokii
       developers, especially Pavel Janik, Pawel Kot and Manfred Jonsson  (see
       CREDITS from Gnokii for all their contributor).

       Many  other  people  have helped with various features, check ChangeLog
       for more details.

SEE ALSO

       gammu-smsd(1), gammu-smsd-inject(1), gammurc(5), jadmaker(1)

       Some  more  hints  can  be  found   in   README   file   or   on   wiki
       <http://www.gammu.org/>.

       Related programs which can be used with GSM modem:

       cu(1), gnokii(1), minicom(1)

       Graphical interfaces for Gammu:

       wammu(1), gmobilemedia(1)