richard@brainstorm.co.uk
)mccallum@gnu.ai.mit.edu
)Version: 1.29
Date: 2004/08/17 06:33:07
Copyright: (C) 1997,2002 Free Software Foundation, Inc.
- Declared in:
- Foundation/NSPort.h
- Conforms to:
- GCFinalization
Standards:
- MacOS-X
- NotOpenStep
- GNUstep
An NSPort implementation for network object communications based on Unix domain sockets. Can be used for interthread/interprocess communications on the same host, but not between different hosts.
This is the preferred initialisation method for
NSMessagePort
. socketName is
the name of the socket in the port directory
Warning the underscore at the start of the
name of this method indicates that it is private, for
internal use only, and you should not use the
method in your code.
Warning the underscore at the start of the name of this method indicates that it is private, for internal use only, and you should not use the method in your code.
Warning the underscore at the start of the name of this method indicates that it is private, for internal use only, and you should not use the method in your code.
Setup method: add new send or receive connection handle.
Delegates processing of a message.
This is called when a socket connection is broken. We remove the connection handle from this port and, if this was the last handle to a remote port, we invalidate the port.
Description forthcoming.
Description forthcoming.
Description forthcoming.
Description forthcoming.
- Declared in:
- Foundation/NSPort.h
- Conforms to:
- NSCoding
- NSCopying
Standards:
- MacOS-X
- OpenStep
- GNUstep
NSPort
is an abstract class defining
interfaces underlying communications in the
distributed objects framework. Each side of a
connection will have an NSPort
object, responsible for sending and receiving
NSPortMessage
s, which are then passed to delegates when received.
The NSPort
must be added to the
NSRunLoop
as an input source.
This class also implements the functionality of
the NSMachPort
class on OS X.
Basic constructor returns object capable of send and receive.
NSMachPort compatibility method.
Adds to run loop as input source to be notified for input in given mode. This method is for use by subclasses.
Returns the object that received messages will be passed off to.
Basic initializer sets up object capable of send and receive.
NSMachPort compatibility method.
Mark port as invalid, deregister with listeners and cease further network operations. Subclasses should override and call super.
Returns whether port has been marked invalid.
NSMachPort compatibility.
Removes from run loop as input source to be notified for input in given mode. This method is for use by subclasses.
Returns amount of space used for header info at beginning of messages. Subclasses should override (this implementation returns 0).
Internal method for sending message, for use by subclasses.
Internal method for sending message, for use by subclasses.
Sets the object that received messages will be passed off to.
Warning the underscore at the start of the name of this instance variable indicates that, even though it is not technically private, it is intended for internal use within the package, and you should not use the variable in other code.
Warning the underscore at the start of the name of this instance variable indicates that, even though it is not technically private, it is intended for internal use within the package, and you should not use the variable in other code.
- Declared in:
- Foundation/NSPort.h
- Conforms to:
- GCFinalization
Standards:
- MacOS-X
- NotOpenStep
- GNUstep
An NSPort implementation for network object communications based on BSD sockets. Can be used for interthread/interprocess communications between same or different hosts (though on same host NSMessagePort will be more efficient).
Note that this class is incompatible with the latest OS X version.
Look up and return an existing
NSSocketPort
given a host and
number, or return nil
if one
has not been created.
This is the preferred initialisation method for
NSSocketPort
.
number
should be a TCP/IP port number or may be
zero for a port on the local host.
aHost should be the host for the port or
may be nil
for the local host.
addr is the IP address that MUST be used
for this port - if it is nil
then, for the
local host, the port uses ALL IP addresses, and for a
remote host, the port will use the first address
that works.
shouldListen specifies
whether to listen on the port initially.
Setup method: add new send or receive connection handle.
Returns IP address of underlying socket.
This is a callback method used by the NSRunLoop class to determine which descriptors to watch for the port.
Description forthcoming.
Delegates processing of a message.
Returns host that the underlying socket is connected to.
Returns port number of underlying socket.
This is called when a TCP/IP socket connection is broken. We remove the connection handle from this port and, if this was the last handle to a remote port, we invalidate the port.
Description forthcoming.
Description forthcoming.
Description forthcoming.
Description forthcoming.
Description forthcoming.
Description forthcoming.
- Declared in:
- Foundation/NSPort.h
Standards:
- NotOpenStep
- NotMacOS-X
- GNUstep
Stubs for backward compatibility. Do not use.
Method summaryDescription forthcoming.
Description forthcoming.
Description forthcoming.