hank-test/quick-docs
1
0
Fork 0
mirror of https://pagure.io/fedora-docs/quick-docs.git synced 2024-11-24 21:35:17 +00:00
Code Issues 1 Projects Releases Packages Wiki Activity Actions

Incorporates feedback from @pbokoc

Browse source
This commit is contained in:
Peter Lilley 2020-12-30 22:06:05 +11:00 committed by pbokoc
parent 9537a43afd
commit 9ad84cab81
1 changed files with 13 additions and 11 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

24
modules/ROOT/pages/samba.adoc
View file

@ -1,5 +1,6 @@
[[how_to_create_a_samba_share]] [[how_to_create_a_samba_share]]
= How to create a Samba share = How to create a Samba share
:toc:
Samba allows for Windows and other clients to connect to file share directories on Linux hosts. It implements the server message block (SMB) protocol. This guide covers creating a shared file location on a Fedora machine that can be accessed by other computers on the local network. Samba allows for Windows and other clients to connect to file share directories on Linux hosts. It implements the server message block (SMB) protocol. This guide covers creating a shared file location on a Fedora machine that can be accessed by other computers on the local network.
@ -20,16 +21,15 @@ $ sudo firewall-cmd --permanent --zone=FedoraWorkstation --add-service=samba
$ sudo firewall-cmd --reload $ sudo firewall-cmd --reload
.... ....
[[sharing_a_directory_under_your_home]] [[sharing_a_directory_inside_home]]
== Sharing a directory under your home == Sharing a directory inside /home
In this example you will share a directory under your home directory, accessible only by your user. In this example you will share a directory inside your home directory, accessible only by your user.
Samba does not use the operating system users for authentication, so Samba does not use the operating system users for authentication, so your user account must be duplicated in Samba. So if your account is
your user account must be duplicated in Samba. So if your account is `jane` on the host, the user `jane` must also be added to Samba. While the usernames must match, the passwords can be different.
"jane" on the host, the user "jane" must also be added to Samba. While the usernames must match, the passwords can be different.
Create a user called "jane" in Samba: Create a user called `jane` in Samba:
.... ....
$ sudo smbpasswd -a jane $ sudo smbpasswd -a jane
.... ....
@ -69,7 +69,7 @@ In this example, you will share a directory (outside your home directory) and cr
Remember that a Samba user must also be a system user, in order to Remember that a Samba user must also be a system user, in order to
respect filesystem permissions. This example creates a system group respect filesystem permissions. This example creates a system group
"myfamily" for two new users "jack" and "maria". `myfamily` for two new users `jack` and `maria`.
.... ....
$ sudo groupadd myfamily $ sudo groupadd myfamily
$ sudo useradd -G myfamily jack $ sudo useradd -G myfamily jack
@ -134,8 +134,10 @@ $ sudo systemctl restart smb
[[change_a_samba_user_password]] [[change_a_samba_user_password]]
=== Change a samba user password === Change a samba user password
Remember: the system user and Samba user passwords can be different. The [TIP]
system user is mandatory in order to handle filesystem permissions. ====
Remember: the system user and Samba user passwords can be different. The system user is needed in order to handle filesystem permissions.
====
.... ....
$ sudo smbpasswd maria $ sudo smbpasswd maria
@ -163,7 +165,7 @@ Samba log files are located in `/var/log/samba/`
$ tail -f /var/log/samba/log.smbd $ tail -f /var/log/samba/log.smbd
.... ....
You can increase the verbosity by adding this to the [global] section of You can increase the verbosity by adding this to the `[global]` section of
`/etc/samba/smb.conf`: `/etc/samba/smb.conf`:
.... ....