40.4 User Identification

Variable: init-file-user

This variable says which user's init files should be used by Emacs--or nil if none. The value reflects command-line options such as `-q' or `-u user'.

Lisp packages that load files of customizations, or any other sort of user profile, should obey this variable in deciding where to find it. They should load the profile of the user name found in this variable. If init-file-user is nil, meaning that the `-q' option was used, then Lisp packages should not load any customization files or user profile.

Variable: user-mail-address

This holds the nominal email address of the user who is using Emacs. Emacs normally sets this variable to a default value after reading your init files, but not if you have already set it. So you can set the variable to some other value in your init file if you do not want to use the default value.

Function: user-login-name &optional uid

If you don't specify uid, this function returns the name under which the user is logged in. If the environment variable LOGNAME is set, that value is used. Otherwise, if the environment variable USER is set, that value is used. Otherwise, the value is based on the effective UID, not the real UID.

If you specify uid, the value is the user name that corresponds to uid (which should be an integer).

(user-login-name) => "lewis"

Function: user-real-login-name

This function returns the user name corresponding to Emacs's real UID. This ignores the effective UID and ignores the environment variables LOGNAME and USER.

Function: user-full-name &optional uid

This function returns the full name of the logged-in user--or the value of the environment variable NAME, if that is set.

(user-full-name) => "Bil Lewis"

If the Emacs job's user-id does not correspond to any known user (and provided NAME is not set), the value is "unknown".

If uid is non-nil, then it should be an integer (a user-id) or a string (a login name). Then user-full-name returns the full name corresponding to that user-id or login name. If you specify a user-id or login name that isn't defined, it returns nil.

The symbols user-login-name, user-real-login-name and user-full-name are variables as well as functions. The functions return the same values that the variables hold. These variables allow you to "fake out" Emacs by telling the functions what to return. The variables are also useful for constructing frame titles (see section 29.4 Frame Titles).

Function: user-real-uid

This function returns the real UID of the user.

(user-real-uid) => 19

Function: user-uid

This function returns the effective UID of the user.