mfiutil.h - mfiutil - Rivoreo Source Code Repositories

 /*-
  * Copyright (c) 2008, 2009 Yahoo!, Inc.
  * All rights reserved.
  *
  * Redistribution and use in source and binary forms, with or without
  * modification, are permitted provided that the following conditions
  * are met:
  * 1. Redistributions of source code must retain the above copyright
  *    notice, this list of conditions and the following disclaimer.
  * 2. Redistributions in binary form must reproduce the above copyright
  *    notice, this list of conditions and the following disclaimer in the
  *    documentation and/or other materials provided with the distribution.
  * 3. The names of the authors may not be used to endorse or promote
  *    products derived from this software without specific prior written
  *    permission.
  *
  * THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS IS'' AND
  * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
  * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
  * ARE DISCLAIMED.  IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE
  * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
  * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
  * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
  * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
  * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
  * OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
  * SUCH DAMAGE.
  *
  * $FreeBSD: releng/11.1/usr.sbin/mfiutil/mfiutil.h 251516 2013-06-08 02:54:59Z sbruno $
  */

 #ifndef __MFIUTIL_H__
 #define	__MFIUTIL_H__

 #include <sys/cdefs.h>
 #include <stdint.h>
 #ifndef __packed
 #define __packed __attribute__((__packed__))
 #endif
 #ifndef __unused
 #define __unused __attribute__((__unused__))
 #endif
 #ifndef SPECNAMELEN
 // XXX: Taken from kFreeBSD header, need verify
 #define SPECNAMELEN	63		/* max length of devicename */
 #endif
 #include <dev/mfi/mfireg.h>

 /* 4.x compat */
 #ifndef SET_DECLARE

 /* <sys/cdefs.h> */
 #define	__weak_symbol	__attribute__((__weak__))
 #define	__used		__attribute__((__used__))
 #define	__section(x)	__attribute__((__section__(x)))

 #define __GLOBL1(sym) __asm__(".globl " #sym)
 #define __GLOBL(sym) __GLOBL1(sym)

 #if 0
 #define __GNUCLIKE___SECTION
 #include <sys/linker_set.h>
 #else
 /* <sys/linker_set.h> */
 #undef __MAKE_SET
 #undef DATA_SET

 #define __MAKE_SET(set, sym)						\
 	__GLOBL(__CONCAT(__start_set_,set));				\
 	__GLOBL(__CONCAT(__stop_set_,set));				\
 	static void const * const __set_##set##_sym_##sym 		\
 	__section("set_" #set) __used = &sym

 #define DATA_SET(set, sym)	__MAKE_SET(set, sym)

 #define SET_DECLARE(set, ptype)						\
 	extern ptype *__weak_symbol __CONCAT(__start_set_,set);		\
 	extern ptype *__weak_symbol __CONCAT(__stop_set_,set)

 #define SET_BEGIN(set)							\
 	(&__CONCAT(__start_set_,set))
 #define SET_LIMIT(set)							\
 	(&__CONCAT(__stop_set_,set))

 #define	SET_FOREACH(pvar, set)						\
 	for (pvar = SET_BEGIN(set); pvar < SET_LIMIT(set); pvar++)
 #endif

 #ifndef __FreeBSD__
 #include <stdlib.h>

 static inline void *reallocf(void *p, size_t size) {
 	void *new_p = realloc(p, size);
 	if(!new_p) free(p);
 	return new_p;
 }
 #endif

 int	humanize_number(char *_buf, size_t _len, int64_t _number,
 	    const char *_suffix, int _scale, int _flags);

 /* humanize_number(3) */
 #define HN_DECIMAL		0x01
 #define HN_NOSPACE		0x02
 #define HN_B			0x04
 #define HN_DIVISOR_1000		0x08

 #define HN_GETSCALE		0x10
 #define HN_AUTOSCALE		0x20

 extern long int human_readable_binary(unsigned long long int n, int *symbol, unsigned int scale);
 extern int print_human_readable_binary(unsigned long long int n, int symbol, unsigned int scale_factor, int print_width, FILE *f);

 #endif

 /* Constants for DDF RAID levels. */
 #define	DDF_RAID0		0x00
 #define	DDF_RAID1		0x01
 #define	DDF_RAID3		0x03
 #define	DDF_RAID5		0x05
 #define	DDF_RAID6		0x06
 #define	DDF_RAID1E		0x11
 #define	DDF_JBOD		0x0f
 #define	DDF_CONCAT		0x1f
 #define	DDF_RAID5E		0x15
 #define	DDF_RAID5EE		0x25

 struct mfiutil_command {
 	const char *name;
 	int (*handler)(int ac, char **av);
 };

 #define	MFI_DATASET(name)	mfiutil_ ## name ## _table

 #define	MFI_COMMAND(set, name, function)				\
 	static struct mfiutil_command function ## _mfiutil_command =	\
 	{ #name, function };						\
 	DATA_SET(MFI_DATASET(set), function ## _mfiutil_command)

 #define	MFI_TABLE(set, name)						\
 	SET_DECLARE(MFI_DATASET(name), struct mfiutil_command);		\
 									\
 	static int							\
 	mfiutil_ ## name ## _table_handler(int ac, char **av)		\
 	{								\
 		return (mfi_table_handler(SET_BEGIN(MFI_DATASET(name)), \
 		    SET_LIMIT(MFI_DATASET(name)), ac, av));		\
 	}								\
 	MFI_COMMAND(set, name, mfiutil_ ## name ## _table_handler)

 /* Drive name printing options */
 #define	MFI_DNAME_ES		0x0001	/* E%u:S%u */
 #define	MFI_DNAME_DEVICE_ID	0x0002	/* %u */
 #define	MFI_DNAME_HONOR_OPTS	0x8000	/* Allow cmd line to override default */

 extern int mfi_unit;

 extern u_int mfi_opts;

 /* We currently don't know the full details of the following struct */
 struct mfi_foreign_scan_cfg {
         char data[24];
 };

 struct mfi_foreign_scan_info {
         uint32_t count; /* Number of foreign configs found */
         struct mfi_foreign_scan_cfg cfgs[8];
 };

 void	mbox_store_ldref(uint8_t *mbox, union mfi_ld_ref *ref);
 void	mbox_store_pdref(uint8_t *mbox, union mfi_pd_ref *ref);
 void	mfi_display_progress(const char *label, struct mfi_progress *prog);
 int	mfi_table_handler(struct mfiutil_command **start,
     struct mfiutil_command **end, int ac, char **av);
 const char *mfi_raid_level(uint8_t primary_level, uint8_t secondary_level);
 const char *mfi_ldstate(enum mfi_ld_state state);
 const char *mfi_pdstate(enum mfi_pd_state state);
 const char *mfi_pd_inq_string(struct mfi_pd_info *info);
 const char *mfi_volume_name(int fd, uint8_t target_id);
 int	mfi_volume_busy(int fd, uint8_t target_id);
 int	mfi_config_read(int fd, struct mfi_config_data **configp);
 int	mfi_config_read_opcode(int fd, uint32_t opcode,
     struct mfi_config_data **configp, uint8_t *mbox, size_t mboxlen);
 int	mfi_lookup_drive(int fd, char *drive, uint16_t *device_id);
 int	mfi_lookup_volume(int fd, const char *name, uint8_t *target_id);
 int	mfi_dcmd_command(int fd, uint32_t opcode, void *buf, size_t bufsize,
     uint8_t *mbox, size_t mboxlen, uint8_t *statusp);
 int	mfi_open(int unit, int acs);
 int	mfi_ctrl_get_info(int fd, struct mfi_ctrl_info *info, uint8_t *statusp);
 int	mfi_ld_get_info(int fd, uint8_t target_id, struct mfi_ld_info *info,
     uint8_t *statusp);
 int	mfi_ld_get_list(int fd, struct mfi_ld_list *list, uint8_t *statusp);
 int	mfi_pd_get_info(int fd, uint16_t device_id, struct mfi_pd_info *info,
     uint8_t *statusp);
 int	mfi_pd_get_list(int fd, struct mfi_pd_list **listp, uint8_t *statusp);
 int	mfi_reconfig_supported(void);
 const char *mfi_status(u_int status_code);
 const char *mfi_drive_name(struct mfi_pd_info *pinfo, uint16_t device_id,
     uint32_t def);
 void	format_stripe(char *buf, size_t buflen, uint8_t stripe);
 void	print_ld(struct mfi_ld_info *info, int state_len);
 void	print_pd(struct mfi_pd_info *info, int state_len);
 void	dump_config(int fd, struct mfi_config_data *config, const char *msg_prefix);
 int	mfi_bbu_get_props(int fd, struct mfi_bbu_properties *props,
 	    uint8_t *statusp);
 int	mfi_bbu_set_props(int fd, struct mfi_bbu_properties *props,
 	    uint8_t *statusp);
 void	mfi_autolearn_period(uint32_t, char *, size_t);
 void	mfi_next_learn_time(uint32_t, char *, size_t);
 void	mfi_autolearn_mode(uint8_t, char *, size_t);

 void	scan_firmware(struct mfi_info_component *comp);
 void	display_firmware(struct mfi_info_component *comp, const char *tag);

 int	display_format(int ac, char **av, int diagnostic, mfi_dcmd_t display_cmd);
 #endif /* !__MFIUTIL_H__ */
	/*-
	* Copyright (c) 2008, 2009 Yahoo!, Inc.
	* All rights reserved.
	*
	* Redistribution and use in source and binary forms, with or without
	* modification, are permitted provided that the following conditions
	* are met:
	* 1. Redistributions of source code must retain the above copyright
	* notice, this list of conditions and the following disclaimer.
	* 2. Redistributions in binary form must reproduce the above copyright
	* notice, this list of conditions and the following disclaimer in the
	* documentation and/or other materials provided with the distribution.
	* 3. The names of the authors may not be used to endorse or promote
	* products derived from this software without specific prior written
	* permission.
	*
	* THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS IS'' AND
	* ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
	* IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
	* ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE
	* FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
	* DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
	* OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
	* HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
	* LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
	* OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
	* SUCH DAMAGE.
	*
	* $FreeBSD: releng/11.1/usr.sbin/mfiutil/mfiutil.h 251516 2013-06-08 02:54:59Z sbruno $
	*/

	#ifndef __MFIUTIL_H__
	#define __MFIUTIL_H__

	#include <sys/cdefs.h>
	#include <stdint.h>
	#ifndef __packed
	#define __packed __attribute__((__packed__))
	#endif
	#ifndef __unused
	#define __unused __attribute__((__unused__))
	#endif
	#ifndef SPECNAMELEN
	// XXX: Taken from kFreeBSD header, need verify
	#define SPECNAMELEN 63 /* max length of devicename */
	#endif
	#include <dev/mfi/mfireg.h>

	/* 4.x compat */
	#ifndef SET_DECLARE

	/* <sys/cdefs.h> */
	#define __weak_symbol __attribute__((__weak__))
	#define __used __attribute__((__used__))
	#define __section(x) __attribute__((__section__(x)))

	#define __GLOBL1(sym) __asm__(".globl " #sym)
	#define __GLOBL(sym) __GLOBL1(sym)

	#if 0
	#define __GNUCLIKE___SECTION
	#include <sys/linker_set.h>
	#else
	/* <sys/linker_set.h> */
	#undef __MAKE_SET
	#undef DATA_SET

	#define __MAKE_SET(set, sym) \
	__GLOBL(__CONCAT(__start_set_,set)); \
	__GLOBL(__CONCAT(__stop_set_,set)); \
	static void const * const __set_##set##_sym_##sym \
	__section("set_" #set) __used = &sym

	#define DATA_SET(set, sym) __MAKE_SET(set, sym)

	#define SET_DECLARE(set, ptype) \
	extern ptype *__weak_symbol __CONCAT(__start_set_,set); \
	extern ptype *__weak_symbol __CONCAT(__stop_set_,set)

	#define SET_BEGIN(set) \
	(&__CONCAT(__start_set_,set))
	#define SET_LIMIT(set) \
	(&__CONCAT(__stop_set_,set))

	#define SET_FOREACH(pvar, set) \
	for (pvar = SET_BEGIN(set); pvar < SET_LIMIT(set); pvar++)
	#endif

	#ifndef __FreeBSD__
	#include <stdlib.h>

	static inline void reallocf(void p, size_t size) {
	void *new_p = realloc(p, size);
	if(!new_p) free(p);
	return new_p;
	}
	#endif

	int humanize_number(char *_buf, size_t _len, int64_t _number,
	const char *_suffix, int _scale, int _flags);

	/* humanize_number(3) */
	#define HN_DECIMAL 0x01
	#define HN_NOSPACE 0x02
	#define HN_B 0x04
	#define HN_DIVISOR_1000 0x08

	#define HN_GETSCALE 0x10
	#define HN_AUTOSCALE 0x20

	extern long int human_readable_binary(unsigned long long int n, int *symbol, unsigned int scale);
	extern int print_human_readable_binary(unsigned long long int n, int symbol, unsigned int scale_factor, int print_width, FILE *f);

	#endif

	/* Constants for DDF RAID levels. */
	#define DDF_RAID0 0x00
	#define DDF_RAID1 0x01
	#define DDF_RAID3 0x03
	#define DDF_RAID5 0x05
	#define DDF_RAID6 0x06
	#define DDF_RAID1E 0x11
	#define DDF_JBOD 0x0f
	#define DDF_CONCAT 0x1f
	#define DDF_RAID5E 0x15
	#define DDF_RAID5EE 0x25

	struct mfiutil_command {
	const char *name;
	int (handler)(int ac, char *av);
	};

	#define MFI_DATASET(name) mfiutil_ ## name ## _table

	#define MFI_COMMAND(set, name, function) \
	static struct mfiutil_command function ## _mfiutil_command = \
	{ #name, function }; \
	DATA_SET(MFI_DATASET(set), function ## _mfiutil_command)

	#define MFI_TABLE(set, name) \
	SET_DECLARE(MFI_DATASET(name), struct mfiutil_command); \
	\
	static int \
	mfiutil_ ## name ## _table_handler(int ac, char **av) \
	{ \
	return (mfi_table_handler(SET_BEGIN(MFI_DATASET(name)), \
	SET_LIMIT(MFI_DATASET(name)), ac, av)); \
	} \
	MFI_COMMAND(set, name, mfiutil_ ## name ## _table_handler)

	/* Drive name printing options */
	#define MFI_DNAME_ES 0x0001 /* E%u:S%u */
	#define MFI_DNAME_DEVICE_ID 0x0002 /* %u */
	#define MFI_DNAME_HONOR_OPTS 0x8000 /* Allow cmd line to override default */

	extern int mfi_unit;

	extern u_int mfi_opts;

	/* We currently don't know the full details of the following struct */
	struct mfi_foreign_scan_cfg {
	char data[24];
	};

	struct mfi_foreign_scan_info {
	uint32_t count; /* Number of foreign configs found */
	struct mfi_foreign_scan_cfg cfgs[8];
	};

	void mbox_store_ldref(uint8_t mbox, union mfi_ld_ref ref);
	void mbox_store_pdref(uint8_t mbox, union mfi_pd_ref ref);
	void mfi_display_progress(const char label, struct mfi_progress prog);
	int mfi_table_handler(struct mfiutil_command **start,
	struct mfiutil_command end, int ac, char av);
	const char *mfi_raid_level(uint8_t primary_level, uint8_t secondary_level);
	const char *mfi_ldstate(enum mfi_ld_state state);
	const char *mfi_pdstate(enum mfi_pd_state state);
	const char mfi_pd_inq_string(struct mfi_pd_info info);
	const char *mfi_volume_name(int fd, uint8_t target_id);
	int mfi_volume_busy(int fd, uint8_t target_id);
	int mfi_config_read(int fd, struct mfi_config_data **configp);
	int mfi_config_read_opcode(int fd, uint32_t opcode,
	struct mfi_config_data *configp, uint8_t mbox, size_t mboxlen);
	int mfi_lookup_drive(int fd, char drive, uint16_t device_id);
	int mfi_lookup_volume(int fd, const char name, uint8_t target_id);
	int mfi_dcmd_command(int fd, uint32_t opcode, void *buf, size_t bufsize,
	uint8_t mbox, size_t mboxlen, uint8_t statusp);
	int mfi_open(int unit, int acs);
	int mfi_ctrl_get_info(int fd, struct mfi_ctrl_info info, uint8_t statusp);
	int mfi_ld_get_info(int fd, uint8_t target_id, struct mfi_ld_info *info,
	uint8_t *statusp);
	int mfi_ld_get_list(int fd, struct mfi_ld_list list, uint8_t statusp);
	int mfi_pd_get_info(int fd, uint16_t device_id, struct mfi_pd_info *info,
	uint8_t *statusp);
	int mfi_pd_get_list(int fd, struct mfi_pd_list *listp, uint8_t statusp);
	int mfi_reconfig_supported(void);
	const char *mfi_status(u_int status_code);
	const char mfi_drive_name(struct mfi_pd_info pinfo, uint16_t device_id,
	uint32_t def);
	void format_stripe(char *buf, size_t buflen, uint8_t stripe);
	void print_ld(struct mfi_ld_info *info, int state_len);
	void print_pd(struct mfi_pd_info *info, int state_len);
	void dump_config(int fd, struct mfi_config_data config, const char msg_prefix);
	int mfi_bbu_get_props(int fd, struct mfi_bbu_properties *props,
	uint8_t *statusp);
	int mfi_bbu_set_props(int fd, struct mfi_bbu_properties *props,
	uint8_t *statusp);
	void mfi_autolearn_period(uint32_t, char *, size_t);
	void mfi_next_learn_time(uint32_t, char *, size_t);
	void mfi_autolearn_mode(uint8_t, char *, size_t);

	void scan_firmware(struct mfi_info_component *comp);
	void display_firmware(struct mfi_info_component comp, const char tag);

	int display_format(int ac, char **av, int diagnostic, mfi_dcmd_t display_cmd);
	#endif /* !__MFIUTIL_H__ */