manpage-idmap-odsam   [plain text]


Index: samba/docs/manpages/idmap_odsam.8
===================================================================
--- /dev/null
+++ samba/docs/manpages/idmap_odsam.8
@@ -0,0 +1,75 @@
+.\"Generated by db2man.xsl. Don't modify this, modify the source.
+.de Sh \" Subsection
+.br
+.if t .Sp
+.ne 5
+.PP
+\fB\\$1\fR
+.PP
+..
+.de Sp \" Vertical space (when we can't use .PP)
+.if t .sp .5v
+.if n .sp
+..
+.de Ip \" List item
+.br
+.ie \\n(.$>=3 .ne \\$3
+.el .ne 3
+.IP "\\$1" \\$2
+..
+.TH "IDMAP_ODSAM" 8 "" "" ""
+.SH NAME
+idmap_odsam \- Open Directory ID mapping backend for winbindd
+.SH "SYNOPSIS"
+
+.PP
+The idmap_odsam plugin is the default backend used by Mac OS X for
+mapping SIDs and user and group IDs using Open Directory. It
+implements both the "idmap" and "idmap alloc" APIs\&.
+
+.PP
+idmap_odsam should always be used in conjunction with the odsam passdb backend\&.
+
+.SH "IDMAP OPTIONS"
+
+.TP
+odsam: msglevel = LEVEL
+LEVEL is the integer log level at which idmap_odsam should emit log messages\&.
+The lower LEVEL is, the more verbose the log messages\&.
+
+.TP
+odsam: traceall = BOOL
+If this is true, idmap_odsam will emit log messages for all Open Directory
+calls\&. If it is false (the default), it will only log errors\&.
+
+.SH "IDMAP ALLOC OPTIONS"
+
+.PP
+The idmap_odsam does not allocate any mappings. On Mac OS X, all SID mappings
+should be made by modifying the appropriate Open Directory record.
+
+.SH "EXAMPLES"
+.nf
+
+	[global]
+	    idmap domain = default
+	    idmap config default:default = yes
+	    idmap config default:backend = odsam
+
+	    idmap alloc backend = odsam
+
+	    passdb backend = odsam
+
+	    odsam: msglevel = 0    # Log at debugging levels
+	    odsam: traceall = no   # Do not trace Open Directory calls
+
+.fi
+
+.SH "BUGS"
+
+.PP
+Please report bugs to Apple.
+
+.SH "SEE ALSO"
+DirectoryService(8), smb.conf(5), winbindd(8)
+