mirror of
https://github.com/gnustep/libs-ec.git
synced 2025-02-16 00:21:01 +00:00
a5cc8bba3f
git-svn-id: svn+ssh://svn.gna.org/svn/gnustep/devmodules/dev-libs/ec@35633 72102866-910b-0410-8b05-ffd578937521
105 lines
4.3 KiB
Objective-C
105 lines
4.3 KiB
Objective-C
|
|
/** Enterprise Control Configuration and Logging
|
|
|
|
Copyright (C) 2012 Free Software Foundation, Inc.
|
|
|
|
Written by: Richard Frith-Macdonald <rfm@gnu.org>
|
|
Date: Febrary 2010
|
|
Originally developed from 1996 to 2012 by Brainstorm, and donated to
|
|
the FSF.
|
|
|
|
This file is part of the GNUstep project.
|
|
|
|
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 3 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/NSHost.h>
|
|
|
|
@class NSDictionary;
|
|
@class NSString;
|
|
|
|
/**
|
|
* <p>This category provides additional methods to standardise host names so
|
|
* that software can consistently refer to a host by a single well known
|
|
* name.<br />
|
|
* This mechanism, as well as ensuring naming consistency, can be used to
|
|
* work with logical names for hosts when the actual naming of the hosts
|
|
* (ie in the domain name system) is not under your control.
|
|
* </p>
|
|
* <p>This operates by managing a map from the various names and addresses a
|
|
* host may be known by, to a single well known name. This host name may,
|
|
* but need not, be a public domain name.
|
|
* </p>
|
|
* <p>The well known name methods are thread-safe, and on initial use the
|
|
* NSUserDefaults system is queried to set up two well known names
|
|
* automatically:<br />
|
|
* The value of EcCurrentHost specifies the well known name for the
|
|
* current host (the machine on which the software is running).<br />
|
|
* The value of EcControlHost specifies the well known name for the
|
|
* control host (the machine on which control functions for your software
|
|
* are centralised). If this is specified without EcControlDomain,
|
|
* it is used as both the well known name and the domain name.<br />
|
|
* The value of EcControlDomain specifies the fully qualified domain
|
|
* name (ie the name provided by the operating system) of the control host.
|
|
* If it is specified without EcControlHost, then it is used as the
|
|
* well known name for the control host.<br />
|
|
* NB. the defaults system is accessed via EcUserDefaults, so if a
|
|
* defaults prefix other than Ec has been set, these keys will use that
|
|
* alternative prefix.
|
|
* </p>
|
|
*/
|
|
@interface NSHost (EcHost)
|
|
|
|
/** Returns the well known name of the 'control' host as obtained from the
|
|
* NSUserDefaults system.<br />
|
|
* If EcControlHost is defined, the well known name is the string specified
|
|
* by EcControlHost.<br />
|
|
* If EcControlHost is undefined but EcHostControlDomain is defined,
|
|
* the well known name is the value of EcHostControlDomain.<br />
|
|
* If neither is defined, this method returns nil.
|
|
*/
|
|
+ (NSString*) controlWellKnownName;
|
|
|
|
/** Returns a host previously established as having the well known name,
|
|
* or nil if no such association exists.
|
|
*/
|
|
+ (NSHost*) hostWithWellKnownName: (NSString*)aName;
|
|
|
|
/** Establishes mappings from a variety of host names (the dictionary keys)
|
|
* to well known names (the dictionary values).<br />
|
|
* The keys and values may be (and often are) identical in the case where
|
|
* the well known name for a host is the same as one of its normal names
|
|
* (eg its fully qualified domain name).<br />
|
|
* It is possible to set a well known name for a host which does not yet
|
|
* exist ... in which case the mapping will be established and will take
|
|
* effect later, when the host is set up.
|
|
*/
|
|
+ (void) setWellKnownNames: (NSDictionary*)map;
|
|
|
|
/** Sets the well known name for the receiver.<br />
|
|
* This replaces any previous well known name for the receiver and, if the
|
|
* name is already in use, removes any associations of that well known name
|
|
* with other hosts.
|
|
*/
|
|
- (void) setWellKnownName: (NSString*)aName;
|
|
|
|
/** Returns the well known name for the receiver (or any name of the receiver
|
|
* if no well known name has been set for it).
|
|
*/
|
|
- (NSString*) wellKnownName;
|
|
@end
|
|
|