1 
      This is the java binding to the libvirt library.
2 





3

To use it, your program needs to access both the java library (.jar file),





4

and the JNA library (.jar file)





5






6

1. This version of the java mappings is designed to work with a 





7

a minimum libvirt version of @libvirt.required@





8






9

2. You must have the libvirt.jar file in your classpath.





10

By default the installs it to /usr/share/java/@version@.jar





11






12

3. See the INSTALL file for instructions on building locally.





13






14

4. You can run the unit tests with ant test.





15






16

5. There is a rudimentary functional test program that the libvirt-java-devel





17

installs put it into /usr/share/doc/libvirt-java-devel-@version@/test.java





18






19

    To run it, first copy the test.java file to writeable directory





20

    cp /usr/share/doc/libvirt-java-devel-@version@/test.java ~





21






22

    Compile the java file to a class:





23

    javac -classpath /usr/share/java/libvirt-@version@.jar test.java





24






25

    Then run the program:





26

    java -classpath .:/usr/share/java/jna.jar:/usr/share/java/libvirt-@version@.jar test





27






28

6. There is full javadoc for the API in /usr/share/javadoc/libvirt-java-@version@/





29






30

7. The full API can be found at http://www.libvirt.org/html/libvirt-libvirt.html