python/py_common.h

ソースコードを見る。

関数
PyObject *	py_werror_tuple (WERROR werror)
PyObject *	py_ntstatus_tuple (NTSTATUS ntstatus)
void	py_samba_init (void)
PyObject *	get_debuglevel (PyObject *self, PyObject *args)
PyObject *	set_debuglevel (PyObject *self, PyObject *args)
PyObject *	py_setup_logging (PyObject *self, PyObject *args, PyObject *kw)
BOOL	py_parse_creds (PyObject *creds, char **username, char **domain, char **password, char **errstr)
cli_state *	open_pipe_creds (char *server, PyObject *creds, int pipe_idx, char **errstr)
BOOL	get_level_value (PyObject *dict, uint32 *level)
BOOL	py_from_SID (PyObject **obj, DOM_SID *sid)
BOOL	py_to_SID (DOM_SID *sid, PyObject *obj)
BOOL	py_from_ACE (PyObject **dict, SEC_ACE *ace)
BOOL	py_to_ACE (SEC_ACE *ace, PyObject *dict)
BOOL	py_from_ACL (PyObject **dict, SEC_ACL *acl)
BOOL	py_to_ACL (SEC_ACL *acl, PyObject *dict, TALLOC_CTX *mem_ctx)
BOOL	py_from_SECDESC (PyObject **dict, SEC_DESC *sd)
BOOL	py_to_SECDESC (SEC_DESC **sd, PyObject *dict, TALLOC_CTX *mem_ctx)

---

関数

PyObject* py_werror_tuple

(

WERROR

werror

)

py_common.c の 25 行で定義されています。

参照先 dos_errstr()・werror.

参照元 spoolss_addprinterdriver()・spoolss_enumports()・spoolss_enumprinterdrivers()・spoolss_enumprinters()・spoolss_getprinterdriverdir()・spoolss_hnd_addform()・spoolss_hnd_deleteform()・spoolss_hnd_deleteprinterdata()・spoolss_hnd_deleteprinterdataex()・spoolss_hnd_enddocprinter()・spoolss_hnd_endpageprinter()・spoolss_hnd_enumforms()・spoolss_hnd_enumjobs()・spoolss_hnd_enumprinterdata()・spoolss_hnd_enumprinterdataex()・spoolss_hnd_enumprinterkey()・spoolss_hnd_getform()・spoolss_hnd_getjob()・spoolss_hnd_getprinter()・spoolss_hnd_getprinterdata()・spoolss_hnd_getprinterdataex()・spoolss_hnd_getprinterdriver()・spoolss_hnd_setform()・spoolss_hnd_setjob()・spoolss_hnd_setprinter()・spoolss_hnd_setprinterdata()・spoolss_hnd_setprinterdataex()・spoolss_hnd_startdocprinter()・spoolss_hnd_startpageprinter()・spoolss_hnd_writeprinter()・spoolss_openprinter()・srvsvc_netservergetinfo().

{
        return Py_BuildValue("[is]", W_ERROR_V(werror), 
                             dos_errstr(werror));
}

PyObject* py_ntstatus_tuple

(

NTSTATUS

ntstatus

)

py_common.c の 33 行で定義されています。

参照先 nt_errstr()・ntstatus.

参照元 lsa_enum_trust_dom()・lsa_lookup_names()・lsa_lookup_sids()・lsa_open_policy()・samr_connect()・samr_create_dom_user()・samr_delete_dom_user()・samr_open_domain()・samr_set_user_info2().

{
        return Py_BuildValue("[is]", NT_STATUS_V(ntstatus), 
                             nt_errstr(ntstatus));
}

void py_samba_init

(

void

)

py_common.c の 43 行で定義されています。

参照先 dyn_CONFIGFILE・fprintf()・init_names()・initialised・load_case_tables()・load_interfaces().

参照元 initlsa()・initsamr()・initsmb()・initspoolss()・initsrvsvc()・initwinbind()・initwinreg().

{
        if (initialised)
                return;

        load_case_tables();

        /* Load configuration file */

        if (!lp_load(dyn_CONFIGFILE, True, False, False, True))
                fprintf(stderr, "Can't load %s\n", dyn_CONFIGFILE);

        /* Misc other stuff */

        load_interfaces();
        init_names();

        initialised = True;
}

PyObject* get_debuglevel	(	PyObject *	self,
		PyObject *	args
	)

py_common.c の 65 行で定義されています。

参照先 DEBUGLEVEL・debuglevel.

{
        PyObject *debuglevel;

        if (!PyArg_ParseTuple(args, ""))
                return NULL;

        debuglevel = PyInt_FromLong(DEBUGLEVEL);

        return debuglevel;
}

PyObject* set_debuglevel	(	PyObject *	self,
		PyObject *	args
	)

py_common.c の 77 行で定義されています。

参照先 DEBUGLEVEL・debuglevel.

{
        int debuglevel;

        if (!PyArg_ParseTuple(args, "i", &debuglevel))
                return NULL;

        DEBUGLEVEL = debuglevel;

        Py_INCREF(Py_None);
        return Py_None;
}

PyObject* py_setup_logging	(	PyObject *	self,
		PyObject *	args,
		PyObject *	kw
	)

py_common.c の 92 行で定義されています。

参照先 interactive・reopen_logs()・setup_logging().

{
        BOOL interactive = False;
        char *logfilename = NULL;
        static char *kwlist[] = {"interactive", "logfilename", NULL};

        if (!PyArg_ParseTupleAndKeywords(
                    args, kw, "|is", kwlist, &interactive, &logfilename))
                return NULL;
        
        if (interactive && logfilename) {
                PyErr_SetString(PyExc_RuntimeError,
                                "can't be interactive and set log file name");
                return NULL;
        }

        if (interactive)
                setup_logging("spoolss", True);

        if (logfilename) {
                lp_set_logfile(logfilename);
                setup_logging(logfilename, False);
                reopen_logs();
        }

        Py_INCREF(Py_None);
        return Py_None;
}

BOOL py_parse_creds	(	PyObject *	creds,
		char **	username,
		char **	domain,
		char **	password,
		char **	errstr
	)

py_common.c の 128 行で定義されています。

参照先 asprintf().

参照元 open_pipe_creds()・py_smb_session_setup().

{
        /* Initialise anonymous credentials */

        *username = "";
        *domain = "";
        *password = "";

        if (creds && PyDict_Size(creds) > 0) {
                PyObject *username_obj, *password_obj, *domain_obj;
                PyObject *key, *value;
                int i;

                /* Check for presence of required fields */

                username_obj = PyDict_GetItemString(creds, "username");
                domain_obj = PyDict_GetItemString(creds, "domain");
                password_obj = PyDict_GetItemString(creds, "password");

                if (!username_obj) {
                        *errstr = SMB_STRDUP("no username field in credential");
                        return False;
                }

                if (!domain_obj) {
                        *errstr = SMB_STRDUP("no domain field in credential");
                        return False;
                }

                if (!password_obj) {
                        *errstr = SMB_STRDUP("no password field in credential");
                        return False;
                }

                /* Check type of required fields */

                if (!PyString_Check(username_obj)) {
                        *errstr = SMB_STRDUP("username field is not string type");
                        return False;
                }

                if (!PyString_Check(domain_obj)) {
                        *errstr = SMB_STRDUP("domain field is not string type");
                        return False;
                }

                if (!PyString_Check(password_obj)) {
                        *errstr = SMB_STRDUP("password field is not string type");
                        return False;
                }

                /* Look for any extra fields */

                i = 0;

                while (PyDict_Next(creds, &i, &key, &value)) {
                        if (strcmp(PyString_AsString(key), "domain") != 0 &&
                            strcmp(PyString_AsString(key), "username") != 0 &&
                            strcmp(PyString_AsString(key), "password") != 0) {
                                asprintf(errstr,
                                         "creds contain extra field '%s'",
                                         PyString_AsString(key));
                                return False;
                        }
                }

                /* Assign values */

                *username = PyString_AsString(username_obj);
                *domain = PyString_AsString(domain_obj);
                *password = PyString_AsString(password_obj);
        }

        *errstr = NULL;

        return True;
}

struct cli_state* open_pipe_creds	(	char *	server,
		PyObject *	creds,
		int	pipe_idx,
		char **	errstr
	)

py_common.c の 212 行で定義されています。

参照先 asprintf()・cli・cli_full_connection()・cli_rpc_pipe_open_noauth()・cli_shutdown()・cli_state::domain・password・py_parse_creds()・result・username.

参照元 lsa_open_policy()・samr_connect()・spoolss_addprinterdriver()・spoolss_addprinterex()・spoolss_enumports()・spoolss_enumprinterdrivers()・spoolss_enumprinters()・spoolss_getprinterdriverdir()・spoolss_openprinter()・srvsvc_netservergetinfo().

{
        char *username, *password, *domain;
        struct cli_state *cli;
        struct rpc_pipe_client *pipe_hnd;
        NTSTATUS result;
        
        /* Extract credentials from the python dictionary */

        if (!py_parse_creds(creds, &username, &domain, &password, errstr))
                return NULL;

        /* Now try to connect */

        result = cli_full_connection(
                &cli, NULL, server, NULL, 0, "IPC$", "IPC",
                username, domain, password, 0, Undefined, NULL);
        
        if (!NT_STATUS_IS_OK(result)) {
                *errstr = SMB_STRDUP("error connecting to IPC$ pipe");
                return NULL;
        }

        pipe_hnd = cli_rpc_pipe_open_noauth(cli, pipe_idx, &result);
        if (!pipe_hnd) {
                cli_shutdown(cli);
                asprintf(errstr, "error opening pipe index %d", pipe_idx);
                return NULL;
        }

        *errstr = NULL;

        return cli;
}

BOOL get_level_value	(	PyObject *	dict,
		uint32 *	level
	)

py_common.c の 251 行で定義されています。

参照元 samr_set_user_info2()・spoolss_addprinterdriver()・spoolss_hnd_addform()・spoolss_hnd_setform()・spoolss_hnd_setprinter()・spoolss_hnd_startdocprinter().

{
        PyObject *obj;

        if (!(obj = PyDict_GetItemString(dict, "level")) ||
            !PyInt_Check(obj))
                return False;

        if (level)
                *level = PyInt_AsLong(obj);

        return True;
}

BOOL py_from_SID	(	PyObject **	obj,
		DOM_SID *	sid
	)

py_ntsec.c の 25 行で定義されています。

参照先 sid_to_string().

参照元 lsa_lookup_names()・py_from_ACE()・py_from_SECDESC().

{
        fstring sidstr;

        if (!sid) {
                Py_INCREF(Py_None);
                *obj = Py_None;
                return True;
        }

        if (!sid_to_string(sidstr, sid))
                return False;

        *obj = PyString_FromString(sidstr);

        return True;
}

BOOL py_to_SID	(	DOM_SID *	sid,
		PyObject *	obj
	)

py_ntsec.c の 43 行で定義されています。

参照先 string_to_sid().

参照元 py_to_ACE()・py_to_SECDESC().

{
        if (!PyString_Check(obj))
                return False;

        return string_to_sid(sid, PyString_AsString(obj));
}

BOOL py_from_ACE	(	PyObject **	dict,
		SEC_ACE *	ace
	)

py_ntsec.c の 51 行で定義されています。

参照先 security_ace_info::access_mask・security_ace_info::flags・py_from_SID()・security_ace_info::trustee・security_ace_info::type.

参照元 py_from_ACL().

{
        PyObject *obj;

        if (!ace) {
                Py_INCREF(Py_None);
                *dict = Py_None;
                return True;
        }

        *dict = Py_BuildValue("{sisisi}", "type", ace->type,
                                "flags", ace->flags,
                                "mask", ace->access_mask);

        if (py_from_SID(&obj, &ace->trustee)) {
                PyDict_SetItemString(*dict, "trustee", obj);
                Py_DECREF(obj);
        }

        return True;
}

BOOL py_to_ACE	(	SEC_ACE *	ace,
		PyObject *	dict
	)

py_ntsec.c の 73 行で定義されています。

参照先 init_sec_ace()・py_to_SID()・sid_size()・security_ace_info::size.

参照元 py_to_ACL().

{
        PyObject *obj;
        uint8 ace_type, ace_flags;
        DOM_SID trustee;
        SEC_ACCESS sec_access;

        if (!PyDict_Check(dict))
                return False;

        if (!(obj = PyDict_GetItemString(dict, "type")) ||
            !PyInt_Check(obj))
                return False;

        ace_type = PyInt_AsLong(obj);

        if (!(obj = PyDict_GetItemString(dict, "flags")) ||
            !PyInt_Check(obj))
                return False;

        ace_flags = PyInt_AsLong(obj);

        if (!(obj = PyDict_GetItemString(dict, "trustee")) ||
            !PyString_Check(obj))
                return False;

        if (!py_to_SID(&trustee, obj))
                return False;

        if (!(obj = PyDict_GetItemString(dict, "mask")) ||
            !PyInt_Check(obj))
                return False;

        sec_access = PyInt_AsLong(obj);

        init_sec_ace(ace, &trustee, ace_type, sec_access, ace_flags);

        /* Fill in size field */

        ace->size = SEC_ACE_HEADER_SIZE + sid_size(&trustee);

        return True;
}

BOOL py_from_ACL	(	PyObject **	dict,
		SEC_ACL *	acl
	)

py_ntsec.c の 117 行で定義されています。

参照先 security_acl_info::aces・security_acl_info::num_aces・py_from_ACE()・security_acl_info::revision.

参照元 py_from_SECDESC().

{
        PyObject *ace_list;
        int i;

        if (!acl) {
                Py_INCREF(Py_None);
                *dict = Py_None;
                return True;
        }

        ace_list = PyList_New(acl->num_aces);

        for (i = 0; i < acl->num_aces; i++) {
                PyObject *obj;

                if (py_from_ACE(&obj, &acl->aces[i]))
                        PyList_SetItem(ace_list, i, obj);
        }

        *dict = Py_BuildValue("{sisN}", "revision", acl->revision,
                        "ace_list", ace_list);

        return True;
}

BOOL py_to_ACL	(	SEC_ACL *	acl,
		PyObject *	dict,
		TALLOC_CTX *	mem_ctx
	)

py_ntsec.c の 143 行で定義されています。

参照先 _talloc()・security_acl_info::aces・security_acl_info::num_aces・py_to_ACE()・security_acl_info::revision・security_acl_info::size・security_ace_info::size.

参照元 py_to_SECDESC().

{
        PyObject *obj;
        uint32 i;

        if (!(obj = PyDict_GetItemString(dict, "revision")) ||
            !PyInt_Check(obj))
                return False;

        acl->revision = PyInt_AsLong(obj);

        if (!(obj = PyDict_GetItemString(dict, "ace_list")) ||
            !PyList_Check(obj)) 
                return False;
        
        acl->num_aces = PyList_Size(obj);

        acl->aces = _talloc(mem_ctx, acl->num_aces * sizeof(SEC_ACE));
        acl->size = SEC_ACL_HEADER_SIZE;

        for (i = 0; i < acl->num_aces; i++) {
                PyObject *py_ace = PyList_GetItem(obj, i);

                if (!py_to_ACE(&acl->aces[i], py_ace))
                        return False;

                acl->size += acl->aces[i].size;
        }

        return True;
}

BOOL py_from_SECDESC	(	PyObject **	dict,
		SEC_DESC *	sd
	)

py_ntsec.c の 175 行で定義されています。

参照先 security_descriptor_info::dacl・security_descriptor_info::group_sid・security_descriptor_info::owner_sid・py_from_ACL()・py_from_SID()・security_descriptor_info::revision・security_descriptor_info::sacl・security_descriptor_info::type.

参照元 py_from_PRINTER_INFO_2()・py_from_PRINTER_INFO_3()・py_smb_query_secdesc().

{
        PyObject *obj;

        *dict = PyDict_New();

        obj = PyInt_FromLong(sd->revision);
        PyDict_SetItemString(*dict, "revision", obj);
        Py_DECREF(obj);

        obj = PyInt_FromLong(sd->type);
        PyDict_SetItemString(*dict, "type", obj);
        Py_DECREF(obj);

        if (py_from_SID(&obj, sd->owner_sid)) {
                PyDict_SetItemString(*dict, "owner_sid", obj);
                Py_DECREF(obj);
        }

        if (py_from_SID(&obj, sd->group_sid)) {
                PyDict_SetItemString(*dict, "group_sid", obj);
                Py_DECREF(obj);
        }

        if (py_from_ACL(&obj, sd->dacl)) {
                PyDict_SetItemString(*dict, "dacl", obj);
                Py_DECREF(obj);
        }

        if (py_from_ACL(&obj, sd->sacl)) {
                PyDict_SetItemString(*dict, "sacl", obj);
                Py_DECREF(obj);
        }

        return True;
}

BOOL py_to_SECDESC	(	SEC_DESC **	sd,
		PyObject *	dict,
		TALLOC_CTX *	mem_ctx
	)

py_ntsec.c の 212 行で定義されています。

参照先 make_sec_desc()・py_to_ACL()・py_to_SID()・type.

参照元 py_smb_set_secdesc()・py_to_PRINTER_INFO_2()・py_to_PRINTER_INFO_3().

{
        PyObject *obj;
        uint16 revision;
        uint16 type = SEC_DESC_SELF_RELATIVE;
        DOM_SID owner_sid, group_sid;
        SEC_ACL sacl, dacl;
        BOOL got_dacl = False, got_sacl = False;
        BOOL got_owner_sid = False, got_group_sid = False;

        ZERO_STRUCT(dacl); ZERO_STRUCT(sacl);
        ZERO_STRUCT(owner_sid); ZERO_STRUCT(group_sid);

        if (!(obj = PyDict_GetItemString(dict, "revision")))
                return False;

        revision = PyInt_AsLong(obj);

        if ((obj = PyDict_GetItemString(dict, "type"))) {
                if (obj != Py_None) {
                        type = PyInt_AsLong(obj);
                }
        }

        if ((obj = PyDict_GetItemString(dict, "owner_sid"))) {

                if (obj != Py_None) {

                        if (!py_to_SID(&owner_sid, obj))
                                return False;

                        got_owner_sid = True;
                }
        }

        if ((obj = PyDict_GetItemString(dict, "group_sid"))) {

                if (obj != Py_None) {

                        if (!py_to_SID(&group_sid, obj))
                                return False;
                        
                        got_group_sid = True;
                }
        }

        if ((obj = PyDict_GetItemString(dict, "dacl"))) {

                if (obj != Py_None) {

                        if (!py_to_ACL(&dacl, obj, mem_ctx))
                                return False;
                        
                        got_dacl = True;
                }
        }

        if ((obj = PyDict_GetItemString(dict, "sacl"))) {

                if (obj != Py_None) {

                        if (!py_to_ACL(&sacl, obj, mem_ctx))
                                return False;

                        got_sacl = True;
                }
        }

#if 0                           /* For new secdesc code */
        *sd = make_sec_desc(mem_ctx, revision, 
                            got_owner_sid ? &owner_sid : NULL, 
                            got_group_sid ? &group_sid : NULL,
                            got_sacl ? &sacl : NULL, 
                            got_dacl ? &dacl : NULL);
#else
        {
                size_t sd_size;

                *sd = make_sec_desc(mem_ctx, revision, type,
                            got_owner_sid ? &owner_sid : NULL, 
                            got_group_sid ? &group_sid : NULL,
                            got_sacl ? &sacl : NULL, 
                            got_dacl ? &dacl : NULL, &sd_size);
        }
#endif

        return True;
}

---