/*
* CDDL HEADER START
*
* The contents of this file are subject to the terms of the
* Common Development and Distribution License (the "License").
* You may not use this file except in compliance with the License.
*
* You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE
* or http://www.opensolaris.org/os/licensing.
* See the License for the specific language governing permissions
* and limitations under the License.
*
* When distributing Covered Code, include this CDDL HEADER in each
* file and include the License file at usr/src/OPENSOLARIS.LICENSE.
* If applicable, add the following below this CDDL HEADER, with the
* fields enclosed by brackets "[]" replaced with your own identifying
* information: Portions Copyright [yyyy] [name of copyright owner]
*
* CDDL HEADER END
*/
/*
* Copyright 2007 Sun Microsystems, Inc. All rights reserved.
* Use is subject to license terms.
*/
#ifndef _SYS_PROMIF_H
#define _SYS_PROMIF_H
#pragma ident "%Z%%M% %I% %E% SMI"
#include <sys/types.h>
#include <sys/obpdefs.h>
#if defined(_KERNEL) || defined(_KMDB)
#include <sys/va_list.h>
#endif
#ifdef __cplusplus
extern "C" {
#endif
/*
* These are for V0 ops only. We sometimes have to specify
* to promif which type of operation we need to perform
* and since we can't get such a property from a V0 prom, we
* sometimes just assume it. V2 and later proms do the right thing.
*/
#define BLOCK 0
#define NETWORK 1
#define BYTE 2
#if defined(_KERNEL) || defined(_KMDB)
extern caddr_t prom_map(caddr_t virthint, uint_t space,
uint_t phys, uint_t size);
/*
* resource allocation group: OBP and IEEE 1275-1994.
* prom_alloc is platform dependent on SPARC.
*/
extern caddr_t prom_alloc(caddr_t virthint, uint_t size, int align);
extern void prom_free(caddr_t virt, uint_t size);
/*
* Device tree and property group: OBP and IEEE 1275-1994.
*/
extern pnode_t prom_childnode(pnode_t nodeid);
extern pnode_t prom_nextnode(pnode_t nodeid);
extern pnode_t prom_optionsnode(void);
extern pnode_t prom_alias_node(void);
extern pnode_t prom_rootnode(void);
extern int prom_getproplen(pnode_t nodeid, caddr_t name);
extern int prom_getprop(pnode_t nodeid, caddr_t name,
caddr_t value);
extern caddr_t prom_nextprop(pnode_t nodeid, caddr_t previous,
caddr_t next);
extern char *prom_decode_composite_string(void *buf,
size_t buflen, char *prev);
/*
* Device tree and property group: IEEE 1275-1994 Only.
*/
extern pnode_t prom_finddevice(char *path);
extern int prom_bounded_getprop(pnode_t nodeid,
caddr_t name, caddr_t buffer, int buflen);
/*
* Device pathnames and pathname conversion: OBP and IEEE 1275-1994.
*/
extern int prom_devname_from_pathname(char *path, char *buffer);
extern char *prom_path_gettoken(char *from, char *to);
/*
* Device pathnames and pathname conversion: IEEE 1275-1994 only.
*/
/*
* Special device nodes: OBP and IEEE 1275-1994.
*/
extern int prom_stdin_is_keyboard(void);
extern int prom_stdout_is_framebuffer(void);
extern void prom_framebuffer_getpos(int *row, int *col);
extern void prom_framebuffer_getcolors(int *fg, int *bg);
extern char *prom_stdinpath(void);
extern char *prom_stdoutpath(void);
extern void prom_strip_options(char *from, char *to);
extern void prom_pathname(char *);
/*
* Special device nodes: IEEE 1275-1994 only.
*/
/*
* Administrative group: OBP and IEEE 1275-1994.
*/
extern void prom_enter_mon(void);
extern void prom_exit_to_mon(void)
__NORETURN;
extern void prom_reboot(char *bootstr)
__NORETURN;
extern void prom_panic(char *string)
__NORETURN;
extern int prom_is_openprom(void);
extern int prom_is_p1275(void);
extern int prom_version_name(char *buf, int buflen);
extern int prom_version_boot_syscalls(void);
extern uint_t prom_gettime(void);
extern char *prom_bootpath(void);
extern char *prom_bootargs(void);
/*
* Administrative group: OBP only.
*/
/*
* Administrative group: IEEE 1275-1994 only.
*/
/*
* Administrative group: IEEE 1275 only.
*/
/*
* Promif support group: Generic.
*/
extern void prom_init(char *progname, void *prom_cookie);
typedef uint_t prom_generation_cookie_t;
#define prom_tree_access(CALLBACK, ARG, GENP) (CALLBACK)((ARG), 0)
/*
* 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 int prom_read(int fd, caddr_t buf, uint_t len,
uint_t startblk, char type);
extern int prom_write(int fd, caddr_t buf, uint_t len,
uint_t startblk, char devtype);
extern int prom_seek(int fd, unsigned long long offset);
extern void prom_writestr(const char *buf, size_t bufsize);
/*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);
/*
* promif tree searching routines ... OBP and IEEE 1275-1994.
*/
extern pnode_t prom_findnode_byname(pnode_t id, char *name);
extern char *prom_get_extend_name(void);
extern int prom_devreset(int);
extern int OpenCount;
extern struct ihandle *open_devices[];
#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;
extern void prom_suspend_prepost(void);
extern void prom_resume_prepost(void);
/*
* 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 */