arch/s390/mm/extmem.c

root/arch/s390/mm/extmem.c
// SPDX-License-Identifier: GPL-2.0
/*
 * Author(s)......: Carsten Otte <cotte@de.ibm.com>
 *                  Rob M van der Heij <rvdheij@nl.ibm.com>
 *                  Steven Shultz <shultzss@us.ibm.com>
 * Bugreports.to..: <Linux390@de.ibm.com>
 * Copyright IBM Corp. 2002, 2004
 */

#define pr_fmt(fmt) "extmem: " fmt

#include <linux/kernel.h>
#include <linux/string.h>
#include <linux/spinlock.h>
#include <linux/list.h>
#include <linux/slab.h>
#include <linux/export.h>
#include <linux/memblock.h>
#include <linux/ctype.h>
#include <linux/ioport.h>
#include <linux/refcount.h>
#include <linux/pgtable.h>
#include <asm/machine.h>
#include <asm/diag.h>
#include <asm/page.h>
#include <asm/ebcdic.h>
#include <asm/errno.h>
#include <asm/extmem.h>
#include <asm/cpcmd.h>
#include <asm/setup.h>
#include <asm/asm.h>

#define DCSS_PURGESEG   0x08
#define DCSS_LOADSHRX   0x20
#define DCSS_LOADNSRX   0x24
#define DCSS_FINDSEGX   0x2c
#define DCSS_SEGEXTX    0x38
#define DCSS_FINDSEGA   0x0c

struct qrange {
        unsigned long  start; /* last byte type */
        unsigned long  end;   /* last byte reserved */
};

struct qout64 {
        unsigned long segstart;
        unsigned long segend;
        int segcnt;
        int segrcnt;
        struct qrange range[6];
};

struct qin64 {
        char qopcode;
        char rsrv1[3];
        char qrcode;
        char rsrv2[3];
        char qname[8];
        unsigned int qoutptr;
        short int qoutlen;
};

struct dcss_segment {
        struct list_head list;
        char dcss_name[8];
        char res_name[16];
        unsigned long start_addr;
        unsigned long end;
        refcount_t ref_count;
        int do_nonshared;
        unsigned int vm_segtype;
        struct qrange range[6];
        int segcnt;
        struct resource *res;
};

static DEFINE_MUTEX(dcss_lock);
static LIST_HEAD(dcss_list);
static char *segtype_string[] = { "SW", "EW", "SR", "ER", "SN", "EN", "SC",
                                        "EW/EN-MIXED" };
static int loadshr_scode = DCSS_LOADSHRX;
static int loadnsr_scode = DCSS_LOADNSRX;
static int purgeseg_scode = DCSS_PURGESEG;
static int segext_scode = DCSS_SEGEXTX;

/*
 * Create the 8 bytes, ebcdic VM segment name from
 * an ascii name.
 */
static void
dcss_mkname(char *name, char *dcss_name)
{
        int i;

        for (i = 0; i < 8; i++) {
                if (name[i] == '\0')
                        break;
                dcss_name[i] = toupper(name[i]);
        }
        for (; i < 8; i++)
                dcss_name[i] = ' ';
        ASCEBC(dcss_name, 8);
}


/*
 * search all segments in dcss_list, and return the one
 * namend *name. If not found, return NULL.
 */
static struct dcss_segment *
segment_by_name (char *name)
{
        char dcss_name[9];
        struct list_head *l;
        struct dcss_segment *tmp, *retval = NULL;

        BUG_ON(!mutex_is_locked(&dcss_lock));
        dcss_mkname (name, dcss_name);
        list_for_each (l, &dcss_list) {
                tmp = list_entry (l, struct dcss_segment, list);
                if (memcmp(tmp->dcss_name, dcss_name, 8) == 0) {
                        retval = tmp;
                        break;
                }
        }
        return retval;
}


/*
 * Perform a function on a dcss segment.
 */
static inline int
dcss_diag(int *func, void *parameter,
           unsigned long *ret1, unsigned long *ret2)
{
        unsigned long rx, ry;
        int cc;

        rx = virt_to_phys(parameter);
        ry = (unsigned long) *func;

        diag_stat_inc(DIAG_STAT_X064);
        asm volatile(
                "       diag    %[rx],%[ry],0x64\n"
                CC_IPM(cc)
                : CC_OUT(cc, cc), [rx] "+d" (rx), [ry] "+d" (ry)
                :
                : CC_CLOBBER);
        *ret1 = rx;
        *ret2 = ry;
        return CC_TRANSFORM(cc);
}

static inline int
dcss_diag_translate_rc (int vm_rc) {
        if (vm_rc == 44)
                return -ENOENT;
        return -EIO;
}


/* do a diag to get info about a segment.
 * fills start_address, end and vm_segtype fields
 */
static int
query_segment_type (struct dcss_segment *seg)
{
        unsigned long dummy, vmrc;
        int diag_cc, rc, i;
        struct qout64 *qout;
        struct qin64 *qin;

        qin = kmalloc_obj(*qin, GFP_KERNEL | GFP_DMA);
        qout = kmalloc_obj(*qout, GFP_KERNEL | GFP_DMA);
        if ((qin == NULL) || (qout == NULL)) {
                rc = -ENOMEM;
                goto out_free;
        }

        /* initialize diag input parameters */
        qin->qopcode = DCSS_FINDSEGA;
        qin->qoutptr = virt_to_phys(qout);
        qin->qoutlen = sizeof(struct qout64);
        memcpy (qin->qname, seg->dcss_name, 8);

        diag_cc = dcss_diag(&segext_scode, qin, &dummy, &vmrc);

        if (diag_cc < 0) {
                rc = diag_cc;
                goto out_free;
        }
        if (diag_cc > 1) {
                pr_warn("Querying a DCSS type failed with rc=%ld\n", vmrc);
                rc = dcss_diag_translate_rc (vmrc);
                goto out_free;
        }

        if (qout->segcnt > 6) {
                rc = -EOPNOTSUPP;
                goto out_free;
        }

        if (qout->segcnt == 1) {
                seg->vm_segtype = qout->range[0].start & 0xff;
        } else {
                /* multi-part segment. only one type supported here:
                    - all parts are contiguous
                    - all parts are either EW or EN type
                    - maximum 6 parts allowed */
                unsigned long start = qout->segstart >> PAGE_SHIFT;
                for (i=0; i<qout->segcnt; i++) {
                        if (((qout->range[i].start & 0xff) != SEG_TYPE_EW) &&
                            ((qout->range[i].start & 0xff) != SEG_TYPE_EN)) {
                                rc = -EOPNOTSUPP;
                                goto out_free;
                        }
                        if (start != qout->range[i].start >> PAGE_SHIFT) {
                                rc = -EOPNOTSUPP;
                                goto out_free;
                        }
                        start = (qout->range[i].end >> PAGE_SHIFT) + 1;
                }
                seg->vm_segtype = SEG_TYPE_EWEN;
        }

        /* analyze diag output and update seg */
        seg->start_addr = qout->segstart;
        seg->end = qout->segend;

        memcpy (seg->range, qout->range, 6*sizeof(struct qrange));
        seg->segcnt = qout->segcnt;

        rc = 0;

 out_free:
        kfree(qin);
        kfree(qout);
        return rc;
}

/*
 * get info about a segment
 * possible return values:
 * -ENOSYS  : we are not running on VM
 * -EIO     : could not perform query diagnose
 * -ENOENT  : no such segment
 * -EOPNOTSUPP: multi-part segment cannot be used with linux
 * -ENOMEM  : out of memory
 * 0 .. 6   : type of segment as defined in include/asm-s390/extmem.h
 */
int
segment_type (char* name)
{
        int rc;
        struct dcss_segment seg;

        if (!machine_is_vm())
                return -ENOSYS;

        dcss_mkname(name, seg.dcss_name);
        rc = query_segment_type (&seg);
        if (rc < 0)
                return rc;
        return seg.vm_segtype;
}

/*
 * check if segment collides with other segments that are currently loaded
 * returns 1 if this is the case, 0 if no collision was found
 */
static int
segment_overlaps_others (struct dcss_segment *seg)
{
        struct list_head *l;
        struct dcss_segment *tmp;

        BUG_ON(!mutex_is_locked(&dcss_lock));
        list_for_each(l, &dcss_list) {
                tmp = list_entry(l, struct dcss_segment, list);
                if ((tmp->start_addr >> 20) > (seg->end >> 20))
                        continue;
                if ((tmp->end >> 20) < (seg->start_addr >> 20))
                        continue;
                if (seg == tmp)
                        continue;
                return 1;
        }
        return 0;
}

/*
 * real segment loading function, called from segment_load
 * Must return either an error code < 0, or the segment type code >= 0
 */
static int
__segment_load (char *name, int do_nonshared, unsigned long *addr, unsigned long *end)
{
        unsigned long start_addr, end_addr, dummy;
        struct dcss_segment *seg;
        int rc, diag_cc, segtype;

        start_addr = end_addr = 0;
        segtype = -1;
        seg = kmalloc_obj(*seg, GFP_KERNEL | GFP_DMA);
        if (seg == NULL) {
                rc = -ENOMEM;
                goto out;
        }
        dcss_mkname (name, seg->dcss_name);
        rc = query_segment_type (seg);
        if (rc < 0)
                goto out_free;

        if (segment_overlaps_others(seg)) {
                rc = -EBUSY;
                goto out_free;
        }

        seg->res = kzalloc_obj(struct resource);
        if (seg->res == NULL) {
                rc = -ENOMEM;
                goto out_free;
        }
        seg->res->flags = IORESOURCE_BUSY | IORESOURCE_MEM;
        seg->res->start = seg->start_addr;
        seg->res->end = seg->end;
        memcpy(&seg->res_name, seg->dcss_name, 8);
        EBCASC(seg->res_name, 8);
        seg->res_name[8] = '\0';
        strlcat(seg->res_name, " (DCSS)", sizeof(seg->res_name));
        seg->res->name = seg->res_name;
        segtype = seg->vm_segtype;
        if (segtype == SEG_TYPE_SC ||
            ((segtype == SEG_TYPE_SR || segtype == SEG_TYPE_ER) && !do_nonshared))
                seg->res->flags |= IORESOURCE_READONLY;

        /* Check for overlapping resources before adding the mapping. */
        if (request_resource(&iomem_resource, seg->res)) {
                rc = -EBUSY;
                goto out_free_resource;
        }

        rc = vmem_add_mapping(seg->start_addr, seg->end - seg->start_addr + 1);
        if (rc)
                goto out_resource;

        if (do_nonshared)
                diag_cc = dcss_diag(&loadnsr_scode, seg->dcss_name,
                                &start_addr, &end_addr);
        else
                diag_cc = dcss_diag(&loadshr_scode, seg->dcss_name,
                                &start_addr, &end_addr);
        if (diag_cc < 0) {
                dcss_diag(&purgeseg_scode, seg->dcss_name,
                                &dummy, &dummy);
                rc = diag_cc;
                goto out_mapping;
        }
        if (diag_cc > 1) {
                pr_warn("Loading DCSS %s failed with rc=%ld\n", name, end_addr);
                rc = dcss_diag_translate_rc(end_addr);
                dcss_diag(&purgeseg_scode, seg->dcss_name,
                                &dummy, &dummy);
                goto out_mapping;
        }
        seg->start_addr = start_addr;
        seg->end = end_addr;
        seg->do_nonshared = do_nonshared;
        refcount_set(&seg->ref_count, 1);
        list_add(&seg->list, &dcss_list);
        *addr = seg->start_addr;
        *end  = seg->end;
        if (do_nonshared)
                pr_info("DCSS %s of range %px to %px and type %s loaded as "
                        "exclusive-writable\n", name, (void*) seg->start_addr,
                        (void*) seg->end, segtype_string[seg->vm_segtype]);
        else {
                pr_info("DCSS %s of range %px to %px and type %s loaded in "
                        "shared access mode\n", name, (void*) seg->start_addr,
                        (void*) seg->end, segtype_string[seg->vm_segtype]);
        }
        goto out;
 out_mapping:
        vmem_remove_mapping(seg->start_addr, seg->end - seg->start_addr + 1);
 out_resource:
        release_resource(seg->res);
 out_free_resource:
        kfree(seg->res);
 out_free:
        kfree(seg);
 out:
        return rc < 0 ? rc : segtype;
}

/*
 * this function loads a DCSS segment
 * name         : name of the DCSS
 * do_nonshared : 0 indicates that the dcss should be shared with other linux images
 *                1 indicates that the dcss should be exclusive for this linux image
 * addr         : will be filled with start address of the segment
 * end          : will be filled with end address of the segment
 * return values:
 * -ENOSYS  : we are not running on VM
 * -EIO     : could not perform query or load diagnose
 * -ENOENT  : no such segment
 * -EOPNOTSUPP: multi-part segment cannot be used with linux
 * -EBUSY   : segment cannot be used (overlaps with dcss or storage)
 * -ERANGE  : segment cannot be used (exceeds kernel mapping range)
 * -EPERM   : segment is currently loaded with incompatible permissions
 * -ENOMEM  : out of memory
 * 0 .. 6   : type of segment as defined in include/asm-s390/extmem.h
 */
int
segment_load (char *name, int do_nonshared, unsigned long *addr,
                unsigned long *end)
{
        struct dcss_segment *seg;
        int rc;

        if (!machine_is_vm())
                return -ENOSYS;

        mutex_lock(&dcss_lock);
        seg = segment_by_name (name);
        if (seg == NULL)
                rc = __segment_load (name, do_nonshared, addr, end);
        else {
                if (do_nonshared == seg->do_nonshared) {
                        refcount_inc(&seg->ref_count);
                        *addr = seg->start_addr;
                        *end  = seg->end;
                        rc    = seg->vm_segtype;
                } else {
                        *addr = *end = 0;
                        rc    = -EPERM;
                }
        }
        mutex_unlock(&dcss_lock);
        return rc;
}

/*
 * this function modifies the shared state of a DCSS segment. note that
 * name         : name of the DCSS
 * do_nonshared : 0 indicates that the dcss should be shared with other linux images
 *                1 indicates that the dcss should be exclusive for this linux image
 * return values:
 * -EIO     : could not perform load diagnose (segment gone!)
 * -ENOENT  : no such segment (segment gone!)
 * -EAGAIN  : segment is in use by other exploiters, try later
 * -EINVAL  : no segment with the given name is currently loaded - name invalid
 * -EBUSY   : segment can temporarily not be used (overlaps with dcss)
 * 0        : operation succeeded
 */
int
segment_modify_shared (char *name, int do_nonshared)
{
        struct dcss_segment *seg;
        unsigned long start_addr, end_addr, dummy;
        int rc, diag_cc;

        start_addr = end_addr = 0;
        mutex_lock(&dcss_lock);
        seg = segment_by_name (name);
        if (seg == NULL) {
                rc = -EINVAL;
                goto out_unlock;
        }
        if (do_nonshared == seg->do_nonshared) {
                pr_info("DCSS %s is already in the requested access "
                        "mode\n", name);
                rc = 0;
                goto out_unlock;
        }
        if (refcount_read(&seg->ref_count) != 1) {
                pr_warn("DCSS %s is in use and cannot be reloaded\n", name);
                rc = -EAGAIN;
                goto out_unlock;
        }
        release_resource(seg->res);
        if (do_nonshared)
                seg->res->flags &= ~IORESOURCE_READONLY;
        else
                if (seg->vm_segtype == SEG_TYPE_SR ||
                    seg->vm_segtype == SEG_TYPE_ER)
                        seg->res->flags |= IORESOURCE_READONLY;

        if (request_resource(&iomem_resource, seg->res)) {
                pr_warn("DCSS %s overlaps with used memory resources and cannot be reloaded\n",
                        name);
                rc = -EBUSY;
                kfree(seg->res);
                goto out_del_mem;
        }

        dcss_diag(&purgeseg_scode, seg->dcss_name, &dummy, &dummy);
        if (do_nonshared)
                diag_cc = dcss_diag(&loadnsr_scode, seg->dcss_name,
                                &start_addr, &end_addr);
        else
                diag_cc = dcss_diag(&loadshr_scode, seg->dcss_name,
                                &start_addr, &end_addr);
        if (diag_cc < 0) {
                rc = diag_cc;
                goto out_del_res;
        }
        if (diag_cc > 1) {
                pr_warn("Reloading DCSS %s failed with rc=%ld\n",
                        name, end_addr);
                rc = dcss_diag_translate_rc(end_addr);
                goto out_del_res;
        }
        seg->start_addr = start_addr;
        seg->end = end_addr;
        seg->do_nonshared = do_nonshared;
        rc = 0;
        goto out_unlock;
 out_del_res:
        release_resource(seg->res);
        kfree(seg->res);
 out_del_mem:
        vmem_remove_mapping(seg->start_addr, seg->end - seg->start_addr + 1);
        list_del(&seg->list);
        dcss_diag(&purgeseg_scode, seg->dcss_name, &dummy, &dummy);
        kfree(seg);
 out_unlock:
        mutex_unlock(&dcss_lock);
        return rc;
}

static void __dcss_diag_purge_on_cpu_0(void *data)
{
        struct dcss_segment *seg = (struct dcss_segment *)data;
        unsigned long dummy;

        dcss_diag(&purgeseg_scode, seg->dcss_name, &dummy, &dummy);
}

/*
 * Decrease the use count of a DCSS segment and remove
 * it from the address space if nobody is using it
 * any longer.
 */
void
segment_unload(char *name)
{
        struct dcss_segment *seg;

        if (!machine_is_vm())
                return;

        mutex_lock(&dcss_lock);
        seg = segment_by_name (name);
        if (seg == NULL) {
                pr_err("Unloading unknown DCSS %s failed\n", name);
                goto out_unlock;
        }
        if (!refcount_dec_and_test(&seg->ref_count))
                goto out_unlock;
        release_resource(seg->res);
        kfree(seg->res);
        vmem_remove_mapping(seg->start_addr, seg->end - seg->start_addr + 1);
        list_del(&seg->list);
        /*
         * Workaround for z/VM issue, where calling the DCSS unload diag on
         * a non-IPL CPU would cause bogus sclp maximum memory detection on
         * next IPL.
         * IPL CPU 0 cannot be set offline, so the dcss_diag() call can
         * directly be scheduled to that CPU.
         */
        smp_call_function_single(0, __dcss_diag_purge_on_cpu_0, seg, 1);
        kfree(seg);
out_unlock:
        mutex_unlock(&dcss_lock);
}

/*
 * save segment content permanently
 */
void
segment_save(char *name)
{
        struct dcss_segment *seg;
        char cmd1[160];
        char cmd2[80];
        int i, response;

        if (!machine_is_vm())
                return;

        mutex_lock(&dcss_lock);
        seg = segment_by_name (name);

        if (seg == NULL) {
                pr_err("Saving unknown DCSS %s failed\n", name);
                goto out;
        }

        snprintf(cmd1, sizeof(cmd1), "DEFSEG %s", name);
        for (i=0; i<seg->segcnt; i++) {
                size_t len = strlen(cmd1);

                snprintf(cmd1 + len, sizeof(cmd1) - len, " %lX-%lX %s",
                         seg->range[i].start >> PAGE_SHIFT,
                         seg->range[i].end >> PAGE_SHIFT,
                         segtype_string[seg->range[i].start & 0xff]);
        }
        snprintf(cmd2, sizeof(cmd2), "SAVESEG %s", name);
        response = 0;
        cpcmd(cmd1, NULL, 0, &response);
        if (response) {
                pr_err("Saving a DCSS failed with DEFSEG response code "
                       "%i\n", response);
                goto out;
        }
        cpcmd(cmd2, NULL, 0, &response);
        if (response) {
                pr_err("Saving a DCSS failed with SAVESEG response code "
                       "%i\n", response);
                goto out;
        }
out:
        mutex_unlock(&dcss_lock);
}

/*
 * print appropriate error message for segment_load()/segment_type()
 * return code
 */
void segment_warning(int rc, char *seg_name)
{
        switch (rc) {
        case -ENOENT:
                pr_err("DCSS %s cannot be loaded or queried\n", seg_name);
                break;
        case -ENOSYS:
                pr_err("DCSS %s cannot be loaded or queried without "
                       "z/VM\n", seg_name);
                break;
        case -EIO:
                pr_err("Loading or querying DCSS %s resulted in a "
                       "hardware error\n", seg_name);
                break;
        case -EOPNOTSUPP:
                pr_err("DCSS %s has multiple page ranges and cannot be "
                       "loaded or queried\n", seg_name);
                break;
        case -EBUSY:
                pr_err("%s needs used memory resources and cannot be "
                       "loaded or queried\n", seg_name);
                break;
        case -EPERM:
                pr_err("DCSS %s is already loaded in a different access "
                       "mode\n", seg_name);
                break;
        case -ENOMEM:
                pr_err("There is not enough memory to load or query "
                       "DCSS %s\n", seg_name);
                break;
        case -ERANGE: {
                struct range mhp_range = arch_get_mappable_range();

                pr_err("DCSS %s exceeds the kernel mapping range (%llu) "
                       "and cannot be loaded\n", seg_name, mhp_range.end + 1);
                break;
        }
        default:
                break;
        }
}

EXPORT_SYMBOL(segment_load);
EXPORT_SYMBOL(segment_unload);
EXPORT_SYMBOL(segment_save);
EXPORT_SYMBOL(segment_type);
EXPORT_SYMBOL(segment_modify_shared);
EXPORT_SYMBOL(segment_warning);