Compare commits

...

9 Commits

Author SHA1 Message Date
d043915a29
feat: implémentation partielle de la fonction get_config et de ses erreurs 2024-10-09 22:38:53 +02:00
2260b0cfa8
feat: implement LireCartePS with hardcoded reader and all errors 2024-10-09 22:38:53 +02:00
203521fe01
feat: Implémentation de la gestion des erreurs numériques de la librairie C pour la fonction InitLIB2
Co-authored-by: theo <t.lettermann@criteo.com>
2024-10-09 22:38:53 +02:00
3c1e691cb8
feat: Création de la crate fsv, couche de haut niveau pour l'usage des librairies FSV 2024-10-09 22:38:53 +02:00
add40f32c5 Merge pull request 'Création d'une sys-crate pour la gestion des librairies FSV' (#70) from feat/38-fsv-sys-crate into main
### Détails

Début d'implémentation de bindings pour FSV SESAM-Vitale

- Création de la crates/fsv-sys
- Ajout des headers des versions FSV 1.40.14 et 1.40.13 dans un sous-dossier crates/fsv-sys/vendor
- Génération des bindings depuis ces headers avec bindgen
- Implémentation d'une structure de loading de la librairie au runtime
    - Un pattern similaire au "TypeState pattern" est utilisé pour gérer plusieurs versions possibles des bindings FSV
    - Une macro permet de générer avec un peu moins de boilerplate que nécessaire la couche d'accès aux fonctions de la librairie

### Pourquoi ?

Cette PR est une étape importante du ticket #38

Une telle sys-crate, respectant (à peu près) les bonnes pratiques d'une telle implem, permet :
- Pouvoir être diffusée publiquement en tant que telle, pour faciliter le travail à des copaines
- De concentrer le travail très spécifique et bas niveau de gestion des librairies et des bindings dans une crate dédiée
- De ne pas "forcer" une approche "orientée" sur l'API plus haut niveau qu'on décide de brancher sur ces bindings
    - En effet, l'implem haut niveau fait des choix non neutres, comme le choix de certains types, la technique de gestion des erreurs, etc.

### Documentation

# Aide reçue sur les forums Rust
- [Génération des bindings avec Bindgen](https://users.rust-lang.org/t/how-to-handle-bindgen-generating-types-aliases-instead-of-callable-functions/118083)
- [Gestion des versions multiples avec la structure de loading de la librairie](https://users.rust-lang.org/t/manage-various-versions-of-a-c-library-loaded-at-runtime/118973)

# Documentations
- [Making a sys-crate](https://kornel.ski/rust-sys-crate)
- [LibLoading](https://docs.rs/libloading/latest/libloading/)
- [Bindgen](https://rust-lang.github.io/rust-bindgen/)

Reviewed-on: #70
Reviewed-by: kosssi <simon@p4pillon.org>
2024-10-09 22:37:36 +02:00
d8b8ce9a77
feat: improve the fsv-sys README, and add a PROGESS.md for implementation tracking 2024-10-09 22:31:26 +02:00
9997ee43f8
feat: Gestion des versions multiples de FSV dans le wrapper exposant les fonctions de la librairie 2024-10-09 22:31:26 +02:00
4ab8a1de81
feat: handle multi-version bindings generation 2024-10-09 22:31:26 +02:00
d13f36c5e2
feat: Première implémentation de bindings pour FSV SESAM-Vitale
- Création de la crates/fsv-sys
- Ajout des headers de la FSV 1.40.14.13 dans crates/fsv-sys/vendor
- Génération des bindings depuis ces headers avec bindgen
- Implémentation d'une structure de loading de la librairie au runtime
- Implémentation d'une macro permettant de générer facilement la couche d'accès aux fonctions de la librairie
2024-10-09 22:31:26 +02:00
30 changed files with 2894 additions and 5 deletions

1
.gitattributes vendored Normal file
View File

@ -0,0 +1 @@
Cargo.lock -merge linguist-generated=false

View File

@ -621,6 +621,26 @@ dependencies = [
"num-traits", "num-traits",
] ]
[[package]]
name = "bindgen"
version = "0.70.1"
source = "registry+https://github.com/rust-lang/crates.io-index"
checksum = "f49d8fed880d473ea71efb9bf597651e77201bdd4893efe54c9e5d65ae04ce6f"
dependencies = [
"bitflags 2.6.0",
"cexpr",
"clang-sys",
"itertools",
"log",
"prettyplease",
"proc-macro2",
"quote",
"regex",
"rustc-hash",
"shlex",
"syn 2.0.77",
]
[[package]] [[package]]
name = "bitflags" name = "bitflags"
version = "1.3.2" version = "1.3.2"
@ -901,6 +921,15 @@ version = "1.1.0"
source = "registry+https://github.com/rust-lang/crates.io-index" source = "registry+https://github.com/rust-lang/crates.io-index"
checksum = "6d43a04d8753f35258c91f8ec639f792891f748a1edbd759cf1dcea3382ad83c" checksum = "6d43a04d8753f35258c91f8ec639f792891f748a1edbd759cf1dcea3382ad83c"
[[package]]
name = "cexpr"
version = "0.6.0"
source = "registry+https://github.com/rust-lang/crates.io-index"
checksum = "6fac387a98bb7c37292057cffc56d62ecb629900026402633ae9160df93a8766"
dependencies = [
"nom 7.1.3",
]
[[package]] [[package]]
name = "cfb" name = "cfb"
version = "0.7.3" version = "0.7.3"
@ -961,6 +990,17 @@ dependencies = [
"windows-targets 0.52.6", "windows-targets 0.52.6",
] ]
[[package]]
name = "clang-sys"
version = "1.8.1"
source = "registry+https://github.com/rust-lang/crates.io-index"
checksum = "0b023947811758c97c59bf9d1c188fd619ad4718dcaa767947df1cadb14f39f4"
dependencies = [
"glob",
"libc",
"libloading 0.8.5",
]
[[package]] [[package]]
name = "clap" name = "clap"
version = "2.34.0" version = "2.34.0"
@ -1923,6 +1963,28 @@ dependencies = [
"libc", "libc",
] ]
[[package]]
name = "fsv"
version = "0.1.0"
dependencies = [
"anyhow",
"fsv-sys",
"libc",
"num_enum",
"thiserror",
"utils",
]
[[package]]
name = "fsv-sys"
version = "0.1.0"
dependencies = [
"bindgen",
"libc",
"libloading 0.8.5",
"thiserror",
]
[[package]] [[package]]
name = "fuchsia-zircon" name = "fuchsia-zircon"
version = "0.3.3" version = "0.3.3"
@ -2782,6 +2844,15 @@ version = "1.70.1"
source = "registry+https://github.com/rust-lang/crates.io-index" source = "registry+https://github.com/rust-lang/crates.io-index"
checksum = "7943c866cc5cd64cbc25b2e01621d07fa8eb2a1a23160ee81ce38704e97b8ecf" checksum = "7943c866cc5cd64cbc25b2e01621d07fa8eb2a1a23160ee81ce38704e97b8ecf"
[[package]]
name = "itertools"
version = "0.13.0"
source = "registry+https://github.com/rust-lang/crates.io-index"
checksum = "413ee7dfc52ee1a4949ceeb7dbc8a33f2d6c088194d9f922fb8318faf1f01186"
dependencies = [
"either",
]
[[package]] [[package]]
name = "itoa" name = "itoa"
version = "0.4.8" version = "0.4.8"
@ -2949,15 +3020,15 @@ source = "registry+https://github.com/rust-lang/crates.io-index"
checksum = "6e9ec52138abedcc58dc17a7c6c0c00a2bdb4f3427c7f63fa97fd0d859155caf" checksum = "6e9ec52138abedcc58dc17a7c6c0c00a2bdb4f3427c7f63fa97fd0d859155caf"
dependencies = [ dependencies = [
"gtk-sys", "gtk-sys",
"libloading", "libloading 0.7.4",
"once_cell", "once_cell",
] ]
[[package]] [[package]]
name = "libc" name = "libc"
version = "0.2.158" version = "0.2.159"
source = "registry+https://github.com/rust-lang/crates.io-index" source = "registry+https://github.com/rust-lang/crates.io-index"
checksum = "d8adc4bb1803a324070e64a98ae98f38934d91957a99cfb3a43dcbc01bc56439" checksum = "561d97a539a36e26a9a5fad1ea11a3039a67714694aaa379433e580854bc3dc5"
[[package]] [[package]]
name = "libloading" name = "libloading"
@ -2969,6 +3040,16 @@ dependencies = [
"winapi 0.3.9", "winapi 0.3.9",
] ]
[[package]]
name = "libloading"
version = "0.8.5"
source = "registry+https://github.com/rust-lang/crates.io-index"
checksum = "4979f22fdb869068da03c9f7528f8297c6fd2606bc3a4affe42e6a823fdb8da4"
dependencies = [
"cfg-if 1.0.0",
"windows-targets 0.52.6",
]
[[package]] [[package]]
name = "libm" name = "libm"
version = "0.2.8" version = "0.2.8"
@ -4183,6 +4264,16 @@ version = "0.1.1"
source = "registry+https://github.com/rust-lang/crates.io-index" source = "registry+https://github.com/rust-lang/crates.io-index"
checksum = "925383efa346730478fb4838dbe9137d2a47675ad789c546d150a6e1dd4ab31c" checksum = "925383efa346730478fb4838dbe9137d2a47675ad789c546d150a6e1dd4ab31c"
[[package]]
name = "prettyplease"
version = "0.2.22"
source = "registry+https://github.com/rust-lang/crates.io-index"
checksum = "479cf940fbbb3426c32c5d5176f62ad57549a0bb84773423ba8be9d089f5faba"
dependencies = [
"proc-macro2",
"syn 2.0.77",
]
[[package]] [[package]]
name = "proc-macro-crate" name = "proc-macro-crate"
version = "1.3.1" version = "1.3.1"
@ -4578,6 +4669,12 @@ version = "0.1.24"
source = "registry+https://github.com/rust-lang/crates.io-index" source = "registry+https://github.com/rust-lang/crates.io-index"
checksum = "719b953e2095829ee67db738b3bfa9fa368c94900df327b3f07fe6e794d2fe1f" checksum = "719b953e2095829ee67db738b3bfa9fa368c94900df327b3f07fe6e794d2fe1f"
[[package]]
name = "rustc-hash"
version = "1.1.0"
source = "registry+https://github.com/rust-lang/crates.io-index"
checksum = "08d43f7aa6b08d49f382cde6a7982047c3426db949b1424bc4b7ec9ae12c6ce2"
[[package]] [[package]]
name = "rustc_version" name = "rustc_version"
version = "0.4.1" version = "0.4.1"

View File

@ -4,6 +4,8 @@ members = [
"crates/backend", "crates/backend",
"crates/desktop", "crates/desktop",
"crates/sesam-vitale", "crates/sesam-vitale",
"crates/fsv",
"crates/fsv-sys",
"crates/utils", "crates/utils",
"migration", "migration",
"entity", "entity",

View File

@ -9,6 +9,7 @@ Logiciel de Pharmacie libre et open-source.
- `crates/desktop`: Client desktop propulsé par Tauri, exposant le `frontend` - `crates/desktop`: Client desktop propulsé par Tauri, exposant le `frontend`
- `crates/sesam-vitale`: Bibliothèque de gestion des services SESAM-Vitale (Lecture des cartes CPS et Vitale, téléservices ...) - `crates/sesam-vitale`: Bibliothèque de gestion des services SESAM-Vitale (Lecture des cartes CPS et Vitale, téléservices ...)
- `crates/utils`: Bibliothèque de fonctions utilitaires - `crates/utils`: Bibliothèque de fonctions utilitaires
- `crates/fsv-sys`: Bindings Rust pour les librairies dynamiques FSV (SESAM-Vitale)
- `frontend`: Interface web du logiciel, propulsée par Nuxt.js - `frontend`: Interface web du logiciel, propulsée par Nuxt.js
## Installation ## Installation
@ -61,9 +62,9 @@ Toutefois, l'usage de la CLI de SeaORM nécessite de renseigner les informations
> Astuce : utilisé un lien symbolique pour éviter de dupliquer le fichier `.env`. > Astuce : utilisé un lien symbolique pour éviter de dupliquer le fichier `.env`.
#### SESAM-Vitale #### FSV-sys
La crate `sesam-vitale` nécessite la présence des librairies dynamiques fournies par le package FSV et la CryptolibCPS. Les instructions d'installation sont disponibles dans le [README](crates/sesam-vitale/README.md) de la crate `sesam-vitale`. La crate `fsv-sys` nécessite la présence des librairies fournies par le package FSV et la CryptolibCPS. Les instructions d'installation sont disponibles dans le [README](crates/sesam-vitale/README.md) de la crate `fsv-sys`.
#### Backend Hot-reload #### Backend Hot-reload

18
crates/fsv-sys/Cargo.toml Normal file
View File

@ -0,0 +1,18 @@
[package]
name = "fsv-sys"
version = "0.1.0"
edition = "2021"
links = "ssvlux64,ssvosx,Ssvw64"
# Linux: Libssvlux64.so
# Windows: Ssvw64.dll
# macOS: ssvosx.framework
[dependencies]
libc = "0.2.159"
libloading = "0.8.5"
thiserror.workspace = true
[build-dependencies]
bindgen = "0.70.1"

View File

@ -0,0 +1,32 @@
# État d'avancement de l'implémentation des bindings FSV
| Module | Progression |
|-------------|------------------------------------|
| [SSV](#ssv) | ![](https://geps.dev/progress/5) |
| [SGD](#sgd) | ![](https://geps.dev/progress/0) |
| [SRT](#srt) | ![](https://geps.dev/progress/0) |
| [STS](#sts) | ![](https://geps.dev/progress/0) |
## SSV
| Fonctions implémentées |
|------------------------|
| SSV_InitLIB2 |
| SSV_LireConfig |
| SSV_LireCartePS |
## SGD
| Fonctions implémentées |
|------------------------|
## SRT
| Fonctions implémentées |
|------------------------|
## STS
| Fonctions implémentées |
|------------------------|

36
crates/fsv-sys/README.md Normal file
View File

@ -0,0 +1,36 @@
# FSV-sys, bindings Rust pour le package FSV SESAM-Vitale
## Librairies FSV
### Versions supportées
| Version FSV |
|-------------|
| 1.40.14 |
| 1.40.13 |
### État d'avancement de l'implémentation des bindings FSV
Les détails de l'avancement de l'implémentation des bindings FSV sont donnés dans le fichier [PROGRESS.md](PROGRESS.md)
## Utilisation
### Pré-requis
- Installer le [package FSV](https://industriels.sesam-vitale.fr/group/fournitures-sesam-vitale)
- Les librairies dynamiques (.lib, .dll, ...) fournies ne sont pas installés dans les emplacements standard du système, il faudra donc configurer leur chemin d'installation dans le fichier de configuration `.env.build` (voir ci-dessous)
- Le détail des chemins d'installation est donné dans la documentation du package FSV `fsv-mi-004_pack-FSV1.40.14_V2.3.pdf`
- Linux - par défaut : `/opt/santesocial/fsv/1.40.13/lib`
- Windows - par défaut : `C:\Program Files\santesocial\santesocial\fsv\1.40.14\lib` (ou dans Program Files (x86) si c'est le package 32bits qui a été installé)
- Installer la [CryptolibCPS](https://industriels.sesam-vitale.fr/group/galss-cryptolib-cps)
- Ce package fourni également l'utilitaire "CPS Gestion" pour obtenir des informations sur le lecteur de carte, etc.
- Linux : `cpgeslux`
- Windows : `...`
## Développement
### Pré-requis
- Pour la génération des bindings lors de la phase de `build` à l'aide de `bindgen`, il est nécessaire d'avoir installé `clang` ([documentation](https://rust-lang.github.io/rust-bindgen/requirements.html)).

View File

@ -0,0 +1,7 @@
#ifndef WRAPPER_LINUX_H
#define WRAPPER_LINUX_H
#include "../../vendor/fsv/1.40.14.13/includes/SYS_DEF/linux/mc_sys_def.h"
#include "../../vendor/fsv/1.40.14.13/includes/SSV/pourFSV1.40.13/ssv.h"
#endif // WRAPPER_LINUX_H

View File

@ -0,0 +1,7 @@
#ifndef WRAPPER_MACOSX_H
#define WRAPPER_MACOSX_H
#include "../../vendor/fsv/1.40.14.13/includes/SYS_DEF/macosx/mc_sys_def.h"
#include "../../vendor/fsv/1.40.14.13/includes/SSV/pourFSV1.40.13/ssv.h"
#endif // WRAPPER_MACOSX_H

View File

@ -0,0 +1,7 @@
#ifndef WRAPPER_WIN_H
#define WRAPPER_WIN_H
#include "../../vendor/fsv/1.40.14.13/includes/SYS_DEF/win/mc_sys_def.h"
#include "../../vendor/fsv/1.40.14.13/includes/SSV/pourFSV1.40.13/ssv.h"
#endif // WRAPPER_WIN_H

View File

@ -0,0 +1,7 @@
#ifndef WRAPPER_LINUX_H
#define WRAPPER_LINUX_H
#include "../../vendor/fsv/1.40.14.13/includes/SYS_DEF/linux/mc_sys_def.h"
#include "../../vendor/fsv/1.40.14.13/includes/SSV/pourFSV1.40.14/ssv.h"
#endif // WRAPPER_LINUX_H

View File

@ -0,0 +1,7 @@
#ifndef WRAPPER_MACOSX_H
#define WRAPPER_MACOSX_H
#include "../../vendor/fsv/1.40.14.13/includes/SYS_DEF/macosx/mc_sys_def.h"
#include "../../vendor/fsv/1.40.14.13/includes/SSV/pourFSV1.40.14/ssv.h"
#endif // WRAPPER_MACOSX_H

View File

@ -0,0 +1,7 @@
#ifndef WRAPPER_WIN_H
#define WRAPPER_WIN_H
#include "../../vendor/fsv/1.40.14.13/includes/SYS_DEF/win/mc_sys_def.h"
#include "../../vendor/fsv/1.40.14.13/includes/SSV/pourFSV1.40.14/ssv.h"
#endif // WRAPPER_WIN_H

57
crates/fsv-sys/build.rs Normal file
View File

@ -0,0 +1,57 @@
use std::{env, path::PathBuf};
// Supported versions of FSV
static SUPPORTED_FSV_VERSIONS: [&str; 2] = ["1.40.14", "1.40.13"];
fn build_bindings(version: &str, target_code: &str) -> PathBuf {
let target = env::var("TARGET").expect("TARGET not set");
let wrapper_path = format!("bindgen-wrappers/{}/wrapper.{}.h", version, target_code);
let bindings = bindgen::Builder::default()
// The input header we would like to generate
// bindings for.
.header(wrapper_path)
// To generate the bindings for specific target
.clang_arg(format!("--target={}", target))
// Limit the bindings generation to the SSV_ prefix
.allowlist_item("SSV_.*")
// Tell cargo to invalidate the built crate whenever any of the
// included header files changed.
.parse_callbacks(Box::new(bindgen::CargoCallbacks::new()))
// Finish the builder and generate the bindings.
.generate()
// Unwrap the Result and panic on failure.
.expect("Unable to generate bindings");
// Write the bindings to the $OUT_DIR/bindings.rs file.
let out_dir = PathBuf::from(env::var("OUT_DIR").unwrap());
let out_file = format!("bindings_{}.rs", version);
let out_path = out_dir.join(out_file);
bindings
.write_to_file(&out_path)
.expect("Couldn't write bindings! ");
out_path
}
fn get_target_code() -> String {
// Use CARGO configuration env Variable, because !cfg(target_os) is not available in build.rs
// Source: https://kazlauskas.me/entries/writing-proper-buildrs-scripts
let target_os = env::var("CARGO_CFG_TARGET_OS");
match target_os.as_ref().map(|x| &**x) {
Ok("linux") => "linux", // lib_name = "ssvlux64";
Ok("windows") => "win", // lib_name = "Ssvw64";
Ok("macos") => "macosx", // lib_name = "ssvosx";
tos => panic!("Unsupported target_os {:?}", tos),
}
.to_string()
}
fn main() {
let target_code = get_target_code();
// Build the bindings for each supported version of FSV
let bindings_paths: Vec<PathBuf> = SUPPORTED_FSV_VERSIONS
.iter()
.map(|version| build_bindings(version, &target_code))
.collect();
println!("FSV bindings generated: {:#?}", bindings_paths);
}

View File

@ -0,0 +1,12 @@
#![allow(non_upper_case_globals)]
#![allow(non_camel_case_types)]
#![allow(non_snake_case)]
#![allow(unused)]
pub mod BINDINGS_V1_40_14 {
include!(concat!(env!("OUT_DIR"), "/bindings_1.40.14.rs"));
}
pub mod BINDINGS_V1_40_13 {
include!(concat!(env!("OUT_DIR"), "/bindings_1.40.13.rs"));
}

212
crates/fsv-sys/src/lib.rs Normal file
View File

@ -0,0 +1,212 @@
#![allow(non_snake_case)]
use std::marker::PhantomData;
mod bindings;
use bindings::*;
#[derive(Debug, Clone)]
pub enum SupportedFsvVersion {
V1_40_14, // 1.40.14
V1_40_13, // 1.40.13
}
impl SupportedFsvVersion {
fn as_str(&self) -> &'static str {
match self {
Self::V1_40_14 => "1.40.14",
Self::V1_40_13 => "1.40.13",
}
}
}
#[derive(thiserror::Error, Debug)]
pub enum Error {
#[error(transparent)]
LibLoading(#[from] libloading::Error),
#[error("Symbol missing: {0}")]
SymbolMissing(&'static str),
}
/// Macro to generate a function that implements a call to an external function in BINDINGS
macro_rules! ssv_function {
($binding:ty, $func_name:ident, {$($arg_name:ident: $arg_type:ty),*}) => {
/// # Safety
/// This function is unsafe because it calls an external function through FFI.
/// The caller must ensure that the provided arguments are valid and that the
/// external function is safe to call.
pub unsafe fn $func_name(&self, $($arg_name: $arg_type),*) -> Result<u16, Error> {
let symbol_name = match stringify!($binding)
.split(&[' ', ':'])
.last() {
Some(name) => name,
None => return Err(Error::SymbolMissing(stringify!($binding))),
};
let func_struct: libloading::Symbol<'_, $binding> =
unsafe { self.library.get(symbol_name.as_bytes())? };
let func = match *func_struct {
Some(func) => func,
None => return Err(Error::SymbolMissing(stringify!($binding))),
};
Ok(func($($arg_name),*))
}
};
}
/// `sealed::Sealed` trait is used to prevent external crates from implementing the LibVersion trait.
mod sealed { pub trait Sealed {}}
/// Wrapper around the SESAM-VITALE library
/// This struct is responsible for loading the library and providing an interface to call its functions.
/// The library is loaded at creation and kept in memory until the struct is dropped.
pub trait SSVLibraryCommon {
fn new(path: &str) -> Result<Self, Error> where Self: Sized;
}
pub trait SSVLibraryVersion: sealed::Sealed {}
pub struct V1_40_13 {}
impl sealed::Sealed for V1_40_13 {}
impl SSVLibraryVersion for V1_40_13 {}
pub struct V1_40_14 {}
impl sealed::Sealed for V1_40_14 {}
impl SSVLibraryVersion for V1_40_14 {}
pub struct SSVLibrary<Version: SSVLibraryVersion> {
_version: PhantomData<Version>,
library: libloading::Library,
}
impl<Version: SSVLibraryVersion> SSVLibraryCommon for SSVLibrary<Version> {
fn new(path: &str) -> Result<Self, Error> {
let library = unsafe { libloading::Library::new(path)?};
Ok(Self {
_version: PhantomData,
library
})
}
}
impl SSVLibrary<V1_40_14> {
pub fn library(&self) -> &libloading::Library {
&self.library
}
ssv_function!(BINDINGS_V1_40_14::SSV_InitLIB2, ssv_init_lib2, {
pcFichierSesam: *const i8
});
ssv_function!(BINDINGS_V1_40_14::SSV_LireConfig, ssv_lire_config, {
pZDataOut: *mut *mut libc::c_void,
psTailleDataOut: *mut usize
});
ssv_function!(BINDINGS_V1_40_14::SSV_LireCartePS, ssv_lire_carte_ps, {
NomRessourcePS: *const i8,
NomRessourceLecteur: *const i8,
CodePorteurPS: *const i8,
pZDataOut: *mut *mut libc::c_void,
pTailleZone: *mut usize
});
}
impl SSVLibrary<V1_40_13> {
ssv_function!(BINDINGS_V1_40_13::SSV_InitLIB2, ssv_init_lib2, {
pcFichierSesam: *const i8
});
ssv_function!(BINDINGS_V1_40_13::SSV_LireConfig, ssv_lire_config, {
pZDataOut: *mut *mut libc::c_void,
psTailleDataOut: *mut usize
});
ssv_function!(BINDINGS_V1_40_13::SSV_LireCartePS, ssv_lire_carte_ps, {
NomRessourcePS: *const i8,
NomRessourceLecteur: *const i8,
CodePorteurPS: *const i8,
pZDataOut: *mut *mut libc::c_void,
pTailleZone: *mut usize
});
}
pub fn get_library_path(version: &SupportedFsvVersion) -> String {
let root_path = get_library_root_path();
let library_name = get_library_name();
let version = version.as_str();
format!("{root_path}/{version}/lib/{library_name}")
}
pub fn sesam_ini_path(version: &SupportedFsvVersion) -> String {
let root_path = get_sesam_ini_root_path();
let version = version.as_str();
format!("{root_path}/{version}/conf/sesam.ini")
}
fn get_library_name() -> &'static str {
// TODO : Use libloading::library_filename to get platform-specific filename ?
"libssvlux64.so"
}
fn get_library_root_path() -> &'static str {
"/opt/santesocial/fsv"
}
fn get_sesam_ini_root_path() -> &'static str {
"/etc/opt/santesocial/fsv"
}
#[cfg(test)]
mod test {
use std::{ffi::CString, ptr};
use super::*;
#[test]
fn test_initlib2() {
let lib_path = &get_library_path(&SupportedFsvVersion::V1_40_13);
let ssv_library = SSVLibrary::<V1_40_13>::new(lib_path).expect("SSVLibrary::new failed");
let sesam_ini_str =
CString::new(sesam_ini_path(&SupportedFsvVersion::V1_40_13)).expect("CString::new failed");
let result = unsafe { ssv_library.ssv_init_lib2(sesam_ini_str.as_ptr()) }.unwrap();
assert_eq!(result, 0);
}
#[test]
fn test_lire_config_and_carte_ps() {
let lib_path = &get_library_path(&SupportedFsvVersion::V1_40_13);
let ssv_library = SSVLibrary::<V1_40_13>::new(lib_path).expect("SSVLibrary::new failed");
let sesam_ini_str =
CString::new(sesam_ini_path(&SupportedFsvVersion::V1_40_13)).expect("CString::new failed");
let result = unsafe { ssv_library.ssv_init_lib2(sesam_ini_str.as_ptr()) }.unwrap();
assert_eq!(result, 0);
let mut buffer_ptr: *mut libc::c_void = ptr::null_mut();
let mut size: libc::size_t = 0;
let result = unsafe { ssv_library.ssv_lire_config(&mut buffer_ptr, &mut size) }.unwrap();
assert_eq!(result, 0);
unsafe { libc::free(buffer_ptr) };
let nom_ressource_ps =
CString::new("Gemalto PC Twin Reader (645D94C3) 00 00").expect("CString::new failed");
let nom_ressource_lecteur =
CString::new("Gemalto PC Twin Reader (645D94C3) 00 00").expect("CString::new failed");
let code_porteur_ps = CString::new("1234").expect("CString::new failed");
let mut buffer_ptr: *mut libc::c_void = ptr::null_mut();
let mut size: libc::size_t = 0;
let result = unsafe {
ssv_library.ssv_lire_carte_ps(
nom_ressource_ps.as_ptr(),
nom_ressource_lecteur.as_ptr(),
code_porteur_ps.as_ptr(),
&mut buffer_ptr,
&mut size,
)
}
.unwrap();
assert_eq!(result, 0);
unsafe { libc::free(buffer_ptr) };
}
}

View File

@ -0,0 +1,123 @@
/*
* -------------------------------------------------------------------
* (c) 2001 GIE SESAM-VITALE
*
* PROJET : Services de Gestion de Donnees
*
* FICHIER : sgd.h (v4)
*
* Declaration des prototypes des fonctions SGD pour les progiciels.
* -------------------------------------------------------------------
*/
#ifndef __SGD_H__
#define __SGD_H__
#ifdef __cplusplus
extern "C" {
#endif
/*
* Inclusions
*/
#include <stddef.h>
#include "mc_sys_def.h"
/* Reservation d'un session d'echange. */
extern unsigned short API_ENTRY SGD_ReserverSession (size_t Taille, unsigned short* NumeroSession);
/* Redimensionnement d'une zone d'entree interne. */
extern unsigned short API_ENTRY
SGD_RedimensionnerBuffer (unsigned short NumeroSession,
size_t NouvelleTaille);
/* Liberation d'une session d'echange. */
extern unsigned short API_ENTRY
SGD_LibererSession (unsigned short NumeroSession);
/* Ajout d'un groupe. */
extern unsigned short API_ENTRY
SGD_AjouterGroupe (unsigned short NumeroSession,
unsigned short IdGroupe);
/* Ajout d'un champ. */
extern unsigned short API_ENTRY
SGD_AjouterChamp (unsigned short NumeroSession,
const char* ValeurChamp);
/* Ajout d'un champ d'octets. */
extern unsigned short API_ENTRY
SGD_AjouterChampBin (unsigned short NumeroSession,
const char* ValeurChamp,
size_t TailleChamp);
/* Ajout d'un champ d'octets d'un Fichier. */
extern unsigned short API_ENTRY
SGD_AjouterChampFichier (unsigned short NumeroSession,
const char* NomFichier);
/* Lecture du numero du groupe suivant. */
extern unsigned short API_ENTRY
SGD_LireGroupeSuivant (unsigned short NumeroSession,
unsigned short IdGroupeCourant,
unsigned short OccurrenceGroupeCourant,
unsigned short* IdGroupeSuivant,
unsigned short* OccurrenceGroupeSuivant);
/* Lecture d'un champ. */
extern unsigned short API_ENTRY
SGD_LireChamp (unsigned short NumeroSession,
unsigned short IdGroupe,
unsigned short OccurrenceGroupe,
unsigned short NumeroChamp,
char* ValeurChamp,
size_t* TailleMax);
/* Lecture d'un champ d'octets. */
extern unsigned short API_ENTRY
SGD_LireChampBin (unsigned short NumeroSession,
unsigned short IdGroupe,
unsigned short OccurrenceGroupe,
unsigned short NumeroChamp,
char* ValeurChamp,
size_t* TailleMax);
/* Lecture d'un champ vers un fichier. */
extern unsigned short API_ENTRY
SGD_LireChampFichier (unsigned short NumeroSession,
unsigned short IdGroupe,
unsigned short OccurrenceGroupe,
unsigned short NumeroChamp,
const char* NomFichier);
/* Activation de la trace. */
extern unsigned short API_ENTRY
SGD_InitTrace (const char* NomFichier,
const char* ModeOuverture,
unsigned short Module,
unsigned char Niveau);
/*Initialisation de SGD*/
unsigned short API_ENTRY SGD_Init(const char *fichierSesam);
/* Transmission de la zone d'entrée. */
extern unsigned short API_ENTRY SGD_LireZoneIn(unsigned short NumeroSession,
void** ZDonneesEntree,
size_t* TailleDonneesEntree);
/* Transmission de la zone de sortie. */
typedef void (API_ENTRY *LibererZoneMem) (void* Zone);
extern unsigned short API_ENTRY SGD_EcrireZoneOut(unsigned short NumeroSession,
void* ZDonneesSortie,
size_t TailleDonneesSortie,
LibererZoneMem Fonction);
#ifdef __cplusplus
}
#endif
#endif

View File

@ -0,0 +1,176 @@
/*
* -------------------------------------------------------------------
* (c) 2001-2003 GIE SESAM-VITALE
*
* PROJET : Services Reglementation et Tarification
*
* FICHIER : srt.h (v5)
*
* Declaration des prototypes des fonctions SRT
* -------------------------------------------------------------------
*/
#ifndef __SRT_H__
#define __SRT_H__
#ifdef __cplusplus
extern "C" {
#endif
/*
* Inclusions
*/
#include <stddef.h>
/* Inclure le fichier de déclarations spécifiques système : win32def.h, macosdef.h, unixdef.h, etc. */
/*
* Declarations des fonctions publiques "standards"
*/
/* Recherche de codes CCAM par mot cle. */
typedef unsigned short (API_ENTRY FARPTR SRT_RechercherParMotCle)
(const char* MotCle,
unsigned long CadreRecherche,
void** ZDonneesSortie,
size_t* TailleDonneesSortie);
/* Recherche de codes CCAM par filtre. */
typedef unsigned short (API_ENTRY FARPTR SRT_RechercherParFiltre)
(const char* Filtre,
void** ZDonneesSortie,
size_t* TailleDonneesSortie);
/* Consultation de donnees CCAM. */
typedef unsigned short (API_ENTRY FARPTR SRT_ConsulterDonnee)
(const char* Identifiant,
const char* DateReference,
void* ZDonneesEntree,
size_t TailleDonneesEntree,
void** ZDonneesSortie,
size_t* TailleDonneesSortie);
/* Modification d'un champ mono-occurrent. */
typedef unsigned short (API_ENTRY FARPTR SRT_ModifierDonnee)
(const char* Identifiant,
const char* DateEffet,
void* ZDonneesEntree,
size_t TailleDonneesEntree);
/* Annulation d'une modification */
typedef unsigned short (API_ENTRY FARPTR SRT_AnnulerModification)
(const char* Identifiant,
void* ZDonneesEntree,
size_t TailleDonneesEntree);
/* Controle de la validite d'une ou plusieurs donnees. */
typedef unsigned short (API_ENTRY FARPTR SRT_ControlerDonnees)
(const char* Identifiant,
const char* DateReference,
void* ZDonneesEntree,
size_t TailleDonneesEntree,
unsigned char* Resultat);
/* Regle de gestion ou de tarification. */
typedef unsigned short (API_ENTRY FARPTR SRT_AppliquerRegle)
(const char* Identifiant,
void* ZDonneesEntree,
size_t TailleDonneesEntree,
void** ZDonneesSortie,
size_t* TailleDonneesSortie);
/* Controle complet. */
typedef unsigned short (API_ENTRY FARPTR SRT_ControleComplet)
(void* ZDonneesEntree,
size_t TailleDonneesEntree,
void** ZDonneesSortie,
size_t* TailleDonneesSortie);
/* Chargement du referentiel. */
typedef unsigned short (API_ENTRY FARPTR SRT_InitLIB2)(const char* SesamIni);
/* Dechargement du referentiel. */
typedef unsigned short (API_ENTRY FARPTR SRT_TermLIB)(void);
/* Sauvegarde des modifications. */
typedef unsigned short (API_ENTRY FARPTR SRT_SauvegarderReferentiel)(const char* Commentaire);
/* Version du referentiel. */
typedef unsigned short (API_ENTRY FARPTR SRT_LireVersion)
(void** ZDonneesSortie,
size_t* TailleDonneesSortie);
/* Activation de la trace. */
typedef unsigned short (API_ENTRY FARPTR SRT_InitTrace)
(const char* pathConf,
const char* ModeOuverture,
unsigned short Module,
unsigned char Niveau);
/* Allocation d'une zone memoire. */
typedef unsigned short (API_ENTRY FARPTR SRT_AllouerZoneMem)
(void** Zone,
size_t Taille);
/* Allocation d'une zone memoire. */
typedef void (API_ENTRY FARPTR SRT_LibererZoneMem) (void* Zone);
/*
* Declarations des fonctions publiques "simplifiees"
*/
/* Recherche de codes CCAM par mot cle. */
typedef unsigned short (API_ENTRY FARPTR SRT_RechercherParMotCle_S)
(const char* MotCle,
unsigned long CadreRecherche,
unsigned short NumeroSession);
/* Recherche de codes CCAM par filtre. */
typedef unsigned short (API_ENTRY FARPTR SRT_RechercherParFiltre_S)
(const char* Filtre,
unsigned short NumeroSession);
/* Consultation de donnees CCAM. */
typedef unsigned short (API_ENTRY FARPTR SRT_ConsulterDonnee_S)
(const char* Identifiant,
const char* DateReference,
unsigned short NumeroSession);
/* Modification d'un champ mono-occurrent. */
typedef unsigned short (API_ENTRY FARPTR SRT_ModifierDonnee_S)
(const char* Identifiant,
const char* DateEffet,
unsigned short NumeroSession);
/* Annulation des modifications d'une donnee. */
typedef unsigned short (API_ENTRY FARPTR SRT_AnnulerModification_S)
(const char* Identifiant,
unsigned short NumeroSession);
/* Controle de la validite d'une ou plusieurs donnees. */
typedef unsigned short (API_ENTRY FARPTR SRT_ControlerDonnees_S)
(const char* Identifiant,
const char* DateReference,
unsigned short NumeroSession,
unsigned char* Resultat);
/* Regle de gestion ou de tarification. */
typedef unsigned short (API_ENTRY FARPTR SRT_AppliquerRegle_S)
(const char* Identifiant,
unsigned short NumeroSession);
/* Controle complet. */
typedef unsigned short (API_ENTRY FARPTR SRT_ControleComplet_S)
(unsigned short NumeroSession);
/* Version du referentiel. */
typedef unsigned short (API_ENTRY FARPTR SRT_LireVersion_S)
(unsigned short NumeroSession);
#ifdef __cplusplus
}
#endif
#endif

View File

@ -0,0 +1,327 @@
/*
* -------------------------------------------------------------------
* (c) 2001-2003 GIE SESAM-VITALE
*
* PROJET : Services SESAM Vitale
*
* FICHIER : ssv.h
*
* Declaration des prototypes des fonctions SSV
* -------------------------------------------------------------------
*/
#ifndef __SSV_H__
#define __SSV_H__
#ifdef __cplusplus
extern "C" {
#endif
/*
* Inclusions
*/
#include <stddef.h>
/* Inclure le fichier de déclarations spécifiques système :
win32def.h, macosdef.h, aixdef.h, etc. */
/****** FONCTIONS STANDARDS *********/
typedef unsigned short (API_ENTRY FARPTR SSV_TraduireARL)
(short NbZDataIn,
void FARPTR FARPTR TZDataIn,
size_t FARPTR TTailleZoneIn,
void FARPTR FARPTR pZDataOut,
size_t FARPTR pTailleZoneOut);
typedef unsigned short (API_ENTRY FARPTR SSV_LireCartePS)
(const char FARPTR NomRessourcePS,
const char FARPTR NomRessourceLecteur,
const char FARPTR CodePorteurPS,
void FARPTR FARPTR pZDataOut,
size_t FARPTR pTailleZone);
typedef unsigned short (API_ENTRY FARPTR SSV_LireConfig)
(void FARPTR FARPTR pZDataOut,
size_t FARPTR psTailleDataOut);
typedef unsigned short (API_ENTRY FARPTR SSV_FormaterFactures)
(const char FARPTR NomRessourcePS,
const char FARPTR NomRessourceLecteur,
const char FARPTR CodePorteurPS,
char cFactureACreer,
char cModeSecur,
void FARPTR pZDataIn,
size_t TailleDataIn,
void FARPTR FARPTR pZDataOut,
size_t FARPTR pTailleZone);
typedef unsigned short (API_ENTRY FARPTR SSV_FormaterLot)
( const char FARPTR NomRessourcePS,
const char FARPTR NomRessourceLecteur,
const char FARPTR CodePorteurPS,
short NBZDataIn,
void FARPTR FARPTR TZDataIn,
size_t FARPTR TTailleZoneIn,
short FARPTR pNbZDataOut,
void FARPTR FARPTR TZDataOut,
size_t FARPTR TTailleZoneOut);
typedef unsigned short (API_ENTRY FARPTR SSV_FormaterFichier)
(void FARPTR pZDataIn,size_t TailleDataIn,
void FARPTR FARPTR pZDataOut,size_t FARPTR pTailleZone);
typedef unsigned short (API_ENTRY FARPTR SSV_InitTrace)
(char FARPTR pathConf, char FARPTR ModeOuverture,
unsigned short Module, unsigned char Niveau);
typedef unsigned short (API_ENTRY FARPTR SSV_AllouerZoneMem)
(void FARPTR FARPTR pZDataIn,
size_t taille);
typedef void (API_ENTRY FARPTR SSV_LibererZoneMem)
(void FARPTR pZone);
typedef unsigned short (API_ENTRY FARPTR SSV_MajDateLecteur)
(const char FARPTR pcNomRessourceLecteur,
const char FARPTR pcDateHeure);
typedef unsigned short (API_ENTRY FARPTR SSV_LireDateLecteur)
(const char FARPTR pcNomRessourceLecteur,
char FARPTR pcDateHeure);
typedef unsigned short (API_ENTRY FARPTR SSV_LireDroitsVitale)
(const char FARPTR NomRessourcePS,
const char FARPTR NomRessourceLecteur,
const char FARPTR CodePorteurPS,
const char FARPTR DateConsultation,
void FARPTR FARPTR pZDataOut,
size_t FARPTR pTailleZone);
typedef unsigned short (API_ENTRY FARPTR SSV_IdentifierTLA)
(const char FARPTR pcNomRessourceLecteur,
const char FARPTR NumVersionCDC,
void FARPTR FARPTR pZDataOut,
size_t FARPTR tailleDataOut);
typedef unsigned short (API_ENTRY FARPTR SSV_DechargerFacturesPdT)
( const char FARPTR NomRessourcePS,
const char FARPTR NomRessourceLecteur,
const char FARPTR CodePorteurPS,
const char FARPTR pcNumFact,
short sNbZDataIn,
void FARPTR FARPTR pvTZDataIn,
size_t FARPTR psTTailleDataIn,
short FARPTR pNbZDataOut,
void FARPTR FARPTR TZDataOut,
size_t FARPTR TTailleZoneOut);
typedef unsigned short (API_ENTRY FARPTR SSV_DechargerFSETLA)
( const char FARPTR NomRessourcePS,
const char FARPTR NomRessourceLecteur,
const char FARPTR CodePorteurPS,
const char FARPTR pcNumFact,
short FARPTR pNbZDataOut,
void FARPTR FARPTR TZDataOut,
size_t FARPTR TTailleZoneOut);
typedef unsigned short (API_ENTRY FARPTR SSV_DechargerFSETLANC)
( const char FARPTR NomRessourcePS,
const char FARPTR NomRessourceLecteur,
const char FARPTR CodePorteurPS,
const char FARPTR pcNumFact,
short FARPTR pNbZDataOut,
void FARPTR FARPTR TZDataOut,
size_t FARPTR TTailleZoneOut);
typedef unsigned short (API_ENTRY FARPTR SSV_EffacerTLA)
(const char FARPTR NomRessourcePS,
const char FARPTR NomRessourceLecteur,
const char FARPTR CodePorteurPS,
const char FARPTR cNumFacturation,
const char FARPTR cTypeDonnee);
typedef unsigned short (API_ENTRY FARPTR SSV_ChargerFacturesPdT)
(const char FARPTR pcNomRessourceLecteur,
const char FARPTR pcNumFacturation,
short sNbZDataIn,
void FARPTR FARPTR pvTZDataIn,
size_t FARPTR psTTailleDataIn,
short FARPTR pNbZDataOut,
void FARPTR FARPTR TZDataOut,
size_t FARPTR TTailleZoneOut);
typedef unsigned short (API_ENTRY FARPTR SSV_ChargerAppli)
(const char FARPTR pcNomRessourceLecteur,
short sNbZDataIn,
void FARPTR FARPTR pvTZDataIn,
size_t FARPTR psTTailleDataIn);
typedef unsigned short (API_ENTRY FARPTR SSV_ChargerDonneesTLA)
(const char FARPTR pcNomRessourceLecteur,
short sNbZDataIn,
void FARPTR FARPTR pvTZDataIn,
size_t FARPTR psTTailleDataIn);
typedef unsigned short (API_ENTRY FARPTR SSV_DechargerBeneficiaires)
(const char FARPTR NomRessourcePS,
const char FARPTR NomRessourceLecteur,
const char FARPTR CodePorteurPS,
const char FARPTR cNumFacturation,
short FARPTR sNbZDataOut,
void FARPTR FARPTR pTZDataOut,
size_t FARPTR sTTailleDataOut);
typedef unsigned short (API_ENTRY FARPTR SSV_TraduireFSE)
(void FARPTR pZDataIn,
size_t TailleDataIn,
void FARPTR FARPTR pZDataOut,
size_t FARPTR pTailleZone);
typedef unsigned short (API_ENTRY FARPTR SSV_SecuriserFacture)
(const char FARPTR pcNomRessourcePS,
const char FARPTR pcNomRessourceLecteur,
const char FARPTR pcCodePorteurPS,
char cNologSituation,
const char FARPTR pcNumFact,
void FARPTR pvDataIn,
size_t szTailleDataIn ,
void FARPTR FARPTR pvDataOut,
size_t FARPTR pszTailleDataOut);
typedef unsigned short (API_ENTRY FARPTR SSV_InitLIB2) (const char FARPTR pcFichierSesam);
typedef unsigned short (API_ENTRY FARPTR SSV_TermLIB)();
/****** FONCTIONS SIMPLIFIEES *********/
typedef unsigned short (API_ENTRY FARPTR SIS_TraduireARL)
(unsigned short numeroSession);
typedef unsigned short (API_ENTRY FARPTR SIS_LireCartePS)
(const char FARPTR NomRessourcePS,
const char FARPTR NomRessourceLecteur,
const char FARPTR CodePorteurPS,
unsigned short numeroSession);
typedef unsigned short (API_ENTRY FARPTR SIS_LireConfig)
(unsigned short numeroSession);
typedef unsigned short (API_ENTRY FARPTR SIS_FormaterFactures)
(const char FARPTR NomRessourcePS,
const char FARPTR NomRessourceLecteur,
const char FARPTR CodePorteurPS,
char cFacturesACreer,
char ModeSecur,
unsigned short numeroSession);
typedef unsigned short (API_ENTRY FARPTR SIS_FormaterLot)
( const char FARPTR NomRessourcePS,
const char FARPTR NomRessourceLecteur,
const char FARPTR CodePorteurPS,
unsigned short numeroSession);
typedef unsigned short (API_ENTRY FARPTR SIS_FormaterFichier)
(unsigned short numeroSession);
typedef unsigned short (API_ENTRY FARPTR SIS_InitTrace)
(char FARPTR NomFichier, char FARPTR ModeOuverture,
unsigned short Module, unsigned char Niveau);
typedef unsigned short (API_ENTRY FARPTR SIS_MajDateLecteur)
(const char FARPTR pcNomRessourceLecteur,
const char FARPTR pcDateHeure);
typedef unsigned short (API_ENTRY FARPTR SIS_LireDateLecteur)
(const char FARPTR pcNomRessourceLecteur,
char FARPTR pcDateHeure);
typedef unsigned short (API_ENTRY FARPTR SIS_LireDroitsVitale)
(const char FARPTR NomRessourcePS,
const char FARPTR NomRessourceLecteur,
const char FARPTR CodePorteurPS,
const char FARPTR DateConsultation,
unsigned short numeroSession);
typedef unsigned short (API_ENTRY FARPTR SIS_IdentifierTLA)
(const char FARPTR pcNomRessourceLecteur,
const char FARPTR NumVersionCDC,
unsigned short numeroSession );
typedef unsigned short (API_ENTRY FARPTR SIS_DechargerFacturesPdT)
( const char FARPTR NomRessourcePS,
const char FARPTR NomRessourceLecteur,
const char FARPTR CodePorteurPS,
const char FARPTR pcNumFact,
unsigned short numeroSession);
typedef unsigned short (API_ENTRY FARPTR SIS_DechargerFSETLA)
(const char FARPTR NomRessourcePS,
const char FARPTR NomRessourceLecteur,
const char FARPTR CodePorteurPS,
const char FARPTR pcNumFact,
unsigned short numeroSession);
typedef unsigned short (API_ENTRY FARPTR SIS_DechargerFSETLANC)
(const char FARPTR NomRessourcePS,
const char FARPTR NomRessourceLecteur,
const char FARPTR CodePorteurPS,
const char FARPTR pcNumFact,
unsigned short numeroSession);
typedef unsigned short (API_ENTRY FARPTR SIS_EffacerTLA)
(const char FARPTR NomRessourcePS,
const char FARPTR NomRessourceLecteur,
const char FARPTR CodePorteurPS,
const char FARPTR cNumFacturation,
const char FARPTR cTypeDonnee);
typedef unsigned short (API_ENTRY FARPTR SIS_ChargerFacturesPdT)
(const char FARPTR pcNomRessourceLecteur,
const char FARPTR pcNumFacturation,
unsigned short numeroSession);
typedef unsigned short (API_ENTRY FARPTR SIS_ChargerAppli)
(const char FARPTR pcNomRessourceLecteur,
unsigned short numeroSession);
typedef unsigned short (API_ENTRY FARPTR SIS_ChargerDonneesTLA)
(const char FARPTR pcNomRessourceLecteur,
unsigned short numeroSession);
typedef unsigned short (API_ENTRY FARPTR SIS_DechargerBeneficiaires)
( const char FARPTR NomRessourcePS,
const char FARPTR NomRessourceLecteur,
const char FARPTR CodePorteurPS,
const char FARPTR cNumFacturation,
unsigned short numeroSession);
typedef unsigned short (API_ENTRY FARPTR SIS_TraduireFSE)
(unsigned short numeroSession);
typedef unsigned short (API_ENTRY FARPTR SIS_SecuriserFacture)
( const char FARPTR pcNomRessourcePS,
const char FARPTR pcNomRessourceLecteur,
const char FARPTR pcCodePorteurPS,
char cNologSituation,
const char FARPTR pcNumFact,
unsigned short numeroSession);
#ifdef __cplusplus
}
#endif
#endif

View File

@ -0,0 +1,412 @@
/*
* -------------------------------------------------------------------
* (c) 2001-2003 GIE SESAM-VITALE
*
* PROJET : Services SESAM Vitale
*
* FICHIER : ssv.h
*
* Declaration des prototypes des fonctions SSV
* -------------------------------------------------------------------
*/
#ifndef __SSV_H__
#define __SSV_H__
#ifdef __cplusplus
extern "C" {
#endif
/*
* Inclusions
*/
#include <stddef.h>
/* Inclure le fichier de déclarations spécifiques système :
win32def.h, macosdef.h, aixdef.h, etc. */
/****** FONCTIONS STANDARDS *********/
typedef unsigned short (API_ENTRY FARPTR SSV_TraduireARL)
(short NbZDataIn,
void FARPTR FARPTR TZDataIn,
size_t FARPTR TTailleZoneIn,
void FARPTR FARPTR pZDataOut,
size_t FARPTR pTailleZoneOut);
typedef unsigned short (API_ENTRY FARPTR SSV_LireCartePS)
(const char FARPTR NomRessourcePS,
const char FARPTR NomRessourceLecteur,
const char FARPTR CodePorteurPS,
void FARPTR FARPTR pZDataOut,
size_t FARPTR pTailleZone);
typedef unsigned short (API_ENTRY FARPTR SSV_LireConfig)
(void FARPTR FARPTR pZDataOut,
size_t FARPTR psTailleDataOut);
typedef unsigned short (API_ENTRY FARPTR SSV_FormaterFactures)
(char cFactureACreer,
char cModeSecur,
char cTypeFlux,
void FARPTR pZDataIn,
size_t TailleDataIn,
void FARPTR FARPTR pZDataOut,
size_t FARPTR pTailleZone);
typedef unsigned short (API_ENTRY FARPTR SSV_ChiffrerFacture)
(void * pZDataIn,
size_t TailleDataIn,
void * * pZDataOut,
size_t * pTailleZone);
typedef unsigned short (API_ENTRY FARPTR SSV_SignerFactureVitale)
(const char * pcNomRessourceVitale,
void * pZDataIn,
size_t szTailleDataIn,
void * * pZDataOut,
size_t * pszTailleZone);
typedef unsigned short (API_ENTRY FARPTR SSV_CalculerHashFactureAssure)
(const char * pcNumSerie,
void * pZDataIn,
size_t szTailleDataIn,
void * * pZDataOut,
size_t * pszTailleZone);
typedef unsigned short (API_ENTRY FARPTR SSV_AjouterSignatureAssureDansFacture)
(void * pZDataIn,
size_t szTailleDataIn,
void * * pZDataOut,
size_t * pszTailleZone);
typedef unsigned short (API_ENTRY FARPTR SSV_SignerFactureCPS)
(const char * pcNomRessourcePS,
const char * pcNomRessourceLecteur,
const char * pcCodePorteurPS,
char cNologSituation,
void * pZDataIn,
size_t szTailleDataIn,
void * * pZDataOut,
size_t * pszTailleZone);
typedef unsigned short (API_ENTRY SSV_CalculerHashFacturePS)
(const char * pcNumSerieCPS,
void * pZDataIn,
size_t usTailleDataIn,
void * * pZDataOut,
size_t * pusTailleZone);
typedef unsigned short (API_ENTRY SSV_AjouterSignaturePSFacture)
(void * pZDataIn,
size_t szTailleDataIn,
void * * pZDataOut,
size_t * pszTailleZone);
typedef unsigned short (API_ENTRY FARPTR SSV_SignerLotCPS)
(const char * pcNomRessourcePS,
const char * pcNomRessourceLecteur,
const char * pcCodePorteurPS,
char cNologSituation,
void * pZDataIn,
size_t szTailleDataIn,
void * * pZDataOut,
size_t * pszTailleZone);
typedef unsigned short (API_ENTRY FARPTR SSV_FormaterLot)
( short NBZDataIn,
void FARPTR FARPTR TZDataIn,
size_t FARPTR TTailleZoneIn,
short FARPTR pNbZDataOut,
void FARPTR FARPTR TZDataOut,
size_t FARPTR TTailleZoneOut);
typedef unsigned short (API_ENTRY FARPTR SSV_FormaterFichier)
(void FARPTR pZDataIn,size_t TailleDataIn,
void FARPTR FARPTR pZDataOut,size_t FARPTR pTailleZone);
typedef unsigned short (API_ENTRY FARPTR SSV_InitTrace)
(char FARPTR pathConf, char FARPTR ModeOuverture,
unsigned short Module, unsigned char Niveau);
typedef unsigned short (API_ENTRY FARPTR SSV_AllouerZoneMem)
(void FARPTR FARPTR pZDataIn,
size_t taille);
typedef void (API_ENTRY FARPTR SSV_LibererZoneMem)
(void FARPTR pZone);
typedef unsigned short (API_ENTRY FARPTR SSV_MajDateLecteur)
(const char FARPTR pcNomRessourceLecteur,
const char FARPTR pcDateHeure);
typedef unsigned short (API_ENTRY FARPTR SSV_LireDateLecteur)
(const char FARPTR pcNomRessourceLecteur,
char FARPTR pcDateHeure);
typedef unsigned short (API_ENTRY FARPTR SSV_LireDroitsVitale)
(const char FARPTR NomRessourcePS,
const char FARPTR NomRessourceLecteur,
const char FARPTR CodePorteurPS,
const char FARPTR DateConsultation,
void FARPTR FARPTR pZDataOut,
size_t FARPTR pTailleZone);
typedef unsigned short (API_ENTRY FARPTR SSV_IdentifierTLA)
(const char FARPTR pcNomRessourceLecteur,
const char FARPTR NumVersionCDC,
void FARPTR FARPTR pZDataOut,
size_t FARPTR tailleDataOut);
typedef unsigned short (API_ENTRY FARPTR SSV_DechargerFacturesPdT)
( const char FARPTR NomRessourcePS,
const char FARPTR NomRessourceLecteur,
const char FARPTR CodePorteurPS,
const char FARPTR pcNumFact,
short sNbZDataIn,
void FARPTR FARPTR pvTZDataIn,
size_t FARPTR psTTailleDataIn,
short FARPTR pNbZDataOut,
void FARPTR FARPTR TZDataOut,
size_t FARPTR TTailleZoneOut);
typedef unsigned short (API_ENTRY FARPTR SSV_DechargerFSETLA)
( const char FARPTR NomRessourcePS,
const char FARPTR NomRessourceLecteur,
const char FARPTR CodePorteurPS,
const char FARPTR pcNumFact,
short FARPTR pNbZDataOut,
void FARPTR FARPTR TZDataOut,
size_t FARPTR TTailleZoneOut);
typedef unsigned short (API_ENTRY FARPTR SSV_DechargerFSETLANC)
( const char FARPTR NomRessourcePS,
const char FARPTR NomRessourceLecteur,
const char FARPTR CodePorteurPS,
const char FARPTR pcNumFact,
short FARPTR pNbZDataOut,
void FARPTR FARPTR TZDataOut,
size_t FARPTR TTailleZoneOut);
typedef unsigned short (API_ENTRY FARPTR SSV_EffacerTLA)
(const char FARPTR NomRessourcePS,
const char FARPTR NomRessourceLecteur,
const char FARPTR CodePorteurPS,
const char FARPTR cNumFacturation,
const char FARPTR cTypeDonnee);
typedef unsigned short (API_ENTRY FARPTR SSV_ChargerFacturesPdT)
(const char FARPTR pcNomRessourceLecteur,
const char FARPTR pcNumFacturation,
short sNbZDataIn,
void FARPTR FARPTR pvTZDataIn,
size_t FARPTR psTTailleDataIn,
short FARPTR pNbZDataOut,
void FARPTR FARPTR TZDataOut,
size_t FARPTR TTailleZoneOut);
typedef unsigned short (API_ENTRY FARPTR SSV_ChargerAppli)
(const char FARPTR pcNomRessourceLecteur,
short sNbZDataIn,
void FARPTR FARPTR pvTZDataIn,
size_t FARPTR psTTailleDataIn);
typedef unsigned short (API_ENTRY FARPTR SSV_ChargerDonneesTLA)
(const char FARPTR pcNomRessourceLecteur,
short sNbZDataIn,
void FARPTR FARPTR pvTZDataIn,
size_t FARPTR psTTailleDataIn);
typedef unsigned short (API_ENTRY FARPTR SSV_DechargerBeneficiaires)
(const char FARPTR NomRessourcePS,
const char FARPTR NomRessourceLecteur,
const char FARPTR CodePorteurPS,
const char FARPTR cNumFacturation,
short FARPTR sNbZDataOut,
void FARPTR FARPTR pTZDataOut,
size_t FARPTR sTTailleDataOut);
typedef unsigned short (API_ENTRY FARPTR SSV_TraduireFSE)
(void FARPTR pZDataIn,
size_t TailleDataIn,
void FARPTR FARPTR pZDataOut,
size_t FARPTR pTailleZone);
typedef unsigned short (API_ENTRY FARPTR SSV_SecuriserFacture)
(const char FARPTR pcNomRessourcePS,
const char FARPTR pcNomRessourceLecteur,
const char FARPTR pcCodePorteurPS,
char cNologSituation,
const char FARPTR pcNumFact,
void FARPTR pvDataIn,
size_t szTailleDataIn ,
void FARPTR FARPTR pvDataOut,
size_t FARPTR pszTailleDataOut);
typedef unsigned short (API_ENTRY FARPTR SSV_InitLIB2) (const char FARPTR pcFichierSesam);
typedef unsigned short (API_ENTRY FARPTR SSV_TermLIB)();
/****** FONCTIONS SIMPLIFIEES *********/
typedef unsigned short (API_ENTRY FARPTR SIS_TraduireARL)
(unsigned short numeroSession);
typedef unsigned short (API_ENTRY FARPTR SIS_LireCartePS)
(const char FARPTR NomRessourcePS,
const char FARPTR NomRessourceLecteur,
const char FARPTR CodePorteurPS,
unsigned short numeroSession);
typedef unsigned short (API_ENTRY FARPTR SIS_LireConfig)
(unsigned short numeroSession);
typedef unsigned short (API_ENTRY FARPTR SIS_FormaterFactures)
(char cFacturesACreer,
char ModeSecur,
char cTypeFlux,
unsigned short numeroSession);
typedef unsigned short (API_ENTRY FARPTR SIS_ChiffrerFacture)
(unsigned short numeroSession);
typedef unsigned short (API_ENTRY FARPTR SIS_SignerFactureVitale)
(const char * pcNomRessourceVitale,
unsigned short numeroSession);
typedef unsigned short (API_ENTRY FARPTR SIS_CalculerHashFactureAssure)
(const char * pcNumSerie,
unsigned short numeroSession);
typedef unsigned short (API_ENTRY FARPTR SIS_AjouterSignatureAssureDansFacture)
(unsigned short numeroSession);
typedef unsigned short (API_ENTRY FARPTR SIS_SignerFactureCPS)
(const char * pcNomRessourcePS,
const char * pcNomRessourceLecteur,
const char * pcCodePorteurPS,
char cNologSituation,
unsigned short numeroSession);
typedef unsigned short (SIS_CalculerHashFacturePS)
(const char * pcNumSerieCPS,
unsigned short numeroSession);
typedef unsigned short (API_ENTRY SIS_AjouterSignaturePSFacture)
(unsigned short numeroSession);
typedef unsigned short (API_ENTRY FARPTR SIS_SignerLotCPS)
(const char * pcNomRessourcePS,
const char * pcNomRessourceLecteur,
const char * pcCodePorteurPS,
char cNologSituation,
unsigned short numeroSession);
typedef unsigned short (API_ENTRY FARPTR SIS_FormaterLot)
(unsigned short numeroSession);
typedef unsigned short (API_ENTRY FARPTR SIS_FormaterFichier)
(unsigned short numeroSession);
typedef unsigned short (API_ENTRY FARPTR SIS_InitTrace)
(char FARPTR NomFichier, char FARPTR ModeOuverture,
unsigned short Module, unsigned char Niveau);
typedef unsigned short (API_ENTRY FARPTR SIS_MajDateLecteur)
(const char FARPTR pcNomRessourceLecteur,
const char FARPTR pcDateHeure);
typedef unsigned short (API_ENTRY FARPTR SIS_LireDateLecteur)
(const char FARPTR pcNomRessourceLecteur,
char FARPTR pcDateHeure);
typedef unsigned short (API_ENTRY FARPTR SIS_LireDroitsVitale)
(const char FARPTR NomRessourcePS,
const char FARPTR NomRessourceLecteur,
const char FARPTR CodePorteurPS,
const char FARPTR DateConsultation,
unsigned short numeroSession);
typedef unsigned short (API_ENTRY FARPTR SIS_IdentifierTLA)
(const char FARPTR pcNomRessourceLecteur,
const char FARPTR NumVersionCDC,
unsigned short numeroSession );
typedef unsigned short (API_ENTRY FARPTR SIS_DechargerFacturesPdT)
( const char FARPTR NomRessourcePS,
const char FARPTR NomRessourceLecteur,
const char FARPTR CodePorteurPS,
const char FARPTR pcNumFact,
unsigned short numeroSession);
typedef unsigned short (API_ENTRY FARPTR SIS_DechargerFSETLA)
(const char FARPTR NomRessourcePS,
const char FARPTR NomRessourceLecteur,
const char FARPTR CodePorteurPS,
const char FARPTR pcNumFact,
unsigned short numeroSession);
typedef unsigned short (API_ENTRY FARPTR SIS_DechargerFSETLANC)
(const char FARPTR NomRessourcePS,
const char FARPTR NomRessourceLecteur,
const char FARPTR CodePorteurPS,
const char FARPTR pcNumFact,
unsigned short numeroSession);
typedef unsigned short (API_ENTRY FARPTR SIS_EffacerTLA)
(const char FARPTR NomRessourcePS,
const char FARPTR NomRessourceLecteur,
const char FARPTR CodePorteurPS,
const char FARPTR cNumFacturation,
const char FARPTR cTypeDonnee);
typedef unsigned short (API_ENTRY FARPTR SIS_ChargerFacturesPdT)
(const char FARPTR pcNomRessourceLecteur,
const char FARPTR pcNumFacturation,
unsigned short numeroSession);
typedef unsigned short (API_ENTRY FARPTR SIS_ChargerAppli)
(const char FARPTR pcNomRessourceLecteur,
unsigned short numeroSession);
typedef unsigned short (API_ENTRY FARPTR SIS_ChargerDonneesTLA)
(const char FARPTR pcNomRessourceLecteur,
unsigned short numeroSession);
typedef unsigned short (API_ENTRY FARPTR SIS_DechargerBeneficiaires)
( const char FARPTR NomRessourcePS,
const char FARPTR NomRessourceLecteur,
const char FARPTR CodePorteurPS,
const char FARPTR cNumFacturation,
unsigned short numeroSession);
typedef unsigned short (API_ENTRY FARPTR SIS_TraduireFSE)
(unsigned short numeroSession);
typedef unsigned short (API_ENTRY FARPTR SIS_SecuriserFacture)
( const char FARPTR pcNomRessourcePS,
const char FARPTR pcNomRessourceLecteur,
const char FARPTR pcCodePorteurPS,
char cNologSituation,
const char FARPTR pcNumFact,
unsigned short numeroSession);
/* inclusion temporaire dans ssv.h pour ne pas a avoir à relivrer Sedica (pas d'incidence sur le code) -> à inclure dans sedica.h ou commun.h*/
/* Chaine discriminante d un nom de ressource TL PCSC */
#define TL_PCSC " TL "
#ifdef __cplusplus
}
#endif
#endif

View File

@ -0,0 +1,353 @@
/*
%-----------------------------------------------------------------------------
% PROJET : STS INTERFACE
%
% MODULE : HEADER STS INTERFACE
%
% VERSION : cf #define ci-après
%
% FICHIER : sts.h
%
% Déclaration des prototypes des fonctions STS - INTERFACE
%-----------------------------------------------------------------------------
%
% EDS DHU - 09/04/03 - Création du .h
%
% EDS OCL - 06/06/03 - Defect 91 : Rectification du prototype de InitTrace()
%
% EDS OCL - 04/07/03 - Defect 115 : Nettoyage de stsitf.h (devenu sts.h)
%
%-----------------------------------------------------------------------------
*/
#ifndef __STSITF_H
#define __STSITF_H
#define __STSITF_VERSION "0103"
/* Ne pas oublier d'impacter idef.h aussi */
#ifdef __cplusplus
extern "C" {
#endif
/*
% Bibliothèques ANSI ou système
%------------------------------
*/
/*
% Fichiers h inclus
%------------------
*/
#include "sys_dep.h"
/*
% Macros et Constantes
%---------------------
*/
/* OCL - Defect 115 : Suppression du #define G_xxx ici même */
/* OCL - Defect 115 : Suppression du second #ifdef _cplusplus ici même */
/*********************************************************************************
************************* Fonctions réentrantes *********************************
*********************************************************************************/
/*
%-----------------------------------------------------------------------------
% STS_Tarification
%
% Rôle : Tarification de la part complémentaire des actes de la facture
%
% Paramètres d'entrée :
% MotifAppel (char) : 1er appel ('P') ou Appel sur echec de
% tarification ('E').
% ZDonneesEntree (void*) : Zone d'échange fournie par le Progiciel
% contenant toutes les informations sur la facture
% TailleDonneesEntree (size_t) : Taille de la zone d'échange Zin
%
% Paramètres de sortie :
% ZDonneesSortie (void**) : Zone d'échange fournie par le module STS appelé
% contenant toutes les informations modifiées de la facture
% en entrée et de nouvelles informations.
% TailleDonneesSortie (size_t*) : Taille de la zone d'échange Zout
%
% Valeur retournée :
% OK si pas d'erreur
% ERR_STS_NON_INITIALISE si module STS non initialisé
% et les codes d'erreurs de la tarification du module STS appelé
%
%-----------------------------------------------------------------------------
*/
/* OCL - Defect 115 : Remplacement PTR par FARPTR */
typedef unsigned short (API_ENTRY FARPTR STS_Tarification)(char MotifAppel, void FARPTR ZDonneesEntree,
size_t TailleDonneesEntree, void FARPTR FARPTR ZDonneesSortie,
size_t FARPTR TailleDonneesSortie);
/* Fonction simplifiée */
/* OCL - Defect 115 : Remplacement STS_SIM par SGD */
#ifdef SGD
typedef unsigned short (API_ENTRY FARPTR STS_Tarification_S)(char MotifAppel, unsigned short NumeroSession);
#endif
/*
%-----------------------------------------------------------------------------
% STS_Assistance
%
% Rôle : Assistance à la facturation.
%
% Paramètres d'entrée :
% MotifAppel (char) : 1er appel ('P') ou Appel sur echec de
% tarification ('E').
% PorteeAppel (ushort) : 0 pour une assistance sur toute la facture.
% 1..n pour une assistance sur un acte de rang donné /zone
% ZDonneesEntree (void*) : Zone d'échange fournie par le Progiciel
% contenant toutes les informations sur la facture
% TailleDonneesEntree (size_t) : Taille de la zone d'échange Zin
%
% Paramètres de sortie :
% ZDonneesSortie (void**) : Zone d'échange fournie par le module STS appelé
% TailleDonneesSortie (size_t*) : Taille de la zone d'échange Zout
%
% Valeur retournée : (idem Tarification)
% OK si pas d'erreur
% ERR_STS_NON_INITIALISE si module STS non initialisé
% et les codes d'erreurs de la tarification du module STS appelé
%
%-----------------------------------------------------------------------------
*/
/* OCL - Defect 115 : Remplacement PTR par FARPTR */
typedef unsigned short (API_ENTRY FARPTR STS_Assistance)(char MotifAppel, unsigned short PorteeAppel,
void FARPTR ZDonneesEntree, size_t TailleDonneesEntree,
void FARPTR FARPTR ZDonneesSortie, size_t FARPTR TailleDonneesSortie);
/* Fonction simplifiée */
#ifdef SGD
typedef unsigned short (API_ENTRY FARPTR STS_Assistance_S)(char MotifAppel, unsigned short PorteeAppel,
unsigned short NumeroSession);
#endif
/*
%-----------------------------------------------------------------------------
% STS_LireVersion
%
% Rôle : Lecture de la version de ce module et du fichier de ces tables externes
% dans le groupe 3780. Appeller la lecture de version de chaque module STS
% puis recopier la réponse 3780 de chacun dans la zone de sortie.
%
% Paramètres d'entrée : aucun
%
% Paramètres de sortie :
% ZDonneesSortie (void**) : Zone d'échange fournie par ce module
% contenant les versions (grp 3780) demandées.
% TailleDonneesSortie (size_t*) : Taille de la zone d'échange Zout
%
% Valeur retournée :
% OK si pas d'erreur
% ERR_STS_NON_INITIALISE si module STS non initialisé
% ERR_ZOUT si ZDonneesSortie==NULL ou TailleDonneesSortie==NULL
% ERR_ZONE_ALLOC si mémoire insuffisante pour allouer la Zout
%
%-----------------------------------------------------------------------------
*/
/* OCL - Defect 115 : Remplacement PTR par FARPTR */
typedef unsigned short (API_ENTRY FARPTR STS_LireVersion)(void FARPTR FARPTR ZDonneesSortie, size_t FARPTR TailleDonneesSortie);
/* Fonction simplifiée */
#ifdef SGD
typedef unsigned short (API_ENTRY FARPTR STS_LireVersion_S)(unsigned short NumeroSession);
#endif
/*
%-----------------------------------------------------------------------------
% STS_InitTrace
%
% Rôle : Initialisation des traces du module STS-Interface dans un fichier log.
% Cette fonction permet d'activer ou désactiver (niveau 0) les
% traces. Une activation requiert un nom de fichier et un mode
% d'ouverture. Un changement de niveau peut se faire sur le même
% fichier ou sur un différent s'il est précisé en entrée
%
% Paramètres d'entrée :
% NomFichier (char*) : Chemin et nom de fichier de trace
% ModeOuverture (char*) : Mode d'ouverture du fichier de trace
% "a", "w" (,"ab", "wb").
% Module (ushort) : n° de module 0 à 5 (6=TOUS)
% Niveau (uchar) : Niveau de trace : 0 signifie pas de trace, 1
% signifie traces de profondeur 8 et >=2 signifie traces sans limite
% de profondeur et activation traces module STS_SI
%
% Paramètres de sortie : aucun
%
% Valeur retournée :
% OK si pas d'erreur
% ERR_PARAM si NomFichier/ModeOuverture incorrect quand Niveau > 0
% ERR_TRACE_FILE si erreur d'ouverture du fichier de trace
%
%-----------------------------------------------------------------------------
*/
/* OCL - Defect 91 : Rectification du prototype de InitTrace() */
/* OCL - Defect 115 : Remplacement PTR par FARPTR */
typedef unsigned short (API_ENTRY FARPTR STS_InitTrace)(const char FARPTR pathConf, const char FARPTR ModeOuverture,
unsigned short Module, unsigned char Niveau);
/*********************************************************************************
************************* Fonctions d'initialisation et de terminaison *********
*********************************************************************************/
/*
%-----------------------------------------------------------------------------
% STS_InitLIB
%
% Rôle : Initialisation du module STS-Interface : Chargement des tables externes
% et suivi de parc. Appel de l'nitialisation de chaque module STS
%
% Paramètres d'entrée : aucun
%
% Paramètres de sortie : aucun
%
% Valeur retournée :
% OK si pas d'erreur
% ERR_INTERNE_ITF si erreur interne du module STS-Interface (ou STS SI)
% ERR_MEM_DISPO si plus de mémoire disponible
% ERR_PKG_PATH_INI si le chemin d'accès au fichier binaire est
% inconnu (fichier de configuration inaccessible ou information
% manquante)
% ERR_ITF_PKG_ACCES si fichier binaire de table inaccessible
% ERR_ITF_PKG_VER si version du fichier incohérent avec version du
% module STS-Interface (dans les deux sens)
% ERR_ITF_PKG_CRC si CRC du fichier binaire est incorrect
% ERR_ITF_PKG_FORME si format du fichier incorrect
% ERR_ITF_PKG_INCPT s'il manque une table dans le fichier binaire
% ERR_ITF_PKG_NOM si le nom du fichier est différent du nom dans
% l'en-tête du fichier.
% les codes suivants ne sont pas des erreurs fatales (non bloquant)
% mais juste des avertissements
% WAR_STS_DEJA_INITIALISE si module déjà initialisé
% WAR_ADM_PATH si chemin au suivi de parc non trouvé dans fichier
% de configuration des produits SV
% WAR_ADM_FILE si impossible de créer les fichiers de suivi de
% parc
% ET les codes de retour de chaque module STS appelé
%
%-----------------------------------------------------------------------------
*/
/* extern unsigned short API_ENTRY STS_InitLIB(); */
/*
%-----------------------------------------------------------------------------
% STS_InitLIB2
%
% Rôle : Initialisation du module STS-Interface : Chargement des tables externes
% et suivi de parc. Appel de l'nitialisation de chaque module STS
%
% Paramètres d'entrée :
% NomFichierIni (char*) : Chemin et nom du fichier de configuration des
% produits SESAM Vitale du poste de travail (sesam.ini)
%
% Paramètres de sortie : aucun
%
% Valeur retournée :
% OK si pas d'erreur
% ERR_INTERNE_ITF si erreur interne du module STS-Interface (ou STS SI)
% ERR_MEM_DISPO si plus de mémoire disponible
% ERR_PKG_PATH_INI si le chemin d'accès au fichier binaire est
% inconnu (fichier de configuration inaccessible ou information
% manquante)
% ERR_ITF_PKG_ACCES si fichier binaire de table inaccessible
% ERR_ITF_PKG_VER si version du fichier incohérent avec version du
% module STS-Interface (dans les deux sens)
% ERR_ITF_PKG_CRC si CRC du fichier binaire est incorrect
% ERR_ITF_PKG_FORME si format du fichier incorrect
% ERR_ITF_PKG_INCPT s'il manque une table dans le fichier binaire
% ERR_ITF_PKG_NOM si le nom du fichier est différent du nom dans
% l'en-tête du fichier.
% les codes suivants ne sont pas des erreurs fatales (non bloquant)
% mais juste des avertissements
% WAR_STS_DEJA_INITIALISE si module déjà initialisé
% WAR_ADM_PATH si chemin au suivi de parc non trouvé dans fichier
% de configuration des produits SV
% WAR_ADM_FILE si impossible de créer les fichiers de suivi de
% parc
% ET les codes de retour de chaque module STS appelé
%
%-----------------------------------------------------------------------------
*/
typedef unsigned short (API_ENTRY FARPTR STS_InitLIB2)(const char FARPTR nomFichierIni);
/*
%-----------------------------------------------------------------------------
% STS_TermLIB
%
% Rôle : Terminaison du module STS-Interface : Déchargement des tables externes.
%
% Paramètres d'entrée : aucun
%
% Paramètres de sortie : aucun
%
% Valeur retournée :
% OK si pas d'erreur
% ERR_INTERNE_ITF si erreur interne du module STS-Interface (ou STS SI)
%
%-----------------------------------------------------------------------------
*/
typedef unsigned short (API_ENTRY FARPTR STS_TermLIB)(void);
/*********************************************************************************
************************* Fonctions de gestion de la mémoire *******************
*********************************************************************************/
/*
%-----------------------------------------------------------------------------
% STS_AllouerZoneMem
%
% Rôle : Allocation d'une zone d'échange de sortie par STS Interface.
% Cette fonction permet la réallocation d'une zone d'échange.
% L'allocation d'une nouvelle zone d'échange nécessite un pointeur
% NULL en entrée !
% Cette fonctio est à utiliser conjointement avec STS_LibererZoneMem
% pour faciliter le Debugage (zone allouée par l'écrivain)
%
% Paramètres d'entrée :
% Taille (size_t) : Taille de la zone d'échange à allouer.
%
% Paramètres d'entrée et de sortie :
% Zone (void**) : Zone d'échange préallouée en entrée (ou NULL).
% Zone allouée (réallouée) par le module STS-Interface.
%
% Valeur retournée :
% OK si pas d'erreur
% ERR_ZOUT si Zone==NULL ou Taille==0
% ERR_ZONE_ALLOC si plus de mémoire disponible
%
%-----------------------------------------------------------------------------
*/
/* OCL - Defect 115 : Remplacement PTR par FARPTR */
typedef unsigned short (API_ENTRY FARPTR STS_AllouerZoneMem)(void FARPTR FARPTR Zone, size_t Taille);
/*
%-----------------------------------------------------------------------------
% STS_LibererZoneMem
%
% Rôle : Libération de la zone d'échange de sortie par STS Interface.
%
% Paramètres d'entrée :
% Zone (void*) : Zone d'échange à libérer (allouée précédemment par
% le module STS-Interce par STS_AllouerZoneMem).
%
% Paramètres de sortie : aucun
%
% Valeur retournée : aucune
%
%-----------------------------------------------------------------------------
*/
/* OCL - Defect 115 : Remplacement PTR par FARPTR */
typedef void (API_ENTRY FARPTR STS_LibererZoneMem)(void FARPTR Zone);
#ifdef __cplusplus
}
#endif
#endif /* __STSITF_H */

View File

@ -0,0 +1,189 @@
/*---------------------------------------------------------------------------
PROJET : Couche de portabilite multi-systeme
PLATE-FORME: LINUX
MODULE : Definition des macros et des types utilises par la couche
d'abstraction systeme pour la plate-forme LINUX.
Le fichier de definition des types portable (ce fichier) doit
etre inclus avant tout autre .h de definitions d'APIS gip-cps.
Ce fichier definit tous les types et macros dependants du
systeme.
FICHIER : common\linux\src\linuxdef.h
VERSION : 1.00
DATE : 10/01/2001
AUTEUR : ALVARO ROCHA
-----------------------------------------------------------------------------
-----------------------------------------------------------------------------
Modifications: (nouvelle version, date, auteur, explication)
...
- V4.31 - AROC le 12/02/2001 :
Ajout des #define TRUE et FALSE ainsi que le typedef int BOOLEEN
-----------------------------------------------------------------------------
---------------------------------------------------------------------------*/
#ifndef __CPSCASDF_H
#define __CPSCASDF_H
/*----------------- definition des macros portables ------------------------*/
#ifndef far
#define far
#endif
#ifndef FAR
#define FAR
#endif
#ifndef PTR
#define PTR *
#endif
#ifndef PVOID
#define PVOID void PTR
#endif
#ifndef FARPTR
#define FARPTR PTR
#endif
#ifndef FPVOID
#define FPVOID void FARPTR
#endif
/* AROC 12/02/2001 debut : */
#ifndef FALSE
#define FALSE 0
#endif
#ifndef TRUE
#define TRUE 1
#endif
/* AROC 12/02/2001 fin */
/*----------------- definition des types portables ------------------------*/
#ifndef CHAR
#define CHAR char
#endif
#ifndef PCHAR
#define PCHAR CHAR PTR
#endif
#ifndef PSTRG
#define PSTRG CHAR PTR
#endif
#ifndef UCHAR
#define UCHAR unsigned char
#endif
#ifndef PUCHAR
#define PUCHAR UCHAR PTR
#endif
#ifndef INT8
#define INT8 char
#endif
#ifndef INT16
#define INT16 short
#endif
#ifndef INT32
#define INT32 long
#endif
#ifndef PINT8
#define PINT8 INT8 PTR
#endif
#ifndef PINT16
#define PINT16 INT16 PTR
#endif
#ifndef PINT32
#define PINT32 INT32 PTR
#endif
#ifndef UINT8
#define UINT8 unsigned char
#endif
#ifndef UINT16
#define UINT16 unsigned short
#endif
#ifndef UINT32
#define UINT32 unsigned long
#endif
#ifndef PUINT8
#define PUINT8 UINT8 PTR
#endif
#ifndef PUINT16
#define PUINT16 UINT16 PTR
#endif
#ifndef PUINT32
#define PUINT32 UINT32 PTR
#endif
/* 11/02/1997 : Ajout DRE pour CPSCAS */
#ifndef VOID
#define VOID void
#endif
#ifndef PSTR
#define PSTR char PTR
#endif
/* 11/02/1997 : Fin */
#ifndef WORD
#define WORD unsigned short
#endif
#ifndef DWORD
#define DWORD unsigned long
#endif
//typedef unsigned char BYTE;
#ifndef BYTE
#define BYTE unsigned char
#endif
//typedef BYTE far * LPBYTE;
#ifndef LPBYTE
#define LPBYTE BYTE far *
#endif
//typedef int BOOL;
#ifndef BOOL
#define BOOL int
#endif
#ifndef Unref
#define Unref( a) a=a
#endif
#ifndef min
#define min(a,b) ((a)>(b)?(b):(a))
#endif
#ifndef max
#define max(a,b) ((a)<(b)?(b):(a))
#endif
/* Taille maximale allouée par la fonction "malloc" */
#ifndef MAXBLOC
#define MAXBLOC 4294967295
#endif
#endif

View File

@ -0,0 +1,85 @@
/*
* -------------------------------------------------------------------
* (c) 2002 GIE SESAM-VITALE
*
* FICHIER : sys_def.h (v2)
*
* PLATE-FORME : Windows 32 bits
*
* Définitions dépendantes du système.
* -------------------------------------------------------------------
*/
#include "linuxdef.h"
#include "stdlib.h"
#ifndef __SYS_DEF_H__
#define __SYS_DEF_H__
#ifdef __cplusplus
extern "C" {
#endif
#ifndef API_ENTRY
#define API_ENTRY
#endif
#ifndef _MAX_PATH
#define _MAX_PATH 256
#endif
#ifndef _MAX_FNAME
#define _MAX_FNAME 160
#endif
#ifndef _MAX_DIR
#define _MAX_DIR 800
#endif
#ifndef FARPTR
#define FARPTR *
#endif
#ifndef SYS_MAX_PATH
#define SYS_MAX_PATH _MAX_PATH
#endif
#ifndef SYS_MAX_FNAME
#define SYS_MAX_FNAME _MAX_FNAME
#endif
#ifndef SYS_MAX_DIR
#define SYS_MAX_DIR _MAX_DIR
#endif
#ifndef SYS_HANDLE
#define SYS_HANDLE void *
#endif
#ifndef PTR
#define PTR *
#endif
#ifndef SYSFARPROC_
#define SYSFARPROC_
typedef unsigned short (API_ENTRY FARPTR SYSFARPROC)();
#endif
/* Séparateur utilisé dans le nommage des arborescences de fichiers */
#ifndef SEPARATEUR_REPERTOIRE
#define SEPARATEUR_REPERTOIRE '/'
#endif
/* Activation des fonctions simplifiées. */
#ifndef SGD
#define SGD
#endif
#ifdef __cplusplus
}
#endif
#endif

View File

@ -0,0 +1,92 @@
/*
* -------------------------------------------------------------------
* (c) 2002 GIE SESAM-VITALE
*
* FICHIER : sys_def.h (v2)
*
* PLATE-FORME : MAC OSX
*
* Définitions dépendantes du système.
* -------------------------------------------------------------------
*/
//3/11/2004 Modification pour compilation MAC OS X
#include "osxdef.h"
#include <stdarg.h>
#include <errno.h>
#include "stdlib.h"
#ifndef __SYS_DEF_H__
#define __SYS_DEF_H__
#ifdef __cplusplus
extern "C" {
#endif
//3-11-2004 Ajout pour MAc OS X
#define FALSE 0
#define TRUE 1
//3/11/2004 Modification pour compilation MAC OS X
#ifndef API_ENTRY
#define API_ENTRY
#endif
#ifndef FARPTR
#define FARPTR *
#endif
#ifndef SYS_MAX_PATH
#define SYS_MAX_PATH _MAX_PATH
#endif
#ifndef SYS_MAX_FNAME
#define SYS_MAX_FNAME _MAX_FNAME
#endif
#ifndef SYS_MAX_DIR
#define SYS_MAX_DIR _MAX_DIR
#endif
#ifndef PTR
#define PTR *
#endif
#ifndef SYS_HANDLE
//typedef void * SYS_HANDLE;
#define SYS_HANDLE void *
#endif
#ifndef SYSFARPROC_
#define SYSFARPROC_
typedef unsigned short (API_ENTRY FARPTR SYSFARPROC)();
#endif
/* Séparateur utilisé dans le nommage des arborescences de fichiers */
#ifndef SEPARATEUR_REPERTOIRE
#ifdef WIN32
#define SEPARATEUR_REPERTOIRE '\\'
#else
#define SEPARATEUR_REPERTOIRE '/'
#endif
#endif
/* Activation des fonctions simplifiées. */
#ifndef SGD
#define SGD
#endif
#ifdef __cplusplus
}
#endif
#endif

View File

@ -0,0 +1,150 @@
/*---------------------------------------------------------------------------
PROJET : Couche de portabilite multi-systeme
PLATE-FORME: MAC OS X
MODULE : Definition des macros et des types utilises par la couche
d'abstraction systeme pour la plate-forme LINUX.
Le fichier de definition des types portable (ce fichier) doit
etre inclus avant tout autre .h de definitions d'APIS gip-cps.
Ce fichier definit tous les types et macros dependants du
systeme.
FICHIER : common\linux\src\linuxdef.h
VERSION : 1.00
DATE : 10/01/2001
AUTEUR : ALVARO ROCHA
-----------------------------------------------------------------------------
-----------------------------------------------------------------------------
Modifications: (nouvelle version, date, auteur, explication)
...
- V4.31 - AROC le 12/02/2001 :
Ajout des #define TRUE et FALSE ainsi que le typedef int BOOLEEN
-----------------------------------------------------------------------------
---------------------------------------------------------------------------*/
#ifndef __CPSCASDF_H
#define __CPSCASDF_H
//#ifndef __MACTYPES__
/*#include <CarbonCore/MacTypes.h>*/
//#include"/System/Library/Frameworks/CoreServices.framework/Versions/A/Frameworks/CarbonCore.framework/Versions/A/Headers/MacTypes.h"*/
//#endif
/*----------------- definition des macros portables ------------------------*/
/* point d'entree exporte en DLL ????????????????????????????????????????? */
#define API_ENTRY /* pour l'instant */
#define far
#define FAR
#define PTR *
#define PVOID void PTR
#ifndef FARPTR
#define FARPTR PTR
#endif
#define FPVOID void FARPTR
/* AROC 18/O4/2001 ajout pour io_comm*/
#define HCOMM unsigned int
#define PHCOMM HCOMM FARPTR
/* AROC 12/02/2001 debut : */
#ifndef FALSE
#define FALSE 0
#endif
#ifndef TRUE
#define TRUE 1
#endif
/* AROC 12/02/2001 fin */
/*----------------- definition des types portables ------------------------*/
/* AROC 12/02/2001 debut : */
/* mise en commentaire de ce define car pb avec module sts où BOOLEEN est defini en char*/
//#ifndef BOOLEEN
//typedef int BOOLEEN;
//#define BOOLEEN int
//#endif
/* AROC 12/02/2001 fin */
/* Boolean */
#define BOOL Boolean
//#define _MAX_PATH 1024
typedef char CHAR;
typedef CHAR PTR PCHAR;
typedef CHAR PTR PSTRG;
typedef unsigned char UCHAR;
typedef UCHAR PTR PUCHAR;
typedef char INT8;
typedef short INT16;
typedef long INT32;
typedef INT8 PTR PINT8;
typedef INT16 PTR PINT16;
typedef INT32 PTR PINT32;
typedef unsigned char UINT8;
typedef unsigned short UINT16;
typedef unsigned long UINT32;
typedef UINT8 PTR PUINT8;
typedef UINT16 PTR PUINT16;
typedef UINT32 PTR PUINT32;
/* 11/02/1997 : Ajout DRE pour CPSCAS */
typedef void VOID;
typedef char PTR PSTR;
/* 11/02/1997 : Fin */
typedef unsigned short WORD;
typedef unsigned long DWORD;
typedef unsigned char BYTE;
typedef BYTE far * LPBYTE;
#define Unref( a) a=a
#ifndef min
#define min(a,b) ((a)>(b)?(b):(a))
#endif
#ifndef max
#define max(a,b) ((a)<(b)?(b):(a))
#endif
#ifdef LITTLE_ENDIAN
#undef LITTLE_ENDIAN
#endif
#ifndef PATH_MAX
#define PATH_MAX 1024
#endif
#ifndef _MAX_PATH
#define _MAX_PATH PATH_MAX /* PATH_MAX defini dans <usr/include/sys/syslimits.h> */
#endif
/* Taille maximale allouÈe par la fonction "malloc" */
#ifndef MAXBLOC
#define MAXBLOC 0x7FFFFFFF
#endif
#endif

View File

@ -0,0 +1,69 @@
/*
* -------------------------------------------------------------------
* (c) 2002 GIE SESAM-VITALE
*
* FICHIER : sys_def.h (v2)
*
* PLATE-FORME : Windows 32 bits
*
* Définitions dépendantes du système.
* -------------------------------------------------------------------
*/
#include <stdlib.h>
#ifndef __SYS_DEF_H__
#define __SYS_DEF_H__
#ifdef __cplusplus
extern "C" {
#endif
#ifndef API_ENTRY
#define API_ENTRY __stdcall
#endif
#ifndef FARPTR
#define FARPTR *
#endif
#ifndef SYS_MAX_PATH
#define SYS_MAX_PATH _MAX_PATH
#endif
#ifndef SYS_MAX_FNAME
#define SYS_MAX_FNAME _MAX_FNAME
#endif
#ifndef SYS_MAX_DIR
#define SYS_MAX_DIR _MAX_DIR
#endif
typedef void * SYS_HANDLE;
#ifndef PTR
#define PTR *
#endif
typedef unsigned short (API_ENTRY FARPTR SYSFARPROC)();
/* Séparateur utilisé dans le nommage des arborescences de fichiers */
#ifndef SEPARATEUR_REPERTOIRE
#define SEPARATEUR_REPERTOIRE '\\'
#endif
/* Activation des fonctions simplifiées. */
#ifndef SGD
#define SGD
#endif
#ifdef __cplusplus
}
#endif
#endif

13
crates/fsv/Cargo.toml Normal file
View File

@ -0,0 +1,13 @@
[package]
name = "fsv"
version = "0.1.0"
edition = "2021"
[dependencies]
anyhow = "1.0.89"
libc = "0.2.159"
num_enum = { version = "0.7.3", features = ["complex-expressions"] }
thiserror = "1.0.64"
fsv-sys = { path = "../fsv-sys" }
utils = { path = "../utils" }

1
crates/fsv/src/lib.rs Normal file
View File

@ -0,0 +1 @@
mod ssv;

View File

@ -0,0 +1,181 @@
use num_enum::FromPrimitive;
use thiserror::Error;
#[derive(Error, Debug, Eq, PartialEq, FromPrimitive)]
#[repr(u16)]
pub enum SSVErrorCodes {
#[error("La Carte du Professionnel de Santé est absente du lecteur.")]
CPSMissing = 0xF001,
#[error("La Carte du Professionnel de Santé bloquée après trois codes porteur erronés.")]
CPSBlocked = 0xF002,
#[error("Le code porteur présenté est erroné.")]
CPSPinWrong = 0xF003,
#[error("Carte du Professionnel de Santé non valide ou inexploitable par le Logiciel Lecteur. Vérifier la présence d'un Domaine d'Assurance Maladie (DAM).")]
CPSInvalid = 0xF004,
#[error("La Carte du Professionnel de Santé est retirée du lecteur.")]
CPSRemoved = 0xF005,
/// - Sécurisation d'une série de lots en cours.
/// - Pour les fonctions TLA (sauf Identifier TLA) : Cette erreur survient lorsque le simulateur TLA est en mode 1.50.
/// - Lire Date Lecteur, Mettre à jour Date Lecteur, Lire Droits Vitale : Cette erreur peut survenir lorsque le Logiciel Lecteur ne connaît pas la fonction sollicitée, c'est-à-dire si la version du Logiciel Lecteur est antérieure à 2.00.
/// - Décharger Données Bénéficiaires : cette erreur peut survenir pour signaler que le
#[error("F022: Erreur commune à plusieurs fonctions.")]
F022 = 0xF022,
#[error("Message du lecteur incohérent. Débrancher et rebrancher le lecteur.")]
PCSCInconsistentMessage = 0xF0FF,
#[error("Le nom de lecteur fourni ne correspond à aucun lecteur reconnu.")]
PCSCReaderNotFound = 0xF101,
#[error("La fonction InitLIB2 n'est pas encore appelée ou la fonction TermLIB a déjà été appelée.")]
FunctionInitLib2NotCalled = 0xF600,
#[error("La bibliothèque SSV nest pas chargée en mémoire. Vérifier que la fonction InitLIB2 a bien été appelée.")]
LibraryNotLoaded = 0xF690, // Warning
#[error("Carte vitale en opposition.")]
VitaleOpposition = 0xF6A1,
#[error("Zone de mémoire non allouée en sortie.")]
MemoryNotAllocated = 0xF800,
#[error("Erreur d'allocation de la zone de mémoire en sortie.")]
MemoryAllocationError = 0xF801,
#[error("Un des paramètres obligatoires d'entrée est non alloué ou invalide.")]
InputParameterNotAllocatedOrInvalid = 0xF802,
#[error("Zone de mémoire spécifiée en entrée non valide. Vérifier que la zone allouée ne dépasse pas la taille maximale autorisée (MAXBLOC).")]
InputMemoryInvalid = 0xF803,
#[error("Le format de la zone de mémoire d'entrée ou le nombre de zones mémoire est incorrect.")]
InputMemoryFormatIncorrect = 0xF810,
#[error("Problème lors de linitialisation du protocole. Erreur du Ressource Manager PC/SC. Vérifiez le lecteur.")]
PCSCProtocolInitError = 0xFF01,
#[error("Time-out au niveau protocolaire ou transmission déjà en cours avec le lecteur. Vérifiez le lecteur et l'insertion de la carte.")]
PCSCProtocolTimeout = 0xFF02,
#[error("Taille insuffisante allouée en entrée dune fonction du Resource Manager.")]
PCSCProtocolInputMemoryTooSmall = 0xFF03,
#[error("Erreur de transmission du protocole. Vérifiez le lecteur et l'insertion de la carte.")]
PCSCProtocolTransmissionError = 0xFF04,
#[error("Lecteur absent ou indisponible.")]
PCSCReaderMissingOrUnavailable = 0xFF05,
#[error("Le nom du lecteur transmis est inconnu du Resource Manager PC/SC.")]
PCSCReaderUnknown = 0xFF06,
#[error("Erreur inconnue remontée par le Resource Manager PC/SC.")]
PCSCUnknownError = 0xFF07,
#[error("Erreur interne Resource Manager PC/SC.")]
PCSCInternalError = 0xFF08,
#[error("Ressource PC/SC déjà prise en exclusivité. Vérifiez qu'une autre application n'utilise pas le lecteur.")]
PCSCResourceAlreadyExclusive = 0xFF09,
#[error("Protocole incompatible avec la carte à puce. Vérifiez l'insertion de la carte et son état.")]
PCSCProtocolIncompatible = 0xFF0A,
#[error("Paramètre incorrect. Erreur interne à la librairie SSV.")]
PCSCIncorrectParameter = 0xFF0B,
#[error("Carte absente. Insérez une carte dans le lecteur.")]
PCSCCardMissing = 0xFF0C,
#[error("L'état de la carte a été modifié (RAZ ou mise hors tension). Vérifiez si la carte n'a pas été retirée ou si une autre application n'utilise pas la carte.")]
PCSCCardStateChanged = 0xFF0D,
#[error("Carte muette ou non supportée. Vérifiez l'insertion de la carte.")]
PCSCCardUnsupported = 0xFF0E,
#[error("Code porteur CPS non renseigné.")]
CPSPinMissing = 0xFF21,
#[error("Ressource PC/SC déjà prise en exclusivité. Vérifiez que le processus en cours n'utilise pas déjà le lecteur.")]
PCSCReaderAlreadyExclusiveForCurrentProcess = 0xFF24,
#[error("Plusieurs lecteurs ou cartes de même type identifiés lors de la détection automatique.")]
PCSCDuplicatedReadersOrCardsDetected = 0xFF29,
#[error("Problème de chargement de la librairie cryptographique ou erreur retournée par la librairie cryptographique.")]
CryptoLibraryError = 0xFF30,
#[error("Erreurs internes aux Services SESAM-Vitale. Vérifiez les traces.")]
#[num_enum(alternatives = [0xFFF1..=0xFFFF])]
SSVInternalError = 0xFFF0,
#[error("Le fichier `tablebin.smc` est inaccessible en lecture (inexistant ou pas de droits d'accès).")]
FileMissingTablebinMsc = 0xF610, // tablebin.smc
#[error("Le fichier `scripts.sms` est inaccessible en lecture (inexistant ou pas de droits d'accès).")]
FileMissingScriptsSms = 0xF611, // scripts.sms
#[error("Le fichier `tablebin.ssv` est inaccessible en lecture (inexistant ou pas de droits d'accès).")]
FileMissingTablebinSsv = 0xF612, // tablebin.ssv
#[error("Le fichier `script.ssv` est inaccessible en lecture (inexistant ou pas de droits d'accès).")]
FileMissingScriptSsv = 0xF613, // script.ssv
#[error("La version du fichier `tablebin.smc` est incompatible avec la bibliothèque des SSV.")]
FileVersionIncompatibleTablebinMsc = 0xF620, // tablebin.smc
#[error("La version du fichier `scripts.sms` est incompatible avec la bibliothèque des SSV.")]
FileVersionIncompatibleScriptsSms = 0xF621, // scripts.sms
#[error("La version du fichier `tablebin.ssv` est incompatible avec la bibliothèque des SSV.")]
FileVersionIncompatibleTablebinSsv = 0xF622, // tablebin.ssv
#[error("La version du fichier `script.ssv` est incompatible avec la bibliothèque des SSV.")]
FileVersionIncompatibleScriptSsv = 0xF623, // script.ssv
#[error("L'intégrité du fichier `tablebin.smc` est incorrecte.")]
FileIntegrityIncorrectTablebinMsc = 0xF630, // tablebin.smc
#[error("L'intégrité du fichier `scripts.sms` est incorrecte.")]
FileIntegrityIncorrectScriptsSms = 0xF631, // scripts.sms
#[error("L'intégrité du fichier `tablebin.ssv` est incorrecte.")]
FileIntegrityIncorrectTablebinSsv = 0xF632, // tablebin.ssv
#[error("L'intégrité du fichier `script.ssv` est incorrecte.")]
FileIntegrityIncorrectScriptSsv = 0xF633, // script.ssv
#[error("La structure interne du fichier `tablebin.smc` est invalide.")]
FileStructureInvalidTablebinMsc = 0xF640, // tablebin.smc
#[error("La structure interne du fichier `scripts.sms` est invalide.")]
FileStructureInvalidScriptsSms = 0xF641, // scripts.sms
#[error("La structure interne du fichier `tablebin.ssv` est invalide.")]
FileStructureInvalidTablebinSsv = 0xF642, // tablebin.ssv
#[error("La structure interne du fichier `script.ssv` est invalide.")]
FileStructureInvalidScriptSsv = 0xF643, // script.ssv
#[error("Le fichier `tablebin.smc` n'a pas pu être chargé en mémoire. Essayez de libérer de la mémoire.")]
FileLoadFailedTablebinMsc = 0xF650, // tablebin.smc
#[error("Le fichier `scripts.sms` n'a pas pu être chargé en mémoire. Essayez de libérer de la mémoire.")]
FileLoadFailedScriptsSms = 0xF651, // scripts.sms
#[error("Le fichier `tablebin.ssv` n'a pas pu être chargé en mémoire. Essayez de libérer de la mémoire.")]
FileLoadFailedTablebinSsv = 0xF652, // tablebin.ssv
#[error("Le fichier `script.ssv` n'a pas pu être chargé en mémoire. Essayez de libérer de la mémoire.")]
FileLoadFailedScriptSsv = 0xF653, // script.ssv
#[error("Le nom du fichier `tablebin.smc` est invalide.")]
FileNameInvalidTablebinMsc = 0xF660, // tablebin.smc
#[error("Le nom du fichier `scripts.sms` est invalide.")]
FileNameInvalidScriptsSms = 0xF661, // scripts.sms
#[error("Le nom du fichier `tablebin.ssv` est invalide.")]
FileNameInvalidTablebinSsv = 0xF662, // tablebin.ssv
#[error("Le nom du fichier `script.ssv` est invalide.")]
FileNameInvalidScriptSsv = 0xF663, // script.ssv
#[error("La fonction Initialiser Librairie est déjà appelée.")]
FunctionInitLib2AlreadyCalled = 0xF670, // Warning
#[error("Le fichier SESAM.INI est inaccessible en lecture (fichier ou droit daccès manquant) ou ne contient pas le chemin des tables binaires des SSV.")]
SesamIniMissingFileOrTablebinPath = 0xF680,
#[error("Le chemin du répertoire de travail est absent du fichier SESAM.INI.")]
SesamIniMissingWorkDir = 0xF6F1,
#[error("Les fichiers dextension adm ne sont pas accessibles en écriture.")]
AdmFilesNotWritable = 0xF6F2, // Warning
#[error("Aucune version de FSV du socle technique trouvé. Vérifier que la version du fichier script.sms est bonne.")]
NoFsvVersionFound = 0xF6F4,
#[error("Librairie SGD absente ou incomplète.")]
LibraryMissingOrIncompleteSGD = 0xF6F5,
#[error("Librairie SMC absente ou incomplète.")]
LibraryMissingOrIncompleteSMC = 0xF6F6,
#[error("Librairie SJS absente ou incomplète.")]
LibraryMissingOrIncompleteSJS = 0xF6F7,
#[error("Librairie SMS absente ou incomplète.")]
LibraryMissingOrIncompleteSMS = 0xF6F8,
#[error("Section MGC absente / clé RepertoireConfigTrace absente / fichier log4crc.xml non trouvé à lemplacement indiqué par la clé RepertoireConfigTrace du fichier SESAM.INI.")]
SesamIniTracingConfigMissing = 0xFF22, // Warning
#[error("Interface Full PC/SC : problème de chargement de la librairie cryptographique ou erreur retournée par la librairie cryptographique.")]
PCSCInterfaceCryptoLibraryError = 0xFF25,
#[error("Valorisation incorrecte des paramètres de gestion de l'accès aux ressources dans le SESAM.INI. Vérifier les valeurs des clés tempoexclusivite, repetitionexclusivite, tempoexclusivitePCSC, repetitionexclusivitePCSC")]
SesamIniResourceAccessParamsIncorrect = 0xFF2A,
#[num_enum(catch_all)]
#[error("Erreur inattendue de la librairie SSV (code d'erreur: {0}).")]
Unexpected(u16),
}
#[cfg(test)]
mod tests {
use super::*;
#[test]
fn test_code_ranges() {
let error_code = 0xFFF1;
let error = SSVErrorCodes::from(error_code);
assert_eq!(error, SSVErrorCodes::SSVInternalError);
let error_code = 0xFFF8;
let error = SSVErrorCodes::from(error_code);
assert_eq!(error, SSVErrorCodes::SSVInternalError);
}
#[test]
fn test_catch_all() {
let error_code = 0xFBFF; // Not a valid error code
let error = SSVErrorCodes::from(error_code);
assert_eq!(error, SSVErrorCodes::Unexpected(0xFBFF));
}
}

208
crates/fsv/src/ssv/mod.rs Normal file
View File

@ -0,0 +1,208 @@
use std::{ffi::CString, ptr};
use thiserror::Error;
use fsv_sys::{
get_library_path,
Error as FsvError,
SSVLibrary,
SSVLibraryCommon,
SupportedFsvVersion,
V1_40_13,
V1_40_14
};
mod errors_ssv;
use errors_ssv::SSVErrorCodes;
#[derive(Error, Debug)]
pub enum Error {
#[error(transparent)]
FSVSysLibrary(#[from] FsvError),
#[error(transparent)]
SSVError(#[from] SSVErrorCodes),
}
/// Enum to hold the different versions of the SSV library
enum SsvLibraryVersion {
V1_40_13(SSVLibrary<V1_40_13>),
V1_40_14(SSVLibrary<V1_40_14>),
}
/// Struct to hold the SSV library and access its functions
pub struct SSV {
library: SsvLibraryVersion,
}
impl SSV {
fn new(version: SupportedFsvVersion) -> Result<Self, Error> {
let library = match version {
SupportedFsvVersion::V1_40_13 => {
let lib_path = get_library_path(&version);
let library = SSVLibrary::<V1_40_13>::new(&lib_path)?;
SsvLibraryVersion::V1_40_13(library)
},
SupportedFsvVersion::V1_40_14 => {
let lib_path = get_library_path(&version);
let library = SSVLibrary::<V1_40_14>::new(&lib_path)?;
SsvLibraryVersion::V1_40_14(library)
},
};
Ok(Self {
library,
})
}
/// # Initialize the SSV library
/// Implement: SSV_InitLIB2
pub fn init_library(&self, sesam_ini_path: &str) -> Result<(), Error> {
let sesam_ini_path = CString::new(sesam_ini_path).expect("CString::new failed");
let result = match &self.library {
SsvLibraryVersion::V1_40_13(library) => {
unsafe { library.ssv_init_lib2(sesam_ini_path.as_ptr()) }?
},
SsvLibraryVersion::V1_40_14(library) => {
unsafe { library.ssv_init_lib2(sesam_ini_path.as_ptr()) }?
},
};
if result != 0 {
let error = SSVErrorCodes::from(result);
return Err(Error::SSVError(error));
}
Ok(())
}
/// # Read the CPS card
/// Implement: SSV_LireCartePS
pub fn read_professional_card(&self, pin_code: &str) -> Result<(), Error> {
let pcsc_reader_name = "Gemalto PC Twin Reader (645D94C3) 00 00";
let pin_code = CString::new(pin_code).expect("CString::new failed");
let pcsc_reader_name = CString::new(pcsc_reader_name).expect("CString::new failed");
let mut out_buffer_ptr: *mut libc::c_void = ptr::null_mut();
let mut out_buffer_size: libc::size_t = 0;
let result = match &self.library {
SsvLibraryVersion::V1_40_13(library) => {
unsafe { library.ssv_lire_carte_ps(
pcsc_reader_name.as_ptr(),
pcsc_reader_name.as_ptr(),
pin_code.as_ptr(),
&mut out_buffer_ptr,
&mut out_buffer_size)
}?
},
SsvLibraryVersion::V1_40_14(library) => {
unsafe { library.ssv_lire_carte_ps(
pcsc_reader_name.as_ptr(),
pcsc_reader_name.as_ptr(),
pin_code.as_ptr(),
&mut out_buffer_ptr,
&mut out_buffer_size)
}?
},
};
if result != 0 {
// Free memory
unsafe { libc::free(out_buffer_ptr) };
let error = SSVErrorCodes::from(result);
return Err(Error::SSVError(error));
}
// Print 10 bytes of the buffer
let buffer = unsafe { std::slice::from_raw_parts(out_buffer_ptr as *const u8, 10) };
println!("{:?}", buffer);
// Free memory
unsafe { libc::free(out_buffer_ptr) };
Ok(())
}
/// # Get the configuration of the SSV library
/// Implement: SSV_LireConfig
pub fn get_config(&self) -> Result<(), Error> {
let mut buffer_ptr: *mut libc::c_void = ptr::null_mut();
let mut size: libc::size_t = 0;
let result = match &self.library {
SsvLibraryVersion::V1_40_13(library) => {
unsafe { library.ssv_lire_config(&mut buffer_ptr, &mut size) }?
},
SsvLibraryVersion::V1_40_14(library) => {
unsafe { library.ssv_lire_config(&mut buffer_ptr, &mut size) }?
},
};
if result != 0 {
// Free memory
unsafe { libc::free(buffer_ptr) };
let error = SSVErrorCodes::from(result);
return Err(Error::SSVError(error));
}
// Print 10 bytes of the buffer
let buffer = unsafe { std::slice::from_raw_parts(buffer_ptr as *const u8, 10) };
println!("{:?}", buffer);
// Free memory
unsafe { libc::free(buffer_ptr) };
Ok(())
}
}
#[cfg(test)]
mod tests {
use std::env;
use utils::config::load_config;
use anyhow::Result;
use super::*;
mod setup {
use super::*;
pub fn init() -> Result<SSV> {
load_config().unwrap();
let sesam_ini_path = env::var("SESAM_INI_PATH").expect("SESAM_INI_PATH must be set");
let lib = SSV::new(SupportedFsvVersion::V1_40_13)?;
lib.init_library(&sesam_ini_path)?;
Ok(lib)
}
}
#[test]
fn test_init_library() -> Result<()> {
setup::init()?;
Ok(())
}
#[test]
fn test_read_professional_card_good_pin() -> Result<()> {
let lib = setup::init()?;
let pin_code = "1234";
lib.read_professional_card(pin_code)?;
Ok(())
}
#[ignore]
#[test]
fn test_read_professional_card_bad_pin() -> Result<()> {
let lib = setup::init()?;
let pin_code = "0000";
// Should return an error
let err = lib.read_professional_card(pin_code).unwrap_err();
assert_eq!(err.to_string(), "Le code porteur présenté est erroné.");
match err {
Error::SSVError(err) => {
assert_eq!(err as SSVErrorCodes, SSVErrorCodes::CPSPinWrong);
},
_ => panic!("Error type is not SSVError"),
}
Ok(())
}
#[test]
fn test_get_config() -> Result<()> {
let lib = setup::init()?;
lib.get_config()?;
Ok(())
}
}