Skip to content
Projects
Groups
Snippets
Help
Loading...
Help
Support
Keyboard shortcuts
?
Submit feedback
Contribute to GitLab
Sign in / Register
Toggle navigation
L
linux
Project overview
Project overview
Details
Activity
Releases
Repository
Repository
Files
Commits
Branches
Tags
Contributors
Graph
Compare
Issues
0
Issues
0
List
Boards
Labels
Milestones
Merge Requests
0
Merge Requests
0
Analytics
Analytics
Repository
Value Stream
Wiki
Wiki
Snippets
Snippets
Members
Members
Collapse sidebar
Close sidebar
Activity
Graph
Create a new issue
Commits
Issue Boards
Open sidebar
nexedi
linux
Commits
19c273c5
Commit
19c273c5
authored
Jun 07, 2003
by
Sam Ravnborg
Browse files
Options
Browse Files
Download
Plain Diff
Merge
bk://linux-sam.bkbits.net/main
into mars.ravnborg.org:/home/sam/src/linux/kernel/bk/v2.5
parents
928880f8
20a88ed0
Changes
6
Hide whitespace changes
Inline
Side-by-side
Showing
6 changed files
with
83 additions
and
59 deletions
+83
-59
Documentation/DocBook/Makefile
Documentation/DocBook/Makefile
+31
-17
Documentation/DocBook/kernel-api.tmpl
Documentation/DocBook/kernel-api.tmpl
+2
-1
drivers/net/sis900.c
drivers/net/sis900.c
+36
-36
kernel/kmod.c
kernel/kmod.c
+1
-1
scripts/docproc.c
scripts/docproc.c
+1
-1
scripts/kernel-doc
scripts/kernel-doc
+12
-3
No files found.
Documentation/DocBook/Makefile
View file @
19c273c5
...
...
@@ -39,8 +39,8 @@ htmldocs: $(HTML)
###
#External programs used
KERNELDOC
=
$(objtree)
/
scripts/kernel-doc
DOCPROC
=
$(objtree)
/
scripts/docproc
KERNELDOC
=
scripts/kernel-doc
DOCPROC
=
scripts/docproc
###
# DOCPROC is used for two purposes:
...
...
@@ -50,14 +50,14 @@ DOCPROC=$(objtree)/scripts/docproc
# The following rules are used to generate the .sgml documentation
# required to generate the final targets. (ps, pdf, html).
quiet_cmd_docproc
=
DOCPROC
$@
cmd_docproc
=
$(DOCPROC)
doc
$<
>
$@
cmd_docproc
=
$(DOCPROC)
doc
$<
>
$@
define
rule_docproc
set
-e
$(if
$($(quiet)cmd_$(1)),echo
' $($(quiet)cmd_$(1))'
;)
$(cmd_$(1));
\
(
\
echo 'cmd_$@
:
= $(cmd_$(1))';
\
echo $@: `$(DOCPROC) depend $<`;
\
set
-e
;
\
$(if
$($(quiet)cmd_$(1)),echo
' $($(quiet)cmd_$(1))'
;)
\
$(cmd_$(1));
\
(
\
echo 'cmd_$@
:
= $(cmd_$(1))';
\
echo $@: `$(DOCPROC) depend $<`;
\
) > $(dir $@).$(notdir $@).cmd
endef
...
...
@@ -96,41 +96,55 @@ $(obj)/parportbook.ps $(obj)/parportbook.pdf: $(EPS-parportbook) $(PNG-parportbo
###
# Rules to generate postscript, PDF and HTML
# db2html creates a directory. Generate a html file used for timestamp
quiet_cmd_db2ps
=
DB2PS
$@
cmd_db2ps
=
db2ps
-o
$(
dir
$@
)
$<
%.ps
:
%.sgml
@
(
which db2ps
>
/dev/null 2>&1
)
||
\
(
echo
"*** You need to install DocBook stylesheets ***"
;
\
exit
1
)
$(
call
do_cmd,DB2PS
$@
,db2ps
-o
$(
dir
$@
)
$<
)
$(
call
cmd,db2ps
)
quiet_cmd_db2pdf
=
DB2PDF
$@
cmd_db2pdf
=
db2pdf
-o
$(
dir
$@
)
$<
%.pdf
:
%.sgml
@
(
which db2pdf
>
/dev/null 2>&1
)
||
\
(
echo
"*** You need to install DocBook stylesheets ***"
;
\
exit
1
)
$(
call
do_cmd,DB2PDF
$@
,db2pdf
-o
$(
dir
$@
)
$<
)
$(
call
cmd,db2pdf
)
quiet_cmd_db2html
=
DB2HTML
$@
cmd_db2html
=
db2html
-o
$(
patsubst
%.html,%,
$@
)
$<
&&
\
echo
'<a HREF="
$(
patsubst
%.html,%,
$(
notdir
$@
))
/book1.html"> \
Goto
$(
patsubst
%.html,%,
$(
notdir
$@
))
</a><p>'
>
$@
%.html
:
%.sgml
@
(
which db2html
>
/dev/null 2>&1
)
||
\
(
echo
"*** You need to install DocBook stylesheets ***"
;
\
exit
1
)
@
rm
-rf
$@
$(
patsubst
%.html,%,
$@
)
$(
call
do_cmd,DB2HTML
$@
,db2html
-o
$(
patsubst
%.html,%,
$@
)
$<
&&
\
echo
'<a HREF="
$(
patsubst
%.html,%,
$(
notdir
$@
))
/book1.html">\
Goto
$(
patsubst
%.html,%,
$(
notdir
$@
))
</a><p>'
>
$@
)
$(
call
cmd,db2html
)
@
if
[
!
-z
"
$
(PNG-
$(
basename
$(
notdir
$@
))
)"
]
;
then
\
cp
$
(
PNG-
$(
basename
$(
notdir
$@
))
)
$(
patsubst
%.html,%,
$@
)
;
fi
###
# Rules to generate postscripts and PNG imgages from .fig format files
quiet_cmd_fig2eps
=
FIG2EPS
$@
cmd_fig2eps
=
fig2dev
-Leps
$<
$@
%.eps
:
%.fig
$(
call
do_cmd,FIG2DEV
-Leps
$@
,fig2dev
-Leps
$<
$@
)
$(
call
cmd,fig2eps
)
quiet_cmd_fig2png
=
FIG2PNG
$@
cmd_fig2png
=
fig2dev
-Lpng
$<
$@
%.png
:
%.fig
$(
call
do_cmd,FIG2DEV
-Lpng
$@
,fig2dev
-Lpng
$<
$@
)
$(
call
cmd,fig2png
)
###
# Rule to convert a .c file to inline SGML documentation
%.sgml
:
%.c
@
echo
' G
enerating
$@'
@
echo
' G
EN
$@'
@
(
\
echo
"<programlisting>"
;
\
expand
--tabs
=
8 <
$<
|
\
...
...
Documentation/DocBook/kernel-api.tmpl
View file @
19c273c5
...
...
@@ -79,6 +79,7 @@ KAO -->
</sect1>
<sect1><title>
String Manipulation
</title>
!Ilib/string.c
!Elib/string.c
</sect1>
<sect1><title>
Bit Operations
</title>
!Iinclude/asm-i386/bitops.h
...
...
@@ -176,7 +177,7 @@ X!Ekernel/module.c
!Edrivers/pci/pci.c
</sect1>
<sect1><title>
PCI Hotplug Support Library
</title>
!Edrivers/hotplug/pci_hotplug_core.c
!Edrivers/
pci/
hotplug/pci_hotplug_core.c
</sect1>
<sect1><title>
MCA Architecture
</title>
<sect2><title>
MCA Device Functions
</title>
...
...
drivers/net/sis900.c
View file @
19c273c5
...
...
@@ -211,7 +211,7 @@ static void sis900_auto_negotiate(struct net_device *net_dev, int phy_addr);
static
void
sis900_set_mode
(
long
ioaddr
,
int
speed
,
int
duplex
);
/**
* sis900_get_mac_addr
:
- Get MAC address for stand alone SiS900 model
* sis900_get_mac_addr - Get MAC address for stand alone SiS900 model
* @pci_dev: the sis900 pci device
* @net_dev: the net device to get address for
*
...
...
@@ -241,7 +241,7 @@ static int __devinit sis900_get_mac_addr(struct pci_dev * pci_dev, struct net_de
}
/**
* sis630e_get_mac_addr
:
- Get MAC address for SiS630E model
* sis630e_get_mac_addr - Get MAC address for SiS630E model
* @pci_dev: the sis900 pci device
* @net_dev: the net device to get address for
*
...
...
@@ -274,7 +274,7 @@ static int __devinit sis630e_get_mac_addr(struct pci_dev * pci_dev, struct net_d
/**
* sis635_get_mac_addr
:
- Get MAC address for SIS635 model
* sis635_get_mac_addr - Get MAC address for SIS635 model
* @pci_dev: the sis900 pci device
* @net_dev: the net device to get address for
*
...
...
@@ -310,7 +310,7 @@ static int __devinit sis635_get_mac_addr(struct pci_dev * pci_dev, struct net_de
}
/**
* sis96x_get_mac_addr
:
- Get MAC address for SiS962 or SiS963 model
* sis96x_get_mac_addr - Get MAC address for SiS962 or SiS963 model
* @pci_dev: the sis900 pci device
* @net_dev: the net device to get address for
*
...
...
@@ -352,7 +352,7 @@ static int __devinit sis96x_get_mac_addr(struct pci_dev * pci_dev, struct net_de
}
/**
* sis900_probe
:
- Probe for sis900 device
* sis900_probe - Probe for sis900 device
* @pci_dev: the sis900 pci device
* @pci_id: the pci device ID
*
...
...
@@ -498,7 +498,7 @@ static int __devinit sis900_probe (struct pci_dev *pci_dev, const struct pci_dev
}
/**
* sis900_mii_probe
:
- Probe MII PHY for sis900
* sis900_mii_probe - Probe MII PHY for sis900
* @net_dev: the net device to probe for
*
* Search for total of 32 possible mii phy addresses.
...
...
@@ -618,7 +618,7 @@ static int __init sis900_mii_probe (struct net_device * net_dev)
}
/**
* sis900_default_phy
:
- Select default PHY for sis900 mac.
* sis900_default_phy - Select default PHY for sis900 mac.
* @net_dev: the net device to probe for
*
* Select first detected PHY with link as default.
...
...
@@ -671,7 +671,7 @@ static u16 sis900_default_phy(struct net_device * net_dev)
/**
* sis900_set_capability
:
- set the media capability of network adapter.
* sis900_set_capability - set the media capability of network adapter.
* @net_dev : the net device to probe for
* @phy : default PHY
*
...
...
@@ -701,7 +701,7 @@ static void sis900_set_capability( struct net_device *net_dev , struct mii_phy *
#define eeprom_delay() inl(ee_addr)
/**
* read_eeprom
:
- Read Serial EEPROM
* read_eeprom - Read Serial EEPROM
* @ioaddr: base i/o address
* @location: the EEPROM location to read
*
...
...
@@ -776,7 +776,7 @@ static void mdio_reset(long mdio_addr)
}
/**
* mdio_read
:
- read MII PHY register
* mdio_read - read MII PHY register
* @net_dev: the net device to read
* @phy_id: the phy address to read
* @location: the phy regiester id to read
...
...
@@ -818,7 +818,7 @@ static u16 mdio_read(struct net_device *net_dev, int phy_id, int location)
}
/**
* mdio_write
:
- write MII PHY register
* mdio_write - write MII PHY register
* @net_dev: the net device to write
* @phy_id: the phy address to write
* @location: the phy regiester id to write
...
...
@@ -872,7 +872,7 @@ static void mdio_write(struct net_device *net_dev, int phy_id, int location, int
/**
* sis900_reset_phy
:
- reset sis900 mii phy.
* sis900_reset_phy - reset sis900 mii phy.
* @net_dev: the net device to write
* @phy_addr: default phy address
*
...
...
@@ -895,7 +895,7 @@ static u16 sis900_reset_phy(struct net_device *net_dev, int phy_addr)
}
/**
* sis900_open
:
- open sis900 device
* sis900_open - open sis900 device
* @net_dev: the net device to open
*
* Do some initialization and start net interface.
...
...
@@ -952,7 +952,7 @@ sis900_open(struct net_device *net_dev)
}
/**
* sis900_init_rxfilter
:
- Initialize the Rx filter
* sis900_init_rxfilter - Initialize the Rx filter
* @net_dev: the net device to initialize for
*
* Set receive filter address to our MAC address
...
...
@@ -990,7 +990,7 @@ sis900_init_rxfilter (struct net_device * net_dev)
}
/**
* sis900_init_tx_ring
:
- Initialize the Tx descriptor ring
* sis900_init_tx_ring - Initialize the Tx descriptor ring
* @net_dev: the net device to initialize for
*
* Initialize the Tx descriptor ring,
...
...
@@ -1023,7 +1023,7 @@ sis900_init_tx_ring(struct net_device *net_dev)
}
/**
* sis900_init_rx_ring
:
- Initialize the Rx descriptor ring
* sis900_init_rx_ring - Initialize the Rx descriptor ring
* @net_dev: the net device to initialize for
*
* Initialize the Rx descriptor ring,
...
...
@@ -1077,7 +1077,7 @@ sis900_init_rx_ring(struct net_device *net_dev)
}
/**
* sis630_set_eq
:
- set phy equalizer value for 630 LAN
* sis630_set_eq - set phy equalizer value for 630 LAN
* @net_dev: the net device to set equalizer value
* @revision: 630 LAN revision number
*
...
...
@@ -1165,7 +1165,7 @@ static void sis630_set_eq(struct net_device *net_dev, u8 revision)
}
/**
* sis900_timer
:
- sis900 timer routine
* sis900_timer - sis900 timer routine
* @data: pointer to sis900 net device
*
* On each timer ticks we check two things,
...
...
@@ -1235,7 +1235,7 @@ static void sis900_timer(unsigned long data)
}
/**
* sis900_check_mode
:
- check the media mode for sis900
* sis900_check_mode - check the media mode for sis900
* @net_dev: the net device to be checked
* @mii_phy: the mii phy
*
...
...
@@ -1266,7 +1266,7 @@ static void sis900_check_mode (struct net_device *net_dev, struct mii_phy *mii_p
}
/**
* sis900_set_mode
:
- Set the media mode of mac register.
* sis900_set_mode - Set the media mode of mac register.
* @ioaddr: the address of the device
* @speed : the transmit speed to be determined
* @duplex: the duplex mode to be determined
...
...
@@ -1310,7 +1310,7 @@ static void sis900_set_mode (long ioaddr, int speed, int duplex)
}
/**
* sis900_auto_negotiate
:
Set the Auto-Negotiation Enable/Reset bit.
* sis900_auto_negotiate
-
Set the Auto-Negotiation Enable/Reset bit.
* @net_dev: the net device to read mode for
* @phy_addr: mii phy address
*
...
...
@@ -1344,7 +1344,7 @@ static void sis900_auto_negotiate(struct net_device *net_dev, int phy_addr)
/**
* sis900_read_mode
:
- read media mode for sis900 internal phy
* sis900_read_mode - read media mode for sis900 internal phy
* @net_dev: the net device to read mode for
* @speed : the transmit speed to be determined
* @duplex : the duplex mode to be determined
...
...
@@ -1401,7 +1401,7 @@ static void sis900_read_mode(struct net_device *net_dev, int *speed, int *duplex
}
/**
* sis900_tx_timeout
:
- sis900 transmit timeout routine
* sis900_tx_timeout - sis900 transmit timeout routine
* @net_dev: the net device to transmit
*
* print transmit timeout status
...
...
@@ -1456,7 +1456,7 @@ static void sis900_tx_timeout(struct net_device *net_dev)
}
/**
* sis900_start_xmit
:
- sis900 start transmit routine
* sis900_start_xmit - sis900 start transmit routine
* @skb: socket buffer pointer to put the data being transmitted
* @net_dev: the net device to transmit with
*
...
...
@@ -1526,7 +1526,7 @@ sis900_start_xmit(struct sk_buff *skb, struct net_device *net_dev)
}
/**
* sis900_interrupt
:
- sis900 interrupt handler
* sis900_interrupt - sis900 interrupt handler
* @irq: the irq number
* @dev_instance: the client data object
* @regs: snapshot of processor context
...
...
@@ -1587,7 +1587,7 @@ static irqreturn_t sis900_interrupt(int irq, void *dev_instance, struct pt_regs
}
/**
* sis900_rx
:
- sis900 receive routine
* sis900_rx - sis900 receive routine
* @net_dev: the net device which receives data
*
* Process receive interrupt events,
...
...
@@ -1726,7 +1726,7 @@ static int sis900_rx(struct net_device *net_dev)
}
/**
* sis900_finish_xmit
:
- finish up transmission of packets
* sis900_finish_xmit - finish up transmission of packets
* @net_dev: the net device to be transmitted on
*
* Check for error condition and free socket buffer etc
...
...
@@ -1796,7 +1796,7 @@ static void sis900_finish_xmit (struct net_device *net_dev)
}
/**
* sis900_close
:
- close sis900 device
* sis900_close - close sis900 device
* @net_dev: the net device to be closed
*
* Disable interrupts, stop the Tx and Rx Status Machine
...
...
@@ -1852,7 +1852,7 @@ sis900_close(struct net_device *net_dev)
}
/**
* netdev_ethtool_ioctl
:
- For the basic support of ethtool
* netdev_ethtool_ioctl - For the basic support of ethtool
* @net_dev: the net device to command for
* @useraddr: start address of interface request
*
...
...
@@ -1886,7 +1886,7 @@ static int netdev_ethtool_ioctl (struct net_device *net_dev, void *useraddr)
}
/**
* mii_ioctl
:
- process MII i/o control command
* mii_ioctl - process MII i/o control command
* @net_dev: the net device to command for
* @rq: parameter for command
* @cmd: the i/o command
...
...
@@ -1922,7 +1922,7 @@ static int mii_ioctl(struct net_device *net_dev, struct ifreq *rq, int cmd)
}
/**
* sis900_get_stats
:
- Get sis900 read/write statistics
* sis900_get_stats - Get sis900 read/write statistics
* @net_dev: the net device to get statistics for
*
* get tx/rx statistics for sis900
...
...
@@ -1937,7 +1937,7 @@ sis900_get_stats(struct net_device *net_dev)
}
/**
* sis900_set_config
:
- Set media type by net_device.set_config
* sis900_set_config - Set media type by net_device.set_config
* @dev: the net device for media type change
* @map: ifmap passed by ifconfig
*
...
...
@@ -2034,7 +2034,7 @@ static int sis900_set_config(struct net_device *dev, struct ifmap *map)
}
/**
* sis900_mcast_bitnr
:
- compute hashtable index
* sis900_mcast_bitnr - compute hashtable index
* @addr: multicast address
* @revision: revision id of chip
*
...
...
@@ -2057,7 +2057,7 @@ static inline u16 sis900_mcast_bitnr(u8 *addr, u8 revision)
}
/**
* set_rx_mode
:
- Set SiS900 receive mode
* set_rx_mode - Set SiS900 receive mode
* @net_dev: the net device to be set
*
* Set SiS900 receive mode for promiscuous, multicast, or broadcast mode.
...
...
@@ -2131,7 +2131,7 @@ static void set_rx_mode(struct net_device *net_dev)
}
/**
* sis900_reset
:
- Reset sis900 MAC
* sis900_reset - Reset sis900 MAC
* @net_dev: the net device to reset
*
* reset sis900 MAC and wait until finished
...
...
@@ -2166,7 +2166,7 @@ static void sis900_reset(struct net_device *net_dev)
}
/**
* sis900_remove
:
- Remove sis900 device
* sis900_remove - Remove sis900 device
* @pci_dev: the pci device to be removed
*
* remove and release SiS900 net device
...
...
kernel/kmod.c
View file @
19c273c5
...
...
@@ -58,9 +58,9 @@ char modprobe_path[256] = "/sbin/modprobe";
* If module auto-loading support is disabled then this function
* becomes a no-operation.
*/
#define MODULENAME_SIZE 32
int
request_module
(
const
char
*
fmt
,
...)
{
#define MODULENAME_SIZE 32
va_list
args
;
char
module_name
[
MODULENAME_SIZE
];
unsigned
int
max_modprobes
;
...
...
scripts/docproc.c
View file @
19c273c5
...
...
@@ -93,7 +93,7 @@ void exec_kernel_doc(char **svec)
waitpid
(
pid
,
&
ret
,
0
);
}
if
(
WIFEXITED
(
ret
))
exitstatus
=
WEXITSTATUS
(
ret
);
exitstatus
|
=
WEXITSTATUS
(
ret
);
else
exitstatus
=
0xff
;
}
...
...
scripts/kernel-doc
View file @
19c273c5
...
...
@@ -154,6 +154,7 @@ use strict;
# '%CONST' - name of a constant.
my
$errors
=
0
;
my
$warnings
=
0
;
# match expressions used to find embedded type information
my
$type_constant
=
'
\
%([-_
\
w]+)
';
...
...
@@ -1352,7 +1353,9 @@ sub create_parameterlist($$$) {
"
or member '
$param
' not
"
.
"
described in '
$declaration_name
'
\n
";
}
++
$errors
;
print
STDERR
"
Warning(
${file}
:$.):
"
.
"
No description found for parameter '
$param
'
\n
";
++
$warnings
;
}
push
@parameterlist
,
$param
;
...
...
@@ -1456,6 +1459,12 @@ foreach (@ARGV) {
chomp
;
process_file
(
$_
);
}
if
(
$verbose
&&
$errors
)
{
print
STDERR
"
$errors
errors
\n
";
}
if
(
$verbose
&&
$warnings
)
{
print
STDERR
"
$warnings
warnings
\n
";
}
exit
(
$errors
);
...
...
@@ -1580,7 +1589,7 @@ sub process_file($) {
}
else
{
print
STDERR
"
Warning(
${file}
:$.): Cannot understand
$_
on line $.
",
"
- I thought it was a doc line
\n
";
++
$
error
s
;
++
$
warning
s
;
$state
=
0
;
}
}
elsif
(
$state
==
2
)
{
# look for head: lines, and include content
...
...
@@ -1633,7 +1642,7 @@ sub process_file($) {
}
else
{
# i dont know - bad line? ignore.
print
STDERR
"
Warning(
${file}
:$.): bad line:
$_
";
++
$
error
s
;
++
$
warning
s
;
}
}
elsif
(
$state
==
3
)
{
# scanning for function { (end of prototype)
if
(
$decl_type
eq
'
function
')
{
...
...
Write
Preview
Markdown
is supported
0%
Try again
or
attach a new file
Attach a file
Cancel
You are about to add
0
people
to the discussion. Proceed with caution.
Finish editing this message first!
Cancel
Please
register
or
sign in
to comment