> For the complete documentation index, see [llms.txt](https://syslog-macos-testing.gitbook.io/syslog-macos-testing/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://syslog-macos-testing.gitbook.io/syslog-macos-testing/modules/affile/pipe-source-driver.md).

# pipe() Source Driver

The pipe source driver opens a named pipe with the specified name and listens for messages. It is used as the native message delivery protocol on HP-UX.

### Important Information

Pipe is very similar to the file() driver, but there are a few differences, for example, pipe() opens its argument in read-write mode, therefore it is not recommended to be used on special files like /proc/kmsg. In fact, it is not recommended to use pipe() on anything else than real pipes.

### Status

| Architecture | Status |
| :----------: | :----: |
|      x86     |  Works |
|      ARM     |  Works |

### How to Test

To test the pipe() source driver, we can create a pipe using the mkfifo command. The mkfifo command basically lets you create FIFOs (a.k.a named pipes). Following is the syntax of the command:

```
mkfifo [OPTION]... NAME...
```

#### Configuration File Used

```
@version: 3.31
@include "scl.conf"

source s_pipe {
    pipe("/Users/yash/Documents/myPipe");
};

destination console{
    file(/dev/stdout);
};

log {
    source(s_pipe);
    destination(console);
};
```

#### Proof

![pipe() source driver tested on macOS (x86)](https://3267548193-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-MaZdBoDvCx_0JwOUICk%2F-McAQPEWKgRIZgiGYeaw%2F-McATQL3GruDk-0H_bXr%2FScreenshot%202021-06-14%20at%207.59.54%20PM.png?alt=media\&token=8512dec9-ed93-40aa-84c9-1a7f08fcd3cb)

![pipe() source driver tested on macOS (ARM)](https://3267548193-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-MaZdBoDvCx_0JwOUICk%2F-MhXfp6utMsNE9_-xfVe%2F-MhXl-b9-cDsN2Ho3xEa%2FScreen%20Shot%202021-08-20%20at%2011.47.47%20AM.png?alt=media\&token=6bfdc978-4b1e-4c5d-9990-77b579728673)
