common_init.c revision 28d65773 
1/*
2 * (C) Copyright IBM Corporation 2006
3 * All Rights Reserved.
4 *
5 * Permission is hereby granted, free of charge, to any person obtaining a
6 * copy of this software and associated documentation files (the "Software"),
7 * to deal in the Software without restriction, including without limitation
8 * on the rights to use, copy, modify, merge, publish, distribute, sub
9 * license, and/or sell copies of the Software, and to permit persons to whom
10 * the Software is furnished to do so, subject to the following conditions:
11 *
12 * The above copyright notice and this permission notice (including the next
13 * paragraph) shall be included in all copies or substantial portions of the
14 * Software.
15 *
16 * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
17 * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
18 * FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT.  IN NO EVENT SHALL
19 * IBM AND/OR THEIR SUPPLIERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
20 * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
21 * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER
22 * DEALINGS IN THE SOFTWARE.
23 */
24
25/**
26 * \file common_init.c
27 * Platform independent routines for initializing access to the PCI system.
28 *
29 * \author Ian Romanick <idr@us.ibm.com>
30 */
31
32#include <stdlib.h>
33#include <errno.h>
34
35#include "pciaccess.h"
36#include "pciaccess_private.h"
37
38_pci_hidden struct pci_system * pci_sys;
39
40/**
41 * Initialize the PCI subsystem for access.
42 *
43 * \return
44 * Zero on success or an errno value on failure.  In particular, if no
45 * platform-specific initializers are available, \c ENOSYS will be returned.
46 *
47 * \sa pci_system_cleanup
48 */
49
50int
51pci_system_init( void )
52{
53    int err = ENOSYS;
54
55#ifdef linux
56    err = pci_system_linux_sysfs_create();
57#elif defined(__FreeBSD__) || defined(__FreeBSD_kernel__) || defined(__DragonFly__)
58    err = pci_system_freebsd_create();
59#elif defined(__NetBSD__)
60    err = pci_system_netbsd_create();
61#elif defined(__OpenBSD__)
62    err = pci_system_openbsd_create();
63#elif defined(__sun)
64    err = pci_system_solx_devfs_create();
65#elif defined(__GNU__)
66    err = pci_system_x86_create();
67#endif
68
69    return err;
70}
71
72void
73pci_system_init_dev_mem(int fd)
74{
75#ifdef __OpenBSD__
76    pci_system_openbsd_init_dev_mem(fd);
77#endif
78}
79
80/**
81 * Shutdown all access to the PCI subsystem.
82 *
83 * \sa pci_system_init
84 */
85void
86pci_system_cleanup( void )
87{
88    unsigned i;
89    unsigned j;
90
91
92    if ( pci_sys == NULL ) {
93	return;
94    }
95
96    pci_io_cleanup();
97
98    if ( pci_sys->devices ) {
99	for ( i = 0 ; i < pci_sys->num_devices ; i++ ) {
100	    for ( j = 0 ; j < 6 ; j++ ) {
101		(void) pci_device_unmap_region( & pci_sys->devices[i].base, j );
102	    }
103
104	    free( (char *) pci_sys->devices[i].device_string );
105	    free( (char *) pci_sys->devices[i].agp );
106
107	    pci_sys->devices[i].device_string = NULL;
108	    pci_sys->devices[i].agp = NULL;
109
110	    if ( pci_sys->methods->destroy_device != NULL ) {
111		(*pci_sys->methods->destroy_device)( & pci_sys->devices[i].base );
112	    }
113	}
114
115	free( pci_sys->devices );
116	pci_sys->devices = NULL;
117	pci_sys->num_devices = 0;
118    }
119
120
121    if ( pci_sys->methods->destroy != NULL ) {
122	(*pci_sys->methods->destroy)();
123    }
124
125    free( pci_sys );
126    pci_sys = NULL;
127}
128