Initial commit of OpenSPARC T2 architecture model.
[OpenSPARC-T2-SAM] / obp / tools / promif / sun4u / prom_retain.c
CommitLineData
920dae64
AT
1/*
2* ========== Copyright Header Begin ==========================================
3*
4* Hypervisor Software File: prom_retain.c
5*
6* Copyright (c) 2006 Sun Microsystems, Inc. All Rights Reserved.
7*
8* - Do no alter or remove copyright notices
9*
10* - Redistribution and use of this software in source and binary forms, with
11* or without modification, are permitted provided that the following
12* conditions are met:
13*
14* - Redistribution of source code must retain the above copyright notice,
15* this list of conditions and the following disclaimer.
16*
17* - Redistribution in binary form must reproduce the above copyright notice,
18* this list of conditions and the following disclaimer in the
19* documentation and/or other materials provided with the distribution.
20*
21* Neither the name of Sun Microsystems, Inc. or the names of contributors
22* may be used to endorse or promote products derived from this software
23* without specific prior written permission.
24*
25* This software is provided "AS IS," without a warranty of any kind.
26* ALL EXPRESS OR IMPLIED CONDITIONS, REPRESENTATIONS AND WARRANTIES,
27* INCLUDING ANY IMPLIED WARRANTY OF MERCHANTABILITY, FITNESS FOR A
28* PARTICULAR PURPOSE OR NON-INFRINGEMENT, ARE HEREBY EXCLUDED. SUN
29* MICROSYSTEMS, INC. ("SUN") AND ITS LICENSORS SHALL NOT BE LIABLE FOR
30* ANY DAMAGES SUFFERED BY LICENSEE AS A RESULT OF USING, MODIFYING OR
31* DISTRIBUTING THIS SOFTWARE OR ITS DERIVATIVES. IN NO EVENT WILL SUN
32* OR ITS LICENSORS BE LIABLE FOR ANY LOST REVENUE, PROFIT OR DATA, OR
33* FOR DIRECT, INDIRECT, SPECIAL, CONSEQUENTIAL, INCIDENTAL OR PUNITIVE
34* DAMAGES, HOWEVER CAUSED AND REGARDLESS OF THE THEORY OF LIABILITY,
35* ARISING OUT OF THE USE OF OR INABILITY TO USE THIS SOFTWARE, EVEN IF
36* SUN HAS BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGES.
37*
38* You acknowledge that this software is not designed, licensed or
39* intended for use in the design, construction, operation or maintenance of
40* any nuclear facility.
41*
42* ========== Copyright Header End ============================================
43*/
44/*
45 * Copyright (c) 2000-2003 Sun Microsystems, Inc.
46 * All rights reserved.
47 * Use is subject to license terms.
48 */
49
50#pragma ident "@(#)prom_retain.c 1.1 00/07/22 SMI"
51
52#include <sys/promif.h>
53#include <sys/promimpl.h>
54
55/*
56 * Allocate retained physical memory
57 * Returns 0: Success; Non-zero: failure.
58 * Returns *phys_hi, *phys_lo only if successful.
59 */
60int
61prom_retain(char *id, size_t size, uint32_t align, u_longlong_t *physaddr)
62{
63 cell_t ci[11];
64 int32_t rv;
65 ihandle_t imemory = prom_memory_ihandle();
66
67 if ((imemory == (ihandle_t)-1))
68 return (-1);
69
70 ci[0] = p1275_ptr2cell("call-method"); /* Service name */
71 ci[1] = (cell_t)5; /* #argument cells */
72 ci[2] = (cell_t)3; /* #result cells */
73 ci[3] = p1275_ptr2cell("SUNW,retain"); /* Arg1: Method name */
74 ci[4] = p1275_ihandle2cell(imemory); /* Arg2: memory ihandle */
75 ci[5] = p1275_uint2cell(align); /* Arg2: SA1: align */
76 ci[6] = p1275_size2cell(size); /* Arg3: SA2: size */
77 ci[7] = p1275_ptr2cell(id); /* Arg4: SA3: id name */
78
79 rv = p1275_cif_handler(&ci);
80
81 if (rv != 0)
82 return (rv); /* Service "call-method" failed */
83 if (ci[8] != 0) /* Res1: catch-result */
84 return (-1); /* Method "SUNW,retain" failed */
85
86 *physaddr = p1275_cells2ull(ci[9], ci[10]);
87 /* Res3: base.hi, Res4: base.lo */
88 return (0);
89}