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
Kirill Smelkov
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