miniupnp/minissdpd
Thomas Bernard d2ee52e4d9
improve syslog
2020-06-08 13:17:16 +02:00
..
.gitignore
Changelog.txt send the startup M-SEARCH message on the right interface(s) 2020-06-06 22:21:43 +02:00
LICENSE 2019 2019-04-08 14:46:11 +02:00
Makefile minissdpd: update config.h. Automatically update version in config.h 2018-02-23 15:00:18 +01:00
README
README.fr
VERSION
asyncsendto.c update minissdpd/asyncsendto.c 2020-06-06 21:54:58 +02:00
asyncsendto.h
codelength.h
config.h send the startup M-SEARCH message on the right interface(s) 2020-06-06 22:21:43 +02:00
daemonize.c no more strlen(xxx) == 0. 2018-04-20 17:19:52 +02:00
daemonize.h
getifaddr.c minissdpd/getifaddr.c: update 2019-08-24 11:06:49 +02:00
getifaddr.h minissdpd: update getifaddr.c/.h 2019-02-10 16:06:34 +01:00
getroute.c Fixes #290 2018-03-12 20:12:01 +01:00
getroute.h
ifacewatch.c minissdpd: remove warning when IPV6 is disabled 2018-03-12 20:14:30 +01:00
ifacewatch.h
listifaces.c
minissdpd.1
minissdpd.c improve syslog 2020-06-08 13:17:16 +02:00
minissdpd.init.d.script
minissdpdtypes.h
openssdpsocket.c improve syslog 2020-06-08 13:17:16 +02:00
openssdpsocket.h
printresponse.c
printresponse.h
showminissdpdnotif.c
testcodelength.c
testminissdpd.c
testminissdpd.sh Fix OS detection for Debian kFreeBSD 2018-05-08 21:59:15 +08:00
testminissdpdnotif.sh Update Changelogs + 2019 2019-02-10 16:11:16 +01:00
upnputils.c minissdpd/upnputils.c: includes for gettimeofday() etc. 2019-08-24 11:07:47 +02:00
upnputils.h minissdpd: use upnp_gettimeofday() 2019-02-10 16:03:26 +01:00

README

 * MiniSSDPd - SSDP daemon

(c) Thomas Bernard
http://miniupnp.free.fr/ or https://miniupnp.tuxfamily.org/
https://github.com/miniupnp/miniupnp/

MiniSSDPd is a daemon that :
1 - keeps track of all UPnP devices announcing themselves on the network.
its database can be queried by local processes using a protocol based on
a unix socket. That enables local processes to quickly discover UPnP devices
without broadcasting SSDP message and waiting several seconds for a response.
2 - keeps a database of local UPnP devices hosted on the machine and
answering SSDP searchs on their behalf. It enables to run several UPnP devices,
like an IGD and a MediaServer, on the same machine.

to build, use GNU Make.


* protocol :

Connect to the unix socket.
Sent request, get response.
close unix socket connection.

* Request format :
1st byte : request type
           0 - version
           1 - type
           2 - USN (unique id)
           3 - everything
           4 - submit service (see below)
           5 - switch connection to notification mode
n bytes : string length : 1 byte if < 128 else the upper bit indicate that
one additional byte should be read, etc. (see codelength.h)
n bytes = string

Response format :

request type 0 (version) :
n bytes string length
n bytes = version string

request type 1 / 2 / 3 / 5 :
1st byte : number of services/devices, from 0 to 254.
           255 is a special value, see below
For each service/device :
URL :
  n bytes string length
  n bytes = Location string
ST:
  n bytes string length
  n bytes = type string
USN:
  n bytes string length
  n bytes = identifier string

if the 1st byte is 255, the format is as follows :
1st byte = 255
2nd byte = notification type (1=NEW, 2=UPDATE, 3=REMOVE)
3rd byte = number of services/devices, from 0 to 255.


request type 4 = submit service
1st byte  = 4
(k,n) bytes : length and string "ST" (service type)
(k,n) bytes : length and string "USN"
(k,n) bytes : length and string "Server"
(k,n) bytes : length and string "Location"
No answer