2 * Public API and common code for RelayFS.
4 * See Documentation/filesystems/relayfs.txt for an overview of relayfs.
6 * Copyright (C) 2002-2005 - Tom Zanussi (zanussi@us.ibm.com), IBM Corp
7 * Copyright (C) 1999-2005 - Karim Yaghmour (karim@opersys.com)
9 * This file is released under the GPL.
12 #include <linux/errno.h>
13 #include <linux/stddef.h>
14 #include <linux/slab.h>
15 #include <linux/module.h>
16 #include <linux/string.h>
17 #include <linux/relayfs_fs.h>
22 * relay_buf_empty - boolean, is the channel buffer empty?
23 * @buf: channel buffer
25 * Returns 1 if the buffer is empty, 0 otherwise.
27 int relay_buf_empty(struct rchan_buf
*buf
)
29 return (buf
->subbufs_produced
- buf
->subbufs_consumed
) ? 0 : 1;
33 * relay_buf_full - boolean, is the channel buffer full?
34 * @buf: channel buffer
36 * Returns 1 if the buffer is full, 0 otherwise.
38 int relay_buf_full(struct rchan_buf
*buf
)
40 size_t ready
= buf
->subbufs_produced
- buf
->subbufs_consumed
;
41 return (ready
>= buf
->chan
->n_subbufs
) ? 1 : 0;
45 * High-level relayfs kernel API and associated functions.
49 * rchan_callback implementations defining default channel behavior. Used
50 * in place of corresponding NULL values in client callback struct.
54 * subbuf_start() default callback. Does nothing.
56 static int subbuf_start_default_callback (struct rchan_buf
*buf
,
61 if (relay_buf_full(buf
))
68 * buf_mapped() default callback. Does nothing.
70 static void buf_mapped_default_callback(struct rchan_buf
*buf
,
76 * buf_unmapped() default callback. Does nothing.
78 static void buf_unmapped_default_callback(struct rchan_buf
*buf
,
84 * create_buf_file_create() default callback. Creates file to represent buf.
86 static struct dentry
*create_buf_file_default_callback(const char *filename
,
87 struct dentry
*parent
,
89 struct rchan_buf
*buf
,
92 return relayfs_create_file(filename
, parent
, mode
,
93 &relay_file_operations
, buf
);
97 * remove_buf_file() default callback. Removes file representing relay buffer.
99 static int remove_buf_file_default_callback(struct dentry
*dentry
)
101 return relayfs_remove(dentry
);
104 /* relay channel default callbacks */
105 static struct rchan_callbacks default_channel_callbacks
= {
106 .subbuf_start
= subbuf_start_default_callback
,
107 .buf_mapped
= buf_mapped_default_callback
,
108 .buf_unmapped
= buf_unmapped_default_callback
,
109 .create_buf_file
= create_buf_file_default_callback
,
110 .remove_buf_file
= remove_buf_file_default_callback
,
114 * wakeup_readers - wake up readers waiting on a channel
115 * @private: the channel buffer
117 * This is the work function used to defer reader waking. The
118 * reason waking is deferred is that calling directly from write
119 * causes problems if you're writing from say the scheduler.
121 static void wakeup_readers(void *private)
123 struct rchan_buf
*buf
= private;
124 wake_up_interruptible(&buf
->read_wait
);
128 * __relay_reset - reset a channel buffer
129 * @buf: the channel buffer
130 * @init: 1 if this is a first-time initialization
132 * See relay_reset for description of effect.
134 static inline void __relay_reset(struct rchan_buf
*buf
, unsigned int init
)
139 init_waitqueue_head(&buf
->read_wait
);
140 kref_init(&buf
->kref
);
141 INIT_WORK(&buf
->wake_readers
, NULL
, NULL
);
143 cancel_delayed_work(&buf
->wake_readers
);
144 flush_scheduled_work();
147 buf
->subbufs_produced
= 0;
148 buf
->subbufs_consumed
= 0;
149 buf
->bytes_consumed
= 0;
151 buf
->data
= buf
->start
;
154 for (i
= 0; i
< buf
->chan
->n_subbufs
; i
++)
157 buf
->chan
->cb
->subbuf_start(buf
, buf
->data
, NULL
, 0);
161 * relay_reset - reset the channel
164 * This has the effect of erasing all data from all channel buffers
165 * and restarting the channel in its initial state. The buffers
166 * are not freed, so any mappings are still in effect.
168 * NOTE: Care should be taken that the channel isn't actually
169 * being used by anything when this call is made.
171 void relay_reset(struct rchan
*chan
)
174 struct rchan_buf
*prev
= NULL
;
179 for (i
= 0; i
< NR_CPUS
; i
++) {
180 if (!chan
->buf
[i
] || chan
->buf
[i
] == prev
)
182 __relay_reset(chan
->buf
[i
], 0);
188 * relay_open_buf - create a new channel buffer in relayfs
190 * Internal - used by relay_open().
192 static struct rchan_buf
*relay_open_buf(struct rchan
*chan
,
193 const char *filename
,
194 struct dentry
*parent
,
197 struct rchan_buf
*buf
;
198 struct dentry
*dentry
;
203 buf
= relay_create_buf(chan
);
207 /* Create file in fs */
208 dentry
= chan
->cb
->create_buf_file(filename
, parent
, S_IRUSR
,
211 relay_destroy_buf(buf
);
215 buf
->dentry
= dentry
;
216 __relay_reset(buf
, 1);
222 * relay_close_buf - close a channel buffer
223 * @buf: channel buffer
225 * Marks the buffer finalized and restores the default callbacks.
226 * The channel buffer and channel buffer data structure are then freed
227 * automatically when the last reference is given up.
229 static inline void relay_close_buf(struct rchan_buf
*buf
)
232 buf
->chan
->cb
= &default_channel_callbacks
;
233 cancel_delayed_work(&buf
->wake_readers
);
234 flush_scheduled_work();
235 kref_put(&buf
->kref
, relay_remove_buf
);
238 static inline void setup_callbacks(struct rchan
*chan
,
239 struct rchan_callbacks
*cb
)
242 chan
->cb
= &default_channel_callbacks
;
246 if (!cb
->subbuf_start
)
247 cb
->subbuf_start
= subbuf_start_default_callback
;
249 cb
->buf_mapped
= buf_mapped_default_callback
;
250 if (!cb
->buf_unmapped
)
251 cb
->buf_unmapped
= buf_unmapped_default_callback
;
252 if (!cb
->create_buf_file
)
253 cb
->create_buf_file
= create_buf_file_default_callback
;
254 if (!cb
->remove_buf_file
)
255 cb
->remove_buf_file
= remove_buf_file_default_callback
;
260 * relay_open - create a new relayfs channel
261 * @base_filename: base name of files to create
262 * @parent: dentry of parent directory, NULL for root directory
263 * @subbuf_size: size of sub-buffers
264 * @n_subbufs: number of sub-buffers
265 * @cb: client callback functions
267 * Returns channel pointer if successful, NULL otherwise.
269 * Creates a channel buffer for each cpu using the sizes and
270 * attributes specified. The created channel buffer files
271 * will be named base_filename0...base_filenameN-1. File
272 * permissions will be S_IRUSR.
274 struct rchan
*relay_open(const char *base_filename
,
275 struct dentry
*parent
,
278 struct rchan_callbacks
*cb
)
288 if (!(subbuf_size
&& n_subbufs
))
291 chan
= kcalloc(1, sizeof(struct rchan
), GFP_KERNEL
);
295 chan
->version
= RELAYFS_CHANNEL_VERSION
;
296 chan
->n_subbufs
= n_subbufs
;
297 chan
->subbuf_size
= subbuf_size
;
298 chan
->alloc_size
= FIX_SIZE(subbuf_size
* n_subbufs
);
299 setup_callbacks(chan
, cb
);
300 kref_init(&chan
->kref
);
302 tmpname
= kmalloc(NAME_MAX
+ 1, GFP_KERNEL
);
306 for_each_online_cpu(i
) {
307 sprintf(tmpname
, "%s%d", base_filename
, i
);
308 chan
->buf
[i
] = relay_open_buf(chan
, tmpname
, parent
,
310 chan
->buf
[i
]->cpu
= i
;
319 for (i
= 0; i
< NR_CPUS
; i
++) {
322 relay_close_buf(chan
->buf
[i
]);
329 kref_put(&chan
->kref
, relay_destroy_channel
);
334 * relay_switch_subbuf - switch to a new sub-buffer
335 * @buf: channel buffer
336 * @length: size of current event
338 * Returns either the length passed in or 0 if full.
340 * Performs sub-buffer-switch tasks such as invoking callbacks,
341 * updating padding counts, waking up readers, etc.
343 size_t relay_switch_subbuf(struct rchan_buf
*buf
, size_t length
)
346 size_t old_subbuf
, new_subbuf
;
348 if (unlikely(length
> buf
->chan
->subbuf_size
))
351 if (buf
->offset
!= buf
->chan
->subbuf_size
+ 1) {
352 buf
->prev_padding
= buf
->chan
->subbuf_size
- buf
->offset
;
353 old_subbuf
= buf
->subbufs_produced
% buf
->chan
->n_subbufs
;
354 buf
->padding
[old_subbuf
] = buf
->prev_padding
;
355 buf
->subbufs_produced
++;
356 if (waitqueue_active(&buf
->read_wait
)) {
357 PREPARE_WORK(&buf
->wake_readers
, wakeup_readers
, buf
);
358 schedule_delayed_work(&buf
->wake_readers
, 1);
363 new_subbuf
= buf
->subbufs_produced
% buf
->chan
->n_subbufs
;
364 new = buf
->start
+ new_subbuf
* buf
->chan
->subbuf_size
;
366 if (!buf
->chan
->cb
->subbuf_start(buf
, new, old
, buf
->prev_padding
)) {
367 buf
->offset
= buf
->chan
->subbuf_size
+ 1;
371 buf
->padding
[new_subbuf
] = 0;
373 if (unlikely(length
+ buf
->offset
> buf
->chan
->subbuf_size
))
379 buf
->chan
->last_toobig
= length
;
384 * relay_subbufs_consumed - update the buffer's sub-buffers-consumed count
386 * @cpu: the cpu associated with the channel buffer to update
387 * @subbufs_consumed: number of sub-buffers to add to current buf's count
389 * Adds to the channel buffer's consumed sub-buffer count.
390 * subbufs_consumed should be the number of sub-buffers newly consumed,
391 * not the total consumed.
393 * NOTE: kernel clients don't need to call this function if the channel
394 * mode is 'overwrite'.
396 void relay_subbufs_consumed(struct rchan
*chan
,
398 size_t subbufs_consumed
)
400 struct rchan_buf
*buf
;
405 if (cpu
>= NR_CPUS
|| !chan
->buf
[cpu
])
408 buf
= chan
->buf
[cpu
];
409 buf
->subbufs_consumed
+= subbufs_consumed
;
410 if (buf
->subbufs_consumed
> buf
->subbufs_produced
)
411 buf
->subbufs_consumed
= buf
->subbufs_produced
;
415 * relay_destroy_channel - free the channel struct
417 * Should only be called from kref_put().
419 void relay_destroy_channel(struct kref
*kref
)
421 struct rchan
*chan
= container_of(kref
, struct rchan
, kref
);
426 * relay_close - close the channel
429 * Closes all channel buffers and frees the channel.
431 void relay_close(struct rchan
*chan
)
434 struct rchan_buf
*prev
= NULL
;
439 for (i
= 0; i
< NR_CPUS
; i
++) {
440 if (!chan
->buf
[i
] || chan
->buf
[i
] == prev
)
442 relay_close_buf(chan
->buf
[i
]);
446 if (chan
->last_toobig
)
447 printk(KERN_WARNING
"relayfs: one or more items not logged "
448 "[item size (%Zd) > sub-buffer size (%Zd)]\n",
449 chan
->last_toobig
, chan
->subbuf_size
);
451 kref_put(&chan
->kref
, relay_destroy_channel
);
455 * relay_flush - close the channel
458 * Flushes all channel buffers i.e. forces buffer switch.
460 void relay_flush(struct rchan
*chan
)
463 struct rchan_buf
*prev
= NULL
;
468 for (i
= 0; i
< NR_CPUS
; i
++) {
469 if (!chan
->buf
[i
] || chan
->buf
[i
] == prev
)
471 relay_switch_subbuf(chan
->buf
[i
], 0);
476 EXPORT_SYMBOL_GPL(relay_open
);
477 EXPORT_SYMBOL_GPL(relay_close
);
478 EXPORT_SYMBOL_GPL(relay_flush
);
479 EXPORT_SYMBOL_GPL(relay_reset
);
480 EXPORT_SYMBOL_GPL(relay_subbufs_consumed
);
481 EXPORT_SYMBOL_GPL(relay_switch_subbuf
);
482 EXPORT_SYMBOL_GPL(relay_buf_full
);