1/*
2 * Copyright (c) 2004,2008,2014 Apple Inc. All Rights Reserved.
3 *
4 * @APPLE_LICENSE_HEADER_START@
5 *
6 * This file contains Original Code and/or Modifications of Original Code
7 * as defined in and that are subject to the Apple Public Source License
8 * Version 2.0 (the 'License'). You may not use this file except in
9 * compliance with the License. Please obtain a copy of the License at
10 * http://www.opensource.apple.com/apsl/ and read it before using this
11 * file.
12 *
13 * The Original Code and all software distributed under the License are
14 * distributed on an 'AS IS' basis, WITHOUT WARRANTY OF ANY KIND, EITHER
15 * EXPRESS OR IMPLIED, AND APPLE HEREBY DISCLAIMS ALL SUCH WARRANTIES,
16 * INCLUDING WITHOUT LIMITATION, ANY WARRANTIES OF MERCHANTABILITY,
17 * FITNESS FOR A PARTICULAR PURPOSE, QUIET ENJOYMENT OR NON-INFRINGEMENT.
18 * Please see the License for the specific language governing rights and
19 * limitations under the License.
20 *
21 * @APPLE_LICENSE_HEADER_END@
22 */
23
24
25//
26// reader - token reader objects
27//
28#ifndef _H_READER
29#define _H_READER
30
31#include "structure.h"
32#include "token.h"
33#include "tokencache.h"
34#include <security_utilities/pcsc++.h>
35
36
37//
38// A Reader object represents a token (card) reader device attached to the
39// system.
40//
41class Reader : public PerGlobal {
42public:
43	Reader(TokenCache &cache, const PCSC::ReaderState &state);	// PCSC managed
44	Reader(TokenCache &cache, const std::string &name);			// software
45	~Reader();
46
47	enum Type {
48		pcsc,				// represents PCSC-managed reader
49		software			// software (virtual) reader,
50	};
51	Type type() const { return mType; }
52	bool isType(Type type) const;
53
54	TokenCache &cache;
55
56	void kill();
57
58	const string &name() const { return mName; }
59	const string &printName() const { return mPrintName; }
60	const PCSC::ReaderState &pcscState() const { return mState; }
61
62	void insertToken(TokenDaemon *tokend);
63	void update(const PCSC::ReaderState &state);
64	void removeToken();
65
66	IFDUMP(void dumpNode());
67
68protected:
69
70private:
71	Type mType;
72	string mName;			// PCSC reader name
73	string mPrintName;		// human readable name of reader
74	PCSC::ReaderState mState; // name field not valid (use mName)
75	Token *mToken;			// token inserted here (also in references)
76};
77
78
79#endif //_H_READER
80