← Back to branch summary

~ubuntu-branches/ubuntu/edgy/hwinfo/edgy

« back to all changes in this revision

Viewing changes to src/isdn/libihw.txt

  • Committer: Bazaar Package Importer
  • Author(s): James Vega
  • Date: 2006-09-28 20:56:06 UTC
  • mfrom: (1.1.4 upstream)
  • Revision ID: james.westby@ubuntu.com-20060928205606-bgxl69hts04xbx51
Tags: 13.4-1
http://bugs.debian.org/388245
* New upstream version.
* Switch from dbs to quilt
  - Revamp debian/rules
  - Add quilt and remove dbs from Build-Depends in debian/control
* Remove reference to hwscan(8) from manpage. (closes: #388245)
* Re-wrote manpage from scratch.  Drop docbook-to-man from Build-Depends.
* Remove NEWS.Debian since it is no longer applicable.

Show diffs side-by-side

added added

removed removed

Lines of Context:
src/isdn/libihw.txt
 
1
1.
 
2
ihw_card_info   *ihw_get_card(int handle);
 
3
 
 
4
"ihw_card_info" is a struct, which hold all info about the card (see ihw.h)
 
5
The parameter is a internal used index for the database (range 0 ... max)
 
6
To get all records use the following code as example:
 
7
 
 
8
        ihw_card_info *icp;
 
9
        handle = 0;
 
10
        while ((icp =ihw_get_card(handle++))) {
 
11
                ...
 
12
        }
 
13
 
 
14
If here are no entries left, you get NULL as return value.
 
15
 
 
16
2.
 
17
ihw_card_info   *ihw_get_device_from_type(int typ, int subtyp);
 
18
 
 
19
Get card informations  for the card with TYPE and SUBTYPE .
 
20
Returns NULL if no card match.
 
21
This function is useful to get the card informations, if you have type and
 
22
subtype from a rc.config, or from hardware probe.
 
23
 
 
24
3.
 
25
extern ihw_card_info    *ihw_get_card_from_id(int vendor, int device,
 
26
                                        int subvendor, int subdevice);
 
27
 
 
28
Get card informations  for the card with VENDOR,DEVICE,SUBVENDOR and
 
29
SUBDEVICE for PCI and ISAPNP cards (set SUBVENDOR and SUBDEVICE 
 
30
to 0xffff for ISAPNP cards). Returns NULL if no card found.
 
31
 
 
32
This function will be useful for hardware probe.
 
33
 
 
34
 
 
35
4. 
 
36
ihw_para_info   *ihw_get_parameter(int card_handle, int pnr);
 
37
 
 
38
This function provides parameter info for a card (which was given by one of
 
39
the first 3 functions). "card_handle" is the "ihw_card_info->handle" of
 
40
the given card, pnr is the number of the requested parameter (1,2, ...).
 
41
For the first parameter, set pnr to 1, for next increment pnr, until
 
42
NULL is returned.
 
43
 
 
44
For examples see at demo/demo.c
 
45
 
 
46
Specials:
 
47
 
 
48
To make it easy to decide, if an parameter has to be set in a rc.config
 
49
a flag P_DEFINE is set in ihw_para_info->flags, which is set for all
 
50
parameter which have to go into rc.config (for yast1 this parameter has to be
 
51
setable).
 
52
 
 
53
Other flags (may be useful for autodetection):
 
54
 
 
55
P_HARDSET  - parameter depends on a jumper or switch.
 
56
P_SOFTSET  - parameter is written into a config register (not for PnP/PCI)
 
57
P_READABLE - parameter can be read from a config register (not for PnP/PCI)
 
58
P_ISAPNP   - parameter is set via ISA PnP setup
 
59
P_PCI      - parameter is a PCI one
 
60
 
 
61
Karsten