bc8b237c5a
There is no longer an external (or stable) interface for libopensc. Linking this program with an existing version of libopensc that is pre-installed in the system library paths is not practical. However, a specific snapshot of the OpenSC source code is embedded here as a Git submodule (and included in the source distributions). Build libopensc from this and statically link it into this program. (Options such as '--enable-openpace' that are passed to ./configure will be forwarded to control the build configuration of libopensc.) Remove code that existed for compatibility when dynamically linking with older versions of libopensc.
89 lines
2.9 KiB
C
89 lines
2.9 KiB
C
/*
|
|
* Copyright (C) 2009 Frank Morgner
|
|
*
|
|
* This file is part of ccid.
|
|
*
|
|
* ccid 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, either version 3 of the License, or (at your option) any later
|
|
* version.
|
|
*
|
|
* ccid 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.
|
|
*
|
|
* You should have received a copy of the GNU General Public License along with
|
|
* ccid. If not, see <http://www.gnu.org/licenses/>.
|
|
*/
|
|
/**
|
|
* @file
|
|
*/
|
|
#ifndef _CCID_H
|
|
#define _CCID_H
|
|
|
|
#include <linux/usb/ch9.h>
|
|
#include <libopensc/ccid-types.h>
|
|
|
|
#ifdef __cplusplus
|
|
extern "C" {
|
|
#endif
|
|
|
|
/**
|
|
* @brief Initializes reader for relaying
|
|
*
|
|
* @param[in] reader_id (optional) Index to the reader to be used. Set to -1 to use the first reader with a card or the first reader if no card is available.
|
|
* @param[in] verbose Verbosity level passed to \c sc_context_t
|
|
*
|
|
* @return \c SC_SUCCESS or error code if an error occurred
|
|
*/
|
|
int ccid_initialize(int reader_id, int verbose);
|
|
|
|
/**
|
|
* @brief Disconnects from card, reader and releases allocated memory
|
|
*/
|
|
void ccid_shutdown(void);
|
|
|
|
|
|
/**
|
|
* @brief Parses input from PC and generates the appropriate RDR response
|
|
*
|
|
* Parses command pipe bulk-OUT messages and generates resoponse pipe bulk-IN
|
|
* messages according to CCID Rev 1.1 section 6.1, 6.2
|
|
*
|
|
* @param[in] inbuf input buffer (command pipe bulk-OUT message)
|
|
* @param[in] inlen length of \a inbuf
|
|
* @param[in,out] outbuf where to save the output buffer (resoponse pipe bulk-IN message), memory is reused via \c realloc()
|
|
*
|
|
* @return length of \a outbuf or -1 if an error occurred
|
|
*/
|
|
int ccid_parse_bulkout(const __u8* inbuf, size_t inlen, __u8** outbuf);
|
|
|
|
/**
|
|
* @brief Parses input from control pipe and generates the appropriate response
|
|
*
|
|
* Parses CCID class-specific requests according to CCID Rev 1.1 section 5.3
|
|
*
|
|
* @param[in] setup input from control pipe
|
|
* @param[in,out] outbuf where to save the output buffer, memory is reused via \c realloc()
|
|
*
|
|
* @return length of \a outbuf or -1 if an error occurred
|
|
*/
|
|
int ccid_parse_control(struct usb_ctrlrequest *setup, __u8 **outbuf);
|
|
|
|
/**
|
|
* @brief Generates event messages
|
|
*
|
|
* @param[in,out] slotchange where to save the output
|
|
* @param[in] timeout currently not used
|
|
* @note ccid_state_changed() must be called periodically. Because the OpenSC implementation of \c sc_wait_for_event() blocks all other operations with the reader, it can't be used for slot state detection.
|
|
*
|
|
* @return 1 if a card is present and/or the state is changed or 0
|
|
*/
|
|
int ccid_state_changed(RDR_to_PC_NotifySlotChange_t **slotchange, int timeout);
|
|
|
|
#ifdef __cplusplus
|
|
}
|
|
#endif
|
|
#endif
|