1RN2NCID.CONF(5) NCID RN2NCID.CONF(5)
2
3
4
6 rn2ncid.conf - rn2ncid configuration file
7
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
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
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
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
109 rn2ncid.1
110
111
112
113NCID 2019-08-17 RN2NCID.CONF(5)