Bug 9454 - Incomplete and incorrect documentation on 'username map' config directive
Summary: Incomplete and incorrect documentation on 'username map' config directive
Alias: None
Product: Samba 3.6
Classification: Unclassified
Component: Docs (show other bugs)
Version: unspecified
Hardware: All All
: P5 minor
Target Milestone: ---
Assignee: Samba Documentation QA Contact~
QA Contact: Samba Documentation QA Contact~
URL: http://www.samba.org/samba/docs/man/S...
Depends on:
Reported: 2012-12-03 17:26 UTC by Andrew Black
Modified: 2021-01-11 12:26 UTC (History)
0 users

See Also:

Proposed documentation changes generated using diff -u (1.05 KB, patch)
2012-12-03 17:26 UTC, Andrew Black
no flags Details

Note You need to log in before you can comment on or make changes to this bug.
Description Andrew Black 2012-12-03 17:26:44 UTC
Created attachment 8269 [details]
Proposed documentation changes generated using diff -u

I recently needed to set up a user name mapping for a couple of windows users on one of our SAMBA servers (joined to a windows domain). Unfortunately, the online documentation for this particular file specified an incorrect file format for the user map file. In addition, the documentation appears to assume that the windows user accounts are local rather than part of a domain.

Attached (as netcommand.patch) is my attempt to update this documentation. This patch was generated from the latest stable sources (samba-3.6.9.tar.gz) using the diff -u command. It can be applied from within the docs-xml/Samba3-HOWTO directory using 'patch -p0 < /path/to/netcommand.patch'. I recognize that this is contrary to the contributor guidelines, but I don't expect to be contributing to the SAMBA project on a regular basis. I have tested that the documentation builds correctly with this patch applied.

A possible changelog for this patch is as follows:
s3/docs Update documentation on smbusers file

Correct format specification for file in Chapter 13 (Remote and Local Management: The Net Command) and add documentation about the use of domain users in the smbusers file.

Andrew Black
Comment 1 Björn Jacke 2020-12-14 14:09:02 UTC
the Samba3-HOWTO is long unmaintained and now even removed since a while.