]> git.proxmox.com Git - mirror_ubuntu-bionic-kernel.git/blame - drivers/isdn/hysdn/hysdn_proclog.c
procfs: new helper - PDE_DATA(inode)
[mirror_ubuntu-bionic-kernel.git] / drivers / isdn / hysdn / hysdn_proclog.c
CommitLineData
1da177e4
LT
1/* $Id: hysdn_proclog.c,v 1.9.6.3 2001/09/23 22:24:54 kai Exp $
2 *
3 * Linux driver for HYSDN cards, /proc/net filesystem log functions.
4 *
5 * Author Werner Cornelius (werner@titro.de) for Hypercope GmbH
6 * Copyright 1999 by Werner Cornelius (werner@titro.de)
7 *
8 * This software may be used and distributed according to the terms
9 * of the GNU General Public License, incorporated herein by reference.
10 *
11 */
12
13#include <linux/module.h>
1da177e4
LT
14#include <linux/poll.h>
15#include <linux/proc_fs.h>
d43c36dc 16#include <linux/sched.h>
5a0e3ad6 17#include <linux/slab.h>
76a64921 18#include <linux/mutex.h>
3944ad68 19#include <linux/kernel.h>
1da177e4
LT
20
21#include "hysdn_defs.h"
22
23/* the proc subdir for the interface is defined in the procconf module */
24extern struct proc_dir_entry *hysdn_proc_entry;
25
76a64921 26static DEFINE_MUTEX(hysdn_log_mutex);
475be4d8 27static void put_log_buffer(hysdn_card *card, char *cp);
aade0e82 28
1da177e4
LT
29/*************************************************/
30/* structure keeping ascii log for device output */
31/*************************************************/
32struct log_data {
33 struct log_data *next;
c721bcce 34 unsigned long usage_cnt;/* number of files still to work */
1da177e4
LT
35 void *proc_ctrl; /* pointer to own control procdata structure */
36 char log_start[2]; /* log string start (final len aligned by size) */
37};
38
39/**********************************************/
40/* structure holding proc entrys for one card */
41/**********************************************/
42struct procdata {
43 struct proc_dir_entry *log; /* log entry */
44 char log_name[15]; /* log filename */
45 struct log_data *log_head, *log_tail; /* head and tail for queue */
46 int if_used; /* open count for interface */
47 int volatile del_lock; /* lock for delete operations */
c721bcce 48 unsigned char logtmp[LOG_MAX_LINELEN];
1da177e4
LT
49 wait_queue_head_t rd_queue;
50};
51
52
53/**********************************************/
54/* log function for cards error log interface */
55/**********************************************/
56void
475be4d8 57hysdn_card_errlog(hysdn_card *card, tErrLogEntry *logp, int maxsize)
1da177e4
LT
58{
59 char buf[ERRLOG_TEXT_SIZE + 40];
60
61 sprintf(buf, "LOG 0x%08lX 0x%08lX : %s\n", logp->ulErrType, logp->ulErrSubtype, logp->ucText);
62 put_log_buffer(card, buf); /* output the string */
63} /* hysdn_card_errlog */
64
65/***************************************************/
66/* Log function using format specifiers for output */
67/***************************************************/
68void
475be4d8 69hysdn_addlog(hysdn_card *card, char *fmt, ...)
1da177e4
LT
70{
71 struct procdata *pd = card->proclog;
72 char *cp;
73 va_list args;
74
75 if (!pd)
76 return; /* log structure non existent */
77
78 cp = pd->logtmp;
79 cp += sprintf(cp, "HYSDN: card %d ", card->myid);
80
81 va_start(args, fmt);
82 cp += vsprintf(cp, fmt, args);
83 va_end(args);
84 *cp++ = '\n';
85 *cp = 0;
86
87 if (card->debug_flags & DEB_OUT_SYSLOG)
88 printk(KERN_INFO "%s", pd->logtmp);
89 else
90 put_log_buffer(card, pd->logtmp);
91
92} /* hysdn_addlog */
93
94/********************************************/
95/* put an log buffer into the log queue. */
96/* This buffer will be kept until all files */
97/* opened for read got the contents. */
98/* Flushes buffers not longer in use. */
99/********************************************/
aade0e82 100static void
475be4d8 101put_log_buffer(hysdn_card *card, char *cp)
1da177e4
LT
102{
103 struct log_data *ib;
104 struct procdata *pd = card->proclog;
105 int i;
106 unsigned long flags;
107
108 if (!pd)
109 return;
110 if (!cp)
111 return;
112 if (!*cp)
113 return;
114 if (pd->if_used <= 0)
115 return; /* no open file for read */
116
5cbded58 117 if (!(ib = kmalloc(sizeof(struct log_data) + strlen(cp), GFP_ATOMIC)))
475be4d8 118 return; /* no memory */
1da177e4
LT
119 strcpy(ib->log_start, cp); /* set output string */
120 ib->next = NULL;
121 ib->proc_ctrl = pd; /* point to own control structure */
0d9ba869 122 spin_lock_irqsave(&card->hysdn_lock, flags);
1da177e4
LT
123 ib->usage_cnt = pd->if_used;
124 if (!pd->log_head)
125 pd->log_head = ib; /* new head */
126 else
127 pd->log_tail->next = ib; /* follows existing messages */
128 pd->log_tail = ib; /* new tail */
129 i = pd->del_lock++; /* get lock state */
0d9ba869 130 spin_unlock_irqrestore(&card->hysdn_lock, flags);
1da177e4
LT
131
132 /* delete old entrys */
133 if (!i)
134 while (pd->log_head->next) {
135 if ((pd->log_head->usage_cnt <= 0) &&
136 (pd->log_head->next->usage_cnt <= 0)) {
137 ib = pd->log_head;
138 pd->log_head = pd->log_head->next;
139 kfree(ib);
140 } else
141 break;
142 } /* pd->log_head->next */
143 pd->del_lock--; /* release lock level */
144 wake_up_interruptible(&(pd->rd_queue)); /* announce new entry */
145} /* put_log_buffer */
146
147
148/******************************/
149/* file operations and tables */
150/******************************/
151
152/****************************************/
153/* write log file -> set log level bits */
154/****************************************/
155static ssize_t
475be4d8 156hysdn_log_write(struct file *file, const char __user *buf, size_t count, loff_t *off)
1da177e4 157{
3944ad68 158 int rc;
54cbb1ca 159 hysdn_card *card = file->private_data;
1da177e4 160
8831a3f2 161 rc = kstrtoul_from_user(buf, count, 0, &card->debug_flags);
19eccc2b
AD
162 if (rc < 0)
163 return rc;
164 hysdn_addlog(card, "debug set to 0x%lx", card->debug_flags);
1da177e4
LT
165 return (count);
166} /* hysdn_log_write */
167
168/******************/
169/* read log file */
170/******************/
171static ssize_t
475be4d8 172hysdn_log_read(struct file *file, char __user *buf, size_t count, loff_t *off)
1da177e4
LT
173{
174 struct log_data *inf;
175 int len;
d9dda78b 176 hysdn_card *card = PDE_DATA(file_inode(file));
1da177e4
LT
177
178 if (!*((struct log_data **) file->private_data)) {
4d8e8d21 179 struct procdata *pd = card->proclog;
1da177e4
LT
180 if (file->f_flags & O_NONBLOCK)
181 return (-EAGAIN);
182
4d8e8d21 183 interruptible_sleep_on(&(pd->rd_queue));
1da177e4
LT
184 }
185 if (!(inf = *((struct log_data **) file->private_data)))
186 return (0);
187
188 inf->usage_cnt--; /* new usage count */
189 file->private_data = &inf->next; /* next structure */
190 if ((len = strlen(inf->log_start)) <= count) {
191 if (copy_to_user(buf, inf->log_start, len))
192 return -EFAULT;
193 *off += len;
194 return (len);
195 }
196 return (0);
197} /* hysdn_log_read */
198
199/******************/
200/* open log file */
201/******************/
202static int
203hysdn_log_open(struct inode *ino, struct file *filep)
204{
d9dda78b 205 hysdn_card *card = PDE_DATA(ino);
1da177e4 206
76a64921 207 mutex_lock(&hysdn_log_mutex);
1da177e4
LT
208 if ((filep->f_mode & (FMODE_READ | FMODE_WRITE)) == FMODE_WRITE) {
209 /* write only access -> write log level only */
4d8e8d21 210 filep->private_data = card; /* remember our own card */
1da177e4 211 } else if ((filep->f_mode & (FMODE_READ | FMODE_WRITE)) == FMODE_READ) {
4d8e8d21
AV
212 struct procdata *pd = card->proclog;
213 unsigned long flags;
1da177e4
LT
214
215 /* read access -> log/debug read */
0d9ba869 216 spin_lock_irqsave(&card->hysdn_lock, flags);
1da177e4
LT
217 pd->if_used++;
218 if (pd->log_head)
219 filep->private_data = &pd->log_tail->next;
220 else
221 filep->private_data = &pd->log_head;
0d9ba869 222 spin_unlock_irqrestore(&card->hysdn_lock, flags);
1da177e4 223 } else { /* simultaneous read/write access forbidden ! */
76a64921 224 mutex_unlock(&hysdn_log_mutex);
1da177e4
LT
225 return (-EPERM); /* no permission this time */
226 }
76a64921 227 mutex_unlock(&hysdn_log_mutex);
1da177e4
LT
228 return nonseekable_open(ino, filep);
229} /* hysdn_log_open */
230
231/*******************************************************************************/
232/* close a cardlog file. If the file has been opened for exclusive write it is */
233/* assumed as pof data input and the pof loader is noticed about. */
234/* Otherwise file is handled as log output. In this case the interface usage */
235/* count is decremented and all buffers are noticed of closing. If this file */
236/* was the last one to be closed, all buffers are freed. */
237/*******************************************************************************/
238static int
239hysdn_log_close(struct inode *ino, struct file *filep)
240{
241 struct log_data *inf;
242 struct procdata *pd;
243 hysdn_card *card;
244 int retval = 0;
1da177e4 245
76a64921 246 mutex_lock(&hysdn_log_mutex);
1da177e4
LT
247 if ((filep->f_mode & (FMODE_READ | FMODE_WRITE)) == FMODE_WRITE) {
248 /* write only access -> write debug level written */
249 retval = 0; /* success */
250 } else {
251 /* read access -> log/debug read, mark one further file as closed */
252
1da177e4
LT
253 inf = *((struct log_data **) filep->private_data); /* get first log entry */
254 if (inf)
255 pd = (struct procdata *) inf->proc_ctrl; /* still entries there */
256 else {
257 /* no info available -> search card */
d9dda78b 258 card = PDE_DATA(file_inode(filep));
4d8e8d21 259 pd = card->proclog; /* pointer to procfs log */
1da177e4
LT
260 }
261 if (pd)
262 pd->if_used--; /* decrement interface usage count by one */
263
264 while (inf) {
265 inf->usage_cnt--; /* decrement usage count for buffers */
266 inf = inf->next;
267 }
1da177e4
LT
268
269 if (pd)
270 if (pd->if_used <= 0) /* delete buffers if last file closed */
271 while (pd->log_head) {
272 inf = pd->log_head;
273 pd->log_head = pd->log_head->next;
274 kfree(inf);
275 }
276 } /* read access */
76a64921 277 mutex_unlock(&hysdn_log_mutex);
1da177e4
LT
278
279 return (retval);
280} /* hysdn_log_close */
281
282/*************************************************/
283/* select/poll routine to be able using select() */
284/*************************************************/
285static unsigned int
475be4d8 286hysdn_log_poll(struct file *file, poll_table *wait)
1da177e4
LT
287{
288 unsigned int mask = 0;
d9dda78b 289 hysdn_card *card = PDE_DATA(file_inode(file));
4d8e8d21 290 struct procdata *pd = card->proclog;
1da177e4
LT
291
292 if ((file->f_mode & (FMODE_READ | FMODE_WRITE)) == FMODE_WRITE)
293 return (mask); /* no polling for write supported */
294
1da177e4
LT
295 poll_wait(file, &(pd->rd_queue), wait);
296
297 if (*((struct log_data **) file->private_data))
298 mask |= POLLIN | POLLRDNORM;
299
300 return mask;
301} /* hysdn_log_poll */
302
303/**************************************************/
304/* table for log filesystem functions defined above. */
305/**************************************************/
2b8693c0 306static const struct file_operations log_fops =
1da177e4 307{
ac41cfd1 308 .owner = THIS_MODULE,
1da177e4
LT
309 .llseek = no_llseek,
310 .read = hysdn_log_read,
311 .write = hysdn_log_write,
312 .poll = hysdn_log_poll,
313 .open = hysdn_log_open,
475be4d8 314 .release = hysdn_log_close,
1da177e4
LT
315};
316
317
318/***********************************************************************************/
319/* hysdn_proclog_init is called when the module is loaded after creating the cards */
320/* conf files. */
321/***********************************************************************************/
322int
475be4d8 323hysdn_proclog_init(hysdn_card *card)
1da177e4
LT
324{
325 struct procdata *pd;
326
327 /* create a cardlog proc entry */
328
41f96935 329 if ((pd = kzalloc(sizeof(struct procdata), GFP_KERNEL)) != NULL) {
1da177e4 330 sprintf(pd->log_name, "%s%d", PROC_LOG_BASENAME, card->myid);
4d8e8d21 331 pd->log = proc_create_data(pd->log_name,
475be4d8 332 S_IFREG | S_IRUGO | S_IWUSR, hysdn_proc_entry,
4d8e8d21 333 &log_fops, card);
1da177e4
LT
334
335 init_waitqueue_head(&(pd->rd_queue));
336
337 card->proclog = (void *) pd; /* remember procfs structure */
338 }
339 return (0);
340} /* hysdn_proclog_init */
341
342/************************************************************************************/
343/* hysdn_proclog_release is called when the module is unloaded and before the cards */
344/* conf file is released */
345/* The module counter is assumed to be 0 ! */
346/************************************************************************************/
347void
475be4d8 348hysdn_proclog_release(hysdn_card *card)
1da177e4
LT
349{
350 struct procdata *pd;
351
352 if ((pd = (struct procdata *) card->proclog) != NULL) {
353 if (pd->log)
354 remove_proc_entry(pd->log_name, hysdn_proc_entry);
355 kfree(pd); /* release memory */
356 card->proclog = NULL;
357 }
358} /* hysdn_proclog_release */