Class

NSPortNameServer

An object-oriented interface to the port registration service used by the distributed objects system.

Overview

NSConnection objects use this interface to contact each other and to distribute objects over the network; you should rarely need to interact directly with an NSPortNameServer.

You get an NSPortNameServer object by using the systemDefaultPortNameServer class method—never allocate and initialize an instance directly. With the default server object you can register an NSPort object under a given name, making it available on the network, and also unregister it so that it can’t be looked up (although other applications that have already looked up the NSPort object can still use it until it becomes invalid). See the NSPort class specification for more information.

Topics

Getting the Server Object

systemDefaultPortNameServer

Returns the single instance of NSPortNameServer for the application.

Looking up Ports

portForName:

Looks up and returns the port registered under the specified name on the local host.

portForName:host:

Looks up and returns the port registered under the specified name on a specified host.

Registering Ports

registerPort:name:

Makes a given port available on the network under a specified name.

removePortForName:

Unregisters the port for a given name on the local host.

Relationships

Inherits From

See Also

Legacy

NSMachPortDelegate

An interface for handling incoming Mach messages.

NSConnectionDelegate

An interface for interacting with low-level, interprocess connections.

Deprecated
NSConnection

An object that manages the communication between objects in different threads or between a thread and a process running on a local or remote system.

Deprecated
NSDistantObject

A proxy for objects in other applications or threads.

Deprecated
NSDistantObjectRequest

An object used by the distributed objects system to help handle invocations between different processes.

Deprecated
NSMachBootstrapServer

A port name server that takes and returns Mach port objects.

Deprecated
NSMachPort

A port that can be used as an endpoint for distributed object connections (or raw messaging).

NSMessagePort

A port that can be used as an endpoint for distributed object connections (or raw messaging).

NSMessagePortNameServer

A server takes and returns message ports.

Deprecated
NSPortCoder

A coder used to transmit object proxies (and sometimes objects themselves) between connections.

Deprecated
NSPortDelegate

An interface for handling incoming messages.

NSPortMessage

A low-level, operating system-independent type for inter-application (and inter-thread) messages.

NSProtocolChecker

An object that restricts the messages that can be sent to another object (referred to as the checker’s delegate).

NSSocketPortNameServer

A port name server that takes and returns socket ports.

Deprecated