richard@brainstorm.co.uk
)Version: 1.51
Date: 2003/07/22 08:52:37
Copyright: (C) 1998,1999,2003 Free Software Foundation, Inc.
- Declared in:
- Foundation/NSPortNameServer.h
Standards:
- MacOS-X
- OpenStep
- GNUstep
Description forthcoming.
Method summaryDescription forthcoming.
- Declared in:
- Foundation/NSPortNameServer.h
Standards:
- MacOS-X
- OpenStep
- GNUstep
The abstract port name server class. This defines an API for working with port name servers... objects used to manage access to ports in the distributed objects system (see NSConnection ).
Method summary
Returns the default port name server for the
process.
The MacOS-X documentation says
that this is a nameserver dealing with NSMessagePort
objects, but that is incompatible with
OpenStep/OPENSTEP/NeXTstep
behavior, so GNUstep returns a name server which
deals with NSSocketPort objects capable of being used
for inter-host communications.
Looks up the port with the specified name
on the local host and returns it or nil
if
no port is found with that name.
Different nameservers have different namespaces
appropriate to the type of port they deal with,
so failing to find a named port with one nameserver does
not guarantee that a port does with that
name does not exist.
This is a
convenience method calling
-portForName:onHost:
with a nil
host argument.
Looks up the port with the specified name
on host and returns it or nil
if
no port is found with that name.
Different nameservers have different namespaces
appropriate to the type of port they deal with,
so failing to find a named port with one nameserver does
not guarantee that a port does with that
name does not exist.
Registers port with the supplied
name, so that other processes can look it
up to contact it. A port may be registered
with more than one name by making multiple
calls to this method.
Returns YES
on success, NO
otherwise.
The common
cause for failure is that another port is
already registered with the name. Raises
NSInvalidArgumentException if
given bad arguments.
Removes any port registration for the supplied
name (whether registered in the current
process or another).
The common cause for
failure is that no port is registered with the
name.
Raises
NSInvalidArgumentException if
given bad arguments.
- Declared in:
- Foundation/NSPortNameServer.h
Standards:
- MacOS-X
- OpenStep
- GNUstep
This is the nameserver handling ports used for
distributed objects communications (see
NSConnection
) between hosts.
Use the
+sharedInstance
method to get a nameserver, rather than allocating
and initialising one.
Description forthcoming.
Description forthcoming.
Returns the shared name server object for NSSocketPort objects.
Concrete implementation of
[NSPortNameServer -portForName:onHost:]
Looks up and returns a port with the specified name and host.
If host is nil
or an empty string, this performs a lookup for a port on the current host.
If host is an asterisk ('*') then the lookup returns the first port found with the specified name on any machine on the local network.
Returns nil
if no matching port could be found.
Concrete implementation of
[NSPortNameServer -registerPort:forName:]
Registers the port with the specified name such that it is available on all the IP addresses of the host on which the process is running.
Returns YES
on success, NO
on failure (eg the name is already in use or there is a problem registering for some reason).
Concrete implementation of
[NSPortNameServer -removePortForName:]
Unregisters the specified name from any associated port on the local host.
Returns YES
on succes, NO
on failure.
- Declared in:
- Foundation/NSPortNameServer.h
Standards:
- NotOpenStep
- NotMacOS-X
- GNUstep
Some extensions to make cleaning up port names easier.
Method summaryReturn all names that have been registered with the receiver for port.
Remove all names registered with the receiver for port. Probably inefficient... subclasses might want to override this.
Remove the name if and only if it is registered with the receiver for the given port.