[#BloombergLP-balb-PipeControlChannel-2constructor-05]
= xref:BloombergLP.adoc[BloombergLP]::xref:BloombergLP/balb.adoc[balb]::xref:BloombergLP/balb/PipeControlChannel.adoc[PipeControlChannel]::PipeControlChannel
:relfileprefix: ../../../
:mrdocs:

Constructors

== Synopses

Declared in `<balb_pipecontrolchannel.h>`

Create a pipe control mechanism that dispatches messages to the specified `callback`. Optionally specify `basicAllocator` to supply memory. If `basicAllocator` is zero, the currently installed default allocator is used. The permission bit mask of the underlying named pipe defaults to `k_DEFAULT_PERMISSIONS` (0666, i.e., read/write for everyone) and may be changed by calling `setPermissions` before `start`.


[source,cpp,subs="verbatim,replacements,macros,-callouts"]
----
explicit
xref:BloombergLP/balb/PipeControlChannel/2constructor-01.adoc[PipeControlChannel](
    xref:BloombergLP/balb/PipeControlChannel/ControlCallback.adoc[ControlCallback] const& callback,
    xref:BloombergLP/bslma/Allocator.adoc[bslma::Allocator]* basicAllocator = 0);
----

[.small]#xref:BloombergLP/balb/PipeControlChannel/2constructor-01.adoc[_» more..._]#

Create a pipe control mechanism that dispatches messages to the specified `callback` and creates its underlying named pipe with the specified `permissions` bit mask. Optionally specify `basicAllocator` to supply memory. If `basicAllocator` is zero, the currently installed default allocator is used. The behavior is undefined unless `bdls::FilePermissions::isValidBaseBits(permissions)` (i.e., unless `permissions` is a combination of the nine owner/group/others read/write/execute bits defined by `bdls::FilePermissions`; note that `k_SET_UID`, `k_SET_GID`, and `k_STICKY_BIT` are not accepted). On operating systems that do not support Unix‐style permission bits (notably Windows) the value is ignored and falls back to the operating‐system default (see the component‐level documentation for details).


[source,cpp,subs="verbatim,replacements,macros,-callouts"]
----
xref:BloombergLP/balb/PipeControlChannel/2constructor-0a.adoc[PipeControlChannel](
    xref:BloombergLP/balb/PipeControlChannel/ControlCallback.adoc[ControlCallback] const& callback,
    int permissions,
    xref:BloombergLP/bslma/Allocator.adoc[bslma::Allocator]* basicAllocator = 0);
----

[.small]#xref:BloombergLP/balb/PipeControlChannel/2constructor-0a.adoc[_» more..._]#


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