\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}