\hypertarget{group__pwd__functions}{}\doxysection{UNIX User and Group Functions}
\label{group__pwd__functions}\index{UNIX User and Group Functions@{UNIX User and Group Functions}}
\doxysubsection*{Functions}
\begin{DoxyCompactItemize}
\item 
\+\_\+\+\_\+7\+\_\+ \mbox{\hyperlink{group__type__conversion__functions_ga24ee71727f0785d3b826833ed6f5e2ee}{hash}} \mbox{\hyperlink{group__pwd__functions_gadfda7ac73dc90aced9e933aaa4ff4eca}{Qore\+::getgrgid}} (softint gid)
\begin{DoxyCompactList}\small\item\em Returns a \mbox{\hyperlink{group__pwd__functions_group_info_hash}{group information hash}} representing the group information for the group ID passed, or, if the group ID does not exist \mbox{\hyperlink{basic_data_types_nothing}{NOTHING}} is returned. \end{DoxyCompactList}\item 
\mbox{\hyperlink{group__type__conversion__functions_ga24ee71727f0785d3b826833ed6f5e2ee}{hash}} \mbox{\hyperlink{group__pwd__functions_ga4f5a414252d127a6d4e5ebdef899b7e0}{Qore\+::getgrgid2}} (softint gid)
\begin{DoxyCompactList}\small\item\em Returns a \mbox{\hyperlink{group__pwd__functions_group_info_hash}{group information hash}} representing the group information for the group ID passed, or, if the group ID does not exist, a {\ttfamily GETGRGID2-\/\+ERROR} exception is thrown. \end{DoxyCompactList}\item 
\+\_\+\+\_\+7\+\_\+ \mbox{\hyperlink{group__type__conversion__functions_ga24ee71727f0785d3b826833ed6f5e2ee}{hash}} \mbox{\hyperlink{group__pwd__functions_ga014d0a2042e551dccb8e269d07f85cc2}{Qore\+::getgrnam}} (\mbox{\hyperlink{group__type__conversion__functions_gacf16b4126b795f4b6933ef3425cadae3}{string}} name)
\begin{DoxyCompactList}\small\item\em Returns a \mbox{\hyperlink{group__pwd__functions_group_info_hash}{group information hash}} representing the group information for the group name passed, or, if the group does not exist \mbox{\hyperlink{basic_data_types_nothing}{NOTHING}} is returned. \end{DoxyCompactList}\item 
\mbox{\hyperlink{group__type__conversion__functions_ga24ee71727f0785d3b826833ed6f5e2ee}{hash}} \mbox{\hyperlink{group__pwd__functions_gaaf26a8ce98d46099b94ddcb494e615d4}{Qore\+::getgrnam2}} (\mbox{\hyperlink{group__type__conversion__functions_gacf16b4126b795f4b6933ef3425cadae3}{string}} name)
\begin{DoxyCompactList}\small\item\em Returns a \mbox{\hyperlink{group__pwd__functions_group_info_hash}{group information hash}} representing the group information for the group name passed, or, if the group does not exist, a {\ttfamily GETGRNAM2-\/\+ERROR} exception is thrown. \end{DoxyCompactList}\item 
\mbox{\hyperlink{group__type__conversion__functions_ga24ee71727f0785d3b826833ed6f5e2ee}{hash}} \mbox{\hyperlink{group__pwd__functions_ga1584a4a9164ae9d500fca9b26452de75}{Qore\+::getpwnam}} (\mbox{\hyperlink{group__type__conversion__functions_gacf16b4126b795f4b6933ef3425cadae3}{string}} name)
\begin{DoxyCompactList}\small\item\em Returns a \mbox{\hyperlink{group__pwd__functions_password_info_hash}{password information hash}} representing the user information for the user name passed, or, if the user does not exist \mbox{\hyperlink{basic_data_types_nothing}{NOTHING}} is returned. \end{DoxyCompactList}\item 
\mbox{\hyperlink{group__type__conversion__functions_ga24ee71727f0785d3b826833ed6f5e2ee}{hash}} \mbox{\hyperlink{group__pwd__functions_ga0c3202405d84f4dd85542c299b3a13cb}{Qore\+::getpwnam2}} (\mbox{\hyperlink{group__type__conversion__functions_gacf16b4126b795f4b6933ef3425cadae3}{string}} name)
\begin{DoxyCompactList}\small\item\em Returns a \mbox{\hyperlink{group__pwd__functions_password_info_hash}{password information hash}} representing the user information for the user name passed, or, if the user does not exist, a {\ttfamily GETPWNAM2-\/\+ERROR} exception is thrown. \end{DoxyCompactList}\item 
nothing \mbox{\hyperlink{group__pwd__functions_gaaa76f90738de6fc76e00963c96da8778}{Qore\+::getpwuid}} ()
\begin{DoxyCompactList}\small\item\em This function variant does nothing at all; it is only included for backwards-\/compatibility with qore prior to version 0.\+8.\+0 for functions that would ignore type errors in arguments. \end{DoxyCompactList}\item 
\+\_\+\+\_\+7\+\_\+ \mbox{\hyperlink{group__type__conversion__functions_ga24ee71727f0785d3b826833ed6f5e2ee}{hash}} \mbox{\hyperlink{group__pwd__functions_gab183044f344ff13e5b239fc955dc752a}{Qore\+::getpwuid}} (softint uid)
\begin{DoxyCompactList}\small\item\em Returns a \mbox{\hyperlink{group__pwd__functions_password_info_hash}{password information hash}} representing the user information for the user ID passed, or, if the user ID does not exist \mbox{\hyperlink{basic_data_types_nothing}{NOTHING}} is returned. \end{DoxyCompactList}\item 
\mbox{\hyperlink{group__type__conversion__functions_ga24ee71727f0785d3b826833ed6f5e2ee}{hash}} \mbox{\hyperlink{group__pwd__functions_ga433e71fb300c2c5bab15a081ff6809da}{Qore\+::getpwuid2}} (softint uid)
\begin{DoxyCompactList}\small\item\em Returns a \mbox{\hyperlink{group__pwd__functions_password_info_hash}{password information hash}} representing the user information for the user ID passed, or, if the user ID does not exist, a {\ttfamily GETPWUID2-\/\+ERROR} exception is thrown. \end{DoxyCompactList}\end{DoxyCompactItemize}


\doxysubsection{Detailed Description}
UNIX user and group functions\hypertarget{group__pwd__functions_group_info_hash}{}\doxysubsection{Group Information Hash}\label{group__pwd__functions_group_info_hash}
 \tabulinesep=1mm
\begin{longtabu}spread 0pt [c]{*{3}{|X[-1]}|}
\hline
{\bfseries{Key}} &{\bfseries{\mbox{\hyperlink{namespace_qore_1_1_type}{Type}}}} &{\bfseries{Description}}  \\\cline{1-3}
{\ttfamily gr\+\_\+name}  &\mbox{\hyperlink{data_type_declarations_string_type}{string}} &The name of the group  \\\cline{1-3}
{\ttfamily gr\+\_\+passwd}  &\mbox{\hyperlink{data_type_declarations_string_type}{string}} &The encrypted password for the group  \\\cline{1-3}
{\ttfamily gr\+\_\+gid}  &\mbox{\hyperlink{data_type_declarations_int_type}{int}} &The group id  \\\cline{1-3}
{\ttfamily gr\+\_\+mem}  &\mbox{\hyperlink{data_type_declarations_list_type}{list}} &List of strings giving the usernames of members of the group  \\\cline{1-3}
\end{longtabu}
\hypertarget{group__pwd__functions_password_info_hash}{}\doxysubsection{Password Information Hash}\label{group__pwd__functions_password_info_hash}
 \tabulinesep=1mm
\begin{longtabu}spread 0pt [c]{*{3}{|X[-1]}|}
\hline
{\bfseries{Key}} &{\bfseries{\mbox{\hyperlink{namespace_qore_1_1_type}{Type}}}} &{\bfseries{Description}}  \\\cline{1-3}
{\ttfamily pw\+\_\+name}  &\mbox{\hyperlink{data_type_declarations_string_type}{string}} &The username of the user  \\\cline{1-3}
{\ttfamily pw\+\_\+passwd}  &\mbox{\hyperlink{data_type_declarations_string_type}{string}} &The encrypted password for the user  \\\cline{1-3}
{\ttfamily pw\+\_\+gecos}  &\mbox{\hyperlink{data_type_declarations_string_type}{string}} &The real name or description of the user  \\\cline{1-3}
{\ttfamily pw\+\_\+dir}  &\mbox{\hyperlink{data_type_declarations_string_type}{string}} &The user\textquotesingle{}s home directory  \\\cline{1-3}
{\ttfamily pw\+\_\+shell}  &\mbox{\hyperlink{data_type_declarations_string_type}{string}} &The user\textquotesingle{}s login shell  \\\cline{1-3}
{\ttfamily pw\+\_\+uid}  &\mbox{\hyperlink{data_type_declarations_int_type}{int}} &The user\textquotesingle{}s userid  \\\cline{1-3}
{\ttfamily pw\+\_\+gid}  &\mbox{\hyperlink{data_type_declarations_int_type}{int}} &The group id of the user\textquotesingle{}s primary group  \\\cline{1-3}
\end{longtabu}


/ 

\doxysubsection{Function Documentation}
\mbox{\Hypertarget{group__pwd__functions_gadfda7ac73dc90aced9e933aaa4ff4eca}\label{group__pwd__functions_gadfda7ac73dc90aced9e933aaa4ff4eca}} 
\index{UNIX User and Group Functions@{UNIX User and Group Functions}!getgrgid@{getgrgid}}
\index{getgrgid@{getgrgid}!UNIX User and Group Functions@{UNIX User and Group Functions}}
\doxysubsubsection{\texorpdfstring{getgrgid()}{getgrgid()}}
{\footnotesize\ttfamily \+\_\+\+\_\+7\+\_\+ \mbox{\hyperlink{group__type__conversion__functions_ga24ee71727f0785d3b826833ed6f5e2ee}{hash}} Qore\+::getgrgid (\begin{DoxyParamCaption}\item[{softint}]{gid }\end{DoxyParamCaption})}



Returns a \mbox{\hyperlink{group__pwd__functions_group_info_hash}{group information hash}} representing the group information for the group ID passed, or, if the group ID does not exist \mbox{\hyperlink{basic_data_types_nothing}{NOTHING}} is returned. 

\begin{DoxyParagraph}{Platform Availability\+:}
\mbox{\hyperlink{group__option__constants_gaef9b69b7df60ff7aa74035d772add3c6}{Qore\+::\+Option\+::\+HAVE\+\_\+\+UNIX\+\_\+\+USERMGT}}
\end{DoxyParagraph}
\begin{DoxyParagraph}{Restrictions\+:}
\mbox{\hyperlink{group__parse__options_ga213aab826b55076c29ffeecebbaea237}{Qore\+::\+PO\+\_\+\+NO\+\_\+\+EXTERNAL\+\_\+\+INFO}}
\end{DoxyParagraph}
\begin{DoxyParagraph}{Code Flags\+:}
\mbox{\hyperlink{code_flags_CONSTANT}{CONSTANT}}
\end{DoxyParagraph}

\begin{DoxyParams}{Parameters}
{\em gid} & the group ID to look up\\
\hline
\end{DoxyParams}
\begin{DoxyReturn}{Returns}
a \mbox{\hyperlink{group__pwd__functions_group_info_hash}{group information hash}} representing the group information for the group ID passed, or, if the group ID does not exist \mbox{\hyperlink{basic_data_types_nothing}{NOTHING}} is returned
\end{DoxyReturn}
\begin{DoxyParagraph}{Example\+:}

\begin{DoxyCode}{0}
\DoxyCodeLine{*hash hash = getgrgid(0);}

\end{DoxyCode}

\end{DoxyParagraph}
\begin{DoxySeeAlso}{See also}
\mbox{\hyperlink{group__pwd__functions_ga4f5a414252d127a6d4e5ebdef899b7e0}{getgrgid2()}} for a similar function that throws an exception if the group ID is invalid 
\end{DoxySeeAlso}
\mbox{\Hypertarget{group__pwd__functions_ga4f5a414252d127a6d4e5ebdef899b7e0}\label{group__pwd__functions_ga4f5a414252d127a6d4e5ebdef899b7e0}} 
\index{UNIX User and Group Functions@{UNIX User and Group Functions}!getgrgid2@{getgrgid2}}
\index{getgrgid2@{getgrgid2}!UNIX User and Group Functions@{UNIX User and Group Functions}}
\doxysubsubsection{\texorpdfstring{getgrgid2()}{getgrgid2()}}
{\footnotesize\ttfamily \mbox{\hyperlink{group__type__conversion__functions_ga24ee71727f0785d3b826833ed6f5e2ee}{hash}} Qore\+::getgrgid2 (\begin{DoxyParamCaption}\item[{softint}]{gid }\end{DoxyParamCaption})}



Returns a \mbox{\hyperlink{group__pwd__functions_group_info_hash}{group information hash}} representing the group information for the group ID passed, or, if the group ID does not exist, a {\ttfamily GETGRGID2-\/\+ERROR} exception is thrown. 

\begin{DoxyParagraph}{Platform Availability\+:}
\mbox{\hyperlink{group__option__constants_gaef9b69b7df60ff7aa74035d772add3c6}{Qore\+::\+Option\+::\+HAVE\+\_\+\+UNIX\+\_\+\+USERMGT}}
\end{DoxyParagraph}
\begin{DoxyParagraph}{Restrictions\+:}
\mbox{\hyperlink{group__parse__options_ga213aab826b55076c29ffeecebbaea237}{Qore\+::\+PO\+\_\+\+NO\+\_\+\+EXTERNAL\+\_\+\+INFO}}
\end{DoxyParagraph}
\begin{DoxyParagraph}{Code Flags\+:}
\mbox{\hyperlink{code_flags_RET_VALUE_ONLY}{RET\+\_\+\+VALUE\+\_\+\+ONLY}}
\end{DoxyParagraph}

\begin{DoxyParams}{Parameters}
{\em gid} & the group ID to look up\\
\hline
\end{DoxyParams}
\begin{DoxyReturn}{Returns}
a \mbox{\hyperlink{group__pwd__functions_group_info_hash}{group information hash}} representing the group information for the group ID passed, or, if the group ID does not exist, a {\ttfamily GETGRGID2-\/\+ERROR} exception is thrown
\end{DoxyReturn}
\begin{DoxyParagraph}{Example\+:}

\begin{DoxyCode}{0}
\DoxyCodeLine{*hash hash = getgrgid2(0);}

\end{DoxyCode}

\end{DoxyParagraph}

\begin{DoxyExceptions}{Exceptions}
{\em GETGRGID2-\/\+ERROR} & invalid gid or error reading group information\\
\hline
\end{DoxyExceptions}
\begin{DoxySeeAlso}{See also}
\mbox{\hyperlink{group__pwd__functions_gadfda7ac73dc90aced9e933aaa4ff4eca}{getgrgid()}} for a similar function that does not throw an exception if the group ID is invalid 
\end{DoxySeeAlso}
\mbox{\Hypertarget{group__pwd__functions_ga014d0a2042e551dccb8e269d07f85cc2}\label{group__pwd__functions_ga014d0a2042e551dccb8e269d07f85cc2}} 
\index{UNIX User and Group Functions@{UNIX User and Group Functions}!getgrnam@{getgrnam}}
\index{getgrnam@{getgrnam}!UNIX User and Group Functions@{UNIX User and Group Functions}}
\doxysubsubsection{\texorpdfstring{getgrnam()}{getgrnam()}}
{\footnotesize\ttfamily \+\_\+\+\_\+7\+\_\+ \mbox{\hyperlink{group__type__conversion__functions_ga24ee71727f0785d3b826833ed6f5e2ee}{hash}} Qore\+::getgrnam (\begin{DoxyParamCaption}\item[{\mbox{\hyperlink{group__type__conversion__functions_gacf16b4126b795f4b6933ef3425cadae3}{string}}}]{name }\end{DoxyParamCaption})}



Returns a \mbox{\hyperlink{group__pwd__functions_group_info_hash}{group information hash}} representing the group information for the group name passed, or, if the group does not exist \mbox{\hyperlink{basic_data_types_nothing}{NOTHING}} is returned. 

\begin{DoxyParagraph}{Platform Availability\+:}
\mbox{\hyperlink{group__option__constants_gaef9b69b7df60ff7aa74035d772add3c6}{Qore\+::\+Option\+::\+HAVE\+\_\+\+UNIX\+\_\+\+USERMGT}}
\end{DoxyParagraph}
\begin{DoxyParagraph}{Restrictions\+:}
\mbox{\hyperlink{group__parse__options_ga213aab826b55076c29ffeecebbaea237}{Qore\+::\+PO\+\_\+\+NO\+\_\+\+EXTERNAL\+\_\+\+INFO}}
\end{DoxyParagraph}
\begin{DoxyParagraph}{Code Flags\+:}
\mbox{\hyperlink{code_flags_CONSTANT}{CONSTANT}}
\end{DoxyParagraph}

\begin{DoxyParams}{Parameters}
{\em name} & the group name to look up\\
\hline
\end{DoxyParams}
\begin{DoxyReturn}{Returns}
a \mbox{\hyperlink{group__pwd__functions_group_info_hash}{group information hash}} representing the group information for the group name passed, or, if the group does not exist \mbox{\hyperlink{basic_data_types_nothing}{NOTHING}} is returned
\end{DoxyReturn}
\begin{DoxyParagraph}{Example\+:}

\begin{DoxyCode}{0}
\DoxyCodeLine{*hash hash = getgrnam(\textcolor{stringliteral}{"{}root"{}});}

\end{DoxyCode}

\end{DoxyParagraph}
\begin{DoxySeeAlso}{See also}
\mbox{\hyperlink{group__pwd__functions_gaaf26a8ce98d46099b94ddcb494e615d4}{getgrnam2()}} for a similar function that throws an exception if the group is invalid 
\end{DoxySeeAlso}
\mbox{\Hypertarget{group__pwd__functions_gaaf26a8ce98d46099b94ddcb494e615d4}\label{group__pwd__functions_gaaf26a8ce98d46099b94ddcb494e615d4}} 
\index{UNIX User and Group Functions@{UNIX User and Group Functions}!getgrnam2@{getgrnam2}}
\index{getgrnam2@{getgrnam2}!UNIX User and Group Functions@{UNIX User and Group Functions}}
\doxysubsubsection{\texorpdfstring{getgrnam2()}{getgrnam2()}}
{\footnotesize\ttfamily \mbox{\hyperlink{group__type__conversion__functions_ga24ee71727f0785d3b826833ed6f5e2ee}{hash}} Qore\+::getgrnam2 (\begin{DoxyParamCaption}\item[{\mbox{\hyperlink{group__type__conversion__functions_gacf16b4126b795f4b6933ef3425cadae3}{string}}}]{name }\end{DoxyParamCaption})}



Returns a \mbox{\hyperlink{group__pwd__functions_group_info_hash}{group information hash}} representing the group information for the group name passed, or, if the group does not exist, a {\ttfamily GETGRNAM2-\/\+ERROR} exception is thrown. 

\begin{DoxyParagraph}{Platform Availability\+:}
\mbox{\hyperlink{group__option__constants_gaef9b69b7df60ff7aa74035d772add3c6}{Qore\+::\+Option\+::\+HAVE\+\_\+\+UNIX\+\_\+\+USERMGT}}
\end{DoxyParagraph}
\begin{DoxyParagraph}{Restrictions\+:}
\mbox{\hyperlink{group__parse__options_ga213aab826b55076c29ffeecebbaea237}{Qore\+::\+PO\+\_\+\+NO\+\_\+\+EXTERNAL\+\_\+\+INFO}}
\end{DoxyParagraph}
\begin{DoxyParagraph}{Code Flags\+:}
\mbox{\hyperlink{code_flags_RET_VALUE_ONLY}{RET\+\_\+\+VALUE\+\_\+\+ONLY}}
\end{DoxyParagraph}

\begin{DoxyParams}{Parameters}
{\em name} & the group name to look up\\
\hline
\end{DoxyParams}
\begin{DoxyReturn}{Returns}
a \mbox{\hyperlink{group__pwd__functions_group_info_hash}{group information hash}} representing the group information for the group name passed, or, if the group does not exist, a {\ttfamily GETGRNAM2-\/\+ERROR} exception is thrown
\end{DoxyReturn}
\begin{DoxyParagraph}{Example\+:}

\begin{DoxyCode}{0}
\DoxyCodeLine{*hash hash = getgrnam2(\textcolor{stringliteral}{"{}root"{}});}

\end{DoxyCode}

\end{DoxyParagraph}

\begin{DoxyExceptions}{Exceptions}
{\em GETGRNAM2-\/\+ERROR} & invalid group or error reading group information\\
\hline
\end{DoxyExceptions}
\begin{DoxySeeAlso}{See also}
\mbox{\hyperlink{group__pwd__functions_ga014d0a2042e551dccb8e269d07f85cc2}{getgrnam()}} for a similar function that does not throw an exception if the group is invalid 
\end{DoxySeeAlso}
\mbox{\Hypertarget{group__pwd__functions_ga1584a4a9164ae9d500fca9b26452de75}\label{group__pwd__functions_ga1584a4a9164ae9d500fca9b26452de75}} 
\index{UNIX User and Group Functions@{UNIX User and Group Functions}!getpwnam@{getpwnam}}
\index{getpwnam@{getpwnam}!UNIX User and Group Functions@{UNIX User and Group Functions}}
\doxysubsubsection{\texorpdfstring{getpwnam()}{getpwnam()}}
{\footnotesize\ttfamily \mbox{\hyperlink{group__type__conversion__functions_ga24ee71727f0785d3b826833ed6f5e2ee}{hash}} Qore\+::getpwnam (\begin{DoxyParamCaption}\item[{\mbox{\hyperlink{group__type__conversion__functions_gacf16b4126b795f4b6933ef3425cadae3}{string}}}]{name }\end{DoxyParamCaption})}



Returns a \mbox{\hyperlink{group__pwd__functions_password_info_hash}{password information hash}} representing the user information for the user name passed, or, if the user does not exist \mbox{\hyperlink{basic_data_types_nothing}{NOTHING}} is returned. 

\begin{DoxyParagraph}{Platform Availability\+:}
\mbox{\hyperlink{group__option__constants_gaef9b69b7df60ff7aa74035d772add3c6}{Qore\+::\+Option\+::\+HAVE\+\_\+\+UNIX\+\_\+\+USERMGT}}
\end{DoxyParagraph}
\begin{DoxyParagraph}{Restrictions\+:}
\mbox{\hyperlink{group__parse__options_ga213aab826b55076c29ffeecebbaea237}{Qore\+::\+PO\+\_\+\+NO\+\_\+\+EXTERNAL\+\_\+\+INFO}}
\end{DoxyParagraph}
\begin{DoxyParagraph}{Code Flags\+:}
\mbox{\hyperlink{code_flags_CONSTANT}{CONSTANT}}
\end{DoxyParagraph}

\begin{DoxyParams}{Parameters}
{\em name} & the user name to look up\\
\hline
\end{DoxyParams}
\begin{DoxyReturn}{Returns}
a \mbox{\hyperlink{group__pwd__functions_password_info_hash}{password information hash}} representing the user information for the user name passed, or, if the user does not exist \mbox{\hyperlink{basic_data_types_nothing}{NOTHING}} is returned
\end{DoxyReturn}
\begin{DoxyParagraph}{Example\+:}

\begin{DoxyCode}{0}
\DoxyCodeLine{*hash hash = getpwnam(\textcolor{stringliteral}{"{}root"{}});}

\end{DoxyCode}

\end{DoxyParagraph}
\begin{DoxySeeAlso}{See also}
\mbox{\hyperlink{group__pwd__functions_ga0c3202405d84f4dd85542c299b3a13cb}{getpwnam2()}} for a similar function that throws an exception if the user is invalid 
\end{DoxySeeAlso}
\mbox{\Hypertarget{group__pwd__functions_ga0c3202405d84f4dd85542c299b3a13cb}\label{group__pwd__functions_ga0c3202405d84f4dd85542c299b3a13cb}} 
\index{UNIX User and Group Functions@{UNIX User and Group Functions}!getpwnam2@{getpwnam2}}
\index{getpwnam2@{getpwnam2}!UNIX User and Group Functions@{UNIX User and Group Functions}}
\doxysubsubsection{\texorpdfstring{getpwnam2()}{getpwnam2()}}
{\footnotesize\ttfamily \mbox{\hyperlink{group__type__conversion__functions_ga24ee71727f0785d3b826833ed6f5e2ee}{hash}} Qore\+::getpwnam2 (\begin{DoxyParamCaption}\item[{\mbox{\hyperlink{group__type__conversion__functions_gacf16b4126b795f4b6933ef3425cadae3}{string}}}]{name }\end{DoxyParamCaption})}



Returns a \mbox{\hyperlink{group__pwd__functions_password_info_hash}{password information hash}} representing the user information for the user name passed, or, if the user does not exist, a {\ttfamily GETPWNAM2-\/\+ERROR} exception is thrown. 

\begin{DoxyParagraph}{Platform Availability\+:}
\mbox{\hyperlink{group__option__constants_gaef9b69b7df60ff7aa74035d772add3c6}{Qore\+::\+Option\+::\+HAVE\+\_\+\+UNIX\+\_\+\+USERMGT}}
\end{DoxyParagraph}
\begin{DoxyParagraph}{Restrictions\+:}
\mbox{\hyperlink{group__parse__options_ga213aab826b55076c29ffeecebbaea237}{Qore\+::\+PO\+\_\+\+NO\+\_\+\+EXTERNAL\+\_\+\+INFO}}
\end{DoxyParagraph}
\begin{DoxyParagraph}{Code Flags\+:}
\mbox{\hyperlink{code_flags_RET_VALUE_ONLY}{RET\+\_\+\+VALUE\+\_\+\+ONLY}}
\end{DoxyParagraph}

\begin{DoxyParams}{Parameters}
{\em name} & the user name to look up\\
\hline
\end{DoxyParams}
\begin{DoxyReturn}{Returns}
a \mbox{\hyperlink{group__pwd__functions_password_info_hash}{password information hash}} representing the user information for the user name passed, or, if the user does not exist, a {\ttfamily GETPWNAM2-\/\+ERROR} exception is thrown
\end{DoxyReturn}
\begin{DoxyParagraph}{Example\+:}

\begin{DoxyCode}{0}
\DoxyCodeLine{*hash hash = getpwnam2(\textcolor{stringliteral}{"{}root"{}});}

\end{DoxyCode}

\end{DoxyParagraph}

\begin{DoxyExceptions}{Exceptions}
{\em GETPWNAM2-\/\+ERROR} & invalid user or error reading user information\\
\hline
\end{DoxyExceptions}
\begin{DoxySeeAlso}{See also}
\mbox{\hyperlink{group__pwd__functions_ga1584a4a9164ae9d500fca9b26452de75}{getpwnam()}} for a similar function that does not throw an exception if the user is invalid 
\end{DoxySeeAlso}
\mbox{\Hypertarget{group__pwd__functions_gaaa76f90738de6fc76e00963c96da8778}\label{group__pwd__functions_gaaa76f90738de6fc76e00963c96da8778}} 
\index{UNIX User and Group Functions@{UNIX User and Group Functions}!getpwuid@{getpwuid}}
\index{getpwuid@{getpwuid}!UNIX User and Group Functions@{UNIX User and Group Functions}}
\doxysubsubsection{\texorpdfstring{getpwuid()}{getpwuid()}\hspace{0.1cm}{\footnotesize\ttfamily [1/2]}}
{\footnotesize\ttfamily nothing Qore\+::getpwuid (\begin{DoxyParamCaption}{ }\end{DoxyParamCaption})}



This function variant does nothing at all; it is only included for backwards-\/compatibility with qore prior to version 0.\+8.\+0 for functions that would ignore type errors in arguments. 

\begin{DoxyParagraph}{Restrictions\+:}
\mbox{\hyperlink{group__parse__options_ga213aab826b55076c29ffeecebbaea237}{Qore\+::\+PO\+\_\+\+NO\+\_\+\+EXTERNAL\+\_\+\+INFO}}
\end{DoxyParagraph}
\begin{DoxyParagraph}{Code Flags\+:}
\mbox{\hyperlink{code_flags_RUNTIME_NOOP}{RUNTIME\+\_\+\+NOOP}} 
\end{DoxyParagraph}
\mbox{\Hypertarget{group__pwd__functions_gab183044f344ff13e5b239fc955dc752a}\label{group__pwd__functions_gab183044f344ff13e5b239fc955dc752a}} 
\index{UNIX User and Group Functions@{UNIX User and Group Functions}!getpwuid@{getpwuid}}
\index{getpwuid@{getpwuid}!UNIX User and Group Functions@{UNIX User and Group Functions}}
\doxysubsubsection{\texorpdfstring{getpwuid()}{getpwuid()}\hspace{0.1cm}{\footnotesize\ttfamily [2/2]}}
{\footnotesize\ttfamily \+\_\+\+\_\+7\+\_\+ \mbox{\hyperlink{group__type__conversion__functions_ga24ee71727f0785d3b826833ed6f5e2ee}{hash}} Qore\+::getpwuid (\begin{DoxyParamCaption}\item[{softint}]{uid }\end{DoxyParamCaption})}



Returns a \mbox{\hyperlink{group__pwd__functions_password_info_hash}{password information hash}} representing the user information for the user ID passed, or, if the user ID does not exist \mbox{\hyperlink{basic_data_types_nothing}{NOTHING}} is returned. 

\begin{DoxyParagraph}{Platform Availability\+:}
\mbox{\hyperlink{group__option__constants_gaef9b69b7df60ff7aa74035d772add3c6}{Qore\+::\+Option\+::\+HAVE\+\_\+\+UNIX\+\_\+\+USERMGT}}
\end{DoxyParagraph}
\begin{DoxyParagraph}{Restrictions\+:}
\mbox{\hyperlink{group__parse__options_ga213aab826b55076c29ffeecebbaea237}{Qore\+::\+PO\+\_\+\+NO\+\_\+\+EXTERNAL\+\_\+\+INFO}}
\end{DoxyParagraph}
\begin{DoxyParagraph}{Code Flags\+:}
\mbox{\hyperlink{code_flags_CONSTANT}{CONSTANT}}
\end{DoxyParagraph}

\begin{DoxyParams}{Parameters}
{\em uid} & the user ID to look up\\
\hline
\end{DoxyParams}
\begin{DoxyReturn}{Returns}
a \mbox{\hyperlink{group__pwd__functions_password_info_hash}{password information hash}} representing the user information for the user ID passed, or, if the user ID does not exist \mbox{\hyperlink{basic_data_types_nothing}{NOTHING}} is returned
\end{DoxyReturn}
\begin{DoxyParagraph}{Example\+:}

\begin{DoxyCode}{0}
\DoxyCodeLine{*hash hash = getpwuid(0);}

\end{DoxyCode}

\end{DoxyParagraph}
\begin{DoxySeeAlso}{See also}
\mbox{\hyperlink{group__pwd__functions_ga433e71fb300c2c5bab15a081ff6809da}{getpwuid2()}} for a similar function that throws an exception if the user ID is invalid 
\end{DoxySeeAlso}
\mbox{\Hypertarget{group__pwd__functions_ga433e71fb300c2c5bab15a081ff6809da}\label{group__pwd__functions_ga433e71fb300c2c5bab15a081ff6809da}} 
\index{UNIX User and Group Functions@{UNIX User and Group Functions}!getpwuid2@{getpwuid2}}
\index{getpwuid2@{getpwuid2}!UNIX User and Group Functions@{UNIX User and Group Functions}}
\doxysubsubsection{\texorpdfstring{getpwuid2()}{getpwuid2()}}
{\footnotesize\ttfamily \mbox{\hyperlink{group__type__conversion__functions_ga24ee71727f0785d3b826833ed6f5e2ee}{hash}} Qore\+::getpwuid2 (\begin{DoxyParamCaption}\item[{softint}]{uid }\end{DoxyParamCaption})}



Returns a \mbox{\hyperlink{group__pwd__functions_password_info_hash}{password information hash}} representing the user information for the user ID passed, or, if the user ID does not exist, a {\ttfamily GETPWUID2-\/\+ERROR} exception is thrown. 

\begin{DoxyParagraph}{Platform Availability\+:}
\mbox{\hyperlink{group__option__constants_gaef9b69b7df60ff7aa74035d772add3c6}{Qore\+::\+Option\+::\+HAVE\+\_\+\+UNIX\+\_\+\+USERMGT}}
\end{DoxyParagraph}
\begin{DoxyParagraph}{Restrictions\+:}
\mbox{\hyperlink{group__parse__options_ga213aab826b55076c29ffeecebbaea237}{Qore\+::\+PO\+\_\+\+NO\+\_\+\+EXTERNAL\+\_\+\+INFO}}
\end{DoxyParagraph}
\begin{DoxyParagraph}{Code Flags\+:}
\mbox{\hyperlink{code_flags_RET_VALUE_ONLY}{RET\+\_\+\+VALUE\+\_\+\+ONLY}}
\end{DoxyParagraph}

\begin{DoxyParams}{Parameters}
{\em uid} & the user ID to look up\\
\hline
\end{DoxyParams}
\begin{DoxyReturn}{Returns}
a \mbox{\hyperlink{group__pwd__functions_password_info_hash}{password information hash}} representing the user information for the user ID passed, or, if the user ID does not exist, a {\ttfamily GETPWUID2-\/\+ERROR} exception is thrown
\end{DoxyReturn}
\begin{DoxyParagraph}{Example\+:}

\begin{DoxyCode}{0}
\DoxyCodeLine{*hash hash = getpwuid2(0);}

\end{DoxyCode}

\end{DoxyParagraph}

\begin{DoxyExceptions}{Exceptions}
{\em GETPWUID2-\/\+ERROR} & invalid uid or error reading user information\\
\hline
\end{DoxyExceptions}
\begin{DoxySeeAlso}{See also}
\mbox{\hyperlink{group__pwd__functions_gaaa76f90738de6fc76e00963c96da8778}{getpwuid()}} for a similar function that does not throw an exception if the user ID is invalid 
\end{DoxySeeAlso}
