Go to file

CI Bot 1f33cd00c9 [skip ci] automated docs update		2024-02-19 09:39:47 +00:00
.woodpecker	ci: migrate to woodpecker	2024-02-19 10:37:58 +01:00
defaults	fix broken link to ansible docs	2021-02-21 15:41:21 +01:00
meta	ci: migrate to woodpecker	2024-02-19 10:37:58 +01:00
molecule	ci: migrate to woodpecker	2024-02-19 10:37:58 +01:00
tasks	ci: migrate to woodpecker	2024-02-19 10:37:58 +01:00
templates	initial commit	2020-01-26 00:09:27 +01:00
.gitignore	ci: migrate to woodpecker	2024-02-19 10:37:58 +01:00
.later.yml	ci: migrate to woodpecker	2024-02-19 10:37:58 +01:00
.markdownlint.yml	ci: migrate to woodpecker	2024-02-19 10:37:58 +01:00
.prettierignore	ci: migrate to woodpecker	2024-02-19 10:37:58 +01:00
LICENSE	chore: end of the year maintenance [skip ci]	2021-12-21 10:45:44 +01:00
README.md	[skip ci] automated docs update	2024-02-19 09:39:47 +00:00
pyproject.toml	ci: migrate to woodpecker	2024-02-19 10:37:58 +01:00

README.md

xoxys.smb

Mount a list of Samba shares.

Table of content

Requirements
Default Variables
- smb_packages
- smb_shares
Dependencies
License
Author

Requirements

Minimum Ansible version: 2.10

Default Variables

smb_packages

Default value

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 module.

Default value

smb_shares: []

Example usage

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.

License

MIT

Author

Robert Kaussow