README.PACKAGERS 1.5 KB

1234567891011121314151617181920212223242526272829303132333435
  1. = Recommendations for distribution integrators =
  2. The X11 subdirectory contains icons and a project logo for use
  3. in desktop packaging.
  4. Usable deb and RPM specifications have their own subdirectories here.
  5. Our package files want to set up a hotplug script to notify gpsd
  6. when a potential GPS device goes active and should be polled. The
  7. goal is zero configuration; users should *never* have to tell gpsd how
  8. to set itself up.
  9. Bluetooth has a requirement to be able to write to the gpsd control
  10. socket from a userland device manager. Accordingly, you probably
  11. want to set up a gpsd privilege group and make sure the Bluetooth
  12. device manager is in it.
  13. To avoid problems with gpsd not starting up properly when devices are
  14. hotplugged, make sure the installed gpsd will have read and write
  15. permissions on all serial devices that a GPS might be connected to (on
  16. Linux, this means at least /dev/ttyS*, /dev/ttyUSB*, and
  17. /dev/ttyACM*).
  18. The gpsd daemon needs to be started as root for best performance (it
  19. wants to nice itself, and needs root access to kernel PPS devices).
  20. But very soon after startup it drops privileges. gpsd normally
  21. figures out which group it should move to by looking at the ownership
  22. of a prototypical tty (look in gpsd.c for this code) but the owning
  23. user and group can be compiled in with build-system options.
  24. Make *sure* whatever group gpsd lands in after privilege-dropping has
  25. dialout access - otherwise your users will see mysterious failures
  26. which they will wrongly attribute to GPSD itself.
  27. // end