[#BloombergLP-balb-PipeTaskManager-start]
= xref:BloombergLP.adoc[BloombergLP]::xref:BloombergLP/balb.adoc[balb]::xref:BloombergLP/balb/PipeTaskManager.adoc[PipeTaskManager]::start
:relfileprefix: ../../../
:mrdocs:

Create a named pipe and run the event processor in a background thread&period;

== Synopsis

Declared in `&lt;balb&lowbar;pipetaskmanager&period;h&gt;`

[source,cpp,subs="verbatim,replacements,macros,-callouts"]
----
int
start(std::string&lowbar;view const& pipeBasename);
----

== Description

Create a named pipe using the specified `pipeBasename` (not a pathname), and execute the task manager event processor in a background thread&period; Return 0 on success, and a non&hyphen;zero value otherwise&period; See &lcub;Requirements for the Named Pipe&rcub; for expectations for `pipeBasename`&period; After a successful return, calls to `start` fail until `stop` has been called (successfully)&semi; afterwards, `start` can be called again with the same or some other `pipeBasename`&period; Note that the `pipeName()` method provides the (full) pathname to the created named pipe&period;

== Return Value

0 on success, and a non&hyphen;zero value otherwise

== Parameters

[cols="1,4"]
|===
| Name| Description
| *pipeBasename*
| basename (not a pathname) for the named pipe
|===


[.small]#Created with https://www.mrdocs.com[MrDocs]#
