root/usr/src/psm/promif/ieee1275/sun4/prom_map.c
/*
 * CDDL HEADER START
 *
 * The contents of this file are subject to the terms of the
 * Common Development and Distribution License, Version 1.0 only
 * (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 (c) 1991-1994, by Sun Microsystems, Inc.
 * All rights reserved.
 */

#pragma ident   "%Z%%M% %I%     %E% SMI"

#include <sys/promif.h>
#include <sys/promimpl.h>

/*
 * Mapping routines suitable for implementations using 2-cell physical
 * address formats.  Use of these routines makes the caller
 * platform-dependent.  The implementation of these routines is
 * a bit sun-hardware centric, for historical use by SunOS and standalones.
 */

caddr_t
prom_map(caddr_t virthint, unsigned long long physaddr, u_int size)
{
        caddr_t virt;

        /*
         * If no virthint, allocate it; otherwise claim it,
         * the physical address is assumed to be a device or
         * already claimed, or not appearing in a resource list.
         */
        if (virthint == (caddr_t)0)  {
                if ((virt = prom_allocate_virt((u_int)1, size)) == 0)
                        return ((caddr_t)0);
        } else {
                virt = virthint;
                if (prom_claim_virt(size, virt) != virt)
                        return ((caddr_t)0);
        }

        if (prom_map_phys(-1, size, virt, physaddr) != 0) {
                /*
                 * The map operation failed, free the virtual
                 * addresses we allocated or claimed.
                 */
                (void) prom_free_virt(size, virt);
                return ((caddr_t)0);
        }
        return (virt);
}

void
prom_unmap(caddr_t virt, u_int size)
{
        (void) prom_unmap_virt(size, virt);
        prom_free_virt(size, virt);
}