• Home
• News
• Downloads
• Documentation

  • Deployment
  • Architecture
  • XML format
  • Drivers
  • API reference

    • libvirt
    • virterror
    • Driver support
  • Language bindings
• Wiki
• FAQ
• Bug reports
• Contact
• Related Links
• Sitemap

Module virterror from libvirt

Provides the interfaces of the libvirt library to handle errors raised while using the library.

Table of Contents

Types

typedef struct _virError virError
typedef enum virErrorDomain
typedef enum virErrorLevel
typedef enum virErrorNumber
typedef virError * virErrorPtr

Functions

int	virConnCopyLastError		(virConnectPtr conn, 
					 virErrorPtr to)
virErrorPtr	virConnGetLastError	(virConnectPtr conn)
void	virConnResetLastError		(virConnectPtr conn)
void	virConnSetErrorFunc		(virConnectPtr conn, 
					 void * userData, 
					 virErrorFunc handler)
int	virCopyLastError		(virErrorPtr to)
void	virDefaultErrorFunc		(virErrorPtr err)
typedef virErrorFunc
void	virErrorFunc			(void * userData, 
					 virErrorPtr error)

virErrorPtr	virGetLastError		(void)
void	virResetError			(virErrorPtr err)
void	virResetLastError		(void)
void	virSetErrorFunc			(void * userData, 
					 virErrorFunc handler)

Description

Types

virError

struct virError{

}

virErrorDomain

enum virErrorDomain {

}

virErrorLevel

enum virErrorLevel {

}

virErrorNumber

enum virErrorNumber {

}

Functions

virConnCopyLastError

int	virConnCopyLastError		(virConnectPtr conn, 
					 virErrorPtr to)

Copy the content of the last error caught on that connection One will need to free the result with virResetError()

virConnGetLastError

virErrorPtr	virConnGetLastError	(virConnectPtr conn)

Provide a pointer to the last error caught on that connection Simpler but may not be suitable for multithreaded accesses, in which case use virConnCopyLastError()

virConnResetLastError

void	virConnResetLastError		(virConnectPtr conn)

Reset the last error caught on that connection

virConnSetErrorFunc

void	virConnSetErrorFunc		(virConnectPtr conn, 
					 void * userData, 
					 virErrorFunc handler)

Set a connection error handling function, if @handler is NULL it will reset to default which is to pass error back to the global library handler.

virCopyLastError

int	virCopyLastError		(virErrorPtr to)

Copy the content of the last error caught at the library level One will need to free the result with virResetError()

virDefaultErrorFunc

void	virDefaultErrorFunc		(virErrorPtr err)

Default routine reporting an error to stderr.

virErrorFunc

typedef void	(*virErrorFunc		)	(void * userData, 
					 virErrorPtr error)

Signature of a function to use when there is an error raised by the library.

virGetLastError

virErrorPtr	virGetLastError		(void)

Provide a pointer to the last error caught at the library level Simpler but may not be suitable for multithreaded accesses, in which case use virCopyLastError()

virResetError

void	virResetError			(virErrorPtr err)

Reset the error being pointed to

virResetLastError

void	virResetLastError		(void)

Reset the last error caught at the library level.

virSetErrorFunc

void	virSetErrorFunc			(void * userData, 
					 virErrorFunc handler)

Set a library global error handling function, if @handler is NULL, it will reset to default printing on stderr. The error raised there are those for which no handler at the connection level could caught.