03/04: doc: Add a simple Samba share example.

[guix-commits]

apteryx pushed a commit to branch master
in repository guix.

commit f2d071c832d4cc556f915ca2595ba958cac3a29c
Author: Maxim Cournoyer <maxim.cournoyer@gmail.com>
AuthorDate: Wed Sep 28 08:22:45 2022 -0400

    doc: Add a simple Samba share example.
    
    * doc/guix.texi (Samba Services): Add a configuration example.
---
 doc/guix.texi | 32 ++++++++++++++++++++++++++++++++
 1 file changed, 32 insertions(+)

diff --git a/doc/guix.texi b/doc/guix.texi
index 275b53f267..5de1fdbd8c 100644
--- a/doc/guix.texi
+++ b/doc/guix.texi
@@ -31337,6 +31337,38 @@ The service type to enable the samba services 
@code{samba}, @code{nmbd},
 @code{smbd} and @code{winbindd}.  By default this service type does not
 run any of the Samba daemons; they must be enabled individually.
 
+Below is a basic example that configures a simple, anonymous
+(unauthenticated) Samba file share exposing the @file{/public}
+directory.
+
+@quotation Tip
+The @file{/public} directory and its contents must be world
+readable/writable, so you'll want to run @samp{chmod -R 777 /public} on
+it.
+@end quotation
+
+@quotation Caution
+Such a Samba configuration should only be used in controlled
+environments, and you should not share any private files using it, as
+anyone connecting to your network would be able to access them.
+@end quotation
+
+@lisp
+(service samba-service-type (samba-configuration
+                             (enable-smbd? #t)
+                             (config-file (plain-file "smb.conf" "\
+[global]
+map to guest = Bad User
+logging = syslog@@1
+
+[public]
+browsable = yes
+path = /public
+read only = no
+guest ok = yes
+guest only = yes\n"))))
+@end lisp
+
 @end defvar
 
 @deftp{Data Type} samba-service-configuration