nvo.h File Reference

Non-volatile stored options. More...

#include <stdint.h>
#include <ipxe/dhcpopts.h>
#include <ipxe/settings.h>

Go to the source code of this file.

Data Structures
struct	nvo_block
	A block of non-volatile stored options. More...

Macros
#define	NVO_SETTINGS_NAME   "nvo"
	Name of non-volatile options settings block.

Functions
	FILE_LICENCE (GPL2_OR_LATER_OR_UBDL)
	FILE_SECBOOT (PERMITTED)
int	nvo_applies (struct settings *settings, const struct setting *setting)
void	nvo_init (struct nvo_block *nvo, struct nvs_device *nvs, size_t address, size_t len, int(*resize)(struct nvo_block *nvo, size_t len), struct refcnt *refcnt)
	Initialise non-volatile stored options.
int	register_nvo (struct nvo_block *nvo, struct settings *parent)
	Register non-volatile stored options.
void	unregister_nvo (struct nvo_block *nvo)
	Unregister non-volatile stored options.

Detailed Description

Non-volatile stored options.

Definition in file nvo.h.

Macro Definition Documentation

NVO_SETTINGS_NAME

#define NVO_SETTINGS_NAME   "nvo"

Name of non-volatile options settings block.

Definition at line 47 of file nvo.h.

Referenced by efi_snp_hii_settings(), and register_nvo().

Function Documentation

FILE_LICENCE()

FILE_LICENCE

(

GPL2_OR_LATER_OR_UBDL

)

FILE_SECBOOT()

FILE_SECBOOT

(

PERMITTED

)

nvo_applies()

int nvo_applies ( struct settings * settings, const struct setting * setting )

extern

References address, and len.

nvo_init()

void nvo_init ( struct nvo_block * nvo, struct nvs_device * nvs, size_t address, size_t len, int(* resize )(struct nvo_block *nvo, size_t len), struct refcnt * refcnt )

extern

Initialise non-volatile stored options.

Parameters

nvo	Non-volatile options block
nvs	Underlying non-volatile storage device
address	Address within NVS device
len	Length of non-volatile options data
resize	Resize method
refcnt	Containing object reference counter, or NULL

Definition at line 274 of file nvo.c.

                                        {
        nvo->nvs = nvs;
        nvo->address = address;
        nvo->len = len;
        nvo->resize = resize;
        dhcpopt_init ( &nvo->dhcpopts, NULL, 0, nvo_realloc_dhcpopt );
        settings_init ( &nvo->settings, &nvo_settings_operations,
                        refcnt, NULL );
}

References address, nvo_block::address, dhcpopt_init(), nvo_block::dhcpopts, len, nvo_block::len, NULL, nvo_realloc_dhcpopt(), nvo_settings_operations, nvo_block::nvs, nvo_block::resize, nvo_block::settings, and settings_init().

Referenced by falcon_probe_spi(), myri10ge_nv_init(), nvs_vpd_nvo_init(), and realtek_init_eeprom().

register_nvo()

int register_nvo ( struct nvo_block * nvo, struct settings * parent )

extern

Register non-volatile stored options.

Parameters

nvo	Non-volatile options block
parent	Parent settings block, or NULL

Return values

rc	Return status code

Definition at line 294 of file nvo.c.

                                                                    {
        int rc;
 
        /* Allocate memory for options */
        if ( ( rc = nvo_realloc ( nvo, nvo->len ) ) != 0 )
                goto err_realloc;
 
        /* Read data from NVS */
        if ( ( rc = nvo_load ( nvo ) ) != 0 )
                goto err_load;
 
        /* Register settings */
        if ( ( rc = register_settings ( &nvo->settings, parent,
                                        NVO_SETTINGS_NAME ) ) != 0 )
                goto err_register;
 
        DBGC ( nvo, "NVO %p registered\n", nvo );
        return 0;
        
 err_register:
 err_load:
        nvo_realloc ( nvo, 0 );
 err_realloc:
        return rc;
}

References DBGC, nvo_block::len, nvo_load(), nvo_realloc(), NVO_SETTINGS_NAME, rc, register_settings(), and nvo_block::settings.

Referenced by efab_probe(), hermon_register_netdev(), myri10ge_nv_init(), and realtek_probe().

unregister_nvo()

void unregister_nvo ( struct nvo_block * nvo )

extern

Unregister non-volatile stored options.

Parameters

nvo	Non-volatile options block

Definition at line 325 of file nvo.c.

                                              {
        unregister_settings ( &nvo->settings );
        nvo_realloc ( nvo, 0 );
        DBGC ( nvo, "NVO %p unregistered\n", nvo );
}

References DBGC, nvo_realloc(), nvo_block::settings, and unregister_settings().

Referenced by efab_remove(), hermon_register_netdev(), hermon_unregister_netdev(), myri10ge_nv_fini(), and realtek_remove().