1 /* $Id: hysdn_proclog.c,v 1.9.6.3 2001/09/23 22:24:54 kai Exp $
3 * Linux driver for HYSDN cards, /proc/net filesystem log functions.
5 * Author Werner Cornelius (werner@titro.de) for Hypercope GmbH
6 * Copyright 1999 by Werner Cornelius (werner@titro.de)
8 * This software may be used and distributed according to the terms
9 * of the GNU General Public License, incorporated herein by reference.
13 #include <linux/module.h>
14 #include <linux/version.h>
15 #include <linux/poll.h>
16 #include <linux/proc_fs.h>
17 #include <linux/pci.h>
18 #include <linux/smp_lock.h>
20 #include "hysdn_defs.h"
22 /* the proc subdir for the interface is defined in the procconf module */
23 extern struct proc_dir_entry *hysdn_proc_entry;
25 static void put_log_buffer(hysdn_card * card, char *cp);
27 /*************************************************/
28 /* structure keeping ascii log for device output */
29 /*************************************************/
31 struct log_data *next;
32 ulong usage_cnt; /* number of files still to work */
33 void *proc_ctrl; /* pointer to own control procdata structure */
34 char log_start[2]; /* log string start (final len aligned by size) */
37 /**********************************************/
38 /* structure holding proc entrys for one card */
39 /**********************************************/
41 struct proc_dir_entry *log; /* log entry */
42 char log_name[15]; /* log filename */
43 struct log_data *log_head, *log_tail; /* head and tail for queue */
44 int if_used; /* open count for interface */
45 int volatile del_lock; /* lock for delete operations */
46 uchar logtmp[LOG_MAX_LINELEN];
47 wait_queue_head_t rd_queue;
51 /**********************************************/
52 /* log function for cards error log interface */
53 /**********************************************/
55 hysdn_card_errlog(hysdn_card * card, tErrLogEntry * logp, int maxsize)
57 char buf[ERRLOG_TEXT_SIZE + 40];
59 sprintf(buf, "LOG 0x%08lX 0x%08lX : %s\n", logp->ulErrType, logp->ulErrSubtype, logp->ucText);
60 put_log_buffer(card, buf); /* output the string */
61 } /* hysdn_card_errlog */
63 /***************************************************/
64 /* Log function using format specifiers for output */
65 /***************************************************/
67 hysdn_addlog(hysdn_card * card, char *fmt,...)
69 struct procdata *pd = card->proclog;
74 return; /* log structure non existent */
77 cp += sprintf(cp, "HYSDN: card %d ", card->myid);
80 cp += vsprintf(cp, fmt, args);
85 if (card->debug_flags & DEB_OUT_SYSLOG)
86 printk(KERN_INFO "%s", pd->logtmp);
88 put_log_buffer(card, pd->logtmp);
92 /********************************************/
93 /* put an log buffer into the log queue. */
94 /* This buffer will be kept until all files */
95 /* opened for read got the contents. */
96 /* Flushes buffers not longer in use. */
97 /********************************************/
99 put_log_buffer(hysdn_card * card, char *cp)
102 struct procdata *pd = card->proclog;
112 if (pd->if_used <= 0)
113 return; /* no open file for read */
115 if (!(ib = (struct log_data *) kmalloc(sizeof(struct log_data) + strlen(cp), GFP_ATOMIC)))
116 return; /* no memory */
117 strcpy(ib->log_start, cp); /* set output string */
119 ib->proc_ctrl = pd; /* point to own control structure */
122 ib->usage_cnt = pd->if_used;
124 pd->log_head = ib; /* new head */
126 pd->log_tail->next = ib; /* follows existing messages */
127 pd->log_tail = ib; /* new tail */
128 i = pd->del_lock++; /* get lock state */
129 restore_flags(flags);
131 /* delete old entrys */
133 while (pd->log_head->next) {
134 if ((pd->log_head->usage_cnt <= 0) &&
135 (pd->log_head->next->usage_cnt <= 0)) {
137 pd->log_head = pd->log_head->next;
141 } /* pd->log_head->next */
142 pd->del_lock--; /* release lock level */
143 wake_up_interruptible(&(pd->rd_queue)); /* announce new entry */
144 } /* put_log_buffer */
147 /******************************/
148 /* file operations and tables */
149 /******************************/
151 /****************************************/
152 /* write log file -> set log level bits */
153 /****************************************/
155 hysdn_log_write(struct file *file, const char __user *buf, size_t count, loff_t * off)
159 uchar *cp, valbuf[128];
161 hysdn_card *card = (hysdn_card *) file->private_data;
163 if (count > (sizeof(valbuf) - 1))
164 count = sizeof(valbuf) - 1; /* limit length */
165 if (copy_from_user(valbuf, buf, count))
166 return (-EFAULT); /* copy failed */
168 valbuf[count] = 0; /* terminating 0 */
170 if ((count > 2) && (valbuf[0] == '0') && (valbuf[1] == 'x')) {
171 cp += 2; /* pointer after hex modifier */
174 /* scan the input for debug flags */
176 if ((*cp >= '0') && (*cp <= '9')) {
178 u *= base; /* adjust to next digit */
183 break; /* end of number */
185 if ((*cp >= 'a') && (*cp <= 'f')) {
187 u *= base; /* adjust to next digit */
188 u += *cp++ - 'a' + 10;
191 break; /* terminated */
195 card->debug_flags = u; /* remember debug flags */
196 hysdn_addlog(card, "debug set to 0x%lx", card->debug_flags);
199 } /* hysdn_log_write */
205 hysdn_log_read(struct file *file, char __user *buf, size_t count, loff_t * off)
207 struct log_data *inf;
209 struct proc_dir_entry *pde = PDE(file->f_dentry->d_inode);
210 struct procdata *pd = NULL;
213 if (!*((struct log_data **) file->private_data)) {
214 if (file->f_flags & O_NONBLOCK)
217 /* sorry, but we need to search the card */
223 card = card->next; /* search next entry */
226 interruptible_sleep_on(&(pd->rd_queue));
231 if (!(inf = *((struct log_data **) file->private_data)))
234 inf->usage_cnt--; /* new usage count */
235 file->private_data = &inf->next; /* next structure */
236 if ((len = strlen(inf->log_start)) <= count) {
237 if (copy_to_user(buf, inf->log_start, len))
243 } /* hysdn_log_read */
249 hysdn_log_open(struct inode *ino, struct file *filep)
252 struct procdata *pd = NULL;
259 if (pd->log == PDE(ino))
261 card = card->next; /* search next entry */
265 return (-ENODEV); /* device is unknown/invalid */
267 filep->private_data = card; /* remember our own card */
269 if ((filep->f_mode & (FMODE_READ | FMODE_WRITE)) == FMODE_WRITE) {
270 /* write only access -> write log level only */
271 } else if ((filep->f_mode & (FMODE_READ | FMODE_WRITE)) == FMODE_READ) {
273 /* read access -> log/debug read */
278 filep->private_data = &pd->log_tail->next;
280 filep->private_data = &pd->log_head;
281 restore_flags(flags);
282 } else { /* simultaneous read/write access forbidden ! */
284 return (-EPERM); /* no permission this time */
287 return nonseekable_open(ino, filep);
288 } /* hysdn_log_open */
290 /*******************************************************************************/
291 /* close a cardlog file. If the file has been opened for exclusive write it is */
292 /* assumed as pof data input and the pof loader is noticed about. */
293 /* Otherwise file is handled as log output. In this case the interface usage */
294 /* count is decremented and all buffers are noticed of closing. If this file */
295 /* was the last one to be closed, all buffers are freed. */
296 /*******************************************************************************/
298 hysdn_log_close(struct inode *ino, struct file *filep)
300 struct log_data *inf;
308 if ((filep->f_mode & (FMODE_READ | FMODE_WRITE)) == FMODE_WRITE) {
309 /* write only access -> write debug level written */
310 retval = 0; /* success */
312 /* read access -> log/debug read, mark one further file as closed */
317 inf = *((struct log_data **) filep->private_data); /* get first log entry */
319 pd = (struct procdata *) inf->proc_ctrl; /* still entries there */
321 /* no info available -> search card */
325 if (pd->log == PDE(ino))
327 card = card->next; /* search next entry */
330 pd = card->proclog; /* pointer to procfs log */
333 pd->if_used--; /* decrement interface usage count by one */
336 inf->usage_cnt--; /* decrement usage count for buffers */
339 restore_flags(flags);
342 if (pd->if_used <= 0) /* delete buffers if last file closed */
343 while (pd->log_head) {
345 pd->log_head = pd->log_head->next;
352 } /* hysdn_log_close */
354 /*************************************************/
355 /* select/poll routine to be able using select() */
356 /*************************************************/
358 hysdn_log_poll(struct file *file, poll_table * wait)
360 unsigned int mask = 0;
361 struct proc_dir_entry *pde = PDE(file->f_dentry->d_inode);
363 struct procdata *pd = NULL;
365 if ((file->f_mode & (FMODE_READ | FMODE_WRITE)) == FMODE_WRITE)
366 return (mask); /* no polling for write supported */
368 /* we need to search the card */
374 card = card->next; /* search next entry */
377 return (mask); /* card not found */
379 poll_wait(file, &(pd->rd_queue), wait);
381 if (*((struct log_data **) file->private_data))
382 mask |= POLLIN | POLLRDNORM;
385 } /* hysdn_log_poll */
387 /**************************************************/
388 /* table for log filesystem functions defined above. */
389 /**************************************************/
390 static struct file_operations log_fops =
393 .read = hysdn_log_read,
394 .write = hysdn_log_write,
395 .poll = hysdn_log_poll,
396 .open = hysdn_log_open,
397 .release = hysdn_log_close,
401 /***********************************************************************************/
402 /* hysdn_proclog_init is called when the module is loaded after creating the cards */
404 /***********************************************************************************/
406 hysdn_proclog_init(hysdn_card * card)
410 /* create a cardlog proc entry */
412 if ((pd = (struct procdata *) kmalloc(sizeof(struct procdata), GFP_KERNEL)) != NULL) {
413 memset(pd, 0, sizeof(struct procdata));
414 sprintf(pd->log_name, "%s%d", PROC_LOG_BASENAME, card->myid);
415 if ((pd->log = create_proc_entry(pd->log_name, S_IFREG | S_IRUGO | S_IWUSR, hysdn_proc_entry)) != NULL) {
416 pd->log->proc_fops = &log_fops;
417 pd->log->owner = THIS_MODULE;
420 init_waitqueue_head(&(pd->rd_queue));
422 card->proclog = (void *) pd; /* remember procfs structure */
425 } /* hysdn_proclog_init */
427 /************************************************************************************/
428 /* hysdn_proclog_release is called when the module is unloaded and before the cards */
429 /* conf file is released */
430 /* The module counter is assumed to be 0 ! */
431 /************************************************************************************/
433 hysdn_proclog_release(hysdn_card * card)
437 if ((pd = (struct procdata *) card->proclog) != NULL) {
439 remove_proc_entry(pd->log_name, hysdn_proc_entry);
440 kfree(pd); /* release memory */
441 card->proclog = NULL;
443 } /* hysdn_proclog_release */