Robert Kaussow
380dbd7c39
Author: Robert Kaussow <mail@thegeeklab.de>
Date: Thu Mar 3 21:16:05 2022 +0100
chore: add auto-generated _docs folder to gitignore file
61 lines
1.6 KiB
Markdown
61 lines
1.6 KiB
Markdown
---
|
|
title: smb
|
|
type: docs
|
|
---
|
|
|
|
[](https://gitea.rknet.org/ansible/xoxys.smb) [](https://drone.rknet.org/ansible/xoxys.smb) [](https://gitea.rknet.org/ansible/xoxys.smb/src/branch/master/LICENSE)
|
|
|
|
Mount a list of Samba shares.
|
|
|
|
- [Default Variables](#default-variables)
|
|
- [smb_packages](#smb_packages)
|
|
- [smb_shares](#smb_shares)
|
|
- [Dependencies](#dependencies)
|
|
|
|
---
|
|
|
|
## Default Variables
|
|
|
|
### smb_packages
|
|
|
|
#### Default value
|
|
|
|
```YAML
|
|
smb_packages:
|
|
- cifs-utils
|
|
```
|
|
|
|
### smb_shares
|
|
|
|
Mount defined samba shares. You can specify samba credentials with the `username` and `password` parameter. Given credentials will be used in a secrets file and saved to `/root/.smbcredentials/<name>` instead of the direct use in `/etc/fstab`. If secrets are defined for a list item, the secrest file will also be passed automatically to `mountopts`.
|
|
|
|
The `state` parameter is related to the possible state values of Ansibles [mount](https://docs.ansible.com/ansible/latest/collections/ansible/posix/mount_module.html) module.
|
|
|
|
#### Default value
|
|
|
|
```YAML
|
|
smb_shares: []
|
|
```
|
|
|
|
#### Example usage
|
|
|
|
```YAML
|
|
smb_shares:
|
|
- name: multimedia
|
|
source: //share.example.com/media
|
|
username: myuser
|
|
password: secure
|
|
mountpoint: /media/data
|
|
mountopts:
|
|
- acl
|
|
- uid=1000
|
|
- gid=1000
|
|
state: mounted
|
|
```
|
|
|
|
|
|
|
|
## Dependencies
|
|
|
|
None.
|