From cd54ca5066e9fa8ee62f32eac7352c5e08d47c28 Mon Sep 17 00:00:00 2001 From: Garrett D'Amore Date: Mon, 7 May 2018 17:42:40 -0700 Subject: man page updates for tip --- man/tip/nng_ipc.7.html | 45 +++++++++++++++++++++++++++++++++++++++++++++ man/tip/nngcat.1.html | 19 +++++++++++++++++++ 2 files changed, 64 insertions(+) (limited to 'man') diff --git a/man/tip/nng_ipc.7.html b/man/tip/nng_ipc.7.html index dcb1630d..11f3e55f 100644 --- a/man/tip/nng_ipc.7.html +++ b/man/tip/nng_ipc.7.html @@ -632,6 +632,20 @@ The default is system-specific, most often 0644.

+
+ + + + + +
+ + +Not all systems validate these permissions. +In particular, illumos and Solaris are known to ignore these permission +settings when connecting. +
+
@@ -658,6 +672,37 @@ The umask of the process is not applied to these bits.
+
+ + + + + +
+ + +The best practice for limiting access is to place the socket in a +directory writable only by the server, and only readable and searchable +by clients. +All mainstream POSIX systems will fail to permit a client to connect +to a socket located in a diretor for which the client lacks search (execute) +permission. +
+
+
+ + + + + +
+ + +Also consider using the NNG_OPT_IPC_PEER_UID property from within a +a pipe notification callback (nng_pipe_notify()) +to validate peer credentials. +
+
NNG_OPT_IPC_SECURITY_DESCRIPTOR
diff --git a/man/tip/nngcat.1.html b/man/tip/nngcat.1.html index 3a763794..e6dc7946 100644 --- a/man/tip/nngcat.1.html +++ b/man/tip/nngcat.1.html @@ -632,6 +632,18 @@ of messages received, and messages are discarded if they do not match. This may be specified multiple times to subscribe to multiple topics. If not specified at all, then a default subscription to everything is assumed.

+
--count==COUNT
+
+

Limit the number of iterations when looping to COUNT iterations. +For protocols that only send, this will only send COUNT messages before +exiting. +For protocols that only receive, this will only receive COUNT messages +before exiting. +For protocols that involve a full exchange, this will only perform COUNT +exchanges (each exchange is characterized by at most a single send, and +one or more receives.) +If COUNT is zero, then an infinite number of iterations is performed.

+
@@ -857,6 +869,13 @@ Messages are emitted as MessagePack "bin forma

Give up receiving messages after SEC seconds pass without any received messages.

+
--recv-maxsz=COUNT
+
+

Set the maximum message size socket will accept to COUNT bytes. +Messages larger than this will be discarded. +The default is 1048576 (1 MB). +To eliminate any restriction, use 0.

+
-- cgit v1.2.3-70-g09d2