Home | History | Annotate | Line # | Download | only in include
prom.h revision 1.5 
      1 /*	$NetBSD: prom.h,v 1.5 1996/11/13 21:13:20 cgd Exp $	*/
      2 
      3 /*
      4  * Copyright (c) 1994, 1995 Carnegie-Mellon University.
      5  * All rights reserved.
      6  *
      7  * Author: Keith Bostic, Chris G. Demetriou
      8  *
      9  * Permission to use, copy, modify and distribute this software and
     10  * its documentation is hereby granted, provided that both the copyright
     11  * notice and this permission notice appear in all copies of the
     12  * software, derivative works or modified versions, and any portions
     13  * thereof, and that both notices appear in supporting documentation.
     14  *
     15  * CARNEGIE MELLON ALLOWS FREE USE OF THIS SOFTWARE IN ITS "AS IS"
     16  * CONDITION.  CARNEGIE MELLON DISCLAIMS ANY LIABILITY OF ANY KIND
     17  * FOR ANY DAMAGES WHATSOEVER RESULTING FROM THE USE OF THIS SOFTWARE.
     18  *
     19  * Carnegie Mellon requests users of this software to return to
     20  *
     21  *  Software Distribution Coordinator  or  Software.Distribution (at) CS.CMU.EDU
     22  *  School of Computer Science
     23  *  Carnegie Mellon University
     24  *  Pittsburgh PA 15213-3890
     25  *
     26  * any improvements or extensions that they make and grant Carnegie the
     27  * rights to redistribute these changes.
     28  */
     29 
     30 #ifndef	ASSEMBLER
     31 struct prom_vec {
     32 	u_int64_t	routine;
     33 	void		*routine_arg;
     34 };
     35 
     36 /* The return value from a prom call. */
     37 typedef union {
     38 	struct {
     39 		u_int64_t
     40 			retval	: 32,		/* return value. */
     41 			unit	: 8,
     42 			mbz	: 8,
     43 			error	: 13,
     44 			status	: 3;
     45 	} u;
     46 	u_int64_t bits;
     47 } prom_return_t;
     48 
     49 #ifdef STANDALONE
     50 int	getchar __P((void));
     51 int	prom_open __P((char *, int));
     52 void	putchar __P((int));
     53 #endif
     54 
     55 void	prom_halt __P((int)) __attribute__((__noreturn__));
     56 int	prom_getenv __P((int, char *, int));
     57 
     58 void	hwrpb_restart_setup __P((void));
     59 #endif
     60 
     61 /* Prom operation values. */
     62 #define	PROM_R_CLOSE		0x11
     63 #define	PROM_R_GETC		0x01
     64 #define	PROM_R_GETENV		0x22
     65 #define	PROM_R_OPEN		0x10
     66 #define	PROM_R_PUTS		0x02
     67 #define	PROM_R_READ		0x13
     68 #define	PROM_R_WRITE		0x14
     69 
     70 /* Environment variable values. */
     71 #define	PROM_E_BOOTED_DEV	0x4
     72 #define	PROM_E_BOOTED_FILE	0x6
     73 #define	PROM_E_BOOTED_OSFLAGS	0x8
     74 #define	PROM_E_TTY_DEV		0xf
     75 
     76 /*
     77  * There have to be stub routines to do the copying that ensures that the
     78  * PROM doesn't get called with an address larger than 32 bits.  Calls that
     79  * either don't need to copy anything, or don't need the copy because it's
     80  * already being done elsewhere, are defined here.
     81  */
     82 #define	prom_close(chan)						\
     83 	prom_dispatch(PROM_R_CLOSE, chan, 0, 0, 0)
     84 #define	prom_read(chan, len, buf, blkno)				\
     85 	prom_dispatch(PROM_R_READ, chan, len, (u_int64_t)buf, blkno)
     86 #define	prom_write(chan, len, buf, blkno)				\
     87 	prom_dispatch(PROM_R_WRITE, chan, len, (u_int64_t)buf, blkno)
     88 #define	prom_putstr(chan, str, len)					\
     89 	prom_dispatch(PROM_R_PUTS, chan, (u_int64_t)str, len, 0)
     90 #define	prom_getc(chan)							\
     91 	prom_dispatch(PROM_R_GETC, chan, 0, 0, 0)
     92 #define prom_getenv_disp(id, buf, len)					\
     93 	prom_dispatch(PROM_R_GETENV, id, (u_int64_t)buf, len, 0)
     94 
     95 #ifndef ASSEMBLER
     96 #ifdef _KERNEL
     97 void	promcnputc __P((dev_t, int));
     98 int	promcngetc __P((dev_t));
     99 int	promcnlookc __P((dev_t, char *));
    100 
    101 u_int64_t	prom_dispatch __P((u_int64_t, u_int64_t, u_int64_t, u_int64_t,
    102 		    u_int64_t));
    103 #endif /* _KERNEL */
    104 #endif /* ASSEMBLER */
    105