mdnssvc.h 2.6 KB

12345678910111213141516171819202122232425262728293031323334353637383940414243444546474849505152535455565758596061626364656667686970717273
  1. /*
  2. * tinysvcmdns - a tiny MDNS implementation for publishing services
  3. * Copyright (C) 2011 Darell Tan
  4. * All rights reserved.
  5. *
  6. * Redistribution and use in source and binary forms, with or without
  7. * modification, are permitted provided that the following conditions
  8. * are met:
  9. * 1. Redistributions of source code must retain the above copyright
  10. * notice, this list of conditions and the following disclaimer.
  11. * 2. Redistributions in binary form must reproduce the above copyright
  12. * notice, this list of conditions and the following disclaimer in the
  13. * documentation and/or other materials provided with the distribution.
  14. * 3. The name of the author may not be used to endorse or promote products
  15. * derived from this software without specific prior written permission.
  16. *
  17. * THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR
  18. * IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
  19. * OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED.
  20. * IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT,
  21. * INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT
  22. * NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
  23. * DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
  24. * THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
  25. * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF
  26. * THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
  27. */
  28. #ifndef __TINYSVCMDNS_H__
  29. #define __TINYSVCMDNS_H__
  30. #include <stdint.h>
  31. #include <stdbool.h>
  32. #ifdef _WIN32
  33. #include <inaddr.h>
  34. #else
  35. #include <netinet/in.h>
  36. #endif
  37. #ifdef __cplusplus
  38. extern "C" {
  39. #endif
  40. struct mdnsd;
  41. struct mdns_service;
  42. // starts a MDNS responder instance
  43. // returns NULL if unsuccessful
  44. struct mdnsd *mdnsd_start(struct in_addr host, bool verbose);
  45. // stops the given MDNS responder instance
  46. void mdnsd_stop(struct mdnsd *s);
  47. // sets the hostname for the given MDNS responder instance
  48. void mdnsd_set_hostname(struct mdnsd *svr, const char *hostname, struct in_addr addr);
  49. // registers a service with the MDNS responder instance
  50. struct mdns_service *mdnsd_register_svc(struct mdnsd *svr, const char *instance_name,
  51. const char *type, uint16_t port, const char *hostname, const char *txt[]);
  52. // destroys the mdns_service struct returned by mdnsd_register_svc()
  53. void mdns_service_destroy(struct mdns_service *srv);
  54. // remove AND destroys the mdns_service struct returned by mdnsd_register_svc()
  55. void mdns_service_remove(struct mdnsd *svr, struct mdns_service *svc);
  56. #ifdef __cplusplus
  57. }
  58. #endif
  59. #endif/*!__MDNSD_H__*/