xref: /titanic_44/usr/src/uts/intel/ia32/promif/README (revision 7c478bd95313f5f23a4c958a745db2134aa03244)
1*7c478bd9Sstevel@tonic-gate#
2*7c478bd9Sstevel@tonic-gate# CDDL HEADER START
3*7c478bd9Sstevel@tonic-gate#
4*7c478bd9Sstevel@tonic-gate# The contents of this file are subject to the terms of the
5*7c478bd9Sstevel@tonic-gate# Common Development and Distribution License, Version 1.0 only
6*7c478bd9Sstevel@tonic-gate# (the "License").  You may not use this file except in compliance
7*7c478bd9Sstevel@tonic-gate# with the License.
8*7c478bd9Sstevel@tonic-gate#
9*7c478bd9Sstevel@tonic-gate# You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE
10*7c478bd9Sstevel@tonic-gate# or http://www.opensolaris.org/os/licensing.
11*7c478bd9Sstevel@tonic-gate# See the License for the specific language governing permissions
12*7c478bd9Sstevel@tonic-gate# and limitations under the License.
13*7c478bd9Sstevel@tonic-gate#
14*7c478bd9Sstevel@tonic-gate# When distributing Covered Code, include this CDDL HEADER in each
15*7c478bd9Sstevel@tonic-gate# file and include the License file at usr/src/OPENSOLARIS.LICENSE.
16*7c478bd9Sstevel@tonic-gate# If applicable, add the following below this CDDL HEADER, with the
17*7c478bd9Sstevel@tonic-gate# fields enclosed by brackets "[]" replaced with your own identifying
18*7c478bd9Sstevel@tonic-gate# information: Portions Copyright [yyyy] [name of copyright owner]
19*7c478bd9Sstevel@tonic-gate#
20*7c478bd9Sstevel@tonic-gate# CDDL HEADER END
21*7c478bd9Sstevel@tonic-gate#
22*7c478bd9Sstevel@tonic-gate#
23*7c478bd9Sstevel@tonic-gate# Copyright 2004 Sun Microsystems, Inc.  All rights reserved.
24*7c478bd9Sstevel@tonic-gate# Use is subject to license terms.
25*7c478bd9Sstevel@tonic-gate#
26*7c478bd9Sstevel@tonic-gate# ident	"%Z%%M%	%I%	%E% SMI"
27*7c478bd9Sstevel@tonic-gate#
28*7c478bd9Sstevel@tonic-gate
29*7c478bd9Sstevel@tonic-gateusr/src/uts/i86/promif for x86			(please update as required)
30*7c478bd9Sstevel@tonic-gate
31*7c478bd9Sstevel@tonic-gateMerge work (here and stand.i386/boot/promif) is done in July 1994.
32*7c478bd9Sstevel@tonic-gate
33*7c478bd9Sstevel@tonic-gate1) The merge is mechanic and textual, no attempt in re-design this interface.
34*7c478bd9Sstevel@tonic-gate   There are other projects that will replace this piece of code.
35*7c478bd9Sstevel@tonic-gate
36*7c478bd9Sstevel@tonic-gate2) Three kind of binaries are generated:
37*7c478bd9Sstevel@tonic-gate	#if defined(_KMDB)
38*7c478bd9Sstevel@tonic-gate		for kmdb to use
39*7c478bd9Sstevel@tonic-gate	#if defined(I386BOOT)
40*7c478bd9Sstevel@tonic-gate		for booters (inetboot and ufsboot) to use and linked
41*7c478bd9Sstevel@tonic-gate		together as libprom.a
42*7c478bd9Sstevel@tonic-gate	#if !defined(_KMDB) && !defined(I386BOOT)
43*7c478bd9Sstevel@tonic-gate		for kernel to use in *.o form
44*7c478bd9Sstevel@tonic-gate
45*7c478bd9Sstevel@tonic-gate ------------------------------------------------------------------------------
46*7c478bd9Sstevel@tonic-gate
47*7c478bd9Sstevel@tonic-gate9 Jan, 1994:
48*7c478bd9Sstevel@tonic-gate
49*7c478bd9Sstevel@tonic-gate    The new plan is to do away with most of the prom lib, keeping only those
50*7c478bd9Sstevel@tonic-gateroutines that are truely common to the three prom clients (kernel, kadb, and
51*7c478bd9Sstevel@tonic-gatesecond level boot).  The modules that remain are:
52*7c478bd9Sstevel@tonic-gate
53*7c478bd9Sstevel@tonic-gate	prom_printf.c
54*7c478bd9Sstevel@tonic-gate	prom_getchar.c
55*7c478bd9Sstevel@tonic-gate	prom_putchar.c
56*7c478bd9Sstevel@tonic-gate	prom_getverion.c
57*7c478bd9Sstevel@tonic-gate	prom_init.c
58*7c478bd9Sstevel@tonic-gate
59*7c478bd9Sstevel@tonic-gateEverything else (which used the 3-way #ifdef's described above), has been
60*7c478bd9Sstevel@tonic-gatemoved off into client-specific modules:
61*7c478bd9Sstevel@tonic-gate
62*7c478bd9Sstevel@tonic-gate	.../psm/stand/boot/i386/prom.c
63*7c478bd9Sstevel@tonic-gate	.../psm/stand/kadb/i386/prom.c
64*7c478bd9Sstevel@tonic-gate
65*7c478bd9Sstevel@tonic-gate								-- Reg
66