Main Page   Modules   Namespace List   Class Hierarchy   Compound List   File List   Namespace Members   Compound Members   Related Pages  

KServerSocket Class Reference

Monitors a port for incoming TCP/IP connections. More...

#include <ksock.h>

List of all members.

Public Slots

virtual void slotAccept (int)

Signals

void accepted (KSocket *s)

Public Methods

 KServerSocket (unsigned short int _port, bool _bind=true)
 KServerSocket (const char *_path, bool _bind=true)
virtual ~KServerSocket ()
bool bindAndListen ()
int socket () const
unsigned short int port ()

Protected Attributes

int sock


Detailed Description

Monitors a port for incoming TCP/IP connections.

Deprecated:
Please use the more powerful KExtendedSocket class.

You can use a KServerSocket to listen on a port for incoming connections. When a connection arrived in the port, a KSocket is created and the signal accepted is raised. Make sure you always connect to this signal. If you don't the ServerSocket will create new KSocket's and no one will delete them!

If socket() is -1 or less the socket was not created properly.

Author:
Torben Weis <weis@stud.uni-frankfurt.de>
Version:
Id:
ksock.h,v 1.53 2002/09/09 21:24:53 tjansen Exp

Definition at line 241 of file ksock.h.


Constructor & Destructor Documentation

KServerSocket::KServerSocket unsigned short int    _port,
bool    _bind = true
 

Constructor.

Parameters:
_port  the port number to monitor for incoming connections.
_bind  if false you need to call bindAndListen yourself. This gives you the opportunity to set options on the socket.

KServerSocket::KServerSocket const char *    _path,
bool    _bind = true
 

Creates a UNIX domain server socket.

Parameters:
_path  path used for the socket.
_bind  if false you need to call bindAndListen yourself. This gives you the opportunity to set options on the socket.

virtual KServerSocket::~KServerSocket   [virtual]
 

Destructor. Closes the socket if it was not already closed.


Member Function Documentation

void KServerSocket::accepted KSocket   s [signal]
 

A connection has been accepted. It is your task to delete the KSocket if it is no longer needed.

WARNING: this signal is always emitted, even if you don't connect anything to it. That would mean memory loss, because the KSockets created go to oblivion.

Parameters:
s  the socket that accepted

bool KServerSocket::bindAndListen  
 

Binds the socket and start listening. This should only be called once when the constructor was called with _bind false. On error the socket will be closed.

Returns:
true on success. false on error.

unsigned short int KServerSocket::port  
 

Returns the port number which is being monitored.

Returns:
the port number

virtual void KServerSocket::slotAccept int    [virtual, slot]
 

Called when someone connected to our port.

int KServerSocket::socket   const [inline]
 

Returns the file descriptor associated with the socket.

Returns:
the file descriptor, -1 when an error occured during construction or bindAndListen

Definition at line 281 of file ksock.h.

References sock.


Member Data Documentation

int KServerSocket::sock [protected]
 

The file descriptor for this socket. sock may be -1. This indicates that it is not connected.

Definition at line 326 of file ksock.h.

Referenced by socket().


The documentation for this class was generated from the following file:
Generated on Wed Aug 13 23:30:23 2003 for kdelibs by doxygen1.2.18