This file is indexed.

/usr/share/pyshared/smartcard/reader/ReaderGroups.py is in python-pyscard 1.6.12.1-4.

This file is owned by root:root, with mode 0o644.

The actual contents of the file can be viewed below.

  1
  2
  3
  4
  5
  6
  7
  8
  9
 10
 11
 12
 13
 14
 15
 16
 17
 18
 19
 20
 21
 22
 23
 24
 25
 26
 27
 28
 29
 30
 31
 32
 33
 34
 35
 36
 37
 38
 39
 40
 41
 42
 43
 44
 45
 46
 47
 48
 49
 50
 51
 52
 53
 54
 55
 56
 57
 58
 59
 60
 61
 62
 63
 64
 65
 66
 67
 68
 69
 70
 71
 72
 73
 74
 75
 76
 77
 78
 79
 80
 81
 82
 83
 84
 85
 86
 87
 88
 89
 90
 91
 92
 93
 94
 95
 96
 97
 98
 99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
"""ReaderGroups manages smart card reader in groups.

__author__ = "gemalto http://www.gemalto.com"

Copyright 2001-2012 gemalto
Author: Jean-Daniel Aussel, mailto:jean-daniel.aussel@gemalto.com

This file is part of pyscard.

pyscard is free software; you can redistribute it and/or modify
it under the terms of the GNU Lesser General Public License as published by
the Free Software Foundation; either version 2.1 of the License, or
(at your option) any later version.

pyscard 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 Lesser General Public License for more details.

You should have received a copy of the GNU Lesser General Public License
along with pyscard; if not, write to the Free Software
Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA  02110-1301  USA
"""

from smartcard.Exceptions import SmartcardException
from smartcard.ulist import ulist


class BadReaderGroupException(SmartcardException):
    """Raised when trying to add an invalid reader group."""

    def __init__(self):
        SmartcardException.__init__(self, 'Invalid reader group')


class DeleteSCardDefaultReaderGroupException(SmartcardException):
    """Raised when trying to delete SCard$DefaultReaders reader group."""

    def __init__(self):
        SmartcardException.__init__(
            self, 'SCard$DefaultReaders cannot be deleted')


class innerreadergroups(ulist):
    """Smartcard readers groups private class.

    The readergroups singleton manages the creation of the unique
    instance of this class.
    """

    def __init__(self, initlist=None):
        """Retrieve and store list of reader groups"""
        if None == initlist:
            initlist = self.getreadergroups()
        if None != initlist:
            ulist.__init__(self, initlist)
        self.unremovablegroups = []

    def __onadditem__(self, item):
        """Called when a reader group is added."""
        self.addreadergroup(item)

    def __onremoveitem__(self, item):
        """Called when a reader group is added."""
        self.removereadergroup(item)

    def __iter__(self):
        return ulist.__iter__(self)

    def next(self):
        return ulist.__next__(self)

    #
    # abstract methods implemented in subclasses
    #

    def getreadergroups(self):
        """Returns the list of smartcard reader groups."""
        return []

    def addreadergroup(self, newgroup):
        """Add a reader group"""
        if not isinstance(newgroup, type("")):
            raise BadReaderGroupException
        self += newgroup

    def removereadergroup(self, group):
        """Remove a reader group"""
        if not isinstance(group, type("")):
            raise BadReaderGroupException
        self.remove(group)

    def addreadertogroup(self, readername, groupname):
        """Add a reader to a reader group"""
        pass

    def removereaderfromgroup(self, readername, groupname):
        """Remove a reader from a reader group"""
        pass


class readergroups(object):
    """ReadersGroups organizes smart card reader as groups."""

    """The single instance of __readergroups"""
    instance = None
    innerclazz = innerreadergroups

    def __init__(self, initlist=None):
        """Create a single instance of innerreadergroups on first call"""
        if None == readergroups.instance:
            readergroups.instance = self.innerclazz(initlist)

    """All operators redirected to inner class."""

    def __getattr__(self, name):
        return getattr(self.instance, name)


if __name__ == '__main__':
    print readergroups()