iPXE
smbios_settings.c
Go to the documentation of this file.
1 /*
2  * Copyright (C) 2008 Michael Brown <mbrown@fensystems.co.uk>.
3  *
4  * This program is free software; you can redistribute it and/or
5  * modify it under the terms of the GNU General Public License as
6  * published by the Free Software Foundation; either version 2 of the
7  * License, or any later version.
8  *
9  * This program is distributed in the hope that it will be useful, but
10  * WITHOUT ANY WARRANTY; without even the implied warranty of
11  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
12  * General Public License for more details.
13  *
14  * You should have received a copy of the GNU General Public License
15  * along with this program; if not, write to the Free Software
16  * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA
17  * 02110-1301, USA.
18  *
19  * You can also choose to distribute this program under the terms of
20  * the Unmodified Binary Distribution Licence (as given in the file
21  * COPYING.UBDL), provided that you have satisfied its requirements.
22  */
23 
24 FILE_LICENCE ( GPL2_OR_LATER_OR_UBDL );
25 
26 #include <stdint.h>
27 #include <string.h>
28 #include <errno.h>
29 #include <ipxe/settings.h>
30 #include <ipxe/init.h>
31 #include <ipxe/uuid.h>
32 #include <ipxe/smbios.h>
33 
34 /** SMBIOS settings scope */
36 
37 /**
38  * Construct SMBIOS raw-data tag
39  *
40  * @v _type SMBIOS structure type number
41  * @v _structure SMBIOS structure data type
42  * @v _field Field within SMBIOS structure data type
43  * @ret tag SMBIOS setting tag
44  */
45 #define SMBIOS_RAW_TAG( _type, _structure, _field ) \
46  ( ( (_type) << 16 ) | \
47  ( offsetof ( _structure, _field ) << 8 ) | \
48  ( sizeof ( ( ( _structure * ) 0 )->_field ) ) )
49 
50 /**
51  * Construct SMBIOS string tag
52  *
53  * @v _type SMBIOS structure type number
54  * @v _structure SMBIOS structure data type
55  * @v _field Field within SMBIOS structure data type
56  * @ret tag SMBIOS setting tag
57  */
58 #define SMBIOS_STRING_TAG( _type, _structure, _field ) \
59  ( ( (_type) << 16 ) | \
60  ( offsetof ( _structure, _field ) << 8 ) )
61 
62 /**
63  * Check applicability of SMBIOS setting
64  *
65  * @v settings Settings block
66  * @v setting Setting
67  * @ret applies Setting applies within this settings block
68  */
70  const struct setting *setting ) {
71 
72  return ( setting->scope == &smbios_settings_scope );
73 }
74 
75 /**
76  * Fetch value of SMBIOS setting
77  *
78  * @v settings Settings block, or NULL to search all blocks
79  * @v setting Setting to fetch
80  * @v data Buffer to fill with setting data
81  * @v len Length of buffer
82  * @ret len Length of setting data, or negative error
83  */
84 static int smbios_fetch ( struct settings *settings __unused,
85  struct setting *setting,
86  void *data, size_t len ) {
87  struct smbios_structure structure;
88  unsigned int tag_instance;
89  unsigned int tag_type;
90  unsigned int tag_offset;
91  unsigned int tag_len;
92  int rc;
93 
94  /* Split tag into instance, type, offset and length */
95  tag_instance = ( ( setting->tag >> 24 ) & 0xff );
96  tag_type = ( ( setting->tag >> 16 ) & 0xff );
97  tag_offset = ( ( setting->tag >> 8 ) & 0xff );
98  tag_len = ( setting->tag & 0xff );
99 
100  /* Find SMBIOS structure */
101  if ( ( rc = find_smbios_structure ( tag_type, tag_instance,
102  &structure ) ) != 0 )
103  return rc;
104 
105  {
106  uint8_t buf[structure.header.len];
107  const void *raw;
108  union uuid uuid;
109  unsigned int index;
110 
111  /* Read SMBIOS structure */
112  if ( ( rc = read_smbios_structure ( &structure, buf,
113  sizeof ( buf ) ) ) != 0 )
114  return rc;
115 
116  /* A <length> of zero indicates that the byte at
117  * <offset> contains a string index. An <offset> of
118  * zero indicates that the <length> contains a literal
119  * string index.
120  */
121  if ( ( tag_len == 0 ) || ( tag_offset == 0 ) ) {
122  index = ( ( tag_offset == 0 ) ?
123  tag_len : buf[tag_offset] );
124  if ( ( rc = read_smbios_string ( &structure, index,
125  data, len ) ) < 0 ) {
126  return rc;
127  }
128  if ( ! setting->type )
129  setting->type = &setting_type_string;
130  return rc;
131  }
132 
133  /* Mangle UUIDs if necessary. iPXE treats UUIDs as
134  * being in network byte order (big-endian). SMBIOS
135  * specification version 2.6 states that UUIDs are
136  * stored with little-endian values in the first three
137  * fields; earlier versions did not specify an
138  * endianness. dmidecode assumes that the byte order
139  * is little-endian if and only if the SMBIOS version
140  * is 2.6 or higher; we match this behaviour.
141  */
142  raw = &buf[tag_offset];
143  if ( ( ( setting->type == &setting_type_uuid ) ||
144  ( setting->type == &setting_type_guid ) ) &&
145  ( tag_len == sizeof ( uuid ) ) &&
146  ( smbios_version() >= SMBIOS_VERSION ( 2, 6 ) ) ) {
147  DBG ( "SMBIOS detected mangled UUID\n" );
148  memcpy ( &uuid, &buf[tag_offset], sizeof ( uuid ) );
149  uuid_mangle ( &uuid );
150  raw = &uuid;
151  }
152 
153  /* Return data */
154  if ( len > tag_len )
155  len = tag_len;
156  memcpy ( data, raw, len );
157  if ( ! setting->type )
158  setting->type = &setting_type_hex;
159  return tag_len;
160  }
161 }
162 
163 /** SMBIOS settings operations */
166  .fetch = smbios_fetch,
167 };
168 
169 /** SMBIOS settings */
170 static struct settings smbios_settings = {
171  .refcnt = NULL,
172  .siblings = LIST_HEAD_INIT ( smbios_settings.siblings ),
173  .children = LIST_HEAD_INIT ( smbios_settings.children ),
175  .default_scope = &smbios_settings_scope,
176 };
177 
178 /** Initialise SMBIOS settings */
179 static void smbios_init ( void ) {
180  int rc;
181 
183  "smbios" ) ) != 0 ) {
184  DBG ( "SMBIOS could not register settings: %s\n",
185  strerror ( rc ) );
186  return;
187  }
188 }
189 
190 /** SMBIOS settings initialiser */
191 struct init_fn smbios_init_fn __init_fn ( INIT_NORMAL ) = {
193 };
194 
195 /** UUID setting obtained via SMBIOS */
196 const struct setting uuid_setting __setting ( SETTING_HOST, uuid ) = {
197  .name = "uuid",
198  .description = "UUID",
201  .type = &setting_type_uuid,
202  .scope = &smbios_settings_scope,
203 };
204 
205 /** Manufacturer name setting */
206 const struct setting manufacturer_setting __setting ( SETTING_HOST_EXTRA,
207  manufacturer ) = {
208  .name = "manufacturer",
209  .description = "Manufacturer",
212  manufacturer ),
213  .type = &setting_type_string,
214  .scope = &smbios_settings_scope,
215 };
216 
217 /** Product name setting */
218 const struct setting product_setting __setting ( SETTING_HOST_EXTRA, product )={
219  .name = "product",
220  .description = "Product name",
223  product ),
224  .type = &setting_type_string,
225  .scope = &smbios_settings_scope,
226 };
227 
228 /** Serial number setting */
229 const struct setting serial_setting __setting ( SETTING_HOST_EXTRA, serial ) = {
230  .name = "serial",
231  .description = "Serial number",
234  serial ),
235  .type = &setting_type_string,
236  .scope = &smbios_settings_scope,
237 };
238 
239 /** Asset tag setting */
240 const struct setting asset_setting __setting ( SETTING_HOST_EXTRA, asset ) = {
241  .name = "asset",
242  .description = "Asset tag",
245  asset_tag ),
246  .type = &setting_type_string,
247  .scope = &smbios_settings_scope,
248 };
249 
250 /** Board serial number setting (may differ from chassis serial number) */
251 const struct setting board_serial_setting __setting ( SETTING_HOST_EXTRA,
252  board-serial ) = {
253  .name = "board-serial",
254  .description = "Base board serial",
257  serial ),
258  .type = &setting_type_string,
259  .scope = &smbios_settings_scope,
260 };
struct arbelprm_rc_send_wqe rc
Definition: arbel.h:14
static int smbios_fetch(struct settings *settings __unused, struct setting *setting, void *data, size_t len)
Fetch value of SMBIOS setting.
FILE_LICENCE(GPL2_OR_LATER_OR_UBDL)
void(* initialise)(void)
Definition: init.h:15
Error codes.
A universally unique ID.
Definition: uuid.h:15
int read_smbios_structure(struct smbios_structure *structure, void *data, size_t len)
Copy SMBIOS structure.
Definition: smbios.c:241
Universally unique IDs.
#define SMBIOS_TYPE_BASE_BOARD_INFORMATION
SMBIOS base board information structure type.
Definition: smbios.h:174
#define SETTING_HOST_EXTRA
Host identity additional settings.
Definition: settings.h:76
struct smbios_header header
Copy of SMBIOS structure header.
Definition: smbios.h:131
const char * name
Name.
Definition: settings.h:28
static void uuid_mangle(union uuid *uuid)
Change UUID endianness.
Definition: uuid.h:43
uint64_t tag
Setting tag, if applicable.
Definition: settings.h:43
#define INIT_NORMAL
Normal initialisation.
Definition: init.h:30
void * memcpy(void *dest, const void *src, size_t len) __nonnull
uint8_t len
Length.
Definition: smbios.h:123
int find_smbios_structure(unsigned int type, unsigned int instance, struct smbios_structure *structure)
Find specific structure type within SMBIOS.
Definition: smbios.c:170
An initialisation function.
Definition: init.h:14
#define SMBIOS_STRING_TAG(_type, _structure, _field)
Construct SMBIOS string tag.
#define SMBIOS_TYPE_ENCLOSURE_INFORMATION
SMBIOS enclosure information structure type.
Definition: smbios.h:193
uint8_t uuid[16]
UUID.
Definition: smbios.h:22
static void smbios_init(void)
Initialise SMBIOS settings.
int smbios_version(void)
Get SMBIOS version.
Definition: smbios.c:299
int read_smbios_string(struct smbios_structure *structure, unsigned int index, void *data, size_t len)
Find indexed string within SMBIOS structure.
Definition: smbios.c:261
const struct setting_type * type
Setting type.
Definition: settings.h:36
uint8_t asset_tag
Asset tag.
Definition: smbios.h:22
static struct settings smbios_settings
SMBIOS settings.
Configuration settings.
static int smbios_applies(struct settings *settings __unused, const struct setting *setting)
Check applicability of SMBIOS setting.
#define SMBIOS_VERSION(major, minor)
Calculate SMBIOS version.
Definition: smbios.h:225
char * strerror(int errno)
Retrieve string representation of error number.
Definition: strerror.c:78
uint64_t serial
Serial number.
Definition: edd.h:30
Settings block operations.
Definition: settings.h:85
A settings block.
Definition: settings.h:132
unsigned char uint8_t
Definition: stdint.h:10
A setting scope.
Definition: settings.h:176
const struct setting uuid_setting __setting(SETTING_HOST, uuid)
UUID setting obtained via SMBIOS.
struct list_head siblings
Sibling settings blocks.
Definition: settings.h:140
uint8_t manufacturer
Manufacturer string.
Definition: smbios.h:14
A setting.
Definition: settings.h:23
System Management BIOS.
#define __unused
Declare a variable or data structure as unused.
Definition: compiler.h:573
SMBIOS system information structure.
Definition: smbios.h:139
uint32_t len
Length.
Definition: ena.h:14
uint8_t data[48]
Additional event data.
Definition: ena.h:22
#define SMBIOS_RAW_TAG(_type, _structure, _field)
Construct SMBIOS raw-data tag.
uint8_t product
Product string.
Definition: smbios.h:16
__be32 raw[7]
Definition: CIB_PRM.h:28
int(* applies)(struct settings *settings, const struct setting *setting)
Check applicability of setting.
Definition: settings.h:98
struct list_head children
Child settings blocks.
Definition: settings.h:142
int register_settings(struct settings *settings, struct settings *parent, const char *name)
Register settings block.
Definition: settings.c:475
static struct settings_operations smbios_settings_operations
SMBIOS settings operations.
static const struct settings_scope smbios_settings_scope
SMBIOS settings scope.
uint64_t index
Index of the first segment within the content.
Definition: pccrc.h:21
SMBIOS base board information structure.
Definition: smbios.h:160
struct init_fn smbios_init_fn __init_fn(INIT_NORMAL)
SMBIOS settings initialiser.
#define DBG(...)
Print a debugging message.
Definition: compiler.h:498
#define LIST_HEAD_INIT(list)
Initialise a static list head.
Definition: list.h:30
const struct settings_scope * scope
Setting scope (or NULL)
Definition: settings.h:49
SMBIOS structure descriptor.
Definition: smbios.h:129
#define SMBIOS_TYPE_SYSTEM_INFORMATION
SMBIOS system information structure type.
Definition: smbios.h:157
#define NULL
NULL pointer (VOID *)
Definition: Base.h:321
String functions.
SMBIOS enclosure information structure.
Definition: smbios.h:177
struct refcnt * refcnt
Reference counter.
Definition: settings.h:134
#define SETTING_HOST
Host identity settings.
Definition: settings.h:75