docs/manual/smsd/inject.rst

   1 .. _gammu-smsd-inject:
   2
   3 gammu-smsd-inject
   4 =================
   5
   6 .. program:: gammu-smsd-inject
   7
   8 Synopsis
   9 --------
  10
  11 .. code-block:: text
  12
  13     gammu-smsd-inject [OPTION]... MESSAGETYPE RECIPIENT [MESSAGE_PARAMETER]...
  14
  15 Description
  16 -----------
  17
  18 This manual page documents briefly the :program:`gammu-smsd-inject` command.
  19
  20 :program:`gammu-smsd-inject` is a program that enqueues message in Gammu SMS
  21 Daemon, which will be later sent by the daemon using connected GSM modem.
  22
  23 Support for this program depends on features available in currently used SMSD
  24 service backend, however currently it is supported by all of them.
  25
  26 Program accepts following options (please note that long options might be not
  27 accepted on some platforms):
  28
  29 .. option:: -h, --help
  30
  31     Shows help.
  32
  33 .. option:: -v, --version
  34
  35     Shows version information and compiled in features.
  36
  37 .. option:: -c, --config=file
  38
  39     Configuration file to use, default is /etc/gammu-smsdrc, on Windows there
  40     is no default and configuration file path has to be always specified.
  41
  42 .. option:: -l, --use-log
  43
  44     Use logging as configured in config file.
  45
  46 .. option:: -L, --no-use-log
  47
  48     Do not use logging as configured in config file (default).
  49
  50 For description of message types and their parameters, please check documentation
  51 for :option:`gammu savesms`.
  52
  53 Examples
  54 --------
  55
  56 To check it out, you need to have configuration file for SMSD, see
  57 :ref:`gammu-smsdrc` for more details about it.
  58
  59 Inject text message up to standard 160 chars:
  60
  61 .. code-block:: sh
  62
  63     echo "All your base are belong to us" | gammu-smsd-inject TEXT 123456
  64
  65 or
  66
  67 .. code-block:: sh
  68
  69     gammu-smsd-inject TEXT 123456 -text "All your base are belong to us"
  70
  71 Inject long text message:
  72
  73 .. code-block:: sh
  74
  75     echo "All your base are belong to us" | gammu-smsd-inject TEXT 123456 -len 400
  76
  77 or
  78
  79 .. code-block:: sh
  80
  81     gammu-smsd-inject TEXT 123456 -len 400 -text "All your base are belong to us"
  82
  83 or
  84
  85 .. code-block:: sh
  86
  87     gammu-smsd-inject EMS 123456 -text "All your base are belong to us"
  88
  89 Inject some funky message with predefined sound and animation from 2 bitmaps:
  90
  91 .. code-block:: sh
  92
  93     gammu-smsd-inject EMS 123456 -text "Greetings" -defsound 1 -text "from Gammu" -tone10 axelf.txt -animation 2 file1.bmp file2.bmp
  94
  95 Inject protected message with ringtone:
  96
  97 .. code-block:: sh
  98
  99     gammu-smsd-inject EMS 123456 -protected 2 -variablebitmaplong ala.bmp -toneSElong axelf.txt -toneSE ring.txt