Skip to content

Latest commit

 

History

History
42 lines (34 loc) · 2.79 KB

CONTRIBUTING.md

File metadata and controls

42 lines (34 loc) · 2.79 KB

Support and Issues

  • IMPORTANT: If you can not access your card due to invalid keying, please be sure that you can contribute very detailed information about your card and keying data (and send a reference card, if needed) or pinpoint the actual faulty functions in GPPro, before opening a ticket. This is just a tool, you need to do your own lockpicking and are responsible if the tool gets stuck in the lock!
  • Please only file a ticket if you think that there is a bug in GlobalPlatformPro or if something can be improved in GlobalPlatformPro.
  • NO generic questions about java/linux/smartcards/7816/windows/globalplatform/world politics/random APDU-s. They shall be closed as invalid. You may try your luck on stackoverflow.com or do your googling and homework.
  • Questions solely about jcshell/gpshell/gpj/gemexpresso/something else shall be ignored.
    • If you DO have a question about how to use GPPro, start the ticket with Question:
    • Comparative APDU traces from other software might be handy in debugging if specifications remain unclear and are OK
  • Re-run your failing command with -d -v -i switches and send the output (if possible, use --dump) with information about your card and applet/CAP
  • Only plaintext logs. NO screenshots, pictures, word documents.
  • If unsure, first read about asking questions
  • I shall not guide your EMV emulation-cloning adventures, even for some bitcoin(s).
  • If you are asking for help in legitimate a commercial endeavour, send an e-mail to [email protected]

Contributing to GlobalPlatformPro

  • Use the software!
  • Send card information
  • Send debug logs (with --debug and --verbose)
  • All patches must be with MIT license.

Building the software

Simple ant will produce working results if you have the dependencies.

On OSX, if you have Eclipse installed, use this to get "ant" on command line: alias ant="java -jar $(find $(mdfind kMDItemCFBundleIdentifier = org.eclipse.platform.ide) -name ant-launcher.jar)"

Debian/Ubuntu

  • Install dependencies: apt-get install --no-install-recommends libccid openjdk-7-jdk git ant

Fedora/CentOS

  • Install dependencies: yum install pcsc-lite-ccid java-1.8.0-openjdk git ant
  • Start pcscd service: service pcscd start

FreeBSD

  • Install dependencies: pkg install devel/libccid java/openjdk7 devel/apache-ant devel/git

Note about Oracle JDK

Building Windows executable

  • Download launch4j and extract a version matching your host platform into ext/launch4j
  • Run ant windist