Bug 9454 - Incomplete and incorrect documentation on 'username map' config directive
Incomplete and incorrect documentation on 'username map' config directive
Status: NEW
Product: Samba 3.6
Classification: Unclassified
Component: Docs
All All
: P5 minor
: ---
Assigned To: Samba Documentation QA Contact~
Samba Documentation QA Contact~
Depends on:
  Show dependency treegraph
Reported: 2012-12-03 17:26 UTC by Andrew Black
Modified: 2012-12-03 17:26 UTC (History)
0 users

See Also:
ablack: review?

Proposed documentation changes generated using diff -u (1.05 KB, patch)
2012-12-03 17:26 UTC, Andrew Black
ablack: review?

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