summaryrefslogtreecommitdiff
path: root/gpsd.xml
diff options
context:
space:
mode:
authorChris Kuethe <chris.kuethe@gmail.com>2006-09-28 20:23:08 +0000
committerChris Kuethe <chris.kuethe@gmail.com>2006-09-28 20:23:08 +0000
commit6b1c624fc2007b335a534d78853ec9de358e305f (patch)
tree377868157a340d535fa349a5067cb4ba280e3943 /gpsd.xml
parent5512ce47cdce9208d2b491f5c0aea8f25acc01c7 (diff)
downloadgpsd-6b1c624fc2007b335a534d78853ec9de358e305f.tar.gz
Protect the | command by adding a -x command line option.
Experimental or debugging features which could damage hardware could can be wrapped in if (dangerous) { /* ... */ ; } so that they will only work if -x is set.
Diffstat (limited to 'gpsd.xml')
-rw-r--r--gpsd.xml7
1 files changed, 5 insertions, 2 deletions
diff --git a/gpsd.xml b/gpsd.xml
index 38130dd2..83aa9436 100644
--- a/gpsd.xml
+++ b/gpsd.xml
@@ -621,8 +621,11 @@ be sent to the gps receiver, packs them into a binary representation and
forwards them on to the device. Hex encoding is used so that both binary
or text (NMEA) commands can be sent to the receiver. The '=' is optional:
"|64656667" and "|=64656667" both send the string "defg" to the receiver.
-Use of this command is tantamount to connecting your receiver to an
-untrusted remote user's computer, ie. it's dangerous.</para></listitem>
+This command is similar to the ! command available over the control socket
+but | is available over the network. To mitigate against hostile remote
+users, the | command will not be honoured unless
+<application>gpsd</application> is invoked with the (intentionally
+undocumented) <term>-x</term> flag.</para></listitem>
</varlistentry>
</variablelist>