pciaccess_private.h 5.85 KB
Newer Older
Ian Romanick's avatar
Ian Romanick committed
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
/*
 * (C) Copyright IBM Corporation 2006
 * All Rights Reserved.
 *
 * Permission is hereby granted, free of charge, to any person obtaining a
 * copy of this software and associated documentation files (the "Software"),
 * to deal in the Software without restriction, including without limitation
 * on the rights to use, copy, modify, merge, publish, distribute, sub
 * license, and/or sell copies of the Software, and to permit persons to whom
 * the Software is furnished to do so, subject to the following conditions:
 *
 * The above copyright notice and this permission notice (including the next
 * paragraph) shall be included in all copies or substantial portions of the
 * Software.
 *
 * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
 * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
 * FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT.  IN NO EVENT SHALL
 * IBM AND/OR THEIR SUPPLIERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
 * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
 * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER
 * DEALINGS IN THE SOFTWARE.
 */

/**
 * \file pciaccess_private.h
 * Functions and datastructures that are private to the pciaccess library.
Alan Coopersmith's avatar
Alan Coopersmith committed
28
 *
Ian Romanick's avatar
Ian Romanick committed
29
30
31
 * \author Ian Romanick <idr@us.ibm.com>
 */

Julien Cristau's avatar
Julien Cristau committed
32
33
34
35
36
37
38
#if defined(__GNUC__) && (__GNUC__ >= 4)
# define _pci_hidden      __attribute__((visibility("hidden")))
#elif defined(__SUNPRO_C) && (__SUNPRO_C >= 0x550)
# define _pci_hidden      __hidden
#else /* not gcc >= 4 and not Sun Studio >= 8 */
# define _pci_hidden
#endif /* GNUC >= 4 */
Ian Romanick's avatar
Ian Romanick committed
39

40
41
42
43
44
/*
 * O_CLOEXEC fixes an fd leak case (see 'man 2 open' for details). I don't
 * know of any OS we support where this isn't available in a sufficiently
 * new version, so warn unconditionally.
 */
45
#include <fcntl.h>
46
47
48
49
50
51
52

#ifndef O_CLOEXEC
#warning O_CLOEXEC not available, please upgrade.
#define O_CLOEXEC 0
#endif


53
54
struct pci_device_mapping;

Ian Romanick's avatar
Ian Romanick committed
55
int pci_fill_capabilities_generic( struct pci_device * dev );
56
57
int pci_device_generic_unmap_range(struct pci_device *dev,
    struct pci_device_mapping *map);
Ian Romanick's avatar
Ian Romanick committed
58
59
60
61

struct pci_system_methods {
    void (*destroy)( void );
    void (*destroy_device)( struct pci_device * dev );
Alan Coopersmith's avatar
Alan Coopersmith committed
62
    int (*read_rom)( struct pci_device * dev, void * buffer );
Ian Romanick's avatar
Ian Romanick committed
63
    int (*probe)( struct pci_device * dev );
64
65
66
    int (*map_range)(struct pci_device *dev, struct pci_device_mapping *map);
    int (*unmap_range)(struct pci_device * dev,
		       struct pci_device_mapping *map);
Alan Coopersmith's avatar
Alan Coopersmith committed
67

Ian Romanick's avatar
Ian Romanick committed
68
69
70
71
72
73
74
    int (*read)(struct pci_device * dev, void * data, pciaddr_t offset,
		pciaddr_t size, pciaddr_t * bytes_read );

    int (*write)(struct pci_device * dev, const void * data, pciaddr_t offset,
		pciaddr_t size, pciaddr_t * bytes_written );

    int (*fill_capabilities)( struct pci_device * dev );
75
    void (*enable)( struct pci_device *dev );
76
    int (*boot_vga)( struct pci_device *dev );
77
    int (*has_kernel_driver)( struct pci_device *dev );
Adam Jackson's avatar
Adam Jackson committed
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
    struct pci_io_handle *(*open_device_io)( struct pci_io_handle *handle,
					     struct pci_device *dev, int bar,
					     pciaddr_t base, pciaddr_t size );
    struct pci_io_handle *(*open_legacy_io)( struct pci_io_handle *handle,
					     struct pci_device *dev,
					     pciaddr_t base, pciaddr_t size );
    void (*close_io)( struct pci_device *dev, struct pci_io_handle *handle );
    uint32_t (*read32)( struct pci_io_handle *handle, uint32_t reg );
    uint16_t (*read16)( struct pci_io_handle *handle, uint32_t reg );
    uint8_t  (*read8)( struct pci_io_handle *handle, uint32_t reg );
    void (*write32)( struct pci_io_handle *handle, uint32_t reg,
		     uint32_t data );
    void (*write16)( struct pci_io_handle *handle, uint32_t reg,
		     uint16_t data );
    void (*write8)( struct pci_io_handle *handle, uint32_t reg, uint8_t data );
Adam Jackson's avatar
Adam Jackson committed
93
94
95
96

    int (*map_legacy)(struct pci_device *dev, pciaddr_t base, pciaddr_t size,
		      unsigned map_flags, void **addr);
    int (*unmap_legacy)(struct pci_device *dev, void *addr, pciaddr_t size);
Ian Romanick's avatar
Ian Romanick committed
97
98
};

99
100
101
102
103
104
105
106
struct pci_device_mapping {
    pciaddr_t base;
    pciaddr_t size;
    unsigned region;
    unsigned flags;
    void *memory;
};

Adam Jackson's avatar
Adam Jackson committed
107
108
109
struct pci_io_handle {
    pciaddr_t base;
    pciaddr_t size;
110
    void *memory;
Adam Jackson's avatar
Adam Jackson committed
111
    int fd;
112
    int is_legacy;
Adam Jackson's avatar
Adam Jackson committed
113
114
};

Ian Romanick's avatar
Ian Romanick committed
115
116
117
struct pci_device_private {
    struct pci_device  base;
    const char * device_string;
Alan Coopersmith's avatar
Alan Coopersmith committed
118

119
120
    uint8_t header_type;

Ian Romanick's avatar
Ian Romanick committed
121
122
123
124
125
126
    /**
     * \name PCI Capabilities
     */
    /*@{*/
    const struct pci_agp_info * agp;   /**< AGP capability information. */
    /*@}*/
Alan Coopersmith's avatar
Alan Coopersmith committed
127

128
129
130
131
132
    /**
     * Base address of the device's expansion ROM.
     */
    pciaddr_t rom_base;

133
134
135
136
137
138
139
140
141
    /**
     * \name Bridge information.
     */
    /*@{*/
    union {
	struct pci_bridge_info * pci;
	struct pci_pcmcia_bridge_info * pcmcia;
    } bridge;
    /*@}*/
142
143
144
145
146
147
148
149

    /**
     * \name Mappings active on this device.
     */
    /*@{*/
    struct pci_device_mapping *mappings;
    unsigned num_mappings;
    /*@}*/
150
151
152
#ifdef __sun
    int is_primary;
#endif
Ian Romanick's avatar
Ian Romanick committed
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
};


/**
 * Base type for tracking PCI subsystem information.
 */
struct pci_system {
    /**
     * Platform dependent implementations of specific API routines.
     */
    const struct pci_system_methods * methods;

    /**
     * Number of known devices in the system.
     */
    size_t num_devices;

    /**
     * Array of known devices.
     */
    struct pci_device_private * devices;
174
175
176
177

#ifdef HAVE_MTRR
    int mtrr_fd;
#endif
178
    int vgaarb_fd;
179
    int vga_count;
180
181
    struct pci_device *vga_target;
    struct pci_device *vga_default_dev;
Ian Romanick's avatar
Ian Romanick committed
182
183
184
};

extern struct pci_system * pci_sys;
185
186
187

extern int pci_system_linux_sysfs_create( void );
extern int pci_system_freebsd_create( void );
188
extern void pci_system_freebsd_init_dev_mem( int );
Juan RP's avatar
Juan RP committed
189
extern int pci_system_netbsd_create( void );
190
191
extern int pci_system_openbsd_create( void );
extern void pci_system_openbsd_init_dev_mem( int );
192
extern int pci_system_solx_devfs_create( void );
Samuel Thibault's avatar
Samuel Thibault committed
193
extern int pci_system_x86_create( void );
Adam Jackson's avatar
Adam Jackson committed
194
extern void pci_io_cleanup( void );