1 files changed, 23 insertions, 0 deletions

diff --git a/noncore/settings/usermanager/passwd.cpp b/noncore/settings/usermanager/passwd.cpp
index 5063661..0a2bfba 100644
--- a/noncore/settings/usermanager/passwd.cpp
+++ b/noncore/settings/usermanager/passwd.cpp
@@ -48,12 +48,13 @@ char *Passwd::crypt_make_salt() {
         result[0] = i64c(((x >> 18) ^ (x >> 6)) & 077);
         result[1] = i64c(((x >> 12) ^ x) & 077);
         result[2] = '\0';
         return result;
 }
 
+//  opens the files /etc/passwd & /etc/group and loads the contents into passwdStringList & groupStringList
 bool Passwd::open() {
         int returnvalue=false;
         
         QFile passwd_file("/etc/passwd");
         QFile group_file("/etc/group");
         passwdStringList.clear();
@@ -73,12 +74,13 @@ bool Passwd::open() {
                 }
                 passwd_file.close();
         }
         return returnvalue;
 }
 
+// Writes back the contents of passwdStringList to /etc/passwd & groupStringList to /etc/group
 bool Passwd::close() {
         int returnvalue=false;
         QFile passwd_file("/etc/passwd");
         QFile group_file("/etc/group");
         if((passwd_file.open(IO_WriteOnly))) {
                 if((group_file.open(IO_WriteOnly))) {
@@ -95,54 +97,60 @@ bool Passwd::close() {
                 }
                 passwd_file.close();
         }
         return returnvalue;
 }
 
+// Splits a "passwd" line into the components and stores them in the pw_* variables.
 void Passwd::splitPasswdEntry(QString &userString) {
         userdataStringList=QStringList::split(":",userString,true);
         QStringList::Iterator it=userdataStringList.begin();
         pw_name=(*it++);
         pw_passwd=(*it++);
         pw_uid=(*it++).toInt();
         pw_gid=(*it++).toInt();
         pw_gecos=(*it++);
         pw_dir=(*it++);
         pw_shell=(*it++);
 }
 
+// Splits a "group" line into the components and stores them in the gr_* variables.
 void Passwd::splitGroupEntry(QString &groupString) {
         groupdataStringList=QStringList::split(":",groupString,true);
         QStringList::Iterator it=groupdataStringList.begin();
         gr_name=(*it++);
         it++;
         gr_gid=(*it++).toInt();
         gr_mem=QStringList::split(" ",(*it++));
 }
 
+// Find a user in the passwdStringList. Return true if found and also fill the pw_* variables.
 bool Passwd::searchUser(QRegExp &userRegExp) {
         QStringList tempStringList(passwdStringList.grep(userRegExp));
         if((tempStringList.isEmpty())) {
                 return false;
         } else {
                 userString=(*(tempStringList.begin()));
                 splitPasswdEntry(userString);
         }
         return true;
 }
 
+// Find a user by login.
 bool Passwd::findUser(const char *username) {
         QRegExp userRegExp(QString("^%1\\:").arg(username));
         return searchUser(userRegExp);
 }
 
+// Find a user by uid.
 bool Passwd::findUser(int uid) {
         QRegExp userRegExp(QString(":%1\\:").arg(uid));
         return searchUser(userRegExp);
 }
 
+// Add a user to the passwdStringList, create home directory, and optionally create a group for the user.
 bool Passwd::addUser(QString pw_name, QString pw_passwd, int pw_uid, int pw_gid, QString pw_gecos,QString pw_dir, QString pw_shell, bool createGroup) {
         QString tempString;
         if((createGroup) && (!(findGroup(pw_gid)))) addGroup(pw_name,pw_gid);
         pw_passwd = crypt(pw_passwd, crypt_make_salt());
         tempString=pw_name+":"+pw_passwd+":"+QString::number(pw_uid)+":"+QString::number(pw_gid)+":"+pw_gecos+":"+pw_dir+":"+pw_shell;
         passwdStringList.append(tempString);
@@ -153,73 +161,82 @@ bool Passwd::addUser(QString pw_name, QString pw_passwd, int pw_uid, int pw_gid,
                 chown(pw_dir,pw_uid,pw_gid);
                 chmod(pw_dir,S_IRUSR|S_IWUSR|S_IXUSR);
         }
         return 1;
 }
 
+// Update info for a user in passwdStringList, take info from the pw_* fields.
 bool Passwd::updateUser(QString login) {
         QRegExp userRegExp(QString("^%1\\:").arg(login));
         for(QStringList::Iterator it=passwdStringList.begin(); it!=passwdStringList.end(); ++it) {
                 if(userRegExp.find((*it),0)!=-1) {
                         *it=QString(pw_name+":"+pw_passwd+":"+QString::number(pw_uid)+":"+QString::number(pw_gid)+":"+pw_gecos+":"+pw_dir+":"+pw_shell);
                         return true;
                 }
         }
         return false;
 }
 
+// Delete a user from passwdStringList.
 bool Passwd::deleteUser(QRegExp &userRegExp, bool delGroup) {
         for(QStringList::Iterator it=passwdStringList.begin(); it!=passwdStringList.end(); ++it) {
                 if(userRegExp.find((*it),0)!=-1) {
                         splitPasswdEntry(*it);
                         if(delGroup) this->delGroup(pw_gid);
                         passwdStringList.remove(it);
                         return true;
                 }
         }
         return false;
 }
 
+// Delete a user by login, and optionally also delete group.
 bool Passwd::delUser(const char *username, bool delGroup) {
         QRegExp userRegExp(QString("^%1\\:").arg(username));
         return deleteUser(userRegExp,delGroup);
 }
 
+// Delete a user by uid, and optionally also delete group.
 bool Passwd::delUser(int uid, bool delGroup) {
         QRegExp userRegExp(QString(":%1\\:").arg(uid));
         return deleteUser(userRegExp,delGroup);
 }
 
+// Locate a group in the groupStringList, fill out the gr_* variables and return "true" if found.
 bool Passwd::searchGroup(QRegExp &groupRegExp) {
         QStringList tempStringList(groupStringList.grep(groupRegExp));
         if((tempStringList.isEmpty())) {
                 return false;
         } else {
                 groupString=(*(tempStringList.begin()));
                 splitGroupEntry(groupString);
         }
         return true;
 }
 
+// Find a group by groupname.
 bool Passwd::findGroup(const char *groupname) {
         QRegExp groupRegExp(QString("^%1\\:").arg(groupname));
         return searchGroup(groupRegExp);
 }
 
+// Find a group by gid.
 bool Passwd::findGroup(int gid) {
         QRegExp groupRegExp(QString(":%1\\:").arg(gid));
         return searchGroup(groupRegExp);
 }
 
+// Add a group to groupStringList
 bool Passwd::addGroup(QString gr_name, int gr_gid) {
         QString tempString;
         tempString=gr_name+":*:"+QString::number(gr_gid)+":";
         groupStringList.append(tempString);
         return 1;
 }
 
+// Update fields for a group in groupStringList, take info from the gr_* variables.
 bool Passwd::updateGroup(int gid) {
         QRegExp groupRegExp(QString(":%1\\:").arg(QString::number(gid)));
         for(QStringList::Iterator it=groupStringList.begin(); it!=groupStringList.end(); ++it) {
                 if(groupRegExp.find((*it),0)!=-1) {
                         *it=QString(gr_name+":*:"+QString::number(gr_gid)+":");
                         for(QStringList::Iterator member=gr_mem.begin(); member!=gr_mem.end(); ++member) {
@@ -229,46 +246,52 @@ bool Passwd::updateGroup(int gid) {
                         return true;
                 }
         }
         return false;
 }
 
+// Delete a group from groupStringList.
 bool Passwd::deleteGroup(QRegExp &groupRegExp) {
         for(QStringList::Iterator it=groupStringList.begin(); it!=groupStringList.end(); ++it) {
                 if(groupRegExp.find((*it),0)!=-1) {
                         groupStringList.remove(it);
                         return true;
                 }
         }
         return false;
 }
 
+// Delete a group by groupname.
 bool Passwd::delGroup(const char *groupname) {
         QRegExp groupRegExp(QString("^%1\\:").arg(groupname));
         return deleteGroup(groupRegExp);
 }
 
+// Delete a group by gid.
 bool Passwd::delGroup(int gid) {
         QRegExp groupRegExp(QString(":%1\\:").arg(gid));
         return deleteGroup(groupRegExp);
 }
 
+// Add a user as a member to a group in groupStringList.
 bool Passwd::addGroupMember(QString groupname, QString member) {
         if(!(findGroup(groupname))) return false;
         gr_mem << member;
         if(!(updateGroup(gr_gid))) return false;
         return true;
 }
 
+// Delete a user as a groupmember from a group in groupStringList.
 bool Passwd::delGroupMember(QString groupname, QString member) {
         if(!(findGroup(groupname))) return false;
         for(QStringList::Iterator it=gr_mem.begin(); it!=gr_mem.end(); ++it) {
                 if(*it==member) {
                         gr_mem.remove(it);
                         it=gr_mem.end();
                 }
         }
         if(!(updateGroup(gr_gid))) return false;
         return true;
 }
 
+// Global Object 
 Passwd *accounts;