OLUnixServerSocket Class Reference
[Sockets]

A server socket that communciates in the Unix domain. More...

#import <Socket.h>

Inheritance diagram for OLUnixServerSocket:

Inheritance graph
[legend]
List of all members.

Public Member Functions

(void) - bindToAddress:
 Bind the socket to a local address.
(void) - close
 Close the socket.
(OLSocketAddress *) - localAddress
 Return the local address.

Static Public Member Functions

(id) + socket
 Create and return a new socket.
(id) + socketWithLocalUnixAddress:
 Create and return a new socket.
(id) + socketWithLocalUnixAddress:queueLength:
 Create and return a new socket.
(id) + socketWithQueueLength:
 Create and return a new socket.

Protected Attributes

OLUnixAddresslocalAddress
 The local address to which this server is bound.

Detailed Description

A server socket that communciates in the Unix domain.

Unix domain sockets don't necessarily have anything to do with Unix; it's just a description of the address family. This class is capable of accepting connections from any Unix domain socket, include OLUnixClientSocket.

See also:
OLUnixClientSocket, OLUnixAddress


Member Function Documentation

- (void) bindToAddress: (OLSocketAddress *)  address  

Bind the socket to a local address.

After successfully sending this message the socket will be assigned the local address.

Exceptions:
OLSocketException if there is a problem binding the socket
Parameters:
address the address that should be assigned to the socket

Reimplemented from OLServerSocket.

- (void) close  

Close the socket.

The socket will no longer be available for communication after receiving this message.

Exceptions:
OLSocketException if there is an error closing the socket

Reimplemented from OLSocket.

- (OLSocketAddress*) localAddress  

Return the local address.

The local address is the address to which this socket is bound.

See also:
- remoteAddress (OLSocket)
Exceptions:
OLSocketException if the socket is not bound to a local address
Returns:
the local address

Reimplemented from OLSocket.

+ (id) socket  

Create and return a new socket.

Create and return a new socket.

An unbound server socket is created that has a queue length of 50.

Exceptions:
OLSocketException if the socket cannot be created
Returns:
a reference to the newly created socket

+ (id) socketWithLocalUnixAddress: (OLUnixAddress *)  address  

Create and return a new socket.

Create and return a new socket.

A server socket is created that is bound to the local address and has a queue length of 50.

Exceptions:
OLSocketException if the socket cannot be created and bound
Parameters:
address the address to which the socket should be bound
Returns:
a reference to the newly created socket

+ (id) socketWithLocalUnixAddress: (OLUnixAddress *)  address
queueLength: (unsigned)  qLen 

Create and return a new socket.

Create and return a new socket.

A server socket is created that is bound to the local address and has a queue length of qLen.

Exceptions:
OLSocketException if the socket cannot be created and bound
Parameters:
address the address to which the socket should be bound
qLen the length of the server's queue
Returns:
a reference to the newly created socket

+ (id) socketWithQueueLength: (unsigned)  qLen  

Create and return a new socket.

Create and return a new socket.

An unbound server socket is created that has a queue length of qLen.

Exceptions:
OLSocketException if the socket cannot be created
Parameters:
qLen the length of the server's queue
Returns:
a reference to the newly created socket


Member Data Documentation

- (OLUnixAddress*) localAddress [protected]

The local address to which this server is bound.


The documentation for this class was generated from the following file:
ObjectiveLibGenerated Sun Apr 22 15:19:11 2007, © 2004-2007 Will Mason
SourceForge.net Logo