Draft Draft
v
Preface ix
1. Document Conventions ................................................................................................... ix
1.1. Typographic Conventions ..................................................................................... ix
1.2. Pull-quote Conventions ......................................................................................... x
1.3. Notes and Warnings ............................................................................................ xi
2. We Need Feedback! ....................................................................................................... xi
1. Introduction 1
1.1. Overview ..................................................................................................................... 1
1.2. Glossary of terms ......................................................................................................... 1
2. Architecture 3
2.1. Object model ............................................................................................................... 3
2.1.1. Hypervisor connections ...................................................................................... 3
2.1.2. Guest domains .................................................................................................. 3
2.1.3. Virtual networks ................................................................................................. 4
2.1.4. Storage pools .................................................................................................... 4
2.1.5. Storage volumes ............................................................................................... 5
2.1.6. Host devices ..................................................................................................... 5
2.2. Driver model ................................................................................................................ 6
2.3. Remote management ................................................................................................... 7
2.3.1. Basic usage ...................................................................................................... 8
2.3.2. Data Transports ................................................................................................. 8
2.3.3. Authentication schemes ..................................................................................... 9
2.4. Generating TLS certificates ......................................................................................... 10
2.4.1. Public Key Infrastructure setup ......................................................................... 10
3. Connections 13
3.1. Overview .................................................................................................................... 13
3.1.1. virConnectOpen ............................................................................................... 13
3.1.2. virConnectOpenReadOnly ................................................................................ 14
3.1.3. virConnectOpenAuth ........................................................................................ 14
3.1.4. virConnectClose .............................................................................................. 17
3.2. URI formats ............................................................................................................... 18
3.2.1. Local URIs ...................................................................................................... 18
3.2.2. Remote URIs .................................................................................................. 19
3.3. Capability information ................................................................................................. 23
3.4. Host information ......................................................................................................... 26
3.4.1. virConnectGetHostname ................................................................................... 27
3.4.2. virConnectGetMaxVcpus .................................................................................. 27
3.4.3. virNodeGetFreeMemory ................................................................................... 28
3.4.4. virNodeGetInfo ................................................................................................ 28
3.4.5. virNodeGetCellsFreeMemory ............................................................................ 29
3.4.6. virConnectGetType .......................................................................................... 30
3.4.7. virConnectGetVersion ....................................................................................... 31
3.4.8. virConnectGetLibVersion .................................................................................. 31
3.4.9. virConnectGetURI ............................................................................................ 32
3.4.10. virConnectIsEncrypted .................................................................................... 32
3.4.11. virConnectIsSecure ........................................................................................ 33
3.5. Event loop integration ................................................................................................. 33
3.6. Security model ........................................................................................................... 34
3.7. Error handling ............................................................................................................ 34
3.7.1. virSetErrorFunc ................................................................................................ 38
