Home | History | Annotate | Line # | Download | only in public 
      1 /******************************************************************************
      2  * version.h
      3  *
      4  * Xen version, type, and compile information.
      5  *
      6  * Permission is hereby granted, free of charge, to any person obtaining a copy
      7  * of this software and associated documentation files (the "Software"), to
      8  * deal in the Software without restriction, including without limitation the
      9  * rights to use, copy, modify, merge, publish, distribute, sublicense, and/or
     10  * sell copies of the Software, and to permit persons to whom the Software is
     11  * furnished to do so, subject to the following conditions:
     12  *
     13  * The above copyright notice and this permission notice shall be included in
     14  * all copies or substantial portions of the Software.
     15  *
     16  * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
     17  * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
     18  * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
     19  * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
     20  * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
     21  * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER
     22  * DEALINGS IN THE SOFTWARE.
     23  *
     24  * Copyright (c) 2005, Nguyen Anh Quynh <aquynh (at) gmail.com>
     25  * Copyright (c) 2005, Keir Fraser <keir (at) xensource.com>
     26  */
     27 
     28 #ifndef __XEN_PUBLIC_VERSION_H__
     29 #define __XEN_PUBLIC_VERSION_H__
     30 
     31 #include "xen.h"
     32 
     33 /* NB. All ops return zero on success, except XENVER_{version,pagesize}
     34  * XENVER_{version,pagesize,build_id} */
     35 
     36 /* arg == NULL; returns major:minor (16:16). */
     37 #define XENVER_version      0
     38 
     39 /* arg == xen_extraversion_t. */
     40 #define XENVER_extraversion 1
     41 typedef char xen_extraversion_t[16];
     42 #define XEN_EXTRAVERSION_LEN (sizeof(xen_extraversion_t))
     43 
     44 /* arg == xen_compile_info_t. */
     45 #define XENVER_compile_info 2
     46 struct xen_compile_info {
     47     char compiler[64];
     48     char compile_by[16];
     49     char compile_domain[32];
     50     char compile_date[32];
     51 };
     52 typedef struct xen_compile_info xen_compile_info_t;
     53 
     54 #define XENVER_capabilities 3
     55 typedef char xen_capabilities_info_t[1024];
     56 #define XEN_CAPABILITIES_INFO_LEN (sizeof(xen_capabilities_info_t))
     57 
     58 #define XENVER_changeset 4
     59 typedef char xen_changeset_info_t[64];
     60 #define XEN_CHANGESET_INFO_LEN (sizeof(xen_changeset_info_t))
     61 
     62 #define XENVER_platform_parameters 5
     63 struct xen_platform_parameters {
     64     xen_ulong_t virt_start;
     65 };
     66 typedef struct xen_platform_parameters xen_platform_parameters_t;
     67 
     68 #define XENVER_get_features 6
     69 struct xen_feature_info {
     70     unsigned int submap_idx;    /* IN: which 32-bit submap to return */
     71     uint32_t     submap;        /* OUT: 32-bit submap */
     72 };
     73 typedef struct xen_feature_info xen_feature_info_t;
     74 
     75 /* Declares the features reported by XENVER_get_features. */
     76 #include "features.h"
     77 
     78 /* arg == NULL; returns host memory page size. */
     79 #define XENVER_pagesize 7
     80 
     81 /* arg == xen_domain_handle_t.
     82  *
     83  * The toolstack fills it out for guest consumption. It is intended to hold
     84  * the UUID of the guest.
     85  */
     86 #define XENVER_guest_handle 8
     87 
     88 #define XENVER_commandline 9
     89 typedef char xen_commandline_t[1024];
     90 
     91 /*
     92  * Return value is the number of bytes written, or XEN_Exx on error.
     93  * Calling with empty parameter returns the size of build_id.
     94  */
     95 #define XENVER_build_id 10
     96 struct xen_build_id {
     97         uint32_t        len; /* IN: size of buf[]. */
     98 #if defined(__STDC_VERSION__) && __STDC_VERSION__ >= 199901L
     99         unsigned char   buf[];
    100 #elif defined(__GNUC__)
    101         unsigned char   buf[1]; /* OUT: Variable length buffer with build_id. */
    102 #endif
    103 };
    104 typedef struct xen_build_id xen_build_id_t;
    105 
    106 #endif /* __XEN_PUBLIC_VERSION_H__ */
    107 
    108 /*
    109  * Local variables:
    110  * mode: C
    111  * c-file-style: "BSD"
    112  * c-basic-offset: 4
    113  * tab-width: 4
    114  * indent-tabs-mode: nil
    115  * End:
    116  */
    117