1 // SPDX-License-Identifier: GPL-2.0
3 * Author(s)......: Carsten Otte <cotte@de.ibm.com>
4 * Rob M van der Heij <rvdheij@nl.ibm.com>
5 * Steven Shultz <shultzss@us.ibm.com>
6 * Bugreports.to..: <Linux390@de.ibm.com>
7 * Copyright IBM Corp. 2002, 2004
10 #define KMSG_COMPONENT "extmem"
11 #define pr_fmt(fmt) KMSG_COMPONENT ": " fmt
13 #include <linux/kernel.h>
14 #include <linux/string.h>
15 #include <linux/spinlock.h>
16 #include <linux/list.h>
17 #include <linux/slab.h>
18 #include <linux/export.h>
19 #include <linux/memblock.h>
20 #include <linux/ctype.h>
21 #include <linux/ioport.h>
22 #include <linux/refcount.h>
23 #include <linux/pgtable.h>
26 #include <asm/ebcdic.h>
27 #include <asm/errno.h>
28 #include <asm/extmem.h>
29 #include <asm/cpcmd.h>
30 #include <asm/setup.h>
32 #define DCSS_PURGESEG 0x08
33 #define DCSS_LOADSHRX 0x20
34 #define DCSS_LOADNSRX 0x24
35 #define DCSS_FINDSEGX 0x2c
36 #define DCSS_SEGEXTX 0x38
37 #define DCSS_FINDSEGA 0x0c
40 unsigned long start; /* last byte type */
41 unsigned long end; /* last byte reserved */
45 unsigned long segstart;
49 struct qrange range[6];
63 struct list_head list;
66 unsigned long start_addr;
70 unsigned int vm_segtype;
71 struct qrange range[6];
76 static DEFINE_MUTEX(dcss_lock);
77 static LIST_HEAD(dcss_list);
78 static char *segtype_string[] = { "SW", "EW", "SR", "ER", "SN", "EN", "SC",
80 static int loadshr_scode = DCSS_LOADSHRX;
81 static int loadnsr_scode = DCSS_LOADNSRX;
82 static int purgeseg_scode = DCSS_PURGESEG;
83 static int segext_scode = DCSS_SEGEXTX;
86 * Create the 8 bytes, ebcdic VM segment name from
90 dcss_mkname(char *name, char *dcss_name)
94 for (i = 0; i < 8; i++) {
97 dcss_name[i] = toupper(name[i]);
101 ASCEBC(dcss_name, 8);
106 * search all segments in dcss_list, and return the one
107 * namend *name. If not found, return NULL.
109 static struct dcss_segment *
110 segment_by_name (char *name)
114 struct dcss_segment *tmp, *retval = NULL;
116 BUG_ON(!mutex_is_locked(&dcss_lock));
117 dcss_mkname (name, dcss_name);
118 list_for_each (l, &dcss_list) {
119 tmp = list_entry (l, struct dcss_segment, list);
120 if (memcmp(tmp->dcss_name, dcss_name, 8) == 0) {
130 * Perform a function on a dcss segment.
133 dcss_diag(int *func, void *parameter,
134 unsigned long *ret1, unsigned long *ret2)
136 unsigned long rx, ry;
139 rx = (unsigned long) parameter;
140 ry = (unsigned long) *func;
142 diag_stat_inc(DIAG_STAT_X064);
147 : "+d" (rx), "+d" (ry), "=d" (rc) : : "cc");
154 dcss_diag_translate_rc (int vm_rc) {
161 /* do a diag to get info about a segment.
162 * fills start_address, end and vm_segtype fields
165 query_segment_type (struct dcss_segment *seg)
167 unsigned long dummy, vmrc;
172 qin = kmalloc(sizeof(*qin), GFP_KERNEL | GFP_DMA);
173 qout = kmalloc(sizeof(*qout), GFP_KERNEL | GFP_DMA);
174 if ((qin == NULL) || (qout == NULL)) {
179 /* initialize diag input parameters */
180 qin->qopcode = DCSS_FINDSEGA;
181 qin->qoutptr = (unsigned long) qout;
182 qin->qoutlen = sizeof(struct qout64);
183 memcpy (qin->qname, seg->dcss_name, 8);
185 diag_cc = dcss_diag(&segext_scode, qin, &dummy, &vmrc);
192 pr_warn("Querying a DCSS type failed with rc=%ld\n", vmrc);
193 rc = dcss_diag_translate_rc (vmrc);
197 if (qout->segcnt > 6) {
202 if (qout->segcnt == 1) {
203 seg->vm_segtype = qout->range[0].start & 0xff;
205 /* multi-part segment. only one type supported here:
206 - all parts are contiguous
207 - all parts are either EW or EN type
208 - maximum 6 parts allowed */
209 unsigned long start = qout->segstart >> PAGE_SHIFT;
210 for (i=0; i<qout->segcnt; i++) {
211 if (((qout->range[i].start & 0xff) != SEG_TYPE_EW) &&
212 ((qout->range[i].start & 0xff) != SEG_TYPE_EN)) {
216 if (start != qout->range[i].start >> PAGE_SHIFT) {
220 start = (qout->range[i].end >> PAGE_SHIFT) + 1;
222 seg->vm_segtype = SEG_TYPE_EWEN;
225 /* analyze diag output and update seg */
226 seg->start_addr = qout->segstart;
227 seg->end = qout->segend;
229 memcpy (seg->range, qout->range, 6*sizeof(struct qrange));
230 seg->segcnt = qout->segcnt;
241 * get info about a segment
242 * possible return values:
243 * -ENOSYS : we are not running on VM
244 * -EIO : could not perform query diagnose
245 * -ENOENT : no such segment
246 * -EOPNOTSUPP: multi-part segment cannot be used with linux
247 * -ENOMEM : out of memory
248 * 0 .. 6 : type of segment as defined in include/asm-s390/extmem.h
251 segment_type (char* name)
254 struct dcss_segment seg;
259 dcss_mkname(name, seg.dcss_name);
260 rc = query_segment_type (&seg);
263 return seg.vm_segtype;
267 * check if segment collides with other segments that are currently loaded
268 * returns 1 if this is the case, 0 if no collision was found
271 segment_overlaps_others (struct dcss_segment *seg)
274 struct dcss_segment *tmp;
276 BUG_ON(!mutex_is_locked(&dcss_lock));
277 list_for_each(l, &dcss_list) {
278 tmp = list_entry(l, struct dcss_segment, list);
279 if ((tmp->start_addr >> 20) > (seg->end >> 20))
281 if ((tmp->end >> 20) < (seg->start_addr >> 20))
291 * real segment loading function, called from segment_load
292 * Must return either an error code < 0, or the segment type code >= 0
295 __segment_load (char *name, int do_nonshared, unsigned long *addr, unsigned long *end)
297 unsigned long start_addr, end_addr, dummy;
298 struct dcss_segment *seg;
299 int rc, diag_cc, segtype;
301 start_addr = end_addr = 0;
303 seg = kmalloc(sizeof(*seg), GFP_KERNEL | GFP_DMA);
308 dcss_mkname (name, seg->dcss_name);
309 rc = query_segment_type (seg);
313 if (segment_overlaps_others(seg)) {
318 seg->res = kzalloc(sizeof(struct resource), GFP_KERNEL);
319 if (seg->res == NULL) {
323 seg->res->flags = IORESOURCE_BUSY | IORESOURCE_MEM;
324 seg->res->start = seg->start_addr;
325 seg->res->end = seg->end;
326 memcpy(&seg->res_name, seg->dcss_name, 8);
327 EBCASC(seg->res_name, 8);
328 seg->res_name[8] = '\0';
329 strlcat(seg->res_name, " (DCSS)", sizeof(seg->res_name));
330 seg->res->name = seg->res_name;
331 segtype = seg->vm_segtype;
332 if (segtype == SEG_TYPE_SC ||
333 ((segtype == SEG_TYPE_SR || segtype == SEG_TYPE_ER) && !do_nonshared))
334 seg->res->flags |= IORESOURCE_READONLY;
336 /* Check for overlapping resources before adding the mapping. */
337 if (request_resource(&iomem_resource, seg->res)) {
339 goto out_free_resource;
342 rc = vmem_add_mapping(seg->start_addr, seg->end - seg->start_addr + 1);
347 diag_cc = dcss_diag(&loadnsr_scode, seg->dcss_name,
348 &start_addr, &end_addr);
350 diag_cc = dcss_diag(&loadshr_scode, seg->dcss_name,
351 &start_addr, &end_addr);
353 dcss_diag(&purgeseg_scode, seg->dcss_name,
359 pr_warn("Loading DCSS %s failed with rc=%ld\n", name, end_addr);
360 rc = dcss_diag_translate_rc(end_addr);
361 dcss_diag(&purgeseg_scode, seg->dcss_name,
365 seg->start_addr = start_addr;
367 seg->do_nonshared = do_nonshared;
368 refcount_set(&seg->ref_count, 1);
369 list_add(&seg->list, &dcss_list);
370 *addr = seg->start_addr;
373 pr_info("DCSS %s of range %px to %px and type %s loaded as "
374 "exclusive-writable\n", name, (void*) seg->start_addr,
375 (void*) seg->end, segtype_string[seg->vm_segtype]);
377 pr_info("DCSS %s of range %px to %px and type %s loaded in "
378 "shared access mode\n", name, (void*) seg->start_addr,
379 (void*) seg->end, segtype_string[seg->vm_segtype]);
383 vmem_remove_mapping(seg->start_addr, seg->end - seg->start_addr + 1);
385 release_resource(seg->res);
391 return rc < 0 ? rc : segtype;
395 * this function loads a DCSS segment
396 * name : name of the DCSS
397 * do_nonshared : 0 indicates that the dcss should be shared with other linux images
398 * 1 indicates that the dcss should be exclusive for this linux image
399 * addr : will be filled with start address of the segment
400 * end : will be filled with end address of the segment
402 * -ENOSYS : we are not running on VM
403 * -EIO : could not perform query or load diagnose
404 * -ENOENT : no such segment
405 * -EOPNOTSUPP: multi-part segment cannot be used with linux
406 * -EBUSY : segment cannot be used (overlaps with dcss or storage)
407 * -ERANGE : segment cannot be used (exceeds kernel mapping range)
408 * -EPERM : segment is currently loaded with incompatible permissions
409 * -ENOMEM : out of memory
410 * 0 .. 6 : type of segment as defined in include/asm-s390/extmem.h
413 segment_load (char *name, int do_nonshared, unsigned long *addr,
416 struct dcss_segment *seg;
422 mutex_lock(&dcss_lock);
423 seg = segment_by_name (name);
425 rc = __segment_load (name, do_nonshared, addr, end);
427 if (do_nonshared == seg->do_nonshared) {
428 refcount_inc(&seg->ref_count);
429 *addr = seg->start_addr;
431 rc = seg->vm_segtype;
437 mutex_unlock(&dcss_lock);
442 * this function modifies the shared state of a DCSS segment. note that
443 * name : name of the DCSS
444 * do_nonshared : 0 indicates that the dcss should be shared with other linux images
445 * 1 indicates that the dcss should be exclusive for this linux image
447 * -EIO : could not perform load diagnose (segment gone!)
448 * -ENOENT : no such segment (segment gone!)
449 * -EAGAIN : segment is in use by other exploiters, try later
450 * -EINVAL : no segment with the given name is currently loaded - name invalid
451 * -EBUSY : segment can temporarily not be used (overlaps with dcss)
452 * 0 : operation succeeded
455 segment_modify_shared (char *name, int do_nonshared)
457 struct dcss_segment *seg;
458 unsigned long start_addr, end_addr, dummy;
461 start_addr = end_addr = 0;
462 mutex_lock(&dcss_lock);
463 seg = segment_by_name (name);
468 if (do_nonshared == seg->do_nonshared) {
469 pr_info("DCSS %s is already in the requested access "
474 if (refcount_read(&seg->ref_count) != 1) {
475 pr_warn("DCSS %s is in use and cannot be reloaded\n", name);
479 release_resource(seg->res);
481 seg->res->flags &= ~IORESOURCE_READONLY;
483 if (seg->vm_segtype == SEG_TYPE_SR ||
484 seg->vm_segtype == SEG_TYPE_ER)
485 seg->res->flags |= IORESOURCE_READONLY;
487 if (request_resource(&iomem_resource, seg->res)) {
488 pr_warn("DCSS %s overlaps with used memory resources and cannot be reloaded\n",
495 dcss_diag(&purgeseg_scode, seg->dcss_name, &dummy, &dummy);
497 diag_cc = dcss_diag(&loadnsr_scode, seg->dcss_name,
498 &start_addr, &end_addr);
500 diag_cc = dcss_diag(&loadshr_scode, seg->dcss_name,
501 &start_addr, &end_addr);
507 pr_warn("Reloading DCSS %s failed with rc=%ld\n",
509 rc = dcss_diag_translate_rc(end_addr);
512 seg->start_addr = start_addr;
514 seg->do_nonshared = do_nonshared;
518 release_resource(seg->res);
521 vmem_remove_mapping(seg->start_addr, seg->end - seg->start_addr + 1);
522 list_del(&seg->list);
523 dcss_diag(&purgeseg_scode, seg->dcss_name, &dummy, &dummy);
526 mutex_unlock(&dcss_lock);
531 * Decrease the use count of a DCSS segment and remove
532 * it from the address space if nobody is using it
536 segment_unload(char *name)
539 struct dcss_segment *seg;
544 mutex_lock(&dcss_lock);
545 seg = segment_by_name (name);
547 pr_err("Unloading unknown DCSS %s failed\n", name);
550 if (!refcount_dec_and_test(&seg->ref_count))
552 release_resource(seg->res);
554 vmem_remove_mapping(seg->start_addr, seg->end - seg->start_addr + 1);
555 list_del(&seg->list);
556 dcss_diag(&purgeseg_scode, seg->dcss_name, &dummy, &dummy);
559 mutex_unlock(&dcss_lock);
563 * save segment content permanently
566 segment_save(char *name)
568 struct dcss_segment *seg;
576 mutex_lock(&dcss_lock);
577 seg = segment_by_name (name);
580 pr_err("Saving unknown DCSS %s failed\n", name);
584 sprintf(cmd1, "DEFSEG %s", name);
585 for (i=0; i<seg->segcnt; i++) {
586 sprintf(cmd1+strlen(cmd1), " %lX-%lX %s",
587 seg->range[i].start >> PAGE_SHIFT,
588 seg->range[i].end >> PAGE_SHIFT,
589 segtype_string[seg->range[i].start & 0xff]);
591 sprintf(cmd2, "SAVESEG %s", name);
593 cpcmd(cmd1, NULL, 0, &response);
595 pr_err("Saving a DCSS failed with DEFSEG response code "
599 cpcmd(cmd2, NULL, 0, &response);
601 pr_err("Saving a DCSS failed with SAVESEG response code "
606 mutex_unlock(&dcss_lock);
610 * print appropriate error message for segment_load()/segment_type()
613 void segment_warning(int rc, char *seg_name)
617 pr_err("DCSS %s cannot be loaded or queried\n", seg_name);
620 pr_err("DCSS %s cannot be loaded or queried without "
624 pr_err("Loading or querying DCSS %s resulted in a "
625 "hardware error\n", seg_name);
628 pr_err("DCSS %s has multiple page ranges and cannot be "
629 "loaded or queried\n", seg_name);
632 pr_err("%s needs used memory resources and cannot be "
633 "loaded or queried\n", seg_name);
636 pr_err("DCSS %s is already loaded in a different access "
640 pr_err("There is not enough memory to load or query "
641 "DCSS %s\n", seg_name);
644 struct range mhp_range = arch_get_mappable_range();
646 pr_err("DCSS %s exceeds the kernel mapping range (%llu) "
647 "and cannot be loaded\n", seg_name, mhp_range.end + 1);
655 EXPORT_SYMBOL(segment_load);
656 EXPORT_SYMBOL(segment_unload);
657 EXPORT_SYMBOL(segment_save);
658 EXPORT_SYMBOL(segment_type);
659 EXPORT_SYMBOL(segment_modify_shared);
660 EXPORT_SYMBOL(segment_warning);