2 * NVRAM variable manipulation
4 * Copyright 2007, Broadcom Corporation
5 * Copyright 2009, OpenWrt.org
8 * THIS SOFTWARE IS OFFERED "AS IS", AND BROADCOM GRANTS NO WARRANTIES OF ANY
9 * KIND, EXPRESS OR IMPLIED, BY STATUTE, COMMUNICATION OR OTHERWISE. BROADCOM
10 * SPECIFICALLY DISCLAIMS ANY IMPLIED WARRANTIES OF MERCHANTABILITY, FITNESS
11 * FOR A SPECIFIC PURPOSE OR NONINFRINGEMENT CONCERNING THIS SOFTWARE.
26 #include <sys/ioctl.h>
27 #include <arpa/inet.h>
28 #include <linux/limits.h>
30 #include "sdinitvals.h"
36 uint32_t crc_ver_init; /* 0:7 crc, 8:15 ver, 16:31 sdram_init */
37 uint32_t config_refresh; /* 0:15 sdram_config, 16:31 sdram_refresh */
38 uint32_t config_ncdl; /* ncdl values for memc */
44 struct nvram_tuple *next;
51 struct nvram_tuple *nvram_hash[257];
52 struct nvram_tuple *nvram_dead;
55 typedef struct nvram_handle nvram_handle_t;
56 typedef struct nvram_header nvram_header_t;
57 typedef struct nvram_tuple nvram_tuple_t;
60 /* Set the value of an NVRAM variable */
61 int nvram_set(nvram_handle_t *h, const char *name, const char *value);
63 /* Get the value of an NVRAM variable. */
64 char * nvram_get(nvram_handle_t *h, const char *name);
66 /* Unset the value of an NVRAM variable. */
67 int nvram_unset(nvram_handle_t *h, const char *name);
69 /* Get all NVRAM variables. */
70 nvram_tuple_t * nvram_getall(nvram_handle_t *h);
72 /* Regenerate NVRAM. */
73 int nvram_commit(nvram_handle_t *h);
75 /* Open NVRAM and obtain a handle. */
76 nvram_handle_t * nvram_open(const char *file, int rdonly);
78 /* Close NVRAM and free memory. */
79 int nvram_close(nvram_handle_t *h);
81 /* Get the value of an NVRAM variable in a safe way, use "" instead of NULL. */
82 #define nvram_safe_get(h, name) (nvram_get(h, name) ? : "")
84 /* Computes a crc8 over the input data. */
85 uint8_t hndcrc8 (const char * pdata, uint32_t nbytes, uint8_t crc );
87 /* Returns the crc value of the nvram. */
88 uint8_t nvram_calc_crc(nvram_header_t * nvh);
90 /* Determine NVRAM device node. */
91 const char * nvram_find_mtd(void);
93 /* Copy NVRAM contents to staging file. */
94 int nvram_to_staging(void);
96 /* Copy staging file to NVRAM device. */
97 int staging_to_nvram(void);
99 /* Check NVRAM staging file. */
100 const char * nvram_find_staging(void);
103 /* Staging file for NVRAM */
104 #define NVRAM_STAGING "/tmp/.nvram"
109 #define NVRAM_ARRAYSIZE(a) sizeof(a)/sizeof(a[0])
110 #define NVRAM_ROUNDUP(x, y) ((((x)+((y)-1))/(y))*(y))
112 /* The NVRAM version number stored as an NVRAM variable */
113 #define NVRAM_SOFTWARE_VERSION "1"
115 /* NVRAM constants */
116 #define NVRAM_SPACE 0x8000
117 #define NVRAM_START(x) x - NVRAM_SPACE
118 #define NVRAM_MAGIC 0x48534C46 /* 'FLSH' */
119 #define NVRAM_CLEAR_MAGIC 0x0
120 #define NVRAM_INVALID_MAGIC 0xFFFFFFFF
121 #define NVRAM_VERSION 1
122 #define NVRAM_HEADER_SIZE 20
124 #define NVRAM_MAX_VALUE_LEN 255
125 #define NVRAM_MAX_PARAM_LEN 64
127 #define NVRAM_CRC_START_POSITION 9 /* magic, len, crc8 to be skipped */
128 #define NVRAM_CRC_VER_MASK 0xffffff00 /* for crc_ver_init */
131 #endif /* _nvram_h_ */