More convenient trusted-host

[gocheese.git] / doc / passwords.texi

diff --git a/doc/passwords.texi b/doc/passwords.texi
index d3d9ad4039b09092c0e5969020a8f230359e3850..fd8bd2edef67845f4a5c59314f4d378549ea591e 100644 (file)
--- a/doc/passwords.texi
+++ b/doc/passwords.texi
@@ -3,17 +3,18 @@
 
 Password authentication is required for packages uploading. Passwords
 are dynamically changed through the FIFO file. You have to create it and
-use in @option{-passwd} option:
+use in @option{-passwd} option. Optionally, to list currently present
+logins use another FIFO and @option{-passwd-list} option:
 
 @example
-$ mkfifo passwd
-$ gocheese -passwd passwd ...
+$ mkfifo passwd passwd-list
+$ gocheese -passwd passwd -passwd-list passwd-list ...
 @end example
 
 Then you must feed it newline-separated records in following format:
 
 @example
-username:hashed-password
+username:hashed-password[:ro]
 @end example
 
 Where @code{hashed-password} is in one of following algorithms:
@@ -24,8 +25,8 @@ Where @code{hashed-password} is in one of following algorithms:
     To get Argon2i hashed-password you can use any of following tools:
 
     @itemize
-    @item @code{go get @url{https://github.com/balakhonova/argon2i,
-        github.com/balakhonova/argon2i}} (Go)
+    @item @code{go install @url{https://github.com/balakhonova/argon2i,
+        github.com/balakhonova/argon2i@@latest}} (Go)
     @item @url{https://github.com/p-h-c/phc-winner-argon2} (C)
     @end itemize
 
@@ -52,6 +53,9 @@ foo:$sha256$fcde2b2edba56bf408601fb721fe9b5c338d10ee429ea04fae5511b68fbf8fb9
 
 @end table
 
+Optional @code{:ro} flag forbids user to upload packages, but allows
+read-only access if @option{-auth-required} is enabled.
+
 To add or update password entry:
 
 @example