|
55 | 55 |
|
56 | 56 | Bind the pipe to a file path (Unix) or a name (Windows).
|
57 | 57 |
|
| 58 | + Does not support Linux abstract namespace sockets, |
| 59 | + unlike :c:func:`uv_pipe_bind2`. |
| 60 | +
|
| 61 | + Alias for ``uv_pipe_bind2(handle, name, strlen(name), 0)``. |
| 62 | +
|
| 63 | + .. note:: |
| 64 | + Paths on Unix get truncated to ``sizeof(sockaddr_un.sun_path)`` bytes, |
| 65 | + typically between 92 and 108 bytes. |
| 66 | +
|
| 67 | +.. c:function:: int uv_pipe_bind2(uv_pipe_t* handle, const char* name, size_t namelen, unsigned int flags) |
| 68 | +
|
| 69 | + Bind the pipe to a file path (Unix) or a name (Windows). |
| 70 | +
|
| 71 | + ``flags`` must be zero or ``UV_PIPE_NO_TRUNCATE``. Returns ``UV_EINVAL`` |
| 72 | + for unsupported flags without performing the bind operation. |
| 73 | +
|
| 74 | + Supports Linux abstract namespace sockets. ``namelen`` must include |
| 75 | + the leading nul byte but not the trailing nul byte. |
| 76 | +
|
| 77 | + .. versionadded:: 1.46.0 |
| 78 | +
|
58 | 79 | .. note::
|
59 |
| - Paths on Unix get truncated to ``sizeof(sockaddr_un.sun_path)`` bytes, typically between |
60 |
| - 92 and 108 bytes. |
| 80 | + Paths on Unix get truncated to ``sizeof(sockaddr_un.sun_path)`` bytes, |
| 81 | + typically between 92 and 108 bytes, unless the ``UV_PIPE_NO_TRUNCATE`` |
| 82 | + flag is specified, in which case an ``UV_EINVAL`` error is returned. |
61 | 83 |
|
62 | 84 | .. c:function:: void uv_pipe_connect(uv_connect_t* req, uv_pipe_t* handle, const char* name, uv_connect_cb cb)
|
63 | 85 |
|
64 |
| - Connect to the Unix domain socket or the named pipe. |
| 86 | + Connect to the Unix domain socket or the Windows named pipe. |
| 87 | +
|
| 88 | + Does not support Linux abstract namespace sockets, |
| 89 | + unlike :c:func:`uv_pipe_connect2`. |
| 90 | +
|
| 91 | + Alias for ``uv_pipe_connect2(req, handle, name, strlen(name), 0, cb)``. |
| 92 | +
|
| 93 | + .. note:: |
| 94 | + Paths on Unix get truncated to ``sizeof(sockaddr_un.sun_path)`` bytes, |
| 95 | + typically between 92 and 108 bytes. |
| 96 | +
|
| 97 | +.. c:function:: void uv_pipe_connect2(uv_connect_t* req, uv_pipe_t* handle, const char* name, size_t namelen, unsigned int flags, uv_connect_cb cb) |
| 98 | +
|
| 99 | + Connect to the Unix domain socket or the Windows named pipe. |
| 100 | +
|
| 101 | + ``flags`` must be zero or ``UV_PIPE_NO_TRUNCATE``. Returns ``UV_EINVAL`` |
| 102 | + for unsupported flags without performing the connect operation. |
| 103 | +
|
| 104 | + Supports Linux abstract namespace sockets. ``namelen`` must include |
| 105 | + the leading nul byte but not the trailing nul byte. |
| 106 | +
|
| 107 | + .. versionadded:: 1.46.0 |
65 | 108 |
|
66 | 109 | .. note::
|
67 |
| - Paths on Unix get truncated to ``sizeof(sockaddr_un.sun_path)`` bytes, typically between |
68 |
| - 92 and 108 bytes. |
| 110 | + Paths on Unix get truncated to ``sizeof(sockaddr_un.sun_path)`` bytes, |
| 111 | + typically between 92 and 108 bytes, unless the ``UV_PIPE_NO_TRUNCATE`` |
| 112 | + flag is specified, in which case an ``UV_EINVAL`` error is returned. |
69 | 113 |
|
70 | 114 | .. c:function:: int uv_pipe_getsockname(const uv_pipe_t* handle, char* buffer, size_t* size)
|
71 | 115 |
|
|
0 commit comments