xref: /titanic_44/usr/src/lib/libdns_sd/java/com/apple/dnssd/DNSRecord.java (revision 4b22b9337f359bfd063322244f5336cc7c6ffcfa)
1 /* -*- Mode: Java; tab-width: 4 -*-
2  *
3  * Copyright (c) 2004 Apple Computer, Inc. All rights reserved.
4  *
5  * Licensed under the Apache License, Version 2.0 (the "License");
6  * you may not use this file except in compliance with the License.
7  * You may obtain a copy of the License at
8  *
9  *     http://www.apache.org/licenses/LICENSE-2.0
10  *
11  * Unless required by applicable law or agreed to in writing, software
12  * distributed under the License is distributed on an "AS IS" BASIS,
13  * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
14  * See the License for the specific language governing permissions and
15  * limitations under the License.
16 
17     Change History (most recent first):
18 
19 $Log: DNSRecord.java,v $
20 Revision 1.3  2006/08/14 23:25:08  cheshire
21 Re-licensed mDNSResponder daemon source code under Apache License, Version 2.0
22 
23 Revision 1.2  2004/12/11 03:00:59  rpantos
24 <rdar://problem/3907498> Java DNSRecord API should be cleaned up
25 
26 Revision 1.1  2004/04/30 16:32:34  rpantos
27 First checked in.
28 
29 
30 ident	"%Z%%M%	%I%	%E% SMI"
31 
32  */
33 
34 
35 package	com.apple.dnssd;
36 
37 
38 /**
39 	Reference to a record returned by {@link DNSSDRegistration#addRecord}.<P>
40 
41 	Note: client is responsible for serializing access to these objects if
42 	they are shared between concurrent threads.
43 */
44 
45 public interface	DNSRecord
46 {
47 	/** Update a registered resource record.<P>
48 		The record must either be the primary txt record of a service registered via DNSSD.register(),
49 		or a record added to a registered service via addRecord().<P>
50 
51 		@param	flags
52 					Currently unused, reserved for future use.
53 		<P>
54 		@param	rData
55 					The new rdata to be contained in the updated resource record.
56 		<P>
57 		@param	ttl
58 					The time to live of the updated resource record, in seconds.
59 	*/
update( int flags, byte[] rData, int ttl)60 	void			update( int flags, byte[] rData, int ttl)
61 	throws DNSSDException;
62 
63 	/** Remove a registered resource record.<P>
64 	*/
remove()65 	void			remove()
66 	throws DNSSDException;
67 }
68 
69