smbautohome(4)							   File Formats 						    smbautohome(4)

NAME

       smbautohome - CIFS autohome configuration

SYNOPSIS

       smbautohome

DESCRIPTION

       The  Solaris  CIFS  service  can automatically share home directories when a CIFS client connects. The autohome map file, /etc/smbautohome,
       uses the search options and rules to determine whether to share a home directory when a CIFS client connects to the server.

       For example, the following entries specify the autohome rules for a particular environment:

	 +nsswitch     dn=ad,dn=sun,dn=com,ou=users
	 jane	 /home/?/&    dn=ad,dn=sun,dn=com,ou=users

       The nsswitch autohome entry uses the naming service to match users to home directories. The second autohome entry specifies that  the  home
       directory for user jane is /home/j/jane.

   autohome Map Entry Format
       A map entry, which is also referred to as a mapping, uses the following format:

	 key location [ options ]

       key  is a user name, location is the fully qualified path for the user's home directory, and options specifies the share options, for exam-
       ple, an AD container or description. See sharemgr(1M) for information on share options.

       If you intend to publish the share in Active Directory (AD), you must specify an AD container name, which is specified as a comma-separated
       list of attribute name-value pairs. The attributes use the LDAP distinguished name (DN) or relative distinguished name (RDN) format.

       The DN or RDN must be specified in LDAP format by using the following attribute types:

	   o	  cn= represents the common name

	   o	  ou= represents the organizational unit

	   o	  dc= represents the domain component

       The attribute type that is used to describe an object's RDN is called a naming attribute. AD uses the naming attributes as follows:

	   o	  cn for the user object class

	   o	  ou for the OU (organizational unit) object class

	   o	  dc for the domainDns object class

   autohome Map Key Substitution
       The autohome feature supports the following wildcard substitutions for the value of the key field:

	   o	  The  ampersand  character (&) is expanded to the value of the key field for the entry in which it occurs. In the following exam-
		  ple, & expands to jane:

		    jane /home/&

	   o	  The question mark character (?) is expanded to the value of the first character in the key field  for  the  entry  in  which	it
		  occurs. In the following example, ? expands to j:

		    jane /home/?/&

   Wildcard Rule
       When supplied in the key field, the asterisk character (*) is recognized as the "catch-all" entry. Such an entry matches any key not previ-
       ously matched.

       For example, the following entry would map any user to a home directory in /home in which the home directory name was the same as the  user
       name:

	 *    /home/&

       The wildcard rule is only applied if an appropriate rule is not matched by another map entry.

   NSSwitch Map
       The  nsswitch  map  is  used to request that the home directory be obtained from a password database, such as the local, NIS, NIS+, or LDAP
       databases. If an AD path is appended, it is used to publish shares.

	 +nsswitch

       Like the "catch-all" entry, the nsswitch map is only searched if an appropriate rule is not matched by another map entry.

       The wildcard and nsswitch rules are mutually exclusive. Do not include an nsswitch rule if a wildcard rule has already been defined.

FILES

       /etc/smbautohome

ATTRIBUTES

       See the attributes(5) man page for descriptions of the following attributes:

       +-----------------------------+-----------------------------+
       |      ATTRIBUTE TYPE	     |	    ATTRIBUTE VALUE	   |
       +-----------------------------+-----------------------------+
       |Availability		     |SUNWsmbsu 		   |
       +-----------------------------+-----------------------------+
       |Interface Stability	     |Uncommitted		   |
       +-----------------------------+-----------------------------+

SEE ALSO

       sharectl(1M), sharemgr(1M), smbadm(1M), smbd(1M), smbstat(1M), smb(4), attributes(5)

SunOS 5.11							    5 Jan 2009							    smbautohome(4)