user_smb

map a QNX user to an SMB user (QNX)

Syntax:

user_smb [-n node] [-s server] [-u userid]
         smb-user [smb-password]

Options:

-n node
Tell the SMBfsys process on the specified node about the mapping. The default is to tell the SMBfsys process on the same node that user_smb is invoked from.
-s server
Specify that this mapping is valid only for the specified SMB server. The default is that the mapping applies to all servers. This allows a single QNX userid to map to different SMB usernames on different servers. Multiple -s options can be specified on a single command line, in which case the mapping is set for all the named servers.
-u userid
The mapping is for the specified userid number or QNX username from the /etc/passwd file. The default is to set the mapping for the current user. Only a root user is allowed to use this option.
smb-user
This is the SMB username on an SMB server.
smb-password
This is the SMB password for the SMB server user.

Examples:

Tell the SMBfsys manager to user the SMB ID gates for requests. The SMB password for gates is "money":

    user_smb gates money

Description:

The user_smb utility creates a mapping between a QNX userid and an SMB username and password. Whenever a request comes in, SMBfsys checks the userid of the requesting process against the list of userid's that it has logged in connections for the given server. If this userid is not currently logged into the SMB server, SMBfsys consults the mapping tables created using user_smb to find out the SMB username/password and attempts to log the user in. The mappings for the particular server is checked first (-s option) and then the mappings for all servers. If no mapping is found for a particular userid, SMBfsys will consult the /etc/passwd file to find a user name. If it finds one for the userid, it uses the given name and an empty password for the logon attempt. If SMBfsys can't find an entry for the userid in /etc/passwd, it will use the username specified by its -u option and an empty password.

The SMBfsys manager does not store the mapping information in stable storage, so the mappings must be reestablished whenever SMBfsys is restarted. If user_smb is run with no password and the userid/smb_user pair is new, the user will be prompted for the password. If userid/smb_user has been seen before, the previous password for the pair is used. This allows a user to place a user_smb command that just specifies an SMB user name in his .profile file. If SMBfsys has been restarted since the last time the user logged in to QNX, he will be prompted to provide the password. If the information was previously entered and SMBfsys has not been restarted, no prompting occurs.

See also: