params.h

Go to the documentation of this file.

#ifndef _IPXE_PARAMS_H
#define _IPXE_PARAMS_H

/** @file
 *
 * Request parameters
 *
 */

FILE_LICENCE ( GPL2_OR_LATER_OR_UBDL );
FILE_SECBOOT ( PERMITTED );

#include <ipxe/list.h>
#include <ipxe/refcnt.h>

/** A request parameter list */
struct parameters {
        /** Reference count */
        struct refcnt refcnt;
        /** List of all parameter lists */
        struct list_head list;
        /** Name */
        const char *name;
        /** Parameters */
        struct list_head entries;
};

/** A request parameter */
struct parameter {
        /** List of request parameters */
        struct list_head list;
        /** Key */
        const char *key;
        /** Value */
        const char *value;
        /** Flags */
        unsigned int flags;
};

/** Request parameter is a form parameter */
#define PARAMETER_FORM 0x0001

/** Request parameter is a header parameter */
#define PARAMETER_HEADER 0x0002

/**
 * Increment request parameter list reference count
 *
 * @v params            Parameter list, or NULL
 * @ret params          Parameter list as passed in
 */
static inline __attribute__ (( always_inline )) struct parameters *
params_get ( struct parameters *params ) {
        ref_get ( &params->refcnt );
        return params;
}

/**
 * Decrement request parameter list reference count
 *
 * @v params            Parameter list, or NULL
 */
static inline __attribute__ (( always_inline )) void
params_put ( struct parameters *params ) {
        ref_put ( &params->refcnt );
}

/**
 * Claim ownership of request parameter list
 *
 * @v params            Parameter list
 * @ret params          Parameter list
 */
static inline __attribute__ (( always_inline )) struct parameters *
claim_parameters ( struct parameters *params ) {

        /* Remove from list of parameter lists */
        list_del ( &params->list );

        return params;
}

/** Iterate over all request parameters in a list */
#define for_each_param( param, params )                         \
        list_for_each_entry ( (param), &(params)->entries, list )

extern struct parameters * find_parameters ( const char *name );
extern struct parameters * create_parameters ( const char *name );
extern struct parameter * add_parameter ( struct parameters *params,
                                          const char *key, const char *value,
                                          unsigned int flags );

#endif /* _IPXE_PARAMS_H */