]> arthur.barton.de Git - bup.git/blobdiff - Documentation/bup-web.md
LocalRepo.__init__: use correct dir everywhere
[bup.git] / Documentation / bup-web.md
index 6b650885fdd89e764b8578ae84e6e9a74b9b4f81..2f7750f66f49b0022711b00c63a0c95fbb1b0fe9 100644 (file)
@@ -10,6 +10,8 @@ bup-web - Start web server to browse bup repositiory
 
 bup web [[hostname]:port]
 
+bup web unix://path
+
 # DESCRIPTION
 
 `bup web` starts a web server that can browse bup repositories. The file
@@ -21,6 +23,9 @@ hierarchy is the same as that shown by `bup-fuse`(1), `bup-ls`(1) and
 you'd like to expose the web server to anyone on your network (dangerous!) you
 can omit the bind address to bind to all available interfaces: `:8080`.
 
+When `unix://path` is specified, the server will listen on the
+filesystem socket at `path` rather than a network socket.
+
 A `SIGTERM` signal may be sent to the server to request an orderly
 shutdown.
 
@@ -44,6 +49,14 @@ shutdown.
     ^C
     Interrupted.
 
+    $ bup web unix://socket &
+    Serving HTTP on filesystem socket 'socket'
+    $ curl --unix-socket ./socket http://localhost/
+    $ fg
+    bup web unix://socket
+    ^C
+    Interrupted.
+
     $ bup web &
     [1] 30980
     Serving HTTP on 127.0.0.1:8080...