/* * Copyright (C) 2009-2011 Red Hat Inc. * * David Sommerseth * * This application is free software; you can redistribute it and/or modify it * under the terms of the GNU General Public License as published by the Free * Software Foundation; version 2. * * This application is distributed in the hope that it will be useful, * but WITHOUT ANY WARRANTY; without even the implied warranty of * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU * General Public License for more details. */ /** * @file etherinfo_obj.c * @author David Sommerseth * @date Fri Sep 4 18:41:28 2009 * * @brief Python ethtool.etherinfo class functions. * */ #include #include "structmember.h" #include #include "etherinfo_struct.h" #include "etherinfo.h" extern PyTypeObject ethtool_etherinfoIPv6Type; /** * ethtool.etherinfo deallocator - cleans up when a object is deleted * * @param self etherinfo_py object structure */ void _ethtool_etherinfo_dealloc(etherinfo_py *self) { if( self->data ) { close_netlink(self->data); if( self->data->ethinfo ) { free_etherinfo(self->data->ethinfo); } free(self->data); } self->ob_type->tp_free((PyObject*)self); } /** * ethtool.etherinfo function, creating a new etherinfo object * * @param type * @param args * @param kwds * * @return Returns in PyObject with the new object on success, otherwise NULL */ PyObject *_ethtool_etherinfo_new(PyTypeObject *type, PyObject *args, PyObject *kwds) { etherinfo_py *self; self = (etherinfo_py *)type->tp_alloc(type, 0); return (PyObject *)self; } /** * ethtool.etherinfo init (constructor) method. Makes sure the object is initialised correctly. * * @param self * @param args * @param kwds * * @return Returns 0 on success. */ int _ethtool_etherinfo_init(etherinfo_py *self, PyObject *args, PyObject *kwds) { static char *etherinfo_kwlist[] = {"etherinfo_ptr", NULL}; PyObject *ethinf_ptr = NULL; if( !PyArg_ParseTupleAndKeywords(args, kwds, "O", etherinfo_kwlist, ðinf_ptr)) { PyErr_SetString(PyExc_AttributeError, "Invalid data pointer to constructor"); return -1; } self->data = (struct etherinfo_obj_data *) PyCObject_AsVoidPtr(ethinf_ptr); return 0; } /* The old approach of having a single IPv4 address per device meant each result that came in from netlink overwrote the old result. Mimic it by returning the last entry in the list (if any). The return value is a *borrowed reference* (or NULL) */ static PyNetlinkIPv4Address* get_last_address(etherinfo_py *self) { Py_ssize_t size; PyObject *list; assert(self); list = self->data->ethinfo->ipv4_addresses; if (!list) { return NULL; } if (!PyList_Check(list)) { return NULL; } size = PyList_Size(list); if (size > 0) { PyObject *item = PyList_GetItem(list, size - 1); if (Py_TYPE(item) == ðtool_netlink_ipv4_address_Type) { return (PyNetlinkIPv4Address*)item; } } return NULL; } /** * ethtool.etherinfo function for retrieving data from a Python object. * * @param self * @param attr_o contains the object member request (which element to return) * * @return Returns a PyObject with the value requested on success, otherwise NULL */ PyObject *_ethtool_etherinfo_getter(etherinfo_py *self, PyObject *attr_o) { char *attr = PyString_AsString(attr_o); PyNetlinkIPv4Address *py_addr; if( !self || !self->data ) { PyErr_SetString(PyExc_AttributeError, "No data available"); return NULL; } if( strcmp(attr, "device") == 0 ) { return RETURN_STRING(self->data->ethinfo->device); } else if( strcmp(attr, "mac_address") == 0 ) { get_etherinfo(self->data, NLQRY_LINK); return RETURN_STRING(self->data->ethinfo->hwaddress); } else if( strcmp(attr, "ipv4_address") == 0 ) { get_etherinfo(self->data, NLQRY_ADDR); /* For compatiblity with old approach, return last IPv4 address: */ py_addr = get_last_address(self); if (py_addr) { if (py_addr->ipv4_address) { Py_INCREF(py_addr->ipv4_address); return py_addr->ipv4_address; } } Py_RETURN_NONE; } else if( strcmp(attr, "ipv4_netmask") == 0 ) { get_etherinfo(self->data, NLQRY_ADDR); py_addr = get_last_address(self); if (py_addr) { return PyInt_FromLong(py_addr->ipv4_netmask); } return PyInt_FromLong(0); } else if( strcmp(attr, "ipv4_broadcast") == 0 ) { get_etherinfo(self->data, NLQRY_ADDR); py_addr = get_last_address(self); if (py_addr) { if (py_addr->ipv4_broadcast) { Py_INCREF(py_addr->ipv4_broadcast); return py_addr->ipv4_broadcast; } } Py_RETURN_NONE; } else { return PyObject_GenericGetAttr((PyObject *)self, attr_o); } } /** * ethtool.etherinfo function for setting a value to a object member. This feature is * disabled by always returning -1, as the values are read-only by the user. * * @param self * @param attr_o * @param val_o * * @return Returns always -1 (failure). */ int _ethtool_etherinfo_setter(etherinfo_py *self, PyObject *attr_o, PyObject *val_o) { PyErr_SetString(PyExc_AttributeError, "etherinfo member values are read-only."); return -1; } /** * Creates a human readable format of the information when object is being treated as a string * * @param self * * @return Returns a PyObject with a string with all of the information */ PyObject *_ethtool_etherinfo_str(etherinfo_py *self) { PyObject *ret = NULL; if( !self || !self->data || !self->data->nlc || !self->data->ethinfo ) { PyErr_SetString(PyExc_AttributeError, "No data available"); return NULL; } get_etherinfo(self->data, NLQRY_LINK); get_etherinfo(self->data, NLQRY_ADDR); ret = PyString_FromFormat("Device %s:\n", self->data->ethinfo->device); if( self->data->ethinfo->hwaddress ) { PyObject *tmp = PyString_FromFormat("\tMAC address: %s\n", self->data->ethinfo->hwaddress); PyString_Concat(&ret, tmp); Py_DECREF(tmp); } if( self->data->ethinfo->ipv4_addresses ) { Py_ssize_t i; for (i = 0; i < PyList_Size(self->data->ethinfo->ipv4_addresses); i++) { PyNetlinkIPv4Address *py_addr = (PyNetlinkIPv4Address *)PyList_GetItem(self->data->ethinfo->ipv4_addresses, i); PyObject *tmp = PyString_FromFormat("\tIPv4 address: "); PyString_Concat(&tmp, py_addr->ipv4_address); PyString_ConcatAndDel(&tmp, PyString_FromFormat("/%d", py_addr->ipv4_netmask)); if (py_addr->ipv4_broadcast ) { PyString_ConcatAndDel(&tmp, PyString_FromString(" Broadcast: ")); PyString_Concat(&tmp, py_addr->ipv4_broadcast); } PyString_ConcatAndDel(&tmp, PyString_FromString("\n")); PyString_ConcatAndDel(&ret, tmp); } } if( self->data->ethinfo->ipv6_addresses ) { struct ipv6address *ipv6 = self->data->ethinfo->ipv6_addresses; PyObject *tmp = PyString_FromFormat("\tIPv6 addresses:\n"); PyString_Concat(&ret, tmp); Py_DECREF(tmp); for( ; ipv6; ipv6 = ipv6->next) { char scope[66]; rtnl_scope2str(ipv6->scope, scope, 64); PyObject *addr = PyString_FromFormat("\t [%s] %s/%i\n", scope, ipv6->address, ipv6->netmask); PyString_Concat(&ret, addr); Py_DECREF(addr); } } return ret; } static PyObject * _ethtool_etherinfo_get_ipv4_addresses(etherinfo_py *self, PyObject *notused) { PyObject *ret; if( !self || !self->data ) { PyErr_SetString(PyExc_AttributeError, "No data available"); return NULL; } get_etherinfo(self->data, NLQRY_ADDR); /* Transfer ownership of reference: */ ret = self->data->ethinfo->ipv4_addresses; self->data->ethinfo->ipv4_addresses = NULL; return ret; } /** * Returns a tuple list of ethertool.etherinfo_ipv6addr objects, containing configured * IPv6 addresses * * @param self * @param notused * * @return Returns a Python tuple list of ethertool.etherinfo_ipv6addr objects */ PyObject * _ethtool_etherinfo_get_ipv6_addresses(etherinfo_py *self, PyObject *notused) { PyObject *ret; struct ipv6address *ipv6 = NULL; int i = 0; if( !self || !self->data ) { PyErr_SetString(PyExc_AttributeError, "No data available"); return NULL; } get_etherinfo(self->data, NLQRY_ADDR); ipv6 = self->data->ethinfo->ipv6_addresses; ret = PyTuple_New(1); if( !ret ) { PyErr_SetString(PyExc_MemoryError, "[INTERNAL] Failed to allocate tuple list for " "IPv6 address objects"); return NULL; } while( ipv6 ) { PyObject *ipv6_pyobj = NULL, *ipv6_pydata = NULL, *args = NULL; struct ipv6address *next = ipv6->next; ipv6->next = NULL; ipv6_pydata = PyCObject_FromVoidPtr(ipv6, NULL); if( !ipv6_pydata ) { PyErr_SetString(PyExc_MemoryError, "[INTERNAL] Failed to create python object " "containing IPv6 address"); return NULL; } args = PyTuple_New(1); if( !args ) { PyErr_SetString(PyExc_MemoryError, "[INTERNAL] Failed to allocate argument list " "a new IPv6 address object"); return NULL; } PyTuple_SetItem(args, 0, ipv6_pydata); ipv6_pyobj = PyObject_CallObject((PyObject *)ðtool_etherinfoIPv6Type, args); Py_DECREF(args); if( ipv6_pyobj ) { PyTuple_SetItem(ret, i++, ipv6_pyobj); _PyTuple_Resize(&ret, i+1); } else { PyErr_SetString(PyExc_RuntimeError, "[INTERNAL] Failed to initialise the new " "IPv6 address object"); return NULL; } ipv6 = next; } _PyTuple_Resize(&ret, i); self->data->ethinfo->ipv6_addresses = NULL; return ret; } /** * Defines all available methods in the ethtool.etherinfo class * */ static PyMethodDef _ethtool_etherinfo_methods[] = { {"get_ipv4_addresses", (PyCFunction)_ethtool_etherinfo_get_ipv4_addresses, METH_NOARGS, "Retrieve configured IPv4 addresses. Returns a list of NetlinkIP4Address objects"}, {"get_ipv6_addresses", (PyCFunction)_ethtool_etherinfo_get_ipv6_addresses, METH_NOARGS, "Retrieve configured IPv6 addresses. Returns a tuple list of etherinfo_ipv6addr objects"}, {NULL} /**< No methods defined */ }; /** * Definition of the functions a Python class/object requires. * */ PyTypeObject ethtool_etherinfoType = { PyObject_HEAD_INIT(NULL) 0, /*ob_size*/ "ethtool.etherinfo", /*tp_name*/ sizeof(etherinfo_py), /*tp_basicsize*/ 0, /*tp_itemsize*/ (destructor)_ethtool_etherinfo_dealloc,/*tp_dealloc*/ 0, /*tp_print*/ 0, /*tp_getattr*/ 0, /*tp_setattr*/ 0, /*tp_compare*/ 0, /*tp_repr*/ 0, /*tp_as_number*/ 0, /*tp_as_sequence*/ 0, /*tp_as_mapping*/ 0, /*tp_hash */ 0, /*tp_call*/ (reprfunc)_ethtool_etherinfo_str, /*tp_str*/ (getattrofunc)_ethtool_etherinfo_getter, /*tp_getattro*/ (setattrofunc)_ethtool_etherinfo_setter, /*tp_setattro*/ 0, /*tp_as_buffer*/ Py_TPFLAGS_DEFAULT | Py_TPFLAGS_BASETYPE, /*tp_flags*/ "Contains information about a specific ethernet device", /* tp_doc */ 0, /* tp_traverse */ 0, /* tp_clear */ 0, /* tp_richcompare */ 0, /* tp_weaklistoffset */ 0, /* tp_iter */ 0, /* tp_iternext */ _ethtool_etherinfo_methods, /* tp_methods */ 0, /* tp_members */ 0, /* tp_getset */ 0, /* tp_base */ 0, /* tp_dict */ 0, /* tp_descr_get */ 0, /* tp_descr_set */ 0, /* tp_dictoffset */ (initproc)_ethtool_etherinfo_init, /* tp_init */ 0, /* tp_alloc */ _ethtool_etherinfo_new, /* tp_new */ };