Merge branch 'akpm' (patches from Andrew)
[deliverable/linux.git] / kernel / irq / irqdesc.c
CommitLineData
3795de23
TG
1/*
2 * Copyright (C) 1992, 1998-2006 Linus Torvalds, Ingo Molnar
3 * Copyright (C) 2005-2006, Thomas Gleixner, Russell King
4 *
5 * This file contains the interrupt descriptor management code
6 *
7 * Detailed information is available in Documentation/DocBook/genericirq
8 *
9 */
10#include <linux/irq.h>
11#include <linux/slab.h>
ec53cf23 12#include <linux/export.h>
3795de23
TG
13#include <linux/interrupt.h>
14#include <linux/kernel_stat.h>
15#include <linux/radix-tree.h>
1f5a5b87 16#include <linux/bitmap.h>
76ba59f8 17#include <linux/irqdomain.h>
3795de23
TG
18
19#include "internals.h"
20
21/*
22 * lockdep: we want to handle all irq_desc locks as a single lock-class:
23 */
78f90d91 24static struct lock_class_key irq_desc_lock_class;
3795de23 25
fe051434 26#if defined(CONFIG_SMP)
3795de23
TG
27static void __init init_irq_default_affinity(void)
28{
29 alloc_cpumask_var(&irq_default_affinity, GFP_NOWAIT);
30 cpumask_setall(irq_default_affinity);
31}
32#else
33static void __init init_irq_default_affinity(void)
34{
35}
36#endif
37
1f5a5b87
TG
38#ifdef CONFIG_SMP
39static int alloc_masks(struct irq_desc *desc, gfp_t gfp, int node)
40{
41 if (!zalloc_cpumask_var_node(&desc->irq_data.affinity, gfp, node))
42 return -ENOMEM;
43
44#ifdef CONFIG_GENERIC_PENDING_IRQ
45 if (!zalloc_cpumask_var_node(&desc->pending_mask, gfp, node)) {
46 free_cpumask_var(desc->irq_data.affinity);
47 return -ENOMEM;
48 }
49#endif
50 return 0;
51}
52
53static void desc_smp_init(struct irq_desc *desc, int node)
54{
aa99ec0f 55 desc->irq_data.node = node;
1f5a5b87 56 cpumask_copy(desc->irq_data.affinity, irq_default_affinity);
b7b29338
TG
57#ifdef CONFIG_GENERIC_PENDING_IRQ
58 cpumask_clear(desc->pending_mask);
59#endif
60}
61
62static inline int desc_node(struct irq_desc *desc)
63{
64 return desc->irq_data.node;
1f5a5b87
TG
65}
66
67#else
68static inline int
69alloc_masks(struct irq_desc *desc, gfp_t gfp, int node) { return 0; }
70static inline void desc_smp_init(struct irq_desc *desc, int node) { }
b7b29338 71static inline int desc_node(struct irq_desc *desc) { return 0; }
1f5a5b87
TG
72#endif
73
b6873807
SAS
74static void desc_set_defaults(unsigned int irq, struct irq_desc *desc, int node,
75 struct module *owner)
1f5a5b87 76{
6c9ae009
ED
77 int cpu;
78
1f5a5b87
TG
79 desc->irq_data.irq = irq;
80 desc->irq_data.chip = &no_irq_chip;
81 desc->irq_data.chip_data = NULL;
82 desc->irq_data.handler_data = NULL;
83 desc->irq_data.msi_desc = NULL;
f9e4989e 84 irq_settings_clr_and_set(desc, ~0, _IRQ_DEFAULT_INIT_FLAGS);
801a0e9a 85 irqd_set(&desc->irq_data, IRQD_IRQ_DISABLED);
1f5a5b87
TG
86 desc->handle_irq = handle_bad_irq;
87 desc->depth = 1;
b7b29338
TG
88 desc->irq_count = 0;
89 desc->irqs_unhandled = 0;
1f5a5b87 90 desc->name = NULL;
b6873807 91 desc->owner = owner;
6c9ae009
ED
92 for_each_possible_cpu(cpu)
93 *per_cpu_ptr(desc->kstat_irqs, cpu) = 0;
1f5a5b87
TG
94 desc_smp_init(desc, node);
95}
96
3795de23
TG
97int nr_irqs = NR_IRQS;
98EXPORT_SYMBOL_GPL(nr_irqs);
99
a05a900a 100static DEFINE_MUTEX(sparse_irq_lock);
c1ee6264 101static DECLARE_BITMAP(allocated_irqs, IRQ_BITMAP_BITS);
1f5a5b87 102
3795de23
TG
103#ifdef CONFIG_SPARSE_IRQ
104
baa0d233 105static RADIX_TREE(irq_desc_tree, GFP_KERNEL);
3795de23 106
1f5a5b87 107static void irq_insert_desc(unsigned int irq, struct irq_desc *desc)
3795de23
TG
108{
109 radix_tree_insert(&irq_desc_tree, irq, desc);
110}
111
112struct irq_desc *irq_to_desc(unsigned int irq)
113{
114 return radix_tree_lookup(&irq_desc_tree, irq);
115}
3911ff30 116EXPORT_SYMBOL(irq_to_desc);
3795de23 117
1f5a5b87
TG
118static void delete_irq_desc(unsigned int irq)
119{
120 radix_tree_delete(&irq_desc_tree, irq);
121}
122
123#ifdef CONFIG_SMP
124static void free_masks(struct irq_desc *desc)
125{
126#ifdef CONFIG_GENERIC_PENDING_IRQ
127 free_cpumask_var(desc->pending_mask);
128#endif
c0a19ebc 129 free_cpumask_var(desc->irq_data.affinity);
1f5a5b87
TG
130}
131#else
132static inline void free_masks(struct irq_desc *desc) { }
133#endif
134
c291ee62
TG
135void irq_lock_sparse(void)
136{
137 mutex_lock(&sparse_irq_lock);
138}
139
140void irq_unlock_sparse(void)
141{
142 mutex_unlock(&sparse_irq_lock);
143}
144
b6873807 145static struct irq_desc *alloc_desc(int irq, int node, struct module *owner)
1f5a5b87
TG
146{
147 struct irq_desc *desc;
baa0d233 148 gfp_t gfp = GFP_KERNEL;
1f5a5b87
TG
149
150 desc = kzalloc_node(sizeof(*desc), gfp, node);
151 if (!desc)
152 return NULL;
153 /* allocate based on nr_cpu_ids */
6c9ae009 154 desc->kstat_irqs = alloc_percpu(unsigned int);
1f5a5b87
TG
155 if (!desc->kstat_irqs)
156 goto err_desc;
157
158 if (alloc_masks(desc, gfp, node))
159 goto err_kstat;
160
161 raw_spin_lock_init(&desc->lock);
162 lockdep_set_class(&desc->lock, &irq_desc_lock_class);
163
b6873807 164 desc_set_defaults(irq, desc, node, owner);
1f5a5b87
TG
165
166 return desc;
167
168err_kstat:
6c9ae009 169 free_percpu(desc->kstat_irqs);
1f5a5b87
TG
170err_desc:
171 kfree(desc);
172 return NULL;
173}
174
175static void free_desc(unsigned int irq)
176{
177 struct irq_desc *desc = irq_to_desc(irq);
1f5a5b87 178
13bfe99e
TG
179 unregister_irq_proc(irq, desc);
180
c291ee62
TG
181 /*
182 * sparse_irq_lock protects also show_interrupts() and
183 * kstat_irq_usr(). Once we deleted the descriptor from the
184 * sparse tree we can free it. Access in proc will fail to
185 * lookup the descriptor.
186 */
a05a900a 187 mutex_lock(&sparse_irq_lock);
1f5a5b87 188 delete_irq_desc(irq);
a05a900a 189 mutex_unlock(&sparse_irq_lock);
1f5a5b87
TG
190
191 free_masks(desc);
6c9ae009 192 free_percpu(desc->kstat_irqs);
1f5a5b87
TG
193 kfree(desc);
194}
195
b6873807
SAS
196static int alloc_descs(unsigned int start, unsigned int cnt, int node,
197 struct module *owner)
1f5a5b87
TG
198{
199 struct irq_desc *desc;
1f5a5b87
TG
200 int i;
201
202 for (i = 0; i < cnt; i++) {
b6873807 203 desc = alloc_desc(start + i, node, owner);
1f5a5b87
TG
204 if (!desc)
205 goto err;
a05a900a 206 mutex_lock(&sparse_irq_lock);
1f5a5b87 207 irq_insert_desc(start + i, desc);
a05a900a 208 mutex_unlock(&sparse_irq_lock);
1f5a5b87
TG
209 }
210 return start;
211
212err:
213 for (i--; i >= 0; i--)
214 free_desc(start + i);
215
a05a900a 216 mutex_lock(&sparse_irq_lock);
1f5a5b87 217 bitmap_clear(allocated_irqs, start, cnt);
a05a900a 218 mutex_unlock(&sparse_irq_lock);
1f5a5b87
TG
219 return -ENOMEM;
220}
221
ed4dea6e 222static int irq_expand_nr_irqs(unsigned int nr)
e7bcecb7 223{
ed4dea6e 224 if (nr > IRQ_BITMAP_BITS)
e7bcecb7 225 return -ENOMEM;
ed4dea6e 226 nr_irqs = nr;
e7bcecb7
TG
227 return 0;
228}
229
3795de23
TG
230int __init early_irq_init(void)
231{
b683de2b 232 int i, initcnt, node = first_online_node;
3795de23 233 struct irq_desc *desc;
3795de23
TG
234
235 init_irq_default_affinity();
236
b683de2b
TG
237 /* Let arch update nr_irqs and return the nr of preallocated irqs */
238 initcnt = arch_probe_nr_irqs();
239 printk(KERN_INFO "NR_IRQS:%d nr_irqs:%d %d\n", NR_IRQS, nr_irqs, initcnt);
3795de23 240
c1ee6264
TG
241 if (WARN_ON(nr_irqs > IRQ_BITMAP_BITS))
242 nr_irqs = IRQ_BITMAP_BITS;
243
244 if (WARN_ON(initcnt > IRQ_BITMAP_BITS))
245 initcnt = IRQ_BITMAP_BITS;
246
247 if (initcnt > nr_irqs)
248 nr_irqs = initcnt;
249
b683de2b 250 for (i = 0; i < initcnt; i++) {
b6873807 251 desc = alloc_desc(i, node, NULL);
aa99ec0f
TG
252 set_bit(i, allocated_irqs);
253 irq_insert_desc(i, desc);
3795de23 254 }
3795de23
TG
255 return arch_early_irq_init();
256}
257
3795de23
TG
258#else /* !CONFIG_SPARSE_IRQ */
259
260struct irq_desc irq_desc[NR_IRQS] __cacheline_aligned_in_smp = {
261 [0 ... NR_IRQS-1] = {
3795de23
TG
262 .handle_irq = handle_bad_irq,
263 .depth = 1,
264 .lock = __RAW_SPIN_LOCK_UNLOCKED(irq_desc->lock),
265 }
266};
267
3795de23
TG
268int __init early_irq_init(void)
269{
aa99ec0f 270 int count, i, node = first_online_node;
3795de23 271 struct irq_desc *desc;
3795de23
TG
272
273 init_irq_default_affinity();
274
275 printk(KERN_INFO "NR_IRQS:%d\n", NR_IRQS);
276
277 desc = irq_desc;
278 count = ARRAY_SIZE(irq_desc);
279
280 for (i = 0; i < count; i++) {
6c9ae009 281 desc[i].kstat_irqs = alloc_percpu(unsigned int);
e7fbad30
LW
282 alloc_masks(&desc[i], GFP_KERNEL, node);
283 raw_spin_lock_init(&desc[i].lock);
154cd387 284 lockdep_set_class(&desc[i].lock, &irq_desc_lock_class);
b6873807 285 desc_set_defaults(i, &desc[i], node, NULL);
3795de23
TG
286 }
287 return arch_early_irq_init();
288}
289
290struct irq_desc *irq_to_desc(unsigned int irq)
291{
292 return (irq < NR_IRQS) ? irq_desc + irq : NULL;
293}
2c45aada 294EXPORT_SYMBOL(irq_to_desc);
3795de23 295
1f5a5b87
TG
296static void free_desc(unsigned int irq)
297{
d8179bc0
TG
298 struct irq_desc *desc = irq_to_desc(irq);
299 unsigned long flags;
300
301 raw_spin_lock_irqsave(&desc->lock, flags);
302 desc_set_defaults(irq, desc, desc_node(desc), NULL);
303 raw_spin_unlock_irqrestore(&desc->lock, flags);
1f5a5b87
TG
304}
305
b6873807
SAS
306static inline int alloc_descs(unsigned int start, unsigned int cnt, int node,
307 struct module *owner)
1f5a5b87 308{
b6873807
SAS
309 u32 i;
310
311 for (i = 0; i < cnt; i++) {
312 struct irq_desc *desc = irq_to_desc(start + i);
313
314 desc->owner = owner;
315 }
1f5a5b87
TG
316 return start;
317}
e7bcecb7 318
ed4dea6e 319static int irq_expand_nr_irqs(unsigned int nr)
e7bcecb7
TG
320{
321 return -ENOMEM;
322}
323
f63b6a05
TG
324void irq_mark_irq(unsigned int irq)
325{
326 mutex_lock(&sparse_irq_lock);
327 bitmap_set(allocated_irqs, irq, 1);
328 mutex_unlock(&sparse_irq_lock);
329}
330
c940e01c
TG
331#ifdef CONFIG_GENERIC_IRQ_LEGACY
332void irq_init_desc(unsigned int irq)
333{
d8179bc0 334 free_desc(irq);
c940e01c
TG
335}
336#endif
337
3795de23
TG
338#endif /* !CONFIG_SPARSE_IRQ */
339
fe12bc2c
TG
340/**
341 * generic_handle_irq - Invoke the handler for a particular irq
342 * @irq: The irq number to handle
343 *
344 */
345int generic_handle_irq(unsigned int irq)
346{
347 struct irq_desc *desc = irq_to_desc(irq);
348
349 if (!desc)
350 return -EINVAL;
351 generic_handle_irq_desc(irq, desc);
352 return 0;
353}
edf76f83 354EXPORT_SYMBOL_GPL(generic_handle_irq);
fe12bc2c 355
76ba59f8
MZ
356#ifdef CONFIG_HANDLE_DOMAIN_IRQ
357/**
358 * __handle_domain_irq - Invoke the handler for a HW irq belonging to a domain
359 * @domain: The domain where to perform the lookup
360 * @hwirq: The HW irq number to convert to a logical one
361 * @lookup: Whether to perform the domain lookup or not
362 * @regs: Register file coming from the low-level handling code
363 *
364 * Returns: 0 on success, or -EINVAL if conversion has failed
365 */
366int __handle_domain_irq(struct irq_domain *domain, unsigned int hwirq,
367 bool lookup, struct pt_regs *regs)
368{
369 struct pt_regs *old_regs = set_irq_regs(regs);
370 unsigned int irq = hwirq;
371 int ret = 0;
372
373 irq_enter();
374
375#ifdef CONFIG_IRQ_DOMAIN
376 if (lookup)
377 irq = irq_find_mapping(domain, hwirq);
378#endif
379
380 /*
381 * Some hardware gives randomly wrong interrupts. Rather
382 * than crashing, do something sensible.
383 */
384 if (unlikely(!irq || irq >= nr_irqs)) {
385 ack_bad_irq(irq);
386 ret = -EINVAL;
387 } else {
388 generic_handle_irq(irq);
389 }
390
391 irq_exit();
392 set_irq_regs(old_regs);
393 return ret;
394}
395#endif
396
1f5a5b87
TG
397/* Dynamic interrupt handling */
398
399/**
400 * irq_free_descs - free irq descriptors
401 * @from: Start of descriptor range
402 * @cnt: Number of consecutive irqs to free
403 */
404void irq_free_descs(unsigned int from, unsigned int cnt)
405{
1f5a5b87
TG
406 int i;
407
408 if (from >= nr_irqs || (from + cnt) > nr_irqs)
409 return;
410
411 for (i = 0; i < cnt; i++)
412 free_desc(from + i);
413
a05a900a 414 mutex_lock(&sparse_irq_lock);
1f5a5b87 415 bitmap_clear(allocated_irqs, from, cnt);
a05a900a 416 mutex_unlock(&sparse_irq_lock);
1f5a5b87 417}
edf76f83 418EXPORT_SYMBOL_GPL(irq_free_descs);
1f5a5b87
TG
419
420/**
421 * irq_alloc_descs - allocate and initialize a range of irq descriptors
422 * @irq: Allocate for specific irq number if irq >= 0
423 * @from: Start the search from this irq number
424 * @cnt: Number of consecutive irqs to allocate.
425 * @node: Preferred node on which the irq descriptor should be allocated
d522a0d1 426 * @owner: Owning module (can be NULL)
1f5a5b87
TG
427 *
428 * Returns the first irq number or error code
429 */
430int __ref
b6873807
SAS
431__irq_alloc_descs(int irq, unsigned int from, unsigned int cnt, int node,
432 struct module *owner)
1f5a5b87 433{
1f5a5b87
TG
434 int start, ret;
435
436 if (!cnt)
437 return -EINVAL;
438
c5182b88
MB
439 if (irq >= 0) {
440 if (from > irq)
441 return -EINVAL;
442 from = irq;
62a08ae2
TG
443 } else {
444 /*
445 * For interrupts which are freely allocated the
446 * architecture can force a lower bound to the @from
447 * argument. x86 uses this to exclude the GSI space.
448 */
449 from = arch_dynirq_lower_bound(from);
c5182b88
MB
450 }
451
a05a900a 452 mutex_lock(&sparse_irq_lock);
1f5a5b87 453
ed4dea6e
YL
454 start = bitmap_find_next_zero_area(allocated_irqs, IRQ_BITMAP_BITS,
455 from, cnt, 0);
1f5a5b87
TG
456 ret = -EEXIST;
457 if (irq >=0 && start != irq)
458 goto err;
459
ed4dea6e
YL
460 if (start + cnt > nr_irqs) {
461 ret = irq_expand_nr_irqs(start + cnt);
e7bcecb7
TG
462 if (ret)
463 goto err;
464 }
1f5a5b87
TG
465
466 bitmap_set(allocated_irqs, start, cnt);
a05a900a 467 mutex_unlock(&sparse_irq_lock);
b6873807 468 return alloc_descs(start, cnt, node, owner);
1f5a5b87
TG
469
470err:
a05a900a 471 mutex_unlock(&sparse_irq_lock);
1f5a5b87
TG
472 return ret;
473}
b6873807 474EXPORT_SYMBOL_GPL(__irq_alloc_descs);
1f5a5b87 475
7b6ef126
TG
476#ifdef CONFIG_GENERIC_IRQ_LEGACY_ALLOC_HWIRQ
477/**
478 * irq_alloc_hwirqs - Allocate an irq descriptor and initialize the hardware
479 * @cnt: number of interrupts to allocate
480 * @node: node on which to allocate
481 *
482 * Returns an interrupt number > 0 or 0, if the allocation fails.
483 */
484unsigned int irq_alloc_hwirqs(int cnt, int node)
485{
486 int i, irq = __irq_alloc_descs(-1, 0, cnt, node, NULL);
487
488 if (irq < 0)
489 return 0;
490
491 for (i = irq; cnt > 0; i++, cnt--) {
492 if (arch_setup_hwirq(i, node))
493 goto err;
494 irq_clear_status_flags(i, _IRQ_NOREQUEST);
495 }
496 return irq;
497
498err:
499 for (i--; i >= irq; i--) {
500 irq_set_status_flags(i, _IRQ_NOREQUEST | _IRQ_NOPROBE);
501 arch_teardown_hwirq(i);
502 }
503 irq_free_descs(irq, cnt);
504 return 0;
505}
506EXPORT_SYMBOL_GPL(irq_alloc_hwirqs);
507
508/**
509 * irq_free_hwirqs - Free irq descriptor and cleanup the hardware
510 * @from: Free from irq number
511 * @cnt: number of interrupts to free
512 *
513 */
514void irq_free_hwirqs(unsigned int from, int cnt)
515{
8844aad8 516 int i, j;
7b6ef126 517
8844aad8 518 for (i = from, j = cnt; j > 0; i++, j--) {
7b6ef126
TG
519 irq_set_status_flags(i, _IRQ_NOREQUEST | _IRQ_NOPROBE);
520 arch_teardown_hwirq(i);
521 }
522 irq_free_descs(from, cnt);
523}
524EXPORT_SYMBOL_GPL(irq_free_hwirqs);
525#endif
526
a98d24b7
TG
527/**
528 * irq_get_next_irq - get next allocated irq number
529 * @offset: where to start the search
530 *
531 * Returns next irq number after offset or nr_irqs if none is found.
532 */
533unsigned int irq_get_next_irq(unsigned int offset)
534{
535 return find_next_bit(allocated_irqs, nr_irqs, offset);
536}
537
d5eb4ad2 538struct irq_desc *
31d9d9b6
MZ
539__irq_get_desc_lock(unsigned int irq, unsigned long *flags, bool bus,
540 unsigned int check)
d5eb4ad2
TG
541{
542 struct irq_desc *desc = irq_to_desc(irq);
543
544 if (desc) {
31d9d9b6
MZ
545 if (check & _IRQ_DESC_CHECK) {
546 if ((check & _IRQ_DESC_PERCPU) &&
547 !irq_settings_is_per_cpu_devid(desc))
548 return NULL;
549
550 if (!(check & _IRQ_DESC_PERCPU) &&
551 irq_settings_is_per_cpu_devid(desc))
552 return NULL;
553 }
554
d5eb4ad2
TG
555 if (bus)
556 chip_bus_lock(desc);
557 raw_spin_lock_irqsave(&desc->lock, *flags);
558 }
559 return desc;
560}
561
562void __irq_put_desc_unlock(struct irq_desc *desc, unsigned long flags, bool bus)
563{
564 raw_spin_unlock_irqrestore(&desc->lock, flags);
565 if (bus)
566 chip_bus_sync_unlock(desc);
567}
568
31d9d9b6
MZ
569int irq_set_percpu_devid(unsigned int irq)
570{
571 struct irq_desc *desc = irq_to_desc(irq);
572
573 if (!desc)
574 return -EINVAL;
575
576 if (desc->percpu_enabled)
577 return -EINVAL;
578
579 desc->percpu_enabled = kzalloc(sizeof(*desc->percpu_enabled), GFP_KERNEL);
580
581 if (!desc->percpu_enabled)
582 return -ENOMEM;
583
584 irq_set_percpu_devid_flags(irq);
585 return 0;
586}
587
792d0018
TG
588void kstat_incr_irq_this_cpu(unsigned int irq)
589{
590 kstat_incr_irqs_this_cpu(irq, irq_to_desc(irq));
591}
592
c291ee62
TG
593/**
594 * kstat_irqs_cpu - Get the statistics for an interrupt on a cpu
595 * @irq: The interrupt number
596 * @cpu: The cpu number
597 *
598 * Returns the sum of interrupt counts on @cpu since boot for
599 * @irq. The caller must ensure that the interrupt is not removed
600 * concurrently.
601 */
3795de23
TG
602unsigned int kstat_irqs_cpu(unsigned int irq, int cpu)
603{
604 struct irq_desc *desc = irq_to_desc(irq);
6c9ae009
ED
605
606 return desc && desc->kstat_irqs ?
607 *per_cpu_ptr(desc->kstat_irqs, cpu) : 0;
3795de23 608}
478735e3 609
c291ee62
TG
610/**
611 * kstat_irqs - Get the statistics for an interrupt
612 * @irq: The interrupt number
613 *
614 * Returns the sum of interrupt counts on all cpus since boot for
615 * @irq. The caller must ensure that the interrupt is not removed
616 * concurrently.
617 */
478735e3
KH
618unsigned int kstat_irqs(unsigned int irq)
619{
620 struct irq_desc *desc = irq_to_desc(irq);
621 int cpu;
622 int sum = 0;
623
6c9ae009 624 if (!desc || !desc->kstat_irqs)
478735e3
KH
625 return 0;
626 for_each_possible_cpu(cpu)
6c9ae009 627 sum += *per_cpu_ptr(desc->kstat_irqs, cpu);
478735e3
KH
628 return sum;
629}
c291ee62
TG
630
631/**
632 * kstat_irqs_usr - Get the statistics for an interrupt
633 * @irq: The interrupt number
634 *
635 * Returns the sum of interrupt counts on all cpus since boot for
636 * @irq. Contrary to kstat_irqs() this can be called from any
637 * preemptible context. It's protected against concurrent removal of
638 * an interrupt descriptor when sparse irqs are enabled.
639 */
640unsigned int kstat_irqs_usr(unsigned int irq)
641{
642 int sum;
643
644 irq_lock_sparse();
645 sum = kstat_irqs(irq);
646 irq_unlock_sparse();
647 return sum;
648}
This page took 0.289355 seconds and 5 git commands to generate.