/usr/include/GNUstep/GNUstepBase/NSNetServices+GNUstepBase.h is in libgnustep-base-dev 1.24.0-1ubuntu3.
This file is owned by root:root, with mode 0o644.
The actual contents of the file can be viewed below.
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 | /* Declarations of GNUstep extensions to NSNetService.
Copyright (C) 2010 Free Software Foundation, Inc.
Written by: Niels Grewe <niels.grewe@halbordnung.de>
Date: March 2010
This file is part of the GNUstep Base Library.
This library is free software; you can redistribute it and/or
modify it under the terms of the GNU Lesser General Public
License as published by the Free Software Foundation; either
version 2 of the License, or (at your option) any later version.
This library is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
Library General Public License for more details.
You should have received a copy of the GNU Lesser General Public
License along with this library; if not, write to the Free
Software Foundation, Inc., 51 Franklin Street, Fifth Floor,
Boston, MA 02111 USA.
*/
#import <Foundation/NSNetServices.h>
#import <GNUstepBase/GSConfig.h>
/*
* Only enable extensions if the Avahi API is used. The mDNS based NSNetService
* doesn't support them yet.
*/
#if GS_USE_AVAHI==1
@interface NSNetService (GNUstepBase)
/**
* Starts monitoring the service represented by the receiver for changes in a
* resource record of <code>recordType</code>. The delegate must either
* implement a -netService:didUpateFOORecordData: method, where "FOO" is the
* record type monitored, or the generic
* -netService:didUpdateRecordData:forRecordType: method.
*/
- (void) startMonitoringForRecordType: (NSString*)recordType;
/**
* Stops monitoring for the specified record type.
*/
- (void) stopMonitoringForRecordType: (NSString*)recordType;
/**
* Adds the service record for a service set up for publishing. The return value
* of this method indicates whether the record was successfully added. The
* record will only be published when -publish is called and it is thus
* considered an error to call this method on a published service.
*/
- (BOOL) addServiceRecord;
/**
* Sets <code>data</code> as the value of a resource record of the specified
* <code>type</code>. The return value of this method indicates whether the
* record was successfully added. The record will only be published when
* -publish is called and it is thus considered an error to call this method on
* a published service. (But it is possible to add a new record to a published
* NSNetService by creating a new NSNetService instance with the same name,
* type, domain and port parameters and publish only the new record in that
* service.)
*/
- (BOOL) addRecordData: (NSData*)data
forRecordType: (NSString*)type;
/**
* Returns the record data for the specified record type. If there is only one
* such record, the return value will be an NSData object, otherwise it will be
* an NSArray.
*/
- (id) recordDataForRecordType: (NSString*)type;
/**
* Returns the full name (including, name, type, and domain) of the service.
*/
- (NSString*) fullServiceName;
@end
@protocol GSNetServiceDelegate <NSNetServiceDelegate>
#ifdef __clang__
@optional
#else
@end
@interface NSObject (GSNetServiceDelegateMethods)
#endif // __clang__
/**
* Notifies the delegate that the addresses for the <var>service</var> have
* changed.
*/
- (void)netService: (NSNetService*)service
didUpdateAddresses: (NSArray*)addresses;
/**
* Notifies the delegate that the record of the <var>type</var> given
* has changed.
*/
- (void)netService: (NSNetService*)service
didUpdateRecordData: (id)newData
forRecordType: (NSString*)type;
/**
* Notifies the delegate that there was a problem when trying to monitor a
* resource record of <var>type</var> for updates.
*/
- (void)netService: (NSNetService*)service
didNotMonitor: (NSDictionary*)errorDict
forRecordType: (NSString*)type;
@end
#endif // GS_USE_AVAHI
|