[#BloombergLP-bdls-PipeUtil-makeCanonicalName-0a]
= xref:BloombergLP.adoc[BloombergLP]::xref:BloombergLP/bdls.adoc[bdls]::xref:BloombergLP/bdls/PipeUtil.adoc[PipeUtil]::makeCanonicalName
:relfileprefix: ../../../
:mrdocs:

Load into the specified `pipeName` the system‐dependent canonical pipe name corresponding to the specified `baseName`. Return 0 on success, and a nonzero value if `baseName` cannot be part of a pipe name on this system.

== Synopsis

Declared in `<bdls_pipeutil.h>`

[source,cpp,subs="verbatim,replacements,macros,-callouts"]
----
static
int
makeCanonicalName(
    xref:bsl/string.adoc[bsl::string]* pipeName,
    std::string_view const& baseName);
----

== Description

On Unix systems, the canonical name is defined by prefixing `baseName` with the directory specified by the `SOCKDIR` environment variable if it is set, otherwise with the directory specified by the `TMPDIR` environment variable if it is set, and otherwise by the current directory.

On Windows systems, the canonical name is defined by prefixing `baseName` with "\.pipe".

Finally, any uppercase characters in `baseName` are converted to lower case in the canonical name.


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