cpython/Modules/pwdmodule.c

227 lines
5.8 KiB
C
Raw Normal View History

1991-04-10 16:48:25 -03:00
/* UNIX password file access module */
1991-04-10 16:48:25 -03:00
1996-12-11 12:54:40 -04:00
#include "Python.h"
#include "posixmodule.h"
1991-04-10 16:48:25 -03:00
#include <pwd.h>
static PyStructSequence_Field struct_pwd_type_fields[] = {
{"pw_name", "user name"},
{"pw_passwd", "password"},
{"pw_uid", "user id"},
{"pw_gid", "group id"},
{"pw_gecos", "real name"},
{"pw_dir", "home directory"},
{"pw_shell", "shell program"},
{0}
};
2002-06-13 17:33:02 -03:00
PyDoc_STRVAR(struct_passwd__doc__,
"pwd.struct_passwd: Results from getpw*() routines.\n\n\
This object may be accessed either as a tuple of\n\
(pw_name,pw_passwd,pw_uid,pw_gid,pw_gecos,pw_dir,pw_shell)\n\
2002-06-13 17:33:02 -03:00
or via the object attributes as named in the above tuple.");
static PyStructSequence_Desc struct_pwd_type_desc = {
"pwd.struct_passwd",
struct_passwd__doc__,
struct_pwd_type_fields,
7,
};
2002-06-13 17:33:02 -03:00
PyDoc_STRVAR(pwd__doc__,
"This module provides access to the Unix password database.\n\
1998-03-03 18:03:26 -04:00
It is available on all Unix versions.\n\
\n\
Password database entries are reported as 7-tuples containing the following\n\
items from the password database (see `<pwd.h>'), in order:\n\
pw_name, pw_passwd, pw_uid, pw_gid, pw_gecos, pw_dir, pw_shell.\n\
The uid and gid items are integers, all others are strings. An\n\
2002-06-13 17:33:02 -03:00
exception is raised if the entry asked for cannot be found.");
1998-03-03 18:03:26 -04:00
static int initialized;
static PyTypeObject StructPwdType;
2002-09-17 06:34:06 -03:00
static void
2007-08-24 20:26:23 -03:00
sets(PyObject *v, int i, const char* val)
2002-09-17 06:34:06 -03:00
{
if (val) {
PyObject *o = PyUnicode_DecodeFSDefault(val);
PyStructSequence_SET_ITEM(v, i, o);
}
2002-09-17 06:34:06 -03:00
else {
PyStructSequence_SET_ITEM(v, i, Py_None);
Py_INCREF(Py_None);
2002-09-17 06:34:06 -03:00
}
}
1996-12-11 12:54:40 -04:00
static PyObject *
2000-07-10 10:12:27 -03:00
mkpwent(struct passwd *p)
1991-04-10 16:48:25 -03:00
{
int setIndex = 0;
PyObject *v = PyStructSequence_New(&StructPwdType);
if (v == NULL)
return NULL;
#define SETI(i,val) PyStructSequence_SET_ITEM(v, i, PyLong_FromLong((long) val))
2002-09-17 06:34:06 -03:00
#define SETS(i,val) sets(v, i, val)
SETS(setIndex++, p->pw_name);
2002-12-06 08:48:53 -04:00
#ifdef __VMS
SETS(setIndex++, "");
2002-12-06 08:48:53 -04:00
#else
SETS(setIndex++, p->pw_passwd);
2002-12-06 08:48:53 -04:00
#endif
PyStructSequence_SET_ITEM(v, setIndex++, _PyLong_FromUid(p->pw_uid));
PyStructSequence_SET_ITEM(v, setIndex++, _PyLong_FromGid(p->pw_gid));
2002-12-06 08:48:53 -04:00
#ifdef __VMS
SETS(setIndex++, "");
2002-12-06 08:48:53 -04:00
#else
SETS(setIndex++, p->pw_gecos);
2002-12-06 08:48:53 -04:00
#endif
SETS(setIndex++, p->pw_dir);
SETS(setIndex++, p->pw_shell);
#undef SETS
#undef SETI
if (PyErr_Occurred()) {
Py_XDECREF(v);
return NULL;
}
return v;
1991-04-10 16:48:25 -03:00
}
2002-06-13 17:33:02 -03:00
PyDoc_STRVAR(pwd_getpwuid__doc__,
"getpwuid(uid) -> (pw_name,pw_passwd,pw_uid,\n\
pw_gid,pw_gecos,pw_dir,pw_shell)\n\
1998-03-03 18:03:26 -04:00
Return the password database entry for the given numeric user ID.\n\
2010-08-16 17:17:07 -03:00
See help(pwd) for more on password database entries.");
1998-03-03 18:03:26 -04:00
1996-12-11 12:54:40 -04:00
static PyObject *
2000-07-10 10:12:27 -03:00
pwd_getpwuid(PyObject *self, PyObject *args)
1991-04-10 16:48:25 -03:00
{
uid_t uid;
struct passwd *p;
if (!PyArg_ParseTuple(args, "O&:getpwuid", _Py_Uid_Converter, &uid)) {
if (PyErr_ExceptionMatches(PyExc_OverflowError))
PyErr_Format(PyExc_KeyError,
"getpwuid(): uid not found");
return NULL;
}
if ((p = getpwuid(uid)) == NULL) {
PyObject *uid_obj = _PyLong_FromUid(uid);
if (uid_obj == NULL)
return NULL;
PyErr_Format(PyExc_KeyError,
"getpwuid(): uid not found: %S", uid_obj);
Py_DECREF(uid_obj);
return NULL;
}
return mkpwent(p);
1991-04-10 16:48:25 -03:00
}
2002-06-13 17:33:02 -03:00
PyDoc_STRVAR(pwd_getpwnam__doc__,
"getpwnam(name) -> (pw_name,pw_passwd,pw_uid,\n\
pw_gid,pw_gecos,pw_dir,pw_shell)\n\
1998-03-03 18:03:26 -04:00
Return the password database entry for the given user name.\n\
2010-08-16 17:17:07 -03:00
See help(pwd) for more on password database entries.");
1998-03-03 18:03:26 -04:00
1996-12-11 12:54:40 -04:00
static PyObject *
2000-07-10 10:12:27 -03:00
pwd_getpwnam(PyObject *self, PyObject *args)
1991-04-10 16:48:25 -03:00
{
char *name;
struct passwd *p;
PyObject *arg, *bytes, *retval = NULL;
if (!PyArg_ParseTuple(args, "U:getpwnam", &arg))
return NULL;
if ((bytes = PyUnicode_EncodeFSDefault(arg)) == NULL)
return NULL;
if (PyBytes_AsStringAndSize(bytes, &name, NULL) == -1)
goto out;
if ((p = getpwnam(name)) == NULL) {
PyErr_Format(PyExc_KeyError,
"getpwnam(): name not found: %s", name);
goto out;
}
retval = mkpwent(p);
out:
Py_DECREF(bytes);
return retval;
1991-04-10 16:48:25 -03:00
}
#ifdef HAVE_GETPWENT
2002-06-13 17:33:02 -03:00
PyDoc_STRVAR(pwd_getpwall__doc__,
"getpwall() -> list_of_entries\n\
1998-03-03 18:03:26 -04:00
Return a list of all available password database entries, \
in arbitrary order.\n\
2010-08-16 17:17:07 -03:00
See help(pwd) for more on password database entries.");
1998-03-03 18:03:26 -04:00
1996-12-11 12:54:40 -04:00
static PyObject *
pwd_getpwall(PyObject *self)
1991-04-10 16:48:25 -03:00
{
PyObject *d;
struct passwd *p;
if ((d = PyList_New(0)) == NULL)
return NULL;
setpwent();
while ((p = getpwent()) != NULL) {
PyObject *v = mkpwent(p);
if (v == NULL || PyList_Append(d, v) != 0) {
Py_XDECREF(v);
Py_DECREF(d);
endpwent();
return NULL;
}
Py_DECREF(v);
}
endpwent();
return d;
1991-04-10 16:48:25 -03:00
}
#endif
1991-04-10 16:48:25 -03:00
1996-12-11 12:54:40 -04:00
static PyMethodDef pwd_methods[] = {
{"getpwuid", pwd_getpwuid, METH_VARARGS, pwd_getpwuid__doc__},
{"getpwnam", pwd_getpwnam, METH_VARARGS, pwd_getpwnam__doc__},
#ifdef HAVE_GETPWENT
{"getpwall", (PyCFunction)pwd_getpwall,
METH_NOARGS, pwd_getpwall__doc__},
#endif
{NULL, NULL} /* sentinel */
1991-04-10 16:48:25 -03:00
};
static struct PyModuleDef pwdmodule = {
PyModuleDef_HEAD_INIT,
"pwd",
pwd__doc__,
-1,
pwd_methods,
NULL,
NULL,
NULL,
NULL
};
PyMODINIT_FUNC
PyInit_pwd(void)
1991-04-10 16:48:25 -03:00
{
PyObject *m;
m = PyModule_Create(&pwdmodule);
if (m == NULL)
return NULL;
if (!initialized) {
PyStructSequence_InitType(&StructPwdType,
&struct_pwd_type_desc);
initialized = 1;
}
Py_INCREF((PyObject *) &StructPwdType);
PyModule_AddObject(m, "struct_passwd", (PyObject *) &StructPwdType);
return m;
1991-04-10 16:48:25 -03:00
}