Jump to content United States-English
HP.com Home Products and Services Support and Drivers Solutions How to Buy
» Contact HP
More options
HP.com home
HP CIFS Client A.01.09 Administrator's Guide: HP-UX 11.0 and 11i version 1 and 2 > Chapter 5 Commandline Utilities

cifslogin

» 

Technical documentation

Complete book in PDF
» Feedback
Content starts here

 » Table of Contents

 » Glossary

 » Index

Synopsis

cifslogin <servername> [<username>] [<options>]

Description

The cifslogin command is used to authenticate additional users at a server. Only authenticated users may access mounted files. Each user accesses the file at the server with his or her privilege status at that server. Because there must be a one-to-one (many=to-one) mapping from local users to remote user names, every user can log in only once at a given server. By default, cifslogin sends the user's login name to the server. If this is not desired, the username can be given in the commandline.

Options

-c <clientname>

Sets the Netbios name of the client. HP CIFS is based on Netbios. Netbios requires that valid Netbios computer names are supplied during the connection establishment for the client and the server. The client name is usually taken from the hostname of your computer. If this does not work or if your computer's Netbios name is different, you may supply the value to be used with this parameter. This parameter is ignored if the server is already connected.

-I <IP number>

IP address of server. By default, the hostname of the server is taken from the server specification of the share. This must also be the Netbios host name of the server, if the server enforces correct Netbios names. The HP CIFS Client uses DNS instead of Netbios to resolve server names to IP addresses. If the DNS name of the server is different from the Netbios name, you may supply the DNS name or the server's IP address with this parameter. It is ignored if the server is already connected.

-p <portnumber>

Sets the connection port. Netbios connections are usually made on port 139. If you want to connect on a different port, you can supply a decimal port number with this parameter. This parameter is ignored if the server is already connected.

-P <password>

Password given in commandline. Use this option only if you really have to, because all commandline parameters may show up in the output of the ps command. It gives you the possibility to pass a dynamically generated password to the server. The password is ignored if the user is already logged in at the server.

-S

Reads the password from stdin. This option may be useful if you want to use cifslogin from a shell script or another program. The -P option is insecure for this purpose because the Unix command ps can show the commandline parameters of running processes.

-N

Do not prompt for a password. This option may be used to avoid prompting for a password if you are already logged in at the server or if the user does not have a password.

-u

Enables plain text passwords. The HP CIFS Client refuses to send passwords in plain text to the server by default because this is a security risk. There are tools available that sniff the network for plain text passwords. If you really must send the password in plain text (e.g., because your server does not allow password encryption), you can enable it with this option. It is ignored if you are already logged in at the server.

-f

Forces login. When this option is used, the login is done even when the server is not responding. No requests are sent to the server. Consequently, none of the parameters can be checked for validity.

-s

Saves password in database. Do not use unless you understand the security implications. This option can maintain a database of mounts, username, and passwords. This database is used at startup to re-establish stored mounts and to log in users on demand, even if you are not logged in at the client.

This option may be useful for automounting and to run programs by cron that have no possibility to ask the user for a password. Passwords are stored in the HP CIFS Client's user database file. It is possible to get the CIFS hash values of the passwords (which is functionally equivalent to the passwords themselves) out of this file, although the file itself is not sufficient.

You can use this option safely only if you are the only one who has physical or root access to your machine or if you trust everyone who has this access. The HP CIFS Client does not store unencrypted passwords in the user database. If your server does not support encrypted passwords, you cannot use this option.

Examples

If local user steve has mounted a share from server bigserver, local user bill has no access to the mounted files because he is not logged in at the server. Bill, who has an account on bigserver under his real name miller, can do the following to gain access:

cifslogin bigserver miller

Bill will be prompted for a password and if it is correct, he will be given access to the share with the same privileges that user miller has on bigserver.

Files

Usernames and passwords are stored encrypted in the HP CIFS Client's user database file. The path to the user database file can be configured in HP CIFS Client's configuration file. The default path is

/var/opt/cifsclient/cifsclient.udb

See Also

cifsmount, cifsumount, cifslogout, cifslist

Printable version
Privacy statement Using this site means you accept its terms Feedback to webmaster
© Hewlett-Packard Development Company, L.P.