promif.h revision c9503a497f482bf9524b37eea8c69239425bcdf4
d583b39bfb4e2571d3e41097c5c357ffe353ad45John Wren Kennedy/*
d583b39bfb4e2571d3e41097c5c357ffe353ad45John Wren Kennedy * CDDL HEADER START
d583b39bfb4e2571d3e41097c5c357ffe353ad45John Wren Kennedy *
d583b39bfb4e2571d3e41097c5c357ffe353ad45John Wren Kennedy * The contents of this file are subject to the terms of the
d583b39bfb4e2571d3e41097c5c357ffe353ad45John Wren Kennedy * Common Development and Distribution License (the "License").
d583b39bfb4e2571d3e41097c5c357ffe353ad45John Wren Kennedy * You may not use this file except in compliance with the License.
d583b39bfb4e2571d3e41097c5c357ffe353ad45John Wren Kennedy *
d583b39bfb4e2571d3e41097c5c357ffe353ad45John Wren Kennedy * You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE
d583b39bfb4e2571d3e41097c5c357ffe353ad45John Wren Kennedy * or http://www.opensolaris.org/os/licensing.
d583b39bfb4e2571d3e41097c5c357ffe353ad45John Wren Kennedy * See the License for the specific language governing permissions
d583b39bfb4e2571d3e41097c5c357ffe353ad45John Wren Kennedy * and limitations under the License.
d583b39bfb4e2571d3e41097c5c357ffe353ad45John Wren Kennedy *
1d32ba663e202c24a5a1f2e5aef83fffb447cb7fJohn Wren Kennedy * When distributing Covered Code, include this CDDL HEADER in each
d583b39bfb4e2571d3e41097c5c357ffe353ad45John Wren Kennedy * file and include the License file at usr/src/OPENSOLARIS.LICENSE.
d583b39bfb4e2571d3e41097c5c357ffe353ad45John Wren Kennedy * If applicable, add the following below this CDDL HEADER, with the
1d32ba663e202c24a5a1f2e5aef83fffb447cb7fJohn Wren Kennedy * fields enclosed by brackets "[]" replaced with your own identifying
1d32ba663e202c24a5a1f2e5aef83fffb447cb7fJohn Wren Kennedy * information: Portions Copyright [yyyy] [name of copyright owner]
1d32ba663e202c24a5a1f2e5aef83fffb447cb7fJohn Wren Kennedy *
1d32ba663e202c24a5a1f2e5aef83fffb447cb7fJohn Wren Kennedy * CDDL HEADER END
1d32ba663e202c24a5a1f2e5aef83fffb447cb7fJohn Wren Kennedy */
1d32ba663e202c24a5a1f2e5aef83fffb447cb7fJohn Wren Kennedy
1d32ba663e202c24a5a1f2e5aef83fffb447cb7fJohn Wren Kennedy/*
1d32ba663e202c24a5a1f2e5aef83fffb447cb7fJohn Wren Kennedy * Copyright 2007 Sun Microsystems, Inc. All rights reserved.
1d32ba663e202c24a5a1f2e5aef83fffb447cb7fJohn Wren Kennedy * Use is subject to license terms.
1d32ba663e202c24a5a1f2e5aef83fffb447cb7fJohn Wren Kennedy */
1d32ba663e202c24a5a1f2e5aef83fffb447cb7fJohn Wren Kennedy
1d32ba663e202c24a5a1f2e5aef83fffb447cb7fJohn Wren Kennedy#ifndef _SYS_PROMIF_H
1d32ba663e202c24a5a1f2e5aef83fffb447cb7fJohn Wren Kennedy#define _SYS_PROMIF_H
1d32ba663e202c24a5a1f2e5aef83fffb447cb7fJohn Wren Kennedy
1d32ba663e202c24a5a1f2e5aef83fffb447cb7fJohn Wren Kennedy#pragma ident "%Z%%M% %I% %E% SMI"
1d32ba663e202c24a5a1f2e5aef83fffb447cb7fJohn Wren Kennedy
1d32ba663e202c24a5a1f2e5aef83fffb447cb7fJohn Wren Kennedy#include <sys/types.h>
1d32ba663e202c24a5a1f2e5aef83fffb447cb7fJohn Wren Kennedy#include <sys/obpdefs.h>
1d32ba663e202c24a5a1f2e5aef83fffb447cb7fJohn Wren Kennedy
1d32ba663e202c24a5a1f2e5aef83fffb447cb7fJohn Wren Kennedy#if defined(_KERNEL) || defined(_KMDB)
1d32ba663e202c24a5a1f2e5aef83fffb447cb7fJohn Wren Kennedy#include <sys/va_list.h>
1d32ba663e202c24a5a1f2e5aef83fffb447cb7fJohn Wren Kennedy#endif
1d32ba663e202c24a5a1f2e5aef83fffb447cb7fJohn Wren Kennedy
1d32ba663e202c24a5a1f2e5aef83fffb447cb7fJohn Wren Kennedy#ifdef __cplusplus
1d32ba663e202c24a5a1f2e5aef83fffb447cb7fJohn Wren Kennedyextern "C" {
1d32ba663e202c24a5a1f2e5aef83fffb447cb7fJohn Wren Kennedy#endif
1d32ba663e202c24a5a1f2e5aef83fffb447cb7fJohn Wren Kennedy
1d32ba663e202c24a5a1f2e5aef83fffb447cb7fJohn Wren Kennedy/*
1d32ba663e202c24a5a1f2e5aef83fffb447cb7fJohn Wren Kennedy * These are for V0 ops only. We sometimes have to specify
1d32ba663e202c24a5a1f2e5aef83fffb447cb7fJohn Wren Kennedy * to promif which type of operation we need to perform
1d32ba663e202c24a5a1f2e5aef83fffb447cb7fJohn Wren Kennedy * and since we can't get such a property from a V0 prom, we
1d32ba663e202c24a5a1f2e5aef83fffb447cb7fJohn Wren Kennedy * sometimes just assume it. V2 and later proms do the right thing.
1d32ba663e202c24a5a1f2e5aef83fffb447cb7fJohn Wren Kennedy */
1d32ba663e202c24a5a1f2e5aef83fffb447cb7fJohn Wren Kennedy#define BLOCK 0
1d32ba663e202c24a5a1f2e5aef83fffb447cb7fJohn Wren Kennedy#define NETWORK 1
1d32ba663e202c24a5a1f2e5aef83fffb447cb7fJohn Wren Kennedy#define BYTE 2
1d32ba663e202c24a5a1f2e5aef83fffb447cb7fJohn Wren Kennedy
1d32ba663e202c24a5a1f2e5aef83fffb447cb7fJohn Wren Kennedy
1d32ba663e202c24a5a1f2e5aef83fffb447cb7fJohn Wren Kennedy#if defined(_KERNEL) || defined(_KMDB)
1d32ba663e202c24a5a1f2e5aef83fffb447cb7fJohn Wren Kennedy
1d32ba663e202c24a5a1f2e5aef83fffb447cb7fJohn Wren Kennedy#if !defined(_BOOT)
1d32ba663e202c24a5a1f2e5aef83fffb447cb7fJohn Wren Kennedy/*
1d32ba663e202c24a5a1f2e5aef83fffb447cb7fJohn Wren Kennedy * Due to FCode on sun4u machines running in a pseudo-32-bit environment
1d32ba663e202c24a5a1f2e5aef83fffb447cb7fJohn Wren Kennedy * we need to enable code in several of the promif routines to ensure
1d32ba663e202c24a5a1f2e5aef83fffb447cb7fJohn Wren Kennedy * that 64-bit pointers from the kernel are not passed through the CIF
1d32ba663e202c24a5a1f2e5aef83fffb447cb7fJohn Wren Kennedy * to OpenBoot.
1d32ba663e202c24a5a1f2e5aef83fffb447cb7fJohn Wren Kennedy *
1d32ba663e202c24a5a1f2e5aef83fffb447cb7fJohn Wren Kennedy * Client programs defining this token need to provide two callbacks to
1d32ba663e202c24a5a1f2e5aef83fffb447cb7fJohn Wren Kennedy * allow the promif routines to allocate and free memory allocated from
1d32ba663e202c24a5a1f2e5aef83fffb447cb7fJohn Wren Kennedy * the bottom 32-bits of the 64-bit address space:
1d32ba663e202c24a5a1f2e5aef83fffb447cb7fJohn Wren Kennedy *
1d32ba663e202c24a5a1f2e5aef83fffb447cb7fJohn Wren Kennedy * void *promplat_alloc(size_t);
1d32ba663e202c24a5a1f2e5aef83fffb447cb7fJohn Wren Kennedy * void promplat_free(void *, size_t);
1d32ba663e202c24a5a1f2e5aef83fffb447cb7fJohn Wren Kennedy *
1d32ba663e202c24a5a1f2e5aef83fffb447cb7fJohn Wren Kennedy * The alloc function should guarantee that it will never return an
1d32ba663e202c24a5a1f2e5aef83fffb447cb7fJohn Wren Kennedy * invalid pointer.
1d32ba663e202c24a5a1f2e5aef83fffb447cb7fJohn Wren Kennedy */
1d32ba663e202c24a5a1f2e5aef83fffb447cb7fJohn Wren Kennedy#define PROM_32BIT_ADDRS
1d32ba663e202c24a5a1f2e5aef83fffb447cb7fJohn Wren Kennedy#endif /* _BOOT */
1d32ba663e202c24a5a1f2e5aef83fffb447cb7fJohn Wren Kennedy
1d32ba663e202c24a5a1f2e5aef83fffb447cb7fJohn Wren Kennedytypedef void promif_preprom_f(void);
1d32ba663e202c24a5a1f2e5aef83fffb447cb7fJohn Wren Kennedytypedef void promif_postprom_f(void);
1d32ba663e202c24a5a1f2e5aef83fffb447cb7fJohn Wren Kennedy
1d32ba663e202c24a5a1f2e5aef83fffb447cb7fJohn Wren Kennedy/*
1d32ba663e202c24a5a1f2e5aef83fffb447cb7fJohn Wren Kennedy * resource allocation group: OBP and IEEE 1275-1994.
1d32ba663e202c24a5a1f2e5aef83fffb447cb7fJohn Wren Kennedy * prom_alloc is platform dependent on SPARC.
1d32ba663e202c24a5a1f2e5aef83fffb447cb7fJohn Wren Kennedy */
1d32ba663e202c24a5a1f2e5aef83fffb447cb7fJohn Wren Kennedyextern caddr_t prom_alloc(caddr_t virthint, size_t size, uint_t align);
1d32ba663e202c24a5a1f2e5aef83fffb447cb7fJohn Wren Kennedyextern void prom_free(caddr_t virt, size_t size);
1d32ba663e202c24a5a1f2e5aef83fffb447cb7fJohn Wren Kennedy
1d32ba663e202c24a5a1f2e5aef83fffb447cb7fJohn Wren Kennedy/*
1d32ba663e202c24a5a1f2e5aef83fffb447cb7fJohn Wren Kennedy * Device tree and property group: OBP and IEEE 1275-1994.
1d32ba663e202c24a5a1f2e5aef83fffb447cb7fJohn Wren Kennedy */
1d32ba663e202c24a5a1f2e5aef83fffb447cb7fJohn Wren Kennedyextern pnode_t prom_childnode(pnode_t nodeid);
1d32ba663e202c24a5a1f2e5aef83fffb447cb7fJohn Wren Kennedyextern pnode_t prom_nextnode(pnode_t nodeid);
1d32ba663e202c24a5a1f2e5aef83fffb447cb7fJohn Wren Kennedyextern pnode_t prom_parentnode(pnode_t nodeid);
1d32ba663e202c24a5a1f2e5aef83fffb447cb7fJohn Wren Kennedyextern pnode_t prom_rootnode(void);
1d32ba663e202c24a5a1f2e5aef83fffb447cb7fJohn Wren Kennedyextern pnode_t prom_chosennode(void);
1d32ba663e202c24a5a1f2e5aef83fffb447cb7fJohn Wren Kennedyextern pnode_t prom_alias_node(void);
1d32ba663e202c24a5a1f2e5aef83fffb447cb7fJohn Wren Kennedyextern pnode_t prom_optionsnode(void);
1d32ba663e202c24a5a1f2e5aef83fffb447cb7fJohn Wren Kennedy
1d32ba663e202c24a5a1f2e5aef83fffb447cb7fJohn Wren Kennedyextern int prom_asr_list_keys_len();
1d32ba663e202c24a5a1f2e5aef83fffb447cb7fJohn Wren Kennedyextern int prom_asr_list_keys(caddr_t value);
1d32ba663e202c24a5a1f2e5aef83fffb447cb7fJohn Wren Kennedyextern int prom_asr_export_len();
1d32ba663e202c24a5a1f2e5aef83fffb447cb7fJohn Wren Kennedyextern int prom_asr_export(caddr_t value);
1d32ba663e202c24a5a1f2e5aef83fffb447cb7fJohn Wren Kennedyextern int prom_asr_disable(char *keystr, int keystr_len,
1d32ba663e202c24a5a1f2e5aef83fffb447cb7fJohn Wren Kennedy char *reason, int reason_len);
1d32ba663e202c24a5a1f2e5aef83fffb447cb7fJohn Wren Kennedyextern int prom_asr_enable(char *keystr, int keystr_len);
1d32ba663e202c24a5a1f2e5aef83fffb447cb7fJohn Wren Kennedy
1d32ba663e202c24a5a1f2e5aef83fffb447cb7fJohn Wren Kennedyextern int prom_getproplen(pnode_t nodeid, caddr_t name);
1d32ba663e202c24a5a1f2e5aef83fffb447cb7fJohn Wren Kennedyextern int prom_getprop(pnode_t nodeid, caddr_t name,
1d32ba663e202c24a5a1f2e5aef83fffb447cb7fJohn Wren Kennedy caddr_t value);
1d32ba663e202c24a5a1f2e5aef83fffb447cb7fJohn Wren Kennedyextern caddr_t prom_nextprop(pnode_t nodeid, caddr_t previous,
1d32ba663e202c24a5a1f2e5aef83fffb447cb7fJohn Wren Kennedy caddr_t next);
1d32ba663e202c24a5a1f2e5aef83fffb447cb7fJohn Wren Kennedyextern int prom_setprop(pnode_t nodeid, caddr_t name,
1d32ba663e202c24a5a1f2e5aef83fffb447cb7fJohn Wren Kennedy caddr_t value, int len);
1d32ba663e202c24a5a1f2e5aef83fffb447cb7fJohn Wren Kennedy
1d32ba663e202c24a5a1f2e5aef83fffb447cb7fJohn Wren Kennedyextern int prom_getnode_byname(pnode_t id, char *name);
1d32ba663e202c24a5a1f2e5aef83fffb447cb7fJohn Wren Kennedyextern int prom_devicetype(pnode_t id, char *type);
1d32ba663e202c24a5a1f2e5aef83fffb447cb7fJohn Wren Kennedy
1d32ba663e202c24a5a1f2e5aef83fffb447cb7fJohn Wren Kennedyextern char *prom_decode_composite_string(void *buf,
1d32ba663e202c24a5a1f2e5aef83fffb447cb7fJohn Wren Kennedy size_t buflen, char *prev);
1d32ba663e202c24a5a1f2e5aef83fffb447cb7fJohn Wren Kennedy
1d32ba663e202c24a5a1f2e5aef83fffb447cb7fJohn Wren Kennedy/*
1d32ba663e202c24a5a1f2e5aef83fffb447cb7fJohn Wren Kennedy * Device tree and property group: IEEE 1275-1994 Only.
1d32ba663e202c24a5a1f2e5aef83fffb447cb7fJohn Wren Kennedy */
1d32ba663e202c24a5a1f2e5aef83fffb447cb7fJohn Wren Kennedyextern pnode_t prom_finddevice(char *path); /* Also on obp2.x */
1d32ba663e202c24a5a1f2e5aef83fffb447cb7fJohn Wren Kennedy
1d32ba663e202c24a5a1f2e5aef83fffb447cb7fJohn Wren Kennedyextern int prom_bounded_getprop(pnode_t nodeid,
1d32ba663e202c24a5a1f2e5aef83fffb447cb7fJohn Wren Kennedy caddr_t name, caddr_t buffer, int buflen);
1d32ba663e202c24a5a1f2e5aef83fffb447cb7fJohn Wren Kennedy
1d32ba663e202c24a5a1f2e5aef83fffb447cb7fJohn Wren Kennedyextern phandle_t prom_getphandle(ihandle_t i);
1d32ba663e202c24a5a1f2e5aef83fffb447cb7fJohn Wren Kennedy
1d32ba663e202c24a5a1f2e5aef83fffb447cb7fJohn Wren Kennedy/*
1d32ba663e202c24a5a1f2e5aef83fffb447cb7fJohn Wren Kennedy * Device pathnames and pathname conversion: OBP and IEEE 1275-1994.
1d32ba663e202c24a5a1f2e5aef83fffb447cb7fJohn Wren Kennedy */
1d32ba663e202c24a5a1f2e5aef83fffb447cb7fJohn Wren Kennedyextern int prom_devname_from_pathname(char *path, char *buffer);
1d32ba663e202c24a5a1f2e5aef83fffb447cb7fJohn Wren Kennedyextern char *prom_path_options(char *pathname);
1d32ba663e202c24a5a1f2e5aef83fffb447cb7fJohn Wren Kennedyextern char *prom_path_gettoken(char *from, char *to);
1d32ba663e202c24a5a1f2e5aef83fffb447cb7fJohn Wren Kennedyextern void prom_pathname(char *pathname);
1d32ba663e202c24a5a1f2e5aef83fffb447cb7fJohn Wren Kennedyextern void prom_strip_options(char *from, char *to);
1d32ba663e202c24a5a1f2e5aef83fffb447cb7fJohn Wren Kennedy
1d32ba663e202c24a5a1f2e5aef83fffb447cb7fJohn Wren Kennedy/*
1d32ba663e202c24a5a1f2e5aef83fffb447cb7fJohn Wren Kennedy * Device pathnames and pathname conversion: IEEE 1275-1994 only.
1d32ba663e202c24a5a1f2e5aef83fffb447cb7fJohn Wren Kennedy */
1d32ba663e202c24a5a1f2e5aef83fffb447cb7fJohn Wren Kennedyextern int prom_ihandle_to_path(ihandle_t, char *buf,
1d32ba663e202c24a5a1f2e5aef83fffb447cb7fJohn Wren Kennedy uint_t buflen);
1d32ba663e202c24a5a1f2e5aef83fffb447cb7fJohn Wren Kennedyextern int prom_phandle_to_path(phandle_t, char *buf,
1d32ba663e202c24a5a1f2e5aef83fffb447cb7fJohn Wren Kennedy uint_t buflen);
1d32ba663e202c24a5a1f2e5aef83fffb447cb7fJohn Wren Kennedy
1d32ba663e202c24a5a1f2e5aef83fffb447cb7fJohn Wren Kennedy/*
1d32ba663e202c24a5a1f2e5aef83fffb447cb7fJohn Wren Kennedy * Special device nodes: OBP and IEEE 1275-1994.
1d32ba663e202c24a5a1f2e5aef83fffb447cb7fJohn Wren Kennedy */
1d32ba663e202c24a5a1f2e5aef83fffb447cb7fJohn Wren Kennedyextern ihandle_t prom_stdin_ihandle(void);
1d32ba663e202c24a5a1f2e5aef83fffb447cb7fJohn Wren Kennedyextern ihandle_t prom_stdout_ihandle(void);
1d32ba663e202c24a5a1f2e5aef83fffb447cb7fJohn Wren Kennedyextern pnode_t prom_stdin_node(void);
1d32ba663e202c24a5a1f2e5aef83fffb447cb7fJohn Wren Kennedyextern pnode_t prom_stdout_node(void);
1d32ba663e202c24a5a1f2e5aef83fffb447cb7fJohn Wren Kennedyextern char *prom_stdinpath(void);
1d32ba663e202c24a5a1f2e5aef83fffb447cb7fJohn Wren Kennedyextern char *prom_stdoutpath(void);
1d32ba663e202c24a5a1f2e5aef83fffb447cb7fJohn Wren Kennedyextern int prom_stdin_devname(char *buffer);
1d32ba663e202c24a5a1f2e5aef83fffb447cb7fJohn Wren Kennedyextern int prom_stdout_devname(char *buffer);
1d32ba663e202c24a5a1f2e5aef83fffb447cb7fJohn Wren Kennedyextern int prom_stdin_is_keyboard(void);
1d32ba663e202c24a5a1f2e5aef83fffb447cb7fJohn Wren Kennedyextern int prom_stdout_is_framebuffer(void);
5602294fda888d923d57a78bafdaf48ae6223deaDan Kimmelextern int prom_stdin_stdout_equivalence(void);
5602294fda888d923d57a78bafdaf48ae6223deaDan Kimmel
1d32ba663e202c24a5a1f2e5aef83fffb447cb7fJohn Wren Kennedyextern void prom_get_tem_inverses(int *, int *);
1d32ba663e202c24a5a1f2e5aef83fffb447cb7fJohn Wren Kennedyextern void prom_get_tem_size(size_t *, size_t *);
1d32ba663e202c24a5a1f2e5aef83fffb447cb7fJohn Wren Kennedyextern void prom_get_tem_pos(uint32_t *, uint32_t *);
1d32ba663e202c24a5a1f2e5aef83fffb447cb7fJohn Wren Kennedyextern void prom_get_term_font_size(int *, int *);
1d32ba663e202c24a5a1f2e5aef83fffb447cb7fJohn Wren Kennedyextern void prom_hide_cursor(void);
1d32ba663e202c24a5a1f2e5aef83fffb447cb7fJohn Wren Kennedy
1d32ba663e202c24a5a1f2e5aef83fffb447cb7fJohn Wren Kennedy/*
1d32ba663e202c24a5a1f2e5aef83fffb447cb7fJohn Wren Kennedy * Special device nodes: IEEE 1275-1994 only.
1d32ba663e202c24a5a1f2e5aef83fffb447cb7fJohn Wren Kennedy */
1d32ba663e202c24a5a1f2e5aef83fffb447cb7fJohn Wren Kennedyextern ihandle_t prom_memory_ihandle(void);
1d32ba663e202c24a5a1f2e5aef83fffb447cb7fJohn Wren Kennedyextern ihandle_t prom_mmu_ihandle(void);
1d32ba663e202c24a5a1f2e5aef83fffb447cb7fJohn Wren Kennedy
1d32ba663e202c24a5a1f2e5aef83fffb447cb7fJohn Wren Kennedy/*
1d32ba663e202c24a5a1f2e5aef83fffb447cb7fJohn Wren Kennedy * Administrative group: OBP and IEEE 1275-1994.
1d32ba663e202c24a5a1f2e5aef83fffb447cb7fJohn Wren Kennedy */
1d32ba663e202c24a5a1f2e5aef83fffb447cb7fJohn Wren Kennedyextern void prom_enter_mon(void);
1d32ba663e202c24a5a1f2e5aef83fffb447cb7fJohn Wren Kennedyextern void prom_exit_to_mon(void)
1d32ba663e202c24a5a1f2e5aef83fffb447cb7fJohn Wren Kennedy __NORETURN;
1d32ba663e202c24a5a1f2e5aef83fffb447cb7fJohn Wren Kennedyextern void prom_reboot(char *bootstr);
1d32ba663e202c24a5a1f2e5aef83fffb447cb7fJohn Wren Kennedy
1d32ba663e202c24a5a1f2e5aef83fffb447cb7fJohn Wren Kennedyextern void prom_panic(char *string)
1d32ba663e202c24a5a1f2e5aef83fffb447cb7fJohn Wren Kennedy __NORETURN;
1d32ba663e202c24a5a1f2e5aef83fffb447cb7fJohn Wren Kennedy
1d32ba663e202c24a5a1f2e5aef83fffb447cb7fJohn Wren Kennedyextern int prom_getversion(void);
1d32ba663e202c24a5a1f2e5aef83fffb447cb7fJohn Wren Kennedyextern int prom_is_openprom(void);
1d32ba663e202c24a5a1f2e5aef83fffb447cb7fJohn Wren Kennedyextern int prom_is_p1275(void);
extern int prom_version_name(char *buf, int buflen);
extern int prom_version_check(char *buf, size_t len, pnode_t *n);
extern void *prom_mon_id(void); /* SMCC/OBP platform centric */
extern uint_t prom_gettime(void);
extern char *prom_bootpath(void);
extern char *prom_bootargs(void);
extern void prom_interpret(char *str, uintptr_t arg1,
uintptr_t arg2, uintptr_t arg3, uintptr_t arg4,
uintptr_t arg5);
/*
* Return code values from prom_version_check:
*
* This routine uses past-prediction mode to determine if the firmware
* on the current system is 64-bit ready.
*
* return code 2 could happen on a board-based server with a slave CPU board
* running down-rev firmware and the current master running adequate fw.
*/
#define PROM_VER64_OK 0 /* Prom is 64-bit ready (or n/a) */
#define PROM_VER64_UPGRADE 1 /* Down-rev firmware is running */
#define PROM_VER64_SUGGEST 2 /* Down-rev firmware detected .. */
/* .. but not currently active */
/*
* Administrative group: OBP only.
*/
extern int prom_sethandler(void (*v0_func)(), void (*v2_func)());
extern struct bootparam *prom_bootparam(void);
/*
* Administrative group: IEEE 1275-1994 only.
*/
extern void *prom_set_callback(void *handler);
extern void prom_set_symbol_lookup(void *sym2val, void *val2sym);
/*
* Administrative group: IEEE 1275 only.
*/
extern int prom_test(char *service);
extern int prom_test_method(char *method, pnode_t node);
/*
* Promif support group: Generic.
*/
extern void prom_init(char *progname, void *prom_cookie);
extern void prom_set_preprom(promif_preprom_f *);
extern void prom_set_postprom(promif_postprom_f *);
extern void prom_get_tem_pos(uint32_t *, uint32_t *);
extern void prom_get_tem_size(size_t *, size_t *);
typedef struct __promif_redir_arg *promif_redir_arg_t;
typedef ssize_t (*promif_redir_t)(promif_redir_arg_t,
uchar_t *, size_t);
extern void prom_set_stdout_redirect(promif_redir_t,
promif_redir_arg_t);
extern void prom_suspend_prepost(void);
extern void prom_resume_prepost(void);
extern void (*prom_set_nextprop_preprom(void (*)(void)))(void);
extern void (*prom_set_nextprop_postprom(void (*)(void)))(void);
extern void prom_montrap(void (*funcptr)());
typedef uint_t prom_generation_cookie_t;
extern int prom_tree_access(int (*callback)(void *arg,
int has_changed), void *arg,
prom_generation_cookie_t *);
extern int prom_tree_update(int (*callback)(void *arg), void *arg);
/*
* I/O Group: OBP and IEEE 1275.
*/
extern uchar_t prom_getchar(void);
extern void prom_putchar(char c);
extern int prom_mayget(void);
extern int prom_mayput(char c);
extern int prom_open(char *name);
extern int prom_close(int fd);
extern ssize_t prom_read(ihandle_t fd, caddr_t buf, size_t len,
uint_t startblk, char type);
extern ssize_t prom_write(ihandle_t fd, caddr_t buf, size_t len,
uint_t startblk, char type);
extern int prom_seek(int fd, u_longlong_t offset);
extern void prom_writestr(const char *buf, size_t bufsize);
extern void prom_pnode_to_pathname(pnode_t, char *);
/*PRINTFLIKE1*/
extern void prom_printf(const char *fmt, ...)
__PRINTFLIKE(1);
#pragma rarely_called(prom_printf)
extern void prom_vprintf(const char *fmt, __va_list adx)
__VPRINTFLIKE(1);
#pragma rarely_called(prom_vprintf)
/*PRINTFLIKE2*/
extern char *prom_sprintf(char *s, const char *fmt, ...)
__PRINTFLIKE(2);
extern char *prom_vsprintf(char *s, const char *fmt, __va_list adx)
__VPRINTFLIKE(2);
#define PROM_WALK_CONTINUE 0 /* keep walking to next node */
#define PROM_WALK_TERMINATE 1 /* abort walk now */
extern void prom_walk_devs(pnode_t node,
int (*f)(pnode_t, void *, void *),
void *arg, void *result);
extern pnode_t prom_findnode_byname(pnode_t id, char *name);
extern pnode_t prom_findnode_bydevtype(pnode_t id, char *devtype);
#define PROM_STOP { \
prom_printf("File %s line %d\n", __FILE__, __LINE__); \
prom_enter_mon(); \
}
#endif /* _KERNEL || _KMDB */
#ifdef _KERNEL
/*
* Used by wrappers which bring up console frame buffer before prom_printf()
* and other prom calls that may output to the console. Struct is filled in
* in prom_env.c and in sunpm.c
*/
typedef struct promif_owrap {
void (*preout)(void);
void (*postout)(void);
} promif_owrap_t;
/*
* WAN boot key storage interface
*/
int prom_set_security_key(char *keyname, caddr_t buf, int buflen, int *reslen,
int *status);
int prom_get_security_key(char *keyname, caddr_t buf, int buflen, int *keylen,
int *status);
#endif /* _KERNEL */
#ifdef __cplusplus
}
#endif
#endif /* _SYS_PROMIF_H */