Manual Pages for UNIX Operating System command usage for man DNSServiceUpdateRecord

DNS Service Discovery Library Functions
                              DNSServiceCreateConnection(3DNS_SD)



NAME
     DNSServiceCreateConnection,        DNSServiceRegisterRecord,
     DNSServiceAddRecord, DNSServiceUpdateRecord, DNSServiceRemo-
     veRecord - registering multiple records

SYNOPSIS
     cc [ flag ... ] file ... -ldns_sd [ library ... ]
     #include 

     DNSServiceErrorType DNSServiceCreateConnection(DNSServiceRef *sdRef);


     DNSServiceErrorType DNSServiceRegisterRecord(DNSServiceRef sdRef,
          DNSRecordRef *RecordRef, DNSServiceFlags flags,
          uint32_t interfaceIndex, const char *fullname,
          uint16_t rrtype, uint16_t rrclass, uint16_t rdlen,
          const void *rdata, uint32_t ttl,
          DNSServiceServiceRegisterRecordReply callBack,
          void *context);


     typedef void(*DNSServiceRegisterRecordReply)(DNSServiceRef sdRef,
          DNSServiceRecordRef RecordRef, DNSServiceFlags flags,
          DNSServiceErrorType errorCode, void *context);


     DNSServiceErrorType DNSServiceAddRecord(DNSServiceRef sdRef,
          DNSRecordRef *RecordRef, DNSServiceFlags flags,
          uint16_t rrtype, uint16_t rdlen, const void *rdata,
          uint32_t ttl);


     DNSServiceErrorType DNSServiceUpdateRecord(DNSServiceRef sdRef,
          DNSRecordRef RecordRef, DNSServiceFlags flags,
          uint16_t rdlen, const void *rdata,
          uint32_t ttl);


     DNSServiceErrorType DNSServiceRemoveRecord(DNSServiceRef sdRef,
          DNSRecordRef RecordRef, DNSServiceFlags flags);


DESCRIPTION
     The DNSServiceCreateConnection() function allows  the  crea-
     tion of a connection to the mDNS daemon in order to register
     multiple individual records.


     The DNSServiceRegisterRecord() function uses the  connection
     created   by   DNSServiceCreateConnection()  to  register  a
     record. Name conflicts that occur from this function  should



SunOS 5.11          Last change: 20 Aug 2007                    1






DNS Service Discovery Library Functions
                              DNSServiceCreateConnection(3DNS_SD)



     be handled by the client in the callback.


     The DNSServiceAddRecord()  call  adds  a  DNS  record  to  a
     registered  service.  The  name of the record is the same as
     registered service name. The RecordRef argument to DNSServi-
     ceAddRecord() points to an uninitialized DNSRecordRef. After
     successful  completion  of  DNSServiceAddRecord(),  the  DNS
     record  can  be  updated  or  deregistered  by  passing  the
     DNSRecordRef initialized by DNSServiceAddRecord() to DNSSer-
     viceUpdateRecord() or to DNSServiceRemoveRecord().


     The DNSServiceUpdateRecords() call updates the DNS record of
     the  registered  service. The DNS record must be the primary
     resource record registered using DNSServiceRegister()  or  a
     record  added  to  a  registered service using DNSServiceAd-
     dRecord() or an individual record  added  via  DNSServiceRe-
     gisterRecord().


     The DNSServiceRemoveRecord() call removes a record that  was
     added  using  DNSServiceAddRecord()  or  DNSServiceRegister-
     Record().


     The sdRef argument points to DNSServiceRef initialized  from
     a  call  to  DNSServiceRegister().  If the sdRef argument is
     passed to DNSServiceRefDeallocate() and the service is dere-
     gistered  DNS  records  added  via DNSServiceAddRecord() are
     invalidated and cannot be further used. The  flags  argument
     is currently ignored and reserved for future use. The rrtype
     parameter value indicates the type of the DNS record.  Suit-
     able   values  for  the  rrtype  parameter  are  defined  in
     :  kDNSServiceType_TXT,  for  example.  The  rdata
     argument  points  to  the  raw  rdata to be contained in the
     resource record. The ttl value indicates the time to live of
     the  resource  record in seconds. A ttl value of 0 should be
     passed to use a default value.

RETURN VALUES
     The     DNSServiceCreateConnection     function      returns
     kDNSServiceErr_NoError  on success. Otherwise, an error code
     defined in  is returned to indicate  the  specific
     failure that occurred.

ATTRIBUTES
     See attributes(5) for description of  the  following  attri-
     butes:





SunOS 5.11          Last change: 20 Aug 2007                    2






DNS Service Discovery Library Functions
                              DNSServiceCreateConnection(3DNS_SD)



______________________________________________________________________
    |       ATTRIBUTE TYPE        |       ATTRIBUTE VALUE       |
    |_____________________________|_____________________________|
    | Interface Stability         | Committed                   |
    |_____________________________|_____________________________|
    | MT-Level                    | Safe                        |
    |_____________________________|_____________________________|


SEE ALSO
     DNSServiceRefDeallocate(3DNS_SD),
     DNSServiceRegister(3DNS_SD), attributes(5)










































SunOS 5.11          Last change: 20 Aug 2007                    3






DNS Service Discovery Library Functions
                              DNSServiceCreateConnection(3DNS_SD)






















































SunOS 5.11          Last change: 20 Aug 2007                    4