2 * Block driver for s390 storage class memory.
4 * Copyright IBM Corp. 2012
5 * Author(s): Sebastian Ott <sebott@linux.vnet.ibm.com>
8 #define KMSG_COMPONENT "scm_block"
9 #define pr_fmt(fmt) KMSG_COMPONENT ": " fmt
11 #include <linux/interrupt.h>
12 #include <linux/spinlock.h>
13 #include <linux/mempool.h>
14 #include <linux/module.h>
15 #include <linux/blkdev.h>
16 #include <linux/genhd.h>
17 #include <linux/slab.h>
18 #include <linux/list.h>
22 debug_info_t *scm_debug;
24 static mempool_t *aidaw_pool;
25 static DEFINE_SPINLOCK(list_lock);
26 static LIST_HEAD(inactive_requests);
27 static unsigned int nr_requests = 64;
28 static atomic_t nr_devices = ATOMIC_INIT(0);
29 module_param(nr_requests, uint, S_IRUGO);
30 MODULE_PARM_DESC(nr_requests, "Number of parallel requests.");
32 MODULE_DESCRIPTION("Block driver for s390 storage class memory.");
33 MODULE_LICENSE("GPL");
34 MODULE_ALIAS("scm:scmdev*");
36 static void __scm_free_rq(struct scm_request *scmrq)
38 struct aob_rq_header *aobrq = to_aobrq(scmrq);
40 free_page((unsigned long) scmrq->aob);
41 __scm_free_rq_cluster(scmrq);
45 static void scm_free_rqs(void)
47 struct list_head *iter, *safe;
48 struct scm_request *scmrq;
50 spin_lock_irq(&list_lock);
51 list_for_each_safe(iter, safe, &inactive_requests) {
52 scmrq = list_entry(iter, struct scm_request, list);
53 list_del(&scmrq->list);
56 spin_unlock_irq(&list_lock);
58 mempool_destroy(aidaw_pool);
61 static int __scm_alloc_rq(void)
63 struct aob_rq_header *aobrq;
64 struct scm_request *scmrq;
66 aobrq = kzalloc(sizeof(*aobrq) + sizeof(*scmrq), GFP_KERNEL);
70 scmrq = (void *) aobrq->data;
71 scmrq->aob = (void *) get_zeroed_page(GFP_DMA);
77 if (__scm_alloc_rq_cluster(scmrq)) {
82 INIT_LIST_HEAD(&scmrq->list);
83 spin_lock_irq(&list_lock);
84 list_add(&scmrq->list, &inactive_requests);
85 spin_unlock_irq(&list_lock);
90 static int scm_alloc_rqs(unsigned int nrqs)
94 aidaw_pool = mempool_create_page_pool(max(nrqs/8, 1U), 0);
98 while (nrqs-- && !ret)
99 ret = __scm_alloc_rq();
104 static struct scm_request *scm_request_fetch(void)
106 struct scm_request *scmrq = NULL;
108 spin_lock(&list_lock);
109 if (list_empty(&inactive_requests))
111 scmrq = list_first_entry(&inactive_requests, struct scm_request, list);
112 list_del(&scmrq->list);
114 spin_unlock(&list_lock);
118 static void scm_request_done(struct scm_request *scmrq)
120 struct msb *msb = &scmrq->aob->msb[0];
121 u64 aidaw = msb->data_addr;
124 if ((msb->flags & MSB_FLAG_IDA) && aidaw &&
125 IS_ALIGNED(aidaw, PAGE_SIZE))
126 mempool_free(virt_to_page(aidaw), aidaw_pool);
128 spin_lock_irqsave(&list_lock, flags);
129 list_add(&scmrq->list, &inactive_requests);
130 spin_unlock_irqrestore(&list_lock, flags);
133 static bool scm_permit_request(struct scm_blk_dev *bdev, struct request *req)
135 return rq_data_dir(req) != WRITE || bdev->state != SCM_WR_PROHIBIT;
138 static inline struct aidaw *scm_aidaw_alloc(void)
140 struct page *page = mempool_alloc(aidaw_pool, GFP_ATOMIC);
142 return page ? page_address(page) : NULL;
145 static inline unsigned long scm_aidaw_bytes(struct aidaw *aidaw)
147 unsigned long _aidaw = (unsigned long) aidaw;
148 unsigned long bytes = ALIGN(_aidaw, PAGE_SIZE) - _aidaw;
150 return (bytes / sizeof(*aidaw)) * PAGE_SIZE;
153 struct aidaw *scm_aidaw_fetch(struct scm_request *scmrq, unsigned int bytes)
157 if (scm_aidaw_bytes(scmrq->next_aidaw) >= bytes)
158 return scmrq->next_aidaw;
160 aidaw = scm_aidaw_alloc();
162 memset(aidaw, 0, PAGE_SIZE);
166 static int scm_request_prepare(struct scm_request *scmrq)
168 struct scm_blk_dev *bdev = scmrq->bdev;
169 struct scm_device *scmdev = bdev->gendisk->private_data;
170 struct msb *msb = &scmrq->aob->msb[0];
171 struct req_iterator iter;
175 aidaw = scm_aidaw_fetch(scmrq, blk_rq_bytes(scmrq->request));
180 scmrq->aob->request.msb_count = 1;
181 msb->scm_addr = scmdev->address +
182 ((u64) blk_rq_pos(scmrq->request) << 9);
183 msb->oc = (rq_data_dir(scmrq->request) == READ) ?
184 MSB_OC_READ : MSB_OC_WRITE;
185 msb->flags |= MSB_FLAG_IDA;
186 msb->data_addr = (u64) aidaw;
188 rq_for_each_segment(bv, scmrq->request, iter) {
189 WARN_ON(bv.bv_offset);
190 msb->blk_count += bv.bv_len >> 12;
191 aidaw->data_addr = (u64) page_address(bv.bv_page);
198 static inline void scm_request_init(struct scm_blk_dev *bdev,
199 struct scm_request *scmrq,
202 struct aob_rq_header *aobrq = to_aobrq(scmrq);
203 struct aob *aob = scmrq->aob;
205 memset(aob, 0, sizeof(*aob));
206 aobrq->scmdev = bdev->scmdev;
207 aob->request.cmd_code = ARQB_CMD_MOVE;
208 aob->request.data = (u64) aobrq;
209 scmrq->request = req;
213 /* We don't use all msbs - place aidaws at the end of the aob page. */
214 scmrq->next_aidaw = (void *) &aob->msb[1];
215 scm_request_cluster_init(scmrq);
218 static void scm_ensure_queue_restart(struct scm_blk_dev *bdev)
220 if (atomic_read(&bdev->queued_reqs)) {
221 /* Queue restart is triggered by the next interrupt. */
224 blk_delay_queue(bdev->rq, SCM_QUEUE_DELAY);
227 void scm_request_requeue(struct scm_request *scmrq)
229 struct scm_blk_dev *bdev = scmrq->bdev;
231 scm_release_cluster(scmrq);
232 blk_requeue_request(bdev->rq, scmrq->request);
233 atomic_dec(&bdev->queued_reqs);
234 scm_request_done(scmrq);
235 scm_ensure_queue_restart(bdev);
238 void scm_request_finish(struct scm_request *scmrq)
240 struct scm_blk_dev *bdev = scmrq->bdev;
242 scm_release_cluster(scmrq);
243 blk_end_request_all(scmrq->request, scmrq->error);
244 atomic_dec(&bdev->queued_reqs);
245 scm_request_done(scmrq);
248 static void scm_blk_request(struct request_queue *rq)
250 struct scm_device *scmdev = rq->queuedata;
251 struct scm_blk_dev *bdev = dev_get_drvdata(&scmdev->dev);
252 struct scm_request *scmrq;
256 while ((req = blk_peek_request(rq))) {
257 if (req->cmd_type != REQ_TYPE_FS) {
258 blk_start_request(req);
259 blk_dump_rq_flags(req, KMSG_COMPONENT " bad request");
260 blk_end_request_all(req, -EIO);
264 if (!scm_permit_request(bdev, req)) {
265 scm_ensure_queue_restart(bdev);
268 scmrq = scm_request_fetch();
270 SCM_LOG(5, "no request");
271 scm_ensure_queue_restart(bdev);
274 scm_request_init(bdev, scmrq, req);
275 if (!scm_reserve_cluster(scmrq)) {
276 SCM_LOG(5, "cluster busy");
277 scm_request_done(scmrq);
280 if (scm_need_cluster_request(scmrq)) {
281 atomic_inc(&bdev->queued_reqs);
282 blk_start_request(req);
283 scm_initiate_cluster_request(scmrq);
287 if (scm_request_prepare(scmrq)) {
288 SCM_LOG(5, "no aidaw");
289 scm_release_cluster(scmrq);
290 scm_request_done(scmrq);
291 scm_ensure_queue_restart(bdev);
295 atomic_inc(&bdev->queued_reqs);
296 blk_start_request(req);
298 ret = eadm_start_aob(scmrq->aob);
300 SCM_LOG(5, "no subchannel");
301 scm_request_requeue(scmrq);
307 static void __scmrq_log_error(struct scm_request *scmrq)
309 struct aob *aob = scmrq->aob;
311 if (scmrq->error == -ETIMEDOUT)
312 SCM_LOG(1, "Request timeout");
314 SCM_LOG(1, "Request error");
315 SCM_LOG_HEX(1, &aob->response, sizeof(aob->response));
318 SCM_LOG(1, "Retry request");
320 pr_err("An I/O operation to SCM failed with rc=%d\n",
324 void scm_blk_irq(struct scm_device *scmdev, void *data, int error)
326 struct scm_request *scmrq = data;
327 struct scm_blk_dev *bdev = scmrq->bdev;
329 scmrq->error = error;
331 __scmrq_log_error(scmrq);
333 spin_lock(&bdev->lock);
334 list_add_tail(&scmrq->list, &bdev->finished_requests);
335 spin_unlock(&bdev->lock);
336 tasklet_hi_schedule(&bdev->tasklet);
339 static void scm_blk_handle_error(struct scm_request *scmrq)
341 struct scm_blk_dev *bdev = scmrq->bdev;
344 if (scmrq->error != -EIO)
347 /* For -EIO the response block is valid. */
348 switch (scmrq->aob->response.eqc) {
349 case EQC_WR_PROHIBIT:
350 spin_lock_irqsave(&bdev->lock, flags);
351 if (bdev->state != SCM_WR_PROHIBIT)
352 pr_info("%lx: Write access to the SCM increment is suspended\n",
353 (unsigned long) bdev->scmdev->address);
354 bdev->state = SCM_WR_PROHIBIT;
355 spin_unlock_irqrestore(&bdev->lock, flags);
362 if (!eadm_start_aob(scmrq->aob))
366 spin_lock_irqsave(&bdev->rq_lock, flags);
367 scm_request_requeue(scmrq);
368 spin_unlock_irqrestore(&bdev->rq_lock, flags);
371 static void scm_blk_tasklet(struct scm_blk_dev *bdev)
373 struct scm_request *scmrq;
376 spin_lock_irqsave(&bdev->lock, flags);
377 while (!list_empty(&bdev->finished_requests)) {
378 scmrq = list_first_entry(&bdev->finished_requests,
379 struct scm_request, list);
380 list_del(&scmrq->list);
381 spin_unlock_irqrestore(&bdev->lock, flags);
383 if (scmrq->error && scmrq->retries-- > 0) {
384 scm_blk_handle_error(scmrq);
386 /* Request restarted or requeued, handle next. */
387 spin_lock_irqsave(&bdev->lock, flags);
391 if (scm_test_cluster_request(scmrq)) {
392 scm_cluster_request_irq(scmrq);
393 spin_lock_irqsave(&bdev->lock, flags);
397 scm_request_finish(scmrq);
398 spin_lock_irqsave(&bdev->lock, flags);
400 spin_unlock_irqrestore(&bdev->lock, flags);
401 /* Look out for more requests. */
402 blk_run_queue(bdev->rq);
405 static const struct block_device_operations scm_blk_devops = {
406 .owner = THIS_MODULE,
409 int scm_blk_dev_setup(struct scm_blk_dev *bdev, struct scm_device *scmdev)
411 struct request_queue *rq;
412 int len, ret = -ENOMEM;
413 unsigned int devindex, nr_max_blk;
415 devindex = atomic_inc_return(&nr_devices) - 1;
416 /* scma..scmz + scmaa..scmzz */
417 if (devindex > 701) {
422 bdev->scmdev = scmdev;
423 bdev->state = SCM_OPER;
424 spin_lock_init(&bdev->rq_lock);
425 spin_lock_init(&bdev->lock);
426 INIT_LIST_HEAD(&bdev->finished_requests);
427 atomic_set(&bdev->queued_reqs, 0);
428 tasklet_init(&bdev->tasklet,
429 (void (*)(unsigned long)) scm_blk_tasklet,
430 (unsigned long) bdev);
432 rq = blk_init_queue(scm_blk_request, &bdev->rq_lock);
437 nr_max_blk = min(scmdev->nr_max_block,
438 (unsigned int) (PAGE_SIZE / sizeof(struct aidaw)));
440 blk_queue_logical_block_size(rq, 1 << 12);
441 blk_queue_max_hw_sectors(rq, nr_max_blk << 3); /* 8 * 512 = blk_size */
442 blk_queue_max_segments(rq, nr_max_blk);
443 queue_flag_set_unlocked(QUEUE_FLAG_NONROT, rq);
444 queue_flag_clear_unlocked(QUEUE_FLAG_ADD_RANDOM, rq);
445 scm_blk_dev_cluster_setup(bdev);
447 bdev->gendisk = alloc_disk(SCM_NR_PARTS);
451 rq->queuedata = scmdev;
452 bdev->gendisk->driverfs_dev = &scmdev->dev;
453 bdev->gendisk->private_data = scmdev;
454 bdev->gendisk->fops = &scm_blk_devops;
455 bdev->gendisk->queue = rq;
456 bdev->gendisk->major = scm_major;
457 bdev->gendisk->first_minor = devindex * SCM_NR_PARTS;
459 len = snprintf(bdev->gendisk->disk_name, DISK_NAME_LEN, "scm");
461 len += snprintf(bdev->gendisk->disk_name + len,
462 DISK_NAME_LEN - len, "%c",
463 'a' + (devindex / 26) - 1);
464 devindex = devindex % 26;
466 snprintf(bdev->gendisk->disk_name + len, DISK_NAME_LEN - len, "%c",
469 /* 512 byte sectors */
470 set_capacity(bdev->gendisk, scmdev->size >> 9);
471 add_disk(bdev->gendisk);
475 blk_cleanup_queue(rq);
477 atomic_dec(&nr_devices);
481 void scm_blk_dev_cleanup(struct scm_blk_dev *bdev)
483 tasklet_kill(&bdev->tasklet);
484 del_gendisk(bdev->gendisk);
485 blk_cleanup_queue(bdev->gendisk->queue);
486 put_disk(bdev->gendisk);
489 void scm_blk_set_available(struct scm_blk_dev *bdev)
493 spin_lock_irqsave(&bdev->lock, flags);
494 if (bdev->state == SCM_WR_PROHIBIT)
495 pr_info("%lx: Write access to the SCM increment is restored\n",
496 (unsigned long) bdev->scmdev->address);
497 bdev->state = SCM_OPER;
498 spin_unlock_irqrestore(&bdev->lock, flags);
501 static int __init scm_blk_init(void)
505 if (!scm_cluster_size_valid())
508 ret = register_blkdev(0, "scm");
513 ret = scm_alloc_rqs(nr_requests);
517 scm_debug = debug_register("scm_log", 16, 1, 16);
523 debug_register_view(scm_debug, &debug_hex_ascii_view);
524 debug_set_level(scm_debug, 2);
526 ret = scm_drv_init();
533 debug_unregister(scm_debug);
536 unregister_blkdev(scm_major, "scm");
540 module_init(scm_blk_init);
542 static void __exit scm_blk_cleanup(void)
545 debug_unregister(scm_debug);
547 unregister_blkdev(scm_major, "scm");
549 module_exit(scm_blk_cleanup);