efx_vpd.c revision 291436
11590Srgrimes/*-
21590Srgrimes * Copyright (c) 2009-2015 Solarflare Communications Inc.
31590Srgrimes * All rights reserved.
41590Srgrimes *
51590Srgrimes * Redistribution and use in source and binary forms, with or without
61590Srgrimes * modification, are permitted provided that the following conditions are met:
71590Srgrimes *
81590Srgrimes * 1. Redistributions of source code must retain the above copyright notice,
91590Srgrimes *    this list of conditions and the following disclaimer.
101590Srgrimes * 2. Redistributions in binary form must reproduce the above copyright notice,
111590Srgrimes *    this list of conditions and the following disclaimer in the documentation
121590Srgrimes *    and/or other materials provided with the distribution.
131590Srgrimes *
141590Srgrimes * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
151590Srgrimes * AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO,
161590Srgrimes * THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
171590Srgrimes * PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR
181590Srgrimes * CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL,
191590Srgrimes * EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO,
201590Srgrimes * PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS;
211590Srgrimes * OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY,
221590Srgrimes * WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR
231590Srgrimes * OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE,
241590Srgrimes * EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
251590Srgrimes *
261590Srgrimes * The views and conclusions contained in the software and documentation are
271590Srgrimes * those of the authors and should not be interpreted as representing official
281590Srgrimes * policies, either expressed or implied, of the FreeBSD Project.
291590Srgrimes */
301590Srgrimes
311590Srgrimes#include <sys/cdefs.h>
321590Srgrimes__FBSDID("$FreeBSD: head/sys/dev/sfxge/common/efx_vpd.c 291436 2015-11-29 05:42:49Z arybchik $");
3387712Smarkm
3487712Smarkm#include "efsys.h"
3587712Smarkm#include "efx.h"
3687712Smarkm#include "efx_types.h"
371590Srgrimes#include "efx_regs.h"
3887712Smarkm#include "efx_impl.h"
3969528Sasmodai
401590Srgrimes#if EFSYS_OPT_VPD
411590Srgrimes
421590Srgrimes#define	TAG_TYPE_LBN 7
4387712Smarkm#define	TAG_TYPE_WIDTH 1
4487712Smarkm#define	TAG_TYPE_LARGE_ITEM_DECODE 1
4587712Smarkm#define	TAG_TYPE_SMALL_ITEM_DECODE 0
461590Srgrimes
471590Srgrimes#define	TAG_SMALL_ITEM_NAME_LBN 3
481590Srgrimes#define	TAG_SMALL_ITEM_NAME_WIDTH 4
491590Srgrimes#define	TAG_SMALL_ITEM_SIZE_LBN 0
5087712Smarkm#define	TAG_SMALL_ITEM_SIZE_WIDTH 3
5187712Smarkm
521590Srgrimes#define	TAG_LARGE_ITEM_NAME_LBN 0
531590Srgrimes#define	TAG_LARGE_ITEM_NAME_WIDTH 7
541590Srgrimes
551590Srgrimes#define	TAG_NAME_END_DECODE 0x0f
561590Srgrimes#define	TAG_NAME_ID_STRING_DECODE 0x02
571590Srgrimes#define	TAG_NAME_VPD_R_DECODE 0x10
581590Srgrimes#define	TAG_NAME_VPD_W_DECODE 0x11
591590Srgrimes
601590Srgrimes#if EFSYS_OPT_FALCON
611590Srgrimes
621590Srgrimesstatic efx_vpd_ops_t	__efx_vpd_falcon_ops = {
631590Srgrimes	NULL,			/* evpdo_init */
6417339Sadam	falcon_vpd_size,	/* evpdo_size */
65193488Sbrian	falcon_vpd_read,	/* evpdo_read */
661590Srgrimes	falcon_vpd_verify,	/* evpdo_verify */
6769552Sasmodai	NULL,			/* evpdo_reinit */
6869552Sasmodai	falcon_vpd_get,		/* evpdo_get */
691590Srgrimes	falcon_vpd_set,		/* evpdo_set */
701590Srgrimes	falcon_vpd_next,	/* evpdo_next */
711590Srgrimes	falcon_vpd_write,	/* evpdo_write */
721590Srgrimes	NULL,			/* evpdo_fini */
7317825Speter};
741590Srgrimes
751590Srgrimes#endif	/* EFSYS_OPT_FALCON */
761590Srgrimes
771590Srgrimes#if EFSYS_OPT_SIENA
781590Srgrimes
791590Srgrimesstatic efx_vpd_ops_t	__efx_vpd_siena_ops = {
801590Srgrimes	siena_vpd_init,		/* evpdo_init */
811590Srgrimes	siena_vpd_size,		/* evpdo_size */
821590Srgrimes	siena_vpd_read,		/* evpdo_read */
83193488Sbrian	siena_vpd_verify,	/* evpdo_verify */
84172719Skib	siena_vpd_reinit,	/* evpdo_reinit */
8517339Sadam	siena_vpd_get,		/* evpdo_get */
861590Srgrimes	siena_vpd_set,		/* evpdo_set */
871590Srgrimes	siena_vpd_next,		/* evpdo_next */
881590Srgrimes	siena_vpd_write,	/* evpdo_write */
891590Srgrimes	siena_vpd_fini,		/* evpdo_fini */
901590Srgrimes};
911590Srgrimes
921590Srgrimes#endif	/* EFSYS_OPT_SIENA */
931590Srgrimes
941590Srgrimes#if EFSYS_OPT_HUNTINGTON
951590Srgrimes
961590Srgrimesstatic efx_vpd_ops_t	__efx_vpd_hunt_ops = {
971590Srgrimes	hunt_vpd_init,		/* evpdo_init */
981590Srgrimes	hunt_vpd_size,		/* evpdo_size */
991590Srgrimes	hunt_vpd_read,		/* evpdo_read */
1001590Srgrimes	hunt_vpd_verify,	/* evpdo_verify */
1011590Srgrimes	hunt_vpd_reinit,	/* evpdo_reinit */
1021590Srgrimes	hunt_vpd_get,		/* evpdo_get */
1031590Srgrimes	hunt_vpd_set,		/* evpdo_set */
1041590Srgrimes	hunt_vpd_next,		/* evpdo_next */
1051590Srgrimes	hunt_vpd_write,		/* evpdo_write */
1061590Srgrimes	hunt_vpd_fini,		/* evpdo_fini */
1071590Srgrimes};
1081590Srgrimes
1091590Srgrimes#endif	/* EFSYS_OPT_HUNTINGTON */
1101590Srgrimes
1111590Srgrimes	__checkReturn		efx_rc_t
1121590Srgrimesefx_vpd_init(
1131590Srgrimes	__in			efx_nic_t *enp)
1141590Srgrimes{
11587712Smarkm	efx_vpd_ops_t *evpdop;
11687712Smarkm	efx_rc_t rc;
1171590Srgrimes
1181590Srgrimes	EFSYS_ASSERT3U(enp->en_magic, ==, EFX_NIC_MAGIC);
119172719Skib	EFSYS_ASSERT3U(enp->en_mod_flags, &, EFX_MOD_PROBE);
120172719Skib	EFSYS_ASSERT(!(enp->en_mod_flags & EFX_MOD_VPD));
12117341Sadam
1221590Srgrimes	switch (enp->en_family) {
1231590Srgrimes#if EFSYS_OPT_FALCON
1241590Srgrimes	case EFX_FAMILY_FALCON:
1251590Srgrimes		evpdop = (efx_vpd_ops_t *)&__efx_vpd_falcon_ops;
1261590Srgrimes		break;
1271590Srgrimes#endif	/* EFSYS_OPT_FALCON */
1281590Srgrimes
1291590Srgrimes#if EFSYS_OPT_SIENA
1301590Srgrimes	case EFX_FAMILY_SIENA:
1311590Srgrimes		evpdop = (efx_vpd_ops_t *)&__efx_vpd_siena_ops;
1321590Srgrimes		break;
1331590Srgrimes#endif	/* EFSYS_OPT_SIENA */
13417339Sadam
135193488Sbrian#if EFSYS_OPT_HUNTINGTON
1361590Srgrimes	case EFX_FAMILY_HUNTINGTON:
1371590Srgrimes		evpdop = (efx_vpd_ops_t *)&__efx_vpd_hunt_ops;
138116156Smarkm		break;
1391590Srgrimes#endif	/* EFSYS_OPT_HUNTINGTON */
1401590Srgrimes
14187712Smarkm	default:
142172719Skib		EFSYS_ASSERT(0);
14387712Smarkm		rc = ENOTSUP;
144116156Smarkm		goto fail1;
1451590Srgrimes	}
146245184Sdelphij
147245184Sdelphij	if (evpdop->evpdo_init != NULL) {
148173285Scharnier		if ((rc = evpdop->evpdo_init(enp)) != 0)
1491590Srgrimes			goto fail2;
150172719Skib	}
1511590Srgrimes
1521590Srgrimes	enp->en_evpdop = evpdop;
1531590Srgrimes	enp->en_mod_flags |= EFX_MOD_VPD;
1541590Srgrimes
15517825Speter	return (0);
1561590Srgrimes
1571590Srgrimesfail2:
1581590Srgrimes	EFSYS_PROBE(fail2);
1591590Srgrimesfail1:
160116156Smarkm	EFSYS_PROBE1(fail1, efx_rc_t, rc);
16187712Smarkm
16287712Smarkm	return (rc);
16387712Smarkm}
16417825Speter
1651590Srgrimes	__checkReturn		efx_rc_t
16687712Smarkmefx_vpd_size(
1671590Srgrimes	__in			efx_nic_t *enp,
1681590Srgrimes	__out			size_t *sizep)
1691590Srgrimes{
1701590Srgrimes	efx_vpd_ops_t *evpdop = enp->en_evpdop;
1711590Srgrimes	efx_rc_t rc;
1721590Srgrimes
1731590Srgrimes	EFSYS_ASSERT3U(enp->en_magic, ==, EFX_NIC_MAGIC);
1741590Srgrimes	EFSYS_ASSERT3U(enp->en_mod_flags, &, EFX_MOD_VPD);
1751590Srgrimes
176193488Sbrian	if ((rc = evpdop->evpdo_size(enp, sizep)) != 0)
177172719Skib		goto fail1;
178172719Skib
1791590Srgrimes	return (0);
1801590Srgrimes
18187712Smarkmfail1:
182173838Savatar	EFSYS_PROBE1(fail1, efx_rc_t, rc);
18387712Smarkm
1841590Srgrimes	return (rc);
1851590Srgrimes}
1861590Srgrimes
1871590Srgrimes	__checkReturn		efx_rc_t
1881590Srgrimesefx_vpd_read(
1891590Srgrimes	__in			efx_nic_t *enp,
1901590Srgrimes	__out_bcount(size)	caddr_t data,
191116156Smarkm	__in			size_t size)
19287712Smarkm{
1931590Srgrimes	efx_vpd_ops_t *evpdop = enp->en_evpdop;
194116156Smarkm	efx_rc_t rc;
19587712Smarkm
1961590Srgrimes	EFSYS_ASSERT3U(enp->en_magic, ==, EFX_NIC_MAGIC);
1971590Srgrimes	EFSYS_ASSERT3U(enp->en_mod_flags, &, EFX_MOD_VPD);
198116156Smarkm
19987712Smarkm	if ((rc = evpdop->evpdo_read(enp, data, size)) != 0)
200116156Smarkm		goto fail1;
20187712Smarkm
2021590Srgrimes	return (0);
203172719Skib
204172719Skibfail1:
205172719Skib	EFSYS_PROBE1(fail1, efx_rc_t, rc);
206172719Skib
207172719Skib	return (rc);
208172719Skib}
2091590Srgrimes
210	__checkReturn		efx_rc_t
211efx_vpd_verify(
212	__in			efx_nic_t *enp,
213	__in_bcount(size)	caddr_t data,
214	__in			size_t size)
215{
216	efx_vpd_ops_t *evpdop = enp->en_evpdop;
217	efx_rc_t rc;
218
219	EFSYS_ASSERT3U(enp->en_magic, ==, EFX_NIC_MAGIC);
220	EFSYS_ASSERT3U(enp->en_mod_flags, &, EFX_MOD_VPD);
221
222	if ((rc = evpdop->evpdo_verify(enp, data, size)) != 0)
223		goto fail1;
224
225	return (0);
226
227fail1:
228	EFSYS_PROBE1(fail1, efx_rc_t, rc);
229
230	return (rc);
231}
232
233	__checkReturn		efx_rc_t
234efx_vpd_reinit(
235	__in			efx_nic_t *enp,
236	__in_bcount(size)	caddr_t data,
237	__in			size_t size)
238{
239	efx_vpd_ops_t *evpdop = enp->en_evpdop;
240	efx_rc_t rc;
241
242	EFSYS_ASSERT3U(enp->en_magic, ==, EFX_NIC_MAGIC);
243	EFSYS_ASSERT3U(enp->en_mod_flags, &, EFX_MOD_VPD);
244
245	if (evpdop->evpdo_reinit == NULL) {
246		rc = ENOTSUP;
247		goto fail1;
248	}
249
250	if ((rc = evpdop->evpdo_reinit(enp, data, size)) != 0)
251		goto fail2;
252
253	return (0);
254
255fail2:
256	EFSYS_PROBE(fail2);
257fail1:
258	EFSYS_PROBE1(fail1, efx_rc_t, rc);
259
260	return (rc);
261}
262
263	__checkReturn		efx_rc_t
264efx_vpd_get(
265	__in			efx_nic_t *enp,
266	__in_bcount(size)	caddr_t data,
267	__in			size_t size,
268	__inout			efx_vpd_value_t *evvp)
269{
270	efx_vpd_ops_t *evpdop = enp->en_evpdop;
271	efx_rc_t rc;
272
273	EFSYS_ASSERT3U(enp->en_magic, ==, EFX_NIC_MAGIC);
274	EFSYS_ASSERT3U(enp->en_mod_flags, &, EFX_MOD_VPD);
275
276	if ((rc = evpdop->evpdo_get(enp, data, size, evvp)) != 0)
277		goto fail1;
278
279	return (0);
280
281fail1:
282	EFSYS_PROBE1(fail1, efx_rc_t, rc);
283
284	return (rc);
285}
286
287	__checkReturn		efx_rc_t
288efx_vpd_set(
289	__in			efx_nic_t *enp,
290	__inout_bcount(size)	caddr_t data,
291	__in			size_t size,
292	__in			efx_vpd_value_t *evvp)
293{
294	efx_vpd_ops_t *evpdop = enp->en_evpdop;
295	efx_rc_t rc;
296
297	EFSYS_ASSERT3U(enp->en_magic, ==, EFX_NIC_MAGIC);
298	EFSYS_ASSERT3U(enp->en_mod_flags, &, EFX_MOD_VPD);
299
300	if ((rc = evpdop->evpdo_set(enp, data, size, evvp)) != 0)
301		goto fail1;
302
303	return (0);
304
305fail1:
306	EFSYS_PROBE1(fail1, efx_rc_t, rc);
307
308	return (rc);
309}
310
311	__checkReturn		efx_rc_t
312efx_vpd_next(
313	__in			efx_nic_t *enp,
314	__inout_bcount(size)	caddr_t data,
315	__in			size_t size,
316	__out			efx_vpd_value_t *evvp,
317	__inout			unsigned int *contp)
318{
319	efx_vpd_ops_t *evpdop = enp->en_evpdop;
320	efx_rc_t rc;
321
322	EFSYS_ASSERT3U(enp->en_magic, ==, EFX_NIC_MAGIC);
323	EFSYS_ASSERT3U(enp->en_mod_flags, &, EFX_MOD_VPD);
324
325	if ((rc = evpdop->evpdo_next(enp, data, size, evvp, contp)) != 0)
326		goto fail1;
327
328	return (0);
329
330fail1:
331	EFSYS_PROBE1(fail1, efx_rc_t, rc);
332
333	return (rc);
334}
335
336	__checkReturn		efx_rc_t
337efx_vpd_write(
338	__in			efx_nic_t *enp,
339	__in_bcount(size)	caddr_t data,
340	__in			size_t size)
341{
342	efx_vpd_ops_t *evpdop = enp->en_evpdop;
343	efx_rc_t rc;
344
345	EFSYS_ASSERT3U(enp->en_magic, ==, EFX_NIC_MAGIC);
346	EFSYS_ASSERT3U(enp->en_mod_flags, &, EFX_MOD_VPD);
347
348	if ((rc = evpdop->evpdo_write(enp, data, size)) != 0)
349		goto fail1;
350
351	return (0);
352
353fail1:
354	EFSYS_PROBE1(fail1, efx_rc_t, rc);
355
356	return (rc);
357}
358
359static	__checkReturn		efx_rc_t
360efx_vpd_next_tag(
361	__in			caddr_t data,
362	__in			size_t size,
363	__inout			unsigned int *offsetp,
364	__out			efx_vpd_tag_t *tagp,
365	__out			uint16_t *lengthp)
366{
367	efx_byte_t byte;
368	efx_word_t word;
369	uint8_t name;
370	uint16_t length;
371	size_t headlen;
372	efx_rc_t rc;
373
374	if (*offsetp >= size) {
375		rc = EFAULT;
376		goto fail1;
377	}
378
379	EFX_POPULATE_BYTE_1(byte, EFX_BYTE_0, data[*offsetp]);
380
381	switch (EFX_BYTE_FIELD(byte, TAG_TYPE)) {
382	case TAG_TYPE_SMALL_ITEM_DECODE:
383		headlen = 1;
384
385		name = EFX_BYTE_FIELD(byte, TAG_SMALL_ITEM_NAME);
386		length = (uint16_t)EFX_BYTE_FIELD(byte, TAG_SMALL_ITEM_SIZE);
387
388		break;
389
390	case TAG_TYPE_LARGE_ITEM_DECODE:
391		headlen = 3;
392
393		if (*offsetp + headlen > size) {
394			rc = EFAULT;
395			goto fail2;
396		}
397
398		name = EFX_BYTE_FIELD(byte, TAG_LARGE_ITEM_NAME);
399		EFX_POPULATE_WORD_2(word,
400				    EFX_BYTE_0, data[*offsetp + 1],
401				    EFX_BYTE_1, data[*offsetp + 2]);
402		length = EFX_WORD_FIELD(word, EFX_WORD_0);
403
404		break;
405
406	default:
407		rc = EFAULT;
408		goto fail2;
409	}
410
411	if (*offsetp + headlen + length > size) {
412		rc = EFAULT;
413		goto fail3;
414	}
415
416	EFX_STATIC_ASSERT(TAG_NAME_END_DECODE == EFX_VPD_END);
417	EFX_STATIC_ASSERT(TAG_NAME_ID_STRING_DECODE == EFX_VPD_ID);
418	EFX_STATIC_ASSERT(TAG_NAME_VPD_R_DECODE == EFX_VPD_RO);
419	EFX_STATIC_ASSERT(TAG_NAME_VPD_W_DECODE == EFX_VPD_RW);
420	if (name != EFX_VPD_END && name != EFX_VPD_ID &&
421	    name != EFX_VPD_RO) {
422		rc = EFAULT;
423		goto fail4;
424	}
425
426	*tagp = name;
427	*lengthp = length;
428	*offsetp += headlen;
429
430	return (0);
431
432fail4:
433	EFSYS_PROBE(fail4);
434fail3:
435	EFSYS_PROBE(fail3);
436fail2:
437	EFSYS_PROBE(fail2);
438fail1:
439	EFSYS_PROBE1(fail1, efx_rc_t, rc);
440
441	return (rc);
442}
443
444static	__checkReturn		efx_rc_t
445efx_vpd_next_keyword(
446	__in_bcount(size)	caddr_t tag,
447	__in			size_t size,
448	__in			unsigned int pos,
449	__out			efx_vpd_keyword_t *keywordp,
450	__out			uint8_t *lengthp)
451{
452	efx_vpd_keyword_t keyword;
453	uint8_t length;
454	efx_rc_t rc;
455
456	if (pos + 3U > size) {
457		rc = EFAULT;
458		goto fail1;
459	}
460
461	keyword = EFX_VPD_KEYWORD(tag[pos], tag[pos + 1]);
462	length = tag[pos + 2];
463
464	if (length == 0 || pos + 3U + length > size) {
465		rc = EFAULT;
466		goto fail2;
467	}
468
469	*keywordp = keyword;
470	*lengthp = length;
471
472	return (0);
473
474fail2:
475	EFSYS_PROBE(fail2);
476fail1:
477	EFSYS_PROBE1(fail1, efx_rc_t, rc);
478
479	return (rc);
480}
481
482	__checkReturn		efx_rc_t
483efx_vpd_hunk_length(
484	__in_bcount(size)	caddr_t data,
485	__in			size_t size,
486	__out			size_t *lengthp)
487{
488	efx_vpd_tag_t tag;
489	unsigned int offset;
490	uint16_t taglen;
491	efx_rc_t rc;
492
493	offset = 0;
494	_NOTE(CONSTANTCONDITION)
495	while (1) {
496		if ((rc = efx_vpd_next_tag(data, size, &offset,
497		    &tag, &taglen)) != 0)
498			goto fail1;
499		offset += taglen;
500		if (tag == EFX_VPD_END)
501			break;
502	}
503
504	*lengthp = offset;
505
506	return (0);
507
508fail1:
509	EFSYS_PROBE1(fail1, efx_rc_t, rc);
510
511	return (rc);
512}
513
514	__checkReturn		efx_rc_t
515efx_vpd_hunk_verify(
516	__in_bcount(size)	caddr_t data,
517	__in			size_t size,
518	__out_opt		boolean_t *cksummedp)
519{
520	efx_vpd_tag_t tag;
521	efx_vpd_keyword_t keyword;
522	unsigned int offset;
523	unsigned int pos;
524	unsigned int i;
525	uint16_t taglen;
526	uint8_t keylen;
527	uint8_t cksum;
528	boolean_t cksummed = B_FALSE;
529	efx_rc_t rc;
530
531	/*
532	 * Parse every tag,keyword in the existing VPD. If the csum is present,
533	 * the assert it is correct, and is the final keyword in the RO block.
534	 */
535	offset = 0;
536	_NOTE(CONSTANTCONDITION)
537	while (1) {
538		if ((rc = efx_vpd_next_tag(data, size, &offset,
539		    &tag, &taglen)) != 0)
540			goto fail1;
541		if (tag == EFX_VPD_END)
542			break;
543		else if (tag == EFX_VPD_ID)
544			goto done;
545
546		for (pos = 0; pos != taglen; pos += 3 + keylen) {
547			/* RV keyword must be the last in the block */
548			if (cksummed) {
549				rc = EFAULT;
550				goto fail2;
551			}
552
553			if ((rc = efx_vpd_next_keyword(data + offset,
554			    taglen, pos, &keyword, &keylen)) != 0)
555				goto fail3;
556
557			if (keyword == EFX_VPD_KEYWORD('R', 'V')) {
558				cksum = 0;
559				for (i = 0; i < offset + pos + 4; i++)
560					cksum += data[i];
561
562				if (cksum != 0) {
563					rc = EFAULT;
564					goto fail4;
565				}
566
567				cksummed = B_TRUE;
568			}
569		}
570
571	done:
572		offset += taglen;
573	}
574
575	if (!cksummed) {
576		rc = EFAULT;
577		goto fail5;
578	}
579
580	if (cksummedp != NULL)
581		*cksummedp = cksummed;
582
583	return (0);
584
585fail5:
586	EFSYS_PROBE(fail5);
587fail4:
588	EFSYS_PROBE(fail4);
589fail3:
590	EFSYS_PROBE(fail3);
591fail2:
592	EFSYS_PROBE(fail2);
593fail1:
594	EFSYS_PROBE1(fail1, efx_rc_t, rc);
595
596	return (rc);
597}
598
599static	uint8_t	__efx_vpd_blank_pid[] = {
600	/* Large resource type ID length 1 */
601	0x82, 0x01, 0x00,
602	/* Product name ' ' */
603	0x32,
604};
605
606static uint8_t __efx_vpd_blank_r[] = {
607	/* Large resource type VPD-R length 4 */
608	0x90, 0x04, 0x00,
609	/* RV keyword length 1 */
610	'R', 'V', 0x01,
611	/* RV payload checksum */
612	0x00,
613};
614
615	__checkReturn		efx_rc_t
616efx_vpd_hunk_reinit(
617	__in_bcount(size)	caddr_t data,
618	__in			size_t size,
619	__in			boolean_t wantpid)
620{
621	unsigned int offset = 0;
622	unsigned int pos;
623	efx_byte_t byte;
624	uint8_t cksum;
625	efx_rc_t rc;
626
627	if (size < 0x100) {
628		rc = ENOSPC;
629		goto fail1;
630	}
631
632	if (wantpid) {
633		memcpy(data + offset, __efx_vpd_blank_pid,
634		    sizeof (__efx_vpd_blank_pid));
635		offset += sizeof (__efx_vpd_blank_pid);
636	}
637
638	memcpy(data + offset, __efx_vpd_blank_r, sizeof (__efx_vpd_blank_r));
639	offset += sizeof (__efx_vpd_blank_r);
640
641	/* Update checksum */
642	cksum = 0;
643	for (pos = 0; pos < offset; pos++)
644		cksum += data[pos];
645	data[offset - 1] -= cksum;
646
647	/* Append trailing tag */
648	EFX_POPULATE_BYTE_3(byte,
649			    TAG_TYPE, TAG_TYPE_SMALL_ITEM_DECODE,
650			    TAG_SMALL_ITEM_NAME, TAG_NAME_END_DECODE,
651			    TAG_SMALL_ITEM_SIZE, 0);
652	data[offset] = EFX_BYTE_FIELD(byte, EFX_BYTE_0);
653	offset++;
654
655	return (0);
656
657fail1:
658	EFSYS_PROBE1(fail1, efx_rc_t, rc);
659
660	return (rc);
661}
662
663	__checkReturn			efx_rc_t
664efx_vpd_hunk_next(
665	__in_bcount(size)		caddr_t data,
666	__in				size_t size,
667	__out				efx_vpd_tag_t *tagp,
668	__out				efx_vpd_keyword_t *keywordp,
669	__out_bcount_opt(*paylenp)	unsigned int *payloadp,
670	__out_opt			uint8_t *paylenp,
671	__inout				unsigned int *contp)
672{
673	efx_vpd_tag_t tag;
674	efx_vpd_keyword_t keyword = 0;
675	unsigned int offset;
676	unsigned int pos;
677	unsigned int index;
678	uint16_t taglen;
679	uint8_t keylen;
680	uint8_t paylen;
681	efx_rc_t rc;
682
683	offset = index = 0;
684	_NOTE(CONSTANTCONDITION)
685	while (1) {
686		if ((rc = efx_vpd_next_tag(data, size, &offset,
687		    &tag, &taglen)) != 0)
688			goto fail1;
689		if (tag == EFX_VPD_END)
690			break;
691
692		if (tag == EFX_VPD_ID) {
693			if (index == *contp) {
694				EFSYS_ASSERT3U(taglen, <, 0x100);
695				paylen = (uint8_t)MIN(taglen, 0xff);
696
697				goto done;
698			}
699		} else {
700			for (pos = 0; pos != taglen; pos += 3 + keylen) {
701				if ((rc = efx_vpd_next_keyword(data + offset,
702				    taglen, pos, &keyword, &keylen)) != 0)
703					goto fail2;
704
705				if (index == *contp) {
706					offset += pos + 3;
707					paylen = keylen;
708
709					goto done;
710				}
711			}
712		}
713
714		offset += taglen;
715	}
716
717	*contp = 0;
718	return (0);
719
720done:
721	*tagp = tag;
722	*keywordp = keyword;
723	if (payloadp != NULL)
724		*payloadp = offset;
725	if (paylenp != NULL)
726		*paylenp = paylen;
727
728	++(*contp);
729	return (0);
730
731fail2:
732	EFSYS_PROBE(fail2);
733fail1:
734	EFSYS_PROBE1(fail1, efx_rc_t, rc);
735
736	return (rc);
737}
738
739	__checkReturn		efx_rc_t
740efx_vpd_hunk_get(
741	__in_bcount(size)	caddr_t data,
742	__in			size_t size,
743	__in			efx_vpd_tag_t tag,
744	__in			efx_vpd_keyword_t keyword,
745	__out			unsigned int *payloadp,
746	__out			uint8_t *paylenp)
747{
748	efx_vpd_tag_t itag;
749	efx_vpd_keyword_t ikeyword;
750	unsigned int offset;
751	unsigned int pos;
752	uint16_t taglen;
753	uint8_t keylen;
754	efx_rc_t rc;
755
756	offset = 0;
757	_NOTE(CONSTANTCONDITION)
758	while (1) {
759		if ((rc = efx_vpd_next_tag(data, size, &offset,
760		    &itag, &taglen)) != 0)
761			goto fail1;
762		if (itag == EFX_VPD_END)
763			break;
764
765		if (itag == tag) {
766			if (itag == EFX_VPD_ID) {
767				EFSYS_ASSERT3U(taglen, <, 0x100);
768
769				*paylenp = (uint8_t)MIN(taglen, 0xff);
770				*payloadp = offset;
771				return (0);
772			}
773
774			for (pos = 0; pos != taglen; pos += 3 + keylen) {
775				if ((rc = efx_vpd_next_keyword(data + offset,
776				    taglen, pos, &ikeyword, &keylen)) != 0)
777					goto fail2;
778
779				if (ikeyword == keyword) {
780					*paylenp = keylen;
781					*payloadp = offset + pos + 3;
782					return (0);
783				}
784			}
785		}
786
787		offset += taglen;
788	}
789
790	/* Not an error */
791	return (ENOENT);
792
793fail2:
794	EFSYS_PROBE(fail2);
795fail1:
796	EFSYS_PROBE1(fail1, efx_rc_t, rc);
797
798	return (rc);
799}
800
801	__checkReturn		efx_rc_t
802efx_vpd_hunk_set(
803	__in_bcount(size)	caddr_t data,
804	__in			size_t size,
805	__in			efx_vpd_value_t *evvp)
806{
807	efx_word_t word;
808	efx_vpd_tag_t tag;
809	efx_vpd_keyword_t keyword;
810	unsigned int offset;
811	unsigned int pos;
812	unsigned int taghead;
813	unsigned int source;
814	unsigned int dest;
815	unsigned int i;
816	uint16_t taglen;
817	uint8_t keylen;
818	uint8_t cksum;
819	size_t used;
820	efx_rc_t rc;
821
822	switch (evvp->evv_tag) {
823	case EFX_VPD_ID:
824		if (evvp->evv_keyword != 0) {
825			rc = EINVAL;
826			goto fail1;
827		}
828
829		/* Can't delete the ID keyword */
830		if (evvp->evv_length == 0) {
831			rc = EINVAL;
832			goto fail1;
833		}
834		break;
835
836	case EFX_VPD_RO:
837		if (evvp->evv_keyword == EFX_VPD_KEYWORD('R', 'V')) {
838			rc = EINVAL;
839			goto fail1;
840		}
841		break;
842
843	default:
844		rc = EINVAL;
845		goto fail1;
846	}
847
848	/* Determine total size of all current tags */
849	if ((rc = efx_vpd_hunk_length(data, size, &used)) != 0)
850		goto fail2;
851
852	offset = 0;
853	_NOTE(CONSTANTCONDITION)
854	while (1) {
855		taghead = offset;
856		if ((rc = efx_vpd_next_tag(data, size, &offset,
857		    &tag, &taglen)) != 0)
858			goto fail3;
859		if (tag == EFX_VPD_END)
860			break;
861		else if (tag != evvp->evv_tag) {
862			offset += taglen;
863			continue;
864		}
865
866		/* We only support modifying large resource tags */
867		if (offset - taghead != 3) {
868			rc = EINVAL;
869			goto fail4;
870		}
871
872		/*
873		 * Work out the offset of the byte immediately after the
874		 * old (=source) and new (=dest) new keyword/tag
875		 */
876		pos = 0;
877		if (tag == EFX_VPD_ID) {
878			source = offset + taglen;
879			dest = offset + evvp->evv_length;
880			goto check_space;
881		}
882
883		EFSYS_ASSERT3U(tag, ==, EFX_VPD_RO);
884		source = dest = 0;
885		for (pos = 0; pos != taglen; pos += 3 + keylen) {
886			if ((rc = efx_vpd_next_keyword(data + offset,
887			    taglen, pos, &keyword, &keylen)) != 0)
888				goto fail5;
889
890			if (keyword == evvp->evv_keyword &&
891			    evvp->evv_length == 0) {
892				/* Deleting this keyword */
893				source = offset + pos + 3 + keylen;
894				dest = offset + pos;
895				break;
896
897			} else if (keyword == evvp->evv_keyword) {
898				/* Adjusting this keyword */
899				source = offset + pos + 3 + keylen;
900				dest = offset + pos + 3 + evvp->evv_length;
901				break;
902
903			} else if (keyword == EFX_VPD_KEYWORD('R', 'V')) {
904				/* The RV keyword must be at the end */
905				EFSYS_ASSERT3U(pos + 3 + keylen, ==, taglen);
906
907				/*
908				 * The keyword doesn't already exist. If the
909				 * user deleting a non-existant keyword then
910				 * this is a no-op.
911				 */
912				if (evvp->evv_length == 0)
913					return (0);
914
915				/* Insert this keyword before the RV keyword */
916				source = offset + pos;
917				dest = offset + pos + 3 + evvp->evv_length;
918				break;
919			}
920		}
921
922	check_space:
923		if (used + dest > size + source) {
924			rc = ENOSPC;
925			goto fail6;
926		}
927
928		/* Move trailing data */
929		(void) memmove(data + dest, data + source, used - source);
930
931		/* Copy contents */
932		memcpy(data + dest - evvp->evv_length, evvp->evv_value,
933		    evvp->evv_length);
934
935		/* Insert new keyword header if required */
936		if (tag != EFX_VPD_ID && evvp->evv_length > 0) {
937			EFX_POPULATE_WORD_1(word, EFX_WORD_0,
938					    evvp->evv_keyword);
939			data[offset + pos + 0] =
940			    EFX_WORD_FIELD(word, EFX_BYTE_0);
941			data[offset + pos + 1] =
942			    EFX_WORD_FIELD(word, EFX_BYTE_1);
943			data[offset + pos + 2] = evvp->evv_length;
944		}
945
946		/* Modify tag length (large resource type) */
947		taglen += (dest - source);
948		EFX_POPULATE_WORD_1(word, EFX_WORD_0, taglen);
949		data[offset - 2] = EFX_WORD_FIELD(word, EFX_BYTE_0);
950		data[offset - 1] = EFX_WORD_FIELD(word, EFX_BYTE_1);
951
952		goto checksum;
953	}
954
955	/* Unable to find the matching tag */
956	rc = ENOENT;
957	goto fail7;
958
959checksum:
960	/* Find the RV tag, and update the checksum */
961	offset = 0;
962	_NOTE(CONSTANTCONDITION)
963	while (1) {
964		if ((rc = efx_vpd_next_tag(data, size, &offset,
965		    &tag, &taglen)) != 0)
966			goto fail8;
967		if (tag == EFX_VPD_END)
968			break;
969		if (tag == EFX_VPD_RO) {
970			for (pos = 0; pos != taglen; pos += 3 + keylen) {
971				if ((rc = efx_vpd_next_keyword(data + offset,
972				    taglen, pos, &keyword, &keylen)) != 0)
973					goto fail9;
974
975				if (keyword == EFX_VPD_KEYWORD('R', 'V')) {
976					cksum = 0;
977					for (i = 0; i < offset + pos + 3; i++)
978						cksum += data[i];
979					data[i] = -cksum;
980					break;
981				}
982			}
983		}
984
985		offset += taglen;
986	}
987
988	/* Zero out the unused portion */
989	(void) memset(data + offset + taglen, 0xff, size - offset - taglen);
990
991	return (0);
992
993fail9:
994	EFSYS_PROBE(fail9);
995fail8:
996	EFSYS_PROBE(fail8);
997fail7:
998	EFSYS_PROBE(fail7);
999fail6:
1000	EFSYS_PROBE(fail6);
1001fail5:
1002	EFSYS_PROBE(fail5);
1003fail4:
1004	EFSYS_PROBE(fail4);
1005fail3:
1006	EFSYS_PROBE(fail3);
1007fail2:
1008	EFSYS_PROBE(fail2);
1009fail1:
1010	EFSYS_PROBE1(fail1, efx_rc_t, rc);
1011
1012	return (rc);
1013}
1014
1015				void
1016efx_vpd_fini(
1017	__in			efx_nic_t *enp)
1018{
1019	efx_vpd_ops_t *evpdop = enp->en_evpdop;
1020
1021	EFSYS_ASSERT3U(enp->en_magic, ==, EFX_NIC_MAGIC);
1022	EFSYS_ASSERT3U(enp->en_mod_flags, &, EFX_MOD_PROBE);
1023	EFSYS_ASSERT3U(enp->en_mod_flags, &, EFX_MOD_VPD);
1024
1025	if (evpdop->evpdo_fini != NULL)
1026		evpdop->evpdo_fini(enp);
1027
1028	enp->en_evpdop = NULL;
1029	enp->en_mod_flags &= ~EFX_MOD_VPD;
1030}
1031
1032#endif	/* EFSYS_OPT_VPD */
1033