From f2d071c832d4cc556f915ca2595ba958cac3a29c Mon Sep 17 00:00:00 2001 From: Maxim Cournoyer Date: Wed, 28 Sep 2022 08:22:45 -0400 Subject: 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 -- cgit v1.2.3