---
name: "UnixSocket"
section: "3cc"
platform: "linux"
package: "libcommoncpp2-dev"
version: "1.0.13-5"
release: "Debian 3.1 (Sarge)"
platforms: ["linux"]
url: "https://new.carta.tech/UnixSocket"
---

# UnixSocket(3cc)

Unix domain sockets are used for stream based connected sessions between processes on the same machine. bound server for Unix domain streams and sessions.

## NAME

UnixSocket - Unix domain sockets are used for stream based connected sessions between processes on the same machine. bound server for Unix domain streams and sessions.

## SYNOPSIS

`#include <unix.h>`

Inherits **Socket**.

### Public Methods

**UnixSocket** (const char \*pathname, int backlog=5)\
 *A Unix domain 'server' is created as a Unix domain socket that is bound to a pathname and that has a backlog queue to listen for connection requests.* bool **isPendingConnection** (**timeout\_t** timeout=TIMEOUT\_INF)\
 *not const -- jfc* virtual **~UnixSocket** ()\
 *Use base socket handler for ending this socket.*

### Friends

class **UnixStream**\
 class **SocketPort**\
 class **unixstream**\

## DETAILED DESCRIPTION

Unix domain sockets are used for stream based connected sessions between processes on the same machine. bound server for Unix domain streams and sessions.

An implicit and unique UnixSocket object exists in Common C++ to represent a bound Unix domain socket acting as a 'server' for receiving connection requests. This class is not part of **UnixStream** because such objects normally perform no physical I/O (read or write operations) other than to specify a listen backlog queue and perform 'accept' operations for pending connections.

**Author:**  Alex Pavloff \<alex@pavloff.net\>

## CONSTRUCTOR & DESTRUCTOR DOCUMENTATION

### UnixSocket::UnixSocket (const char \* pathname, int backlog = 5)

A Unix domain 'server' is created as a Unix domain socket that is bound to a pathname and that has a backlog queue to listen for connection requests.

If the server cannot be created, an exception is thrown.

**Parameters:**

- *pathname*

  *pathname to socket file*

- *backlog*

  *size of connection request queue.*

### virtual UnixSocket::~UnixSocket ()` [inline, virtual]`

*Use base socket handler for ending this socket.*

## MEMBER FUNCTION DOCUMENTATION

### bool UnixSocket::isPendingConnection (timeout\_t timeout = TIMEOUT\_INF)` [inline]`

*not const -- jfc*

## FRIENDS AND RELATED FUNCTION DOCUMENTATION

### friend class SocketPort` [friend]`

### friend class unixstream` [friend]`

### friend class UnixStream` [friend]`

## AUTHOR

*Generated automatically by Doxygen for CommonC++ from the source code.*