Structured comments updated.

[lincan.git] / lincan / src / main.c

diff --git a/lincan/src/main.c b/lincan/src/main.c
index b57c79c87b53e3b00795bd2e28c53d11095be842..23bd6da2ed57b6207f0ad93eb09e3e90c7a7e44d 100644 (file)
--- a/lincan/src/main.c
+++ b/lincan/src/main.c
@@ -7,7 +7,9 @@
  * Version lincan-0.2  9 Jul 2003
  */
 
+#ifndef EXPORT_SYMTAB
 #define EXPORT_SYMTAB
+#endif
 
 #include <linux/autoconf.h>
 
@@ -61,36 +63,53 @@
 #include "../include/can_iortl.h"
 #endif /*CAN_WITH_RTL*/
 
-#define EXPORT_SYMTAB
-
 can_spinlock_t canuser_manipulation_lock;
 
 /* Module parameters, some must be supplied at module loading time */
 int major=CAN_MAJOR;
 MODULE_PARM(major,"1i");
+MODULE_PARM_DESC(major,"can be used to change default major [" __MODULE_STRING(CAN_MAJOR) "]");
 int minor[MAX_TOT_CHIPS]={-1,-1,-1,-1,-1,-1,-1,-1,-1,-1,-1,-1,-1,-1,-1,-1,-1,-1,-1,-1,-1,-1,-1,-1,-1,-1,-1,-1,-1,-1,-1,-1};
 /*MODULE_PARM(minor, "1-" __MODULE_STRING(MAX_TOT_CHIPS)"i");*/
 MODULE_PARM(minor, "1-" __MODULE_STRING(MAX_TOT_CHIPS_STR)"i");
+MODULE_PARM_DESC(minor,"can be used to change default starting minor for each channel");
 int extended=0;
 MODULE_PARM(extended,"1i");
+MODULE_PARM_DESC(extended,"enables automatic switching to extended format if ID>2047,"
+                       " selects extended frames reception for i82527");
 int pelican=0;
 MODULE_PARM(pelican,"1i");
+MODULE_PARM_DESC(pelican,"unused parameter, PeliCAN used by default for sja1000p chips");
 int baudrate[MAX_TOT_CHIPS];
 MODULE_PARM(baudrate, "1-" __MODULE_STRING(MAX_TOT_CHIPS_STR)"i");
+MODULE_PARM_DESC(baudrate,"baudrate for each channel in step of 1kHz");
 char *hw[MAX_HW_CARDS]={NULL,};
 MODULE_PARM(hw, "1-" __MODULE_STRING(MAX_HW_CARDS)"s");
+MODULE_PARM_DESC(hw,"list of boards types to initialize - virtual,pip5,...");
 int irq[MAX_IRQ]={-1,-1,-1,-1,-1,-1,-1,-1,-1,-1,-1,-1,-1,-1,-1,-1,-1,-1,-1,-1,-1,-1,-1,-1,-1,-1,-1,-1,-1,-1,-1,-1};
 MODULE_PARM(irq, "1-" __MODULE_STRING(MAX_IRQ)"i");
+MODULE_PARM_DESC(irq,"list of iterrupt signal numbers, most ISA has one per chip, no value for PCI or virtual");
 unsigned long io[MAX_HW_CARDS]={-1,-1,-1,-1,-1,-1,-1,-1};
 MODULE_PARM(io, "1-" __MODULE_STRING(MAX_HW_CARDS)"i");
+MODULE_PARM_DESC(io,"IO address for each board, use 0 for PCI or virtual");
 int stdmask=0;
 MODULE_PARM(stdmask, "1i");
+MODULE_PARM_DESC(stdmask,"default standard mask for i82527 chips");
 int extmask=0;
 MODULE_PARM(extmask, "1i");
+MODULE_PARM_DESC(extmask,"default extended mask for i82527 chips");
 int mo15mask=0;
 MODULE_PARM(mo15mask, "1i");
+MODULE_PARM_DESC(mo15mask,"mask for communication object 15 of i82527 chips");
 int processlocal=0;
 MODULE_PARM(processlocal, "1i");
+MODULE_PARM_DESC(processlocal,"select postprocessing/loopback of transmitted messages - "
+               "0 .. disabled, 1 .. can be enabled by FIFO filter, 2 .. enabled by default");
+#ifdef CAN_WITH_RTL
+int can_rtl_priority=-1;
+MODULE_PARM(can_rtl_priority, "1i");
+MODULE_PARM_DESC(can_rtl_priority,"select priority of chip worker thread");
+#endif /*CAN_WITH_RTL*/
 
 /* Other module attributes */
 #ifdef MODULE_SUPPORTED_DEVICE
@@ -163,6 +182,7 @@ int init_module(void)
        if (parse_mod_parms())
                return -EINVAL;
 
+       can_spin_lock_init(&canuser_manipulation_lock);
        canqueue_kern_initialize();
 
        if (init_hw_struct())
@@ -179,6 +199,7 @@ int init_module(void)
        }
 
        #ifdef CAN_WITH_RTL
+       can_spin_lock_init(&can_irq_manipulation_lock);
        canqueue_rtl_initialize();
        res=rtl_register_rtldev(major,DEVICE_NAME,&can_fops_rtl);
        if (res<0) {