1RN2NCID.CONF(5)                      NCID                      RN2NCID.CONF(5)
2
3
4

NAME

6       rn2ncid.conf - rn2ncid configuration file
7

DESCRIPTION

9       The  rn2ncid.conf  file  contains  the  configuration  information  for
10       rn2ncid.
11
12       The rn2ncid.conf file understands 3 types of lines:
13
14       blank line
15              ignored
16
17       comment line, beginning with '#'
18              ignored
19
20       VARIABLE = VALUE
21              VALUE can contain spaces if it is between quotes.
22
23       See rn2ncid.conf for all default values.
24

VARIABLES

26       verbose = level
27              Level is in the range 1-9. Not all verbose levels are used.
28
29       HostnameFlag = value
30              Value is 0 or 1.  Includes hostname in the IDENT string if 1.
31
32       ncidaddr = host address
33              The NCID server host address can be an IP address or  a  resolv‐
34              able host name.
35
36       ncidport = port
37              The NCID server port number.
38
39       delay = seconds
40              If the connection to the NCID server is lost, this specifies the
41              number of seconds between reconnection attempts.
42
43       cellport = port
44              The listen port as specified in the Remote Notifier application.
45
46       reject = from address[,from address][,from address]...
47              SMS and MMS messages usually have a 'from' address and depending
48              on the carrier this could be a number or an email address. Spec‐
49              ify a comma separated list of addresses that will NOT be  trans‐
50              mitted by the NCID server to all listening NCID clients. This is
51              used to prevent endless loops which could result in  excessively
52              high data or text charges by your cell phone carrier.
53
54       Remote  Notifier  sends the 'from' address in its 'data' (fifth) field.
55       See NOTES below.
56
57       An example of an endless loop would be:
58
59            -  cell phone gets SMS
60
61            -  Remote Notifier sends out the SMS
62
63            -  rn2ncid gets the SMS and sends it to the NCID server as 'MSG'
64
65            -  the ncid-page module gets this 'MSG' and forwards  it  back  to
66               the cell phone
67
68            -  cell phone gets the 'MSG' as an SMS
69
70            -  cycle repeats forever
71
72       To  prevent  this endless loop, suppose you have ncid-page.conf config‐
73       ured to send SMS messages to your cell 'from' your  email  address  of:
74       johndoe@yahoo.com
75
76       You might want to set 'reject' to be:
77
78          reject = johndoe@yahoo.com
79

NOTES

81       Remote Notifier sends six pieces of information:
82
83            -  (1) version (e.g., 'v2')
84
85            -  (2) unique device id in hex
86
87            -  (3) unique notification id in hex
88
89            -  (4) event type (BATTERY, PING, SMS, etc.)
90
91            -  (5) data (terse information)
92
93            -  (6) event contents (verbose free-form text, can be multi-line)
94

EXAMPLES

96       Set the NCID server IP address:
97
98          ncidaddr = 192.168.1.20
99
100       Set the Remote Notifier listen port
101
102          cellport = 10600
103
104       Reject SMS/MMS messages to manage text blocking
105
106          reject = 9999
107

SEE ALSO

109       rn2ncid.1
110
111
112
113NCID                              2019-08-17                   RN2NCID.CONF(5)
Impressum