vsmartcard-vpcd, vsmartcard-pcsc-relay: init at 0.9-unstable-2024-05-14, nixos/vsmartcard-vpcd: init

[StarGate01]

Description of changes

This PR adds the virtual smart card reader and relay: https://frankmorgner.github.io/vsmartcard/ . It can be used to e.g. emulate a smartcard when combined with e.g. https://jcardsim.org/ , or to debug smartcard communications via an Android phone bridge.

The service module service.services.vsmartcard-vpcd is used to enable and configure the virtual smart card driver. It appends a configuration to the pcscd readers.conf. To facilitate this, the readerConfig option of services.pcscd was upgraded to a list readerConfigs, which is internally joined into the single config file. The old readerConfig option has been marked as deprecated, but continues to work.

Things done

• Built on platform(s)
  • x86_64-linux
  • aarch64-linux
  • x86_64-darwin
  • aarch64-darwin
• For non-Linux: Is sandbox = true set in nix.conf? (See Nix manual)
• Tested, as applicable:
  • NixOS test(s) (look inside nixos/tests)
  • and/or package tests
  • or, for functions and "core" functionality, tests in lib/tests or pkgs/test
  • made sure NixOS tests are linked to the relevant packages
• Tested compilation of all packages that depend on this change using nix-shell -p nixpkgs-review --run "nixpkgs-review rev HEAD". Note: all changes have to be committed, also see nixpkgs-review usage
• Tested basic functionality of all binary files (usually in ./result/bin/)
• 22.11 Release Notes (or backporting 22.05 Release notes)
  • (Package updates) Added a release notes entry if the change is major or breaking
  • (Module updates) Added a release notes entry if the change is significant
  • (Module addition) Added a release notes entry if adding a new NixOS module
  • (Release notes changes) Ran nixos/doc/manual/md-to-db.sh to update generated release notes
• Fits CONTRIBUTING.md.

[StarGate01]

as for the configuration of pcscd, would it be preferable to provide configuration options instead of the readerConfig fragment? E.g.: (see also https://frankmorgner.github.io/vsmartcard/virtualsmartcard/README.html#configuring-vpcd-on-unix)

services.pcscd = {
  enable = true;
  vpcd = {
    enable = true;
    port = 35963;
    hostname = "/dev/null";
  };
  ...
};

The service definition would then generate and append the configuration to readerConfig, and ensure the vcpd package is loaded.

[StarGate01]

@SuperSandro2000 I have implemented all of your suggestions, thank you!

I have also added a service module definition to make configuring the PCSC driver (with the default options) just a simple matter of

services.vsmartcard-vpcd = {
  enable = true;
};

The options port and hostname are exposed as well.

The services.pcscd option readerConfig was upgraded to a list readerConfigs, to allow collection of config fragments from multiple sources. The old option was marked as deprecated but continues to work.

[nixos-discourse]

This pull request has been mentioned on NixOS Discourse. There might be relevant details there:

https://discourse.nixos.org/t/prs-ready-for-review/3032/4220

[StarGate01]

Thank you @SuperSandro2000 for you suggestions, I have implemented them.