This file is indexed.

/usr/share/pyshared/smartcard/pcsc/PCSCReaderGroups.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
"""PCSCReaderGroups organizes smartcard readers as 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.scard import *
from smartcard.reader.ReaderGroups import readergroups, innerreadergroups
from smartcard.pcsc.PCSCExceptions import *


class pcscinnerreadergroups(innerreadergroups):
    """Smartcard PCSC readers groups inner class.

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

    def __init__(self, initlist=None):
        """Constructor."""
        innerreadergroups.__init__(self, initlist)
        self.unremovablegroups = ['SCard$DefaultReaders']

    def getreadergroups(self):
        """ Returns the list of smartcard reader groups."""
        innerreadergroups.getreadergroups(self)

        hresult, hcontext = SCardEstablishContext(SCARD_SCOPE_USER)
        if hresult != 0:
            raise EstablishContextException(hresult)
        hresult, readers = SCardListReaderGroups(hcontext)
        if hresult != 0:
            raise ListReadersException(hresult)
        hresult = SCardReleaseContext(hcontext)
        if hresult != 0:
            raise ReleaseContextException(hresult)
        return readers

    def addreadergroup(self, newgroup):
        """Add a reader group"""

        hresult, hcontext = SCardEstablishContext(SCARD_SCOPE_USER)
        if 0 != hresult:
            raise error(
                'Failed to establish context: ' + \
                SCardGetErrorMessage(hresult))
        try:
            hresult = SCardIntroduceReaderGroup(hcontext, newgroup)
            if 0 != hresult:
                raise error(
                    'Unable to introduce reader group: ' + \
                    SCardGetErrorMessage(hresult))
            else:
                innerreadergroups.addreadergroup(self, newgroup)

        finally:
            hresult = SCardReleaseContext(hcontext)
            if 0 != hresult:
                raise error(
                    'Failed to release context: ' + \
                    SCardGetErrorMessage(hresult))

    def removereadergroup(self, group):
        """Remove a reader group"""

        hresult, hcontext = SCardEstablishContext(SCARD_SCOPE_USER)
        if 0 != hresult:
            raise error(
                'Failed to establish context: ' + \
                SCardGetErrorMessage(hresult))
        try:
            hresult = SCardForgetReaderGroup(hcontext, group)
            if hresult != 0:
                raise error(
                    'Unable to forget reader group: ' + \
                    SCardGetErrorMessage(hresult))
            else:
                innerreadergroups.removereadergroup(self, group)

        finally:
            hresult = SCardReleaseContext(hcontext)
            if 0 != hresult:
                raise error(
                    'Failed to release context: ' + \
                    SCardGetErrorMessage(hresult))


class PCSCReaderGroups(readergroups):
    """PCSC readers groups."""

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

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