KUser Class Reference
from PyKDE4.kdecore import *
Detailed Description
\class KUser kuser.h <KUser>
Represents a user on your system
This class represents a user on your system. You can either get information about the current user, of fetch information about a user on the system. Instances of this class will be explicitly shared, so copying objects is very cheap and you can safely pass objects by value.
Enumerations | |
UIDMode | { UseEffectiveUID, UseRealUserID } |
UserProperty | { FullName, RoomNumber, WorkPhone, HomePhone } |
Methods | |
__init__ (self, KUser.UIDMode mode=KUser.UseEffectiveUID) | |
__init__ (self, K_UID uid) | |
__init__ (self, QString name) | |
__init__ (self, QString name) | |
__init__ (self, passwd p) | |
__init__ (self, KUser user) | |
QString | faceIconPath (self) |
QString | fullName (self) |
K_GID | gid (self) |
QStringList | groupNames (self) |
[KUserGroup] | groups (self) |
QString | homeDir (self) |
bool | isSuperUser (self) |
bool | isValid (self) |
QString | loginName (self) |
bool | operator != (self, KUser user) |
bool | operator == (self, KUser user) |
QVariant | property (self, KUser.UserProperty which) |
QString | shell (self) |
K_UID | uid (self) |
Static Methods | |
QStringList | allUserNames () |
[KUser] | allUsers () |
Method Documentation
__init__ | ( | self, | ||
KUser.UIDMode | mode=KUser.UseEffectiveUID | |||
) |
Creates an object that contains information about the current user. (as returned by getuid(2) or geteuid(2), taking $LOGNAME/$USER into account).
- Parameters:
-
mode if #UseEffectiveUID is passed the effective user is returned. If #UseRealUserID is passed the real user will be returned. The real UID will be different than the effective UID in setuid programs; in such a case use the effective UID for checking permissions, and the real UID for displaying information about the user.
__init__ | ( | self, | ||
K_UID | uid | |||
) |
Creates an object for the user with the given user id. If the user does not exist isValid() will return false.
- Parameters:
-
uid the user id
__init__ | ( | self, | ||
QString | name | |||
) |
Creates an object that contains information about the user with the given name. If the user does not exist isValid() will return false.
- Parameters:
-
name the name of the user
__init__ | ( | self, | ||
QString | name | |||
) |
Creates an object that contains information about the user with the given name. If the user does not exist isValid() will return false.
- Parameters:
-
name the name of the user
__init__ | ( | self, | ||
passwd | p | |||
) |
Creates an object from a passwd structure. If the pointer is null isValid() will return false.
- Parameters:
-
p the passwd structure to create the user from
__init__ | ( | self, | ||
KUser | user | |||
) |
Creates an object from another KUser object
- Parameters:
-
user the user to create the new object from
QStringList allUserNames | ( | ) |
Returns all user names of the system.
- Returns:
- all user names of the system.
[KUser] allUsers | ( | ) |
Returns all users of the system.
- Returns:
- all users of the system.
QString faceIconPath | ( | self ) |
The path to the user's face file.
- Returns:
- the path to the user's face file or QString() if no face has been set
QString fullName | ( | self ) |
The full name of the user.
- Returns:
- the full name of the user or QString() if user is invalid
- Deprecated:
- use property(KUser.FullName) instead
K_GID gid | ( | self ) |
Returns the group id of the user.
- Returns:
- the id of the group or -1 if user is invalid
QStringList groupNames | ( | self ) |
Returns all group names of the user
- Returns:
- all group names of the user
[KUserGroup] groups | ( | self ) |
Returns all groups of the user
- Returns:
- all groups of the user
QString homeDir | ( | self ) |
The path to the user's home directory.
- Returns:
- the home directory of the user or QString() if the user is invalid
bool isSuperUser | ( | self ) |
Checks whether the user is the super user (root).
- Returns:
- true if the user is root
bool isValid | ( | self ) |
Returns true if the user is valid. A KUser object can be invalid if you created it with an non-existing uid or name.
- Returns:
- true if the user is valid
QString loginName | ( | self ) |
The login name of the user.
- Returns:
- the login name of the user or QString() if user is invalid
bool operator != | ( | self, | ||
KUser | user | |||
) |
Two KUser objects are not equal if uid() are not identical. Invalid users always compare unequal.
bool operator == | ( | self, | ||
KUser | user | |||
) |
Two KUser objects are equal if the uid() are identical. Invalid users never compare equal.
QVariant property | ( | self, | ||
KUser.UserProperty | which | |||
) |
Returns an extended property.
Under Windows, RoomNumber, WorkPhone and HomePhone are unsupported.
- Returns:
- a QVariant with the value of the property or an invalid QVariant, if the property is not set
QString shell | ( | self ) |
The path to the user's login shell.
- Returns:
- the login shell of the user or QString() if the user is invalid
K_UID uid | ( | self ) |
Returns the user id of the user.
- Returns:
- the id of the user or -1 if user is invalid
Enumeration Documentation
UIDMode |
- Enumerator:
-
UseEffectiveUID UseRealUserID
UserProperty |
- Enumerator:
-
FullName RoomNumber WorkPhone HomePhone