aboutsummaryrefslogtreecommitdiffstats
path: root/doc/src/manual/gun.open_unix.asciidoc
diff options
context:
space:
mode:
authorLoïc Hoguin <[email protected]>2018-06-02 22:44:16 +0200
committerLoïc Hoguin <[email protected]>2018-06-02 22:44:16 +0200
commit5b810c924da242632a04a2c44772cb892aa1b7c0 (patch)
treee9ee81bd3b6aea1f9665914b8858edad377c24c7 /doc/src/manual/gun.open_unix.asciidoc
parent04b41c3cf70aba88c1dd76e4e86c39458d817219 (diff)
downloadgun-5b810c924da242632a04a2c44772cb892aa1b7c0.tar.gz
gun-5b810c924da242632a04a2c44772cb892aa1b7c0.tar.bz2
gun-5b810c924da242632a04a2c44772cb892aa1b7c0.zip
Revamp the manual, one page per function/message
Diffstat (limited to 'doc/src/manual/gun.open_unix.asciidoc')
-rw-r--r--doc/src/manual/gun.open_unix.asciidoc60
1 files changed, 60 insertions, 0 deletions
diff --git a/doc/src/manual/gun.open_unix.asciidoc b/doc/src/manual/gun.open_unix.asciidoc
new file mode 100644
index 0000000..225ecc8
--- /dev/null
+++ b/doc/src/manual/gun.open_unix.asciidoc
@@ -0,0 +1,60 @@
+= gun:open_unix(3)
+
+== Name
+
+gun:open_unix - Open a connection to the given Unix domain socket
+
+== Description
+
+[source,erlang]
+----
+open_unix(SocketPath, Opts) -> {ok, pid()} | {error, any()}
+
+SocketPath :: string()
+Opts :: gun:opts()
+----
+
+Open a connection to the given Unix domain socket.
+
+== Arguments
+
+SocketPath::
+
+Path to the Unix domain socket to connect to.
+
+Opts::
+
+Options for this connection.
+
+== Return value
+
+The pid of the newly created Gun process is returned.
+Note that this does not indicate that the connection
+has been successfully opened; the link:man:gun_up(3)[gun_up(3)]
+message will be sent for that.
+
+== Changelog
+
+* *1.0*: Function introduced.
+
+== Examples
+
+.Connect to a server via a Unix domain socket
+[source,erlang]
+----
+{ok, ConnPid} = gun:open_unix("/var/run/dbus/system_bus_socket", #{}).
+----
+
+.Connect to a server via a Unix domain socket with custom options
+[source,erlang]
+----
+{ok, ConnPid} = gun:open_unix("/var/run/dbus/system_bus_socket",
+ #{protocols => [http2]}).
+----
+
+== See also
+
+link:man:gun(3)[gun(3)],
+link:man:gun:open(3)[gun:open(3)],
+link:man:gun:await_up(3)[gun:await_up(3)],
+link:man:gun_up(3)[gun_up(3)]