This desribes how to get ID-card tool for linux distros working.

Latest version is 0.9.13

Quickstart for Ubuntu people:
	sudo sh -c "echo deb http://kaidokert.com/work/repo binary/ >> /etc/apt/sources.list"
	sudo sh -c "echo deb http://apt.wxwidgets.org/ `grep CODENAME /etc/lsb-release | sed 's/.*=//'`-wx main >> /etc/apt/sources.list"
	sudo apt-get update && sudo apt-get install esteidutil
Done ! the tool should be in the Utilities or Tools menu of your window manager.

For Mandriva ( at least 2008.0 ) : ( still at 0.9.12 for now )
	wget http://kaidokert.com/work/esteidutil-0.9.12-1mdv2008.0.i586.rpm
	rpm -i esteidutil-0.9.12-1mdv2008.0.i586.rpm
Now, read on.

DEB packaging is currently only for Ubuntu, it may or may not, but should work on 
other Debian-based distros. You can always repack Debs from source.

RPM pack is ready for Mandriva 2008.0 ( may work on other RPM-based systems, it
 did for me on OpenSuse 10.3 )

If you are not on Debian-based system, you may simply try to download the binary tarball
	http://kaidokert.com/work/repo/EsteidUtil_0.9.13_Linux86Static.tar.gz
There are no significant dependencies, but no guarantees. For image download support you 
need to have libengine-pkcs11-openssl and libopensc2 installed. Follow installation procedures 
according to your distribution.

The rest of this document describes Debian/APT procedures.

Before starting, make sure you have card reader installed and card subsystem working.
	 pcsc_scan
or, 
	openct-tool list

If pcsc_scan is not installed, install pcsc-related stuff:
	sudo apt-get install pcscd pcsc-tools libccid

Alternatively, openct should also work, but is less tested.
	sudo apt-get install openct

Add the following to /etc/apt/sources.list
	deb http://kaidokert.com/work/repo binary/
	deb-src http://kaidokert.com/work/repo source/ 

Last line is optional, only if you want to rebuild debian source packs.

If you dont have wxWidgets2.8 on your system 
	dpkg -s libwxgtk2.8-0
Then you should also add this line to sources.list:
	deb http://apt.wxwidgets.org/ feisty-wx main

Substitute feisty-wx to edgy-wx or whatever other release of Ubuntu you have.

	sudo apt-get update
	sudo apt-get install esteidutil

If you have a card reader and pcscd running, card inserted and ready, then:
	EsteidUtil

To download your picture ( and test authentication ) you should have OpenSC library
installed and working, also OpenSSL and the SSL engine for OpenSC.
If not:
	sudo apt-get install libopensc2 libssl0.9.8 libengine-pkcs11-openssl

If trying to download the image from EsteidUtil and you get errors about "slot list"
or "certificate loading" make sure that your OpenSC is configured properly for the ID-card:

	pkcs11-tool -L 
Slot 0           SCR24x Smart Card Reader 00 00
  token label:   ID-kaart (PIN1, Isikutuvastus)

If this does not work, you may want to modify your /etc/opensc/opensc.conf, make sure you 
have these lines uncommented:
	try_emulation_first = yes;
	lock_login = false;

If you are seeing many messages like:
	Error: can't open /var/run/openct/status: No such file or directory
on the console, then to reduce debugoutput if you are not using OpenCT readers, change openct 
section in opensc.conf so:
        reader_driver openct {
                readers = 0;
        };

After this, pkcs11-tool -L should work, and image downloading from EsteidUtil should work
as well.

If you have any problems, please first try to run diagnostics from the help menu. In case of
crashes, try the same without inserting the smartcard. If you still get a crash, and know how
to use a debugger, try to get a stack backtrace as well.

Reporting a bug means:
	First following this guide carefully
	Reporting your distribution, smart card reader, and smart card reader drivers
	Getting a diagnostics log from Help->Diagnostics menu, preferrably with the card in the reader
	Describing your type of a problem and how to reproduce it as in much detail as possible
	( Optionally ) In case of crashes submitting a stack backtrace