Release 4.14 arch/s390/include/asm/cpacf.h

/* SPDX-License-Identifier: GPL-2.0 */
/*
 * CP Assist for Cryptographic Functions (CPACF)
 *
 * Copyright IBM Corp. 2003, 2016
 * Author(s): Thomas Spatzier
 *            Jan Glauber
 *            Harald Freudenberger (freude@de.ibm.com)
 *            Martin Schwidefsky <schwidefsky@de.ibm.com>
 */
#ifndef _ASM_S390_CPACF_H

#define _ASM_S390_CPACF_H

#include <asm/facility.h>

/*
 * Instruction opcodes for the CPACF instructions
 */

#define CPACF_KMAC		0xb91e		
/* MSA  */

#define CPACF_KM		0xb92e		
/* MSA  */

#define CPACF_KMC		0xb92f		
/* MSA  */

#define CPACF_KIMD		0xb93e		
/* MSA  */

#define CPACF_KLMD		0xb93f		
/* MSA  */

#define CPACF_PCKMO		0xb928		
/* MSA3 */

#define CPACF_KMF		0xb92a		
/* MSA4 */

#define CPACF_KMO		0xb92b		
/* MSA4 */

#define CPACF_PCC		0xb92c		
/* MSA4 */

#define CPACF_KMCTR		0xb92d		
/* MSA4 */

#define CPACF_PRNO		0xb93c		
/* MSA5 */

#define CPACF_KMA		0xb929		
/* MSA8 */

/*
 * En/decryption modifier bits
 */

#define CPACF_ENCRYPT		0x00

#define CPACF_DECRYPT		0x80

/*
 * Function codes for the KM (CIPHER MESSAGE) instruction
 */

#define CPACF_KM_QUERY		0x00

#define CPACF_KM_DEA		0x01

#define CPACF_KM_TDEA_128	0x02

#define CPACF_KM_TDEA_192	0x03

#define CPACF_KM_AES_128	0x12

#define CPACF_KM_AES_192	0x13

#define CPACF_KM_AES_256	0x14

#define CPACF_KM_PAES_128	0x1a

#define CPACF_KM_PAES_192	0x1b

#define CPACF_KM_PAES_256	0x1c

#define CPACF_KM_XTS_128	0x32

#define CPACF_KM_XTS_256	0x34

#define CPACF_KM_PXTS_128	0x3a

#define CPACF_KM_PXTS_256	0x3c

/*
 * Function codes for the KMC (CIPHER MESSAGE WITH CHAINING)
 * instruction
 */

#define CPACF_KMC_QUERY		0x00

#define CPACF_KMC_DEA		0x01

#define CPACF_KMC_TDEA_128	0x02

#define CPACF_KMC_TDEA_192	0x03

#define CPACF_KMC_AES_128	0x12

#define CPACF_KMC_AES_192	0x13

#define CPACF_KMC_AES_256	0x14

#define CPACF_KMC_PAES_128	0x1a

#define CPACF_KMC_PAES_192	0x1b

#define CPACF_KMC_PAES_256	0x1c

#define CPACF_KMC_PRNG		0x43

/*
 * Function codes for the KMCTR (CIPHER MESSAGE WITH COUNTER)
 * instruction
 */

#define CPACF_KMCTR_QUERY	0x00

#define CPACF_KMCTR_DEA		0x01

#define CPACF_KMCTR_TDEA_128	0x02

#define CPACF_KMCTR_TDEA_192	0x03

#define CPACF_KMCTR_AES_128	0x12

#define CPACF_KMCTR_AES_192	0x13

#define CPACF_KMCTR_AES_256	0x14

#define CPACF_KMCTR_PAES_128	0x1a

#define CPACF_KMCTR_PAES_192	0x1b

#define CPACF_KMCTR_PAES_256	0x1c

/*
 * Function codes for the KIMD (COMPUTE INTERMEDIATE MESSAGE DIGEST)
 * instruction
 */

#define CPACF_KIMD_QUERY	0x00

#define CPACF_KIMD_SHA_1	0x01

#define CPACF_KIMD_SHA_256	0x02

#define CPACF_KIMD_SHA_512	0x03

#define CPACF_KIMD_GHASH	0x41

/*
 * Function codes for the KLMD (COMPUTE LAST MESSAGE DIGEST)
 * instruction
 */

#define CPACF_KLMD_QUERY	0x00

#define CPACF_KLMD_SHA_1	0x01

#define CPACF_KLMD_SHA_256	0x02

#define CPACF_KLMD_SHA_512	0x03

/*
 * function codes for the KMAC (COMPUTE MESSAGE AUTHENTICATION CODE)
 * instruction
 */

#define CPACF_KMAC_QUERY	0x00

#define CPACF_KMAC_DEA		0x01

#define CPACF_KMAC_TDEA_128	0x02

#define CPACF_KMAC_TDEA_192	0x03

/*
 * Function codes for the PCKMO (PERFORM CRYPTOGRAPHIC KEY MANAGEMENT)
 * instruction
 */

#define CPACF_PCKMO_QUERY		0x00

#define CPACF_PCKMO_ENC_DES_KEY		0x01

#define CPACF_PCKMO_ENC_TDES_128_KEY	0x02

#define CPACF_PCKMO_ENC_TDES_192_KEY	0x03

#define CPACF_PCKMO_ENC_AES_128_KEY	0x12

#define CPACF_PCKMO_ENC_AES_192_KEY	0x13

#define CPACF_PCKMO_ENC_AES_256_KEY	0x14

/*
 * Function codes for the PRNO (PERFORM RANDOM NUMBER OPERATION)
 * instruction
 */

#define CPACF_PRNO_QUERY		0x00

#define CPACF_PRNO_SHA512_DRNG_GEN	0x03

#define CPACF_PRNO_SHA512_DRNG_SEED	0x83

#define CPACF_PRNO_TRNG_Q_R2C_RATIO	0x70

#define CPACF_PRNO_TRNG			0x72



typedef struct { unsigned char bytes[16]; } cpacf_mask_t;

/**
 * cpacf_query() - check if a specific CPACF function is available
 * @opcode: the opcode of the crypto instruction
 * @func: the function code to test for
 *
 * Executes the query function for the given crypto instruction @opcode
 * and checks if @func is available
 *
 * Returns 1 if @func is available for @opcode, 0 otherwise
 */


static inline void __cpacf_query(unsigned int opcode, cpacf_mask_t *mask)
{
	register unsigned long r0 asm("0") = 0;	/* query function */
	register unsigned long r1 asm("1") = (unsigned long) mask;

	asm volatile(
                "       spm 0\n" /* pckmo doesn't change the cc */
		/* Parameter regs are ignored, but must be nonzero and unique */
		"0:     .insn   rrf,%[opc] << 16,2,4,6,0\n"
                "       brc     1,0b\n"	/* handle partial completion */
		: "=m" (*mask)
                : [fc] "d" (r0), [pba] "a" (r1), [opc] "i" (opcode)
                : "cc");
}

Contributors
Person
Tokens
Prop
Commits
CommitProp
Martin Schwidefsky
46
92.00%
2
50.00%
Jason J. Herne
2
4.00%
1
25.00%
David Hildenbrand
2
4.00%
1
25.00%
Total
50
100.00%
4
100.00%



static inline int __cpacf_check_opcode(unsigned int opcode)
{
	switch (opcode) {
	case CPACF_KMAC:
	case CPACF_KM:
	case CPACF_KMC:
	case CPACF_KIMD:
	case CPACF_KLMD:
		return test_facility(17);	/* check for MSA */
	case CPACF_PCKMO:
		return test_facility(76);	/* check for MSA3 */
	case CPACF_KMF:
	case CPACF_KMO:
	case CPACF_PCC:
	case CPACF_KMCTR:
		return test_facility(77);	/* check for MSA4 */
	case CPACF_PRNO:
		return test_facility(57);	/* check for MSA5 */
	default:
		BUG();
	}
}

Contributors
Person
Tokens
Prop
Commits
CommitProp
Martin Schwidefsky
67
81.71%
2
50.00%
David Hildenbrand
14
17.07%
1
25.00%
Harald Freudenberger
1
1.22%
1
25.00%
Total
82
100.00%
4
100.00%



static inline int cpacf_query(unsigned int opcode, cpacf_mask_t *mask)
{
	if (__cpacf_check_opcode(opcode)) {
		__cpacf_query(opcode, mask);
		return 1;
	}
	memset(mask, 0, sizeof(*mask));
	return 0;
}

Contributors
Person
Tokens
Prop
Commits
CommitProp
Martin Schwidefsky
50
100.00%
2
100.00%
Total
50
100.00%
2
100.00%



static inline int cpacf_test_func(cpacf_mask_t *mask, unsigned int func)
{
	return (mask->bytes[func >> 3] & (0x80 >> (func & 7))) != 0;
}

Contributors
Person
Tokens
Prop
Commits
CommitProp
Martin Schwidefsky
39
100.00%
2
100.00%
Total
39
100.00%
2
100.00%



static inline int cpacf_query_func(unsigned int opcode, unsigned int func)
{
	cpacf_mask_t mask;

	if (cpacf_query(opcode, &mask))
		return cpacf_test_func(&mask, func);
	return 0;
}

Contributors
Person
Tokens
Prop
Commits
CommitProp
Martin Schwidefsky
40
100.00%
1
100.00%
Total
40
100.00%
1
100.00%

/**
 * cpacf_km() - executes the KM (CIPHER MESSAGE) instruction
 * @func: the function code passed to KM; see CPACF_KM_xxx defines
 * @param: address of parameter block; see POP for details on each func
 * @dest: address of destination memory area
 * @src: address of source memory area
 * @src_len: length of src operand in bytes
 *
 * Returns 0 for the query func, number of processed bytes for
 * encryption/decryption funcs
 */


static inline int cpacf_km(unsigned long func, void *param,
			   u8 *dest, const u8 *src, long src_len)
{
	register unsigned long r0 asm("0") = (unsigned long) func;
	register unsigned long r1 asm("1") = (unsigned long) param;
	register unsigned long r2 asm("2") = (unsigned long) src;
	register unsigned long r3 asm("3") = (unsigned long) src_len;
	register unsigned long r4 asm("4") = (unsigned long) dest;

	asm volatile(
                "0:     .insn   rre,%[opc] << 16,%[dst],%[src]\n"
                "       brc     1,0b\n" /* handle partial completion */
		: [src] "+a" (r2), [len] "+d" (r3), [dst] "+a" (r4)
                : [fc] "d" (r0), [pba] "a" (r1), [opc] "i" (CPACF_KM)
                : "cc", "memory");

	return src_len - r3;
}

Contributors
Person
Tokens
Prop
Commits
CommitProp
Martin Schwidefsky
112
100.00%
2
100.00%
Total
112
100.00%
2
100.00%

/**
 * cpacf_kmc() - executes the KMC (CIPHER MESSAGE WITH CHAINING) instruction
 * @func: the function code passed to KM; see CPACF_KMC_xxx defines
 * @param: address of parameter block; see POP for details on each func
 * @dest: address of destination memory area
 * @src: address of source memory area
 * @src_len: length of src operand in bytes
 *
 * Returns 0 for the query func, number of processed bytes for
 * encryption/decryption funcs
 */


static inline int cpacf_kmc(unsigned long func, void *param,
			    u8 *dest, const u8 *src, long src_len)
{
	register unsigned long r0 asm("0") = (unsigned long) func;
	register unsigned long r1 asm("1") = (unsigned long) param;
	register unsigned long r2 asm("2") = (unsigned long) src;
	register unsigned long r3 asm("3") = (unsigned long) src_len;
	register unsigned long r4 asm("4") = (unsigned long) dest;

	asm volatile(
                "0:     .insn   rre,%[opc] << 16,%[dst],%[src]\n"
                "       brc     1,0b\n" /* handle partial completion */
		: [src] "+a" (r2), [len] "+d" (r3), [dst] "+a" (r4)
                : [fc] "d" (r0), [pba] "a" (r1), [opc] "i" (CPACF_KMC)
                : "cc", "memory");

	return src_len - r3;
}

Contributors
Person
Tokens
Prop
Commits
CommitProp
Martin Schwidefsky
112
100.00%
2
100.00%
Total
112
100.00%
2
100.00%

/**
 * cpacf_kimd() - executes the KIMD (COMPUTE INTERMEDIATE MESSAGE DIGEST)
 *                instruction
 * @func: the function code passed to KM; see CPACF_KIMD_xxx defines
 * @param: address of parameter block; see POP for details on each func
 * @src: address of source memory area
 * @src_len: length of src operand in bytes
 */


static inline void cpacf_kimd(unsigned long func, void *param,
			      const u8 *src, long src_len)
{
	register unsigned long r0 asm("0") = (unsigned long) func;
	register unsigned long r1 asm("1") = (unsigned long) param;
	register unsigned long r2 asm("2") = (unsigned long) src;
	register unsigned long r3 asm("3") = (unsigned long) src_len;

	asm volatile(
                "0:     .insn   rre,%[opc] << 16,0,%[src]\n"
                "       brc     1,0b\n" /* handle partial completion */
		: [src] "+a" (r2), [len] "+d" (r3)
                : [fc] "d" (r0), [pba] "a" (r1), [opc] "i" (CPACF_KIMD)
                : "cc", "memory");
}

Contributors
Person
Tokens
Prop
Commits
CommitProp
Martin Schwidefsky
88
100.00%
3
100.00%
Total
88
100.00%
3
100.00%

/**
 * cpacf_klmd() - executes the KLMD (COMPUTE LAST MESSAGE DIGEST) instruction
 * @func: the function code passed to KM; see CPACF_KLMD_xxx defines
 * @param: address of parameter block; see POP for details on each func
 * @src: address of source memory area
 * @src_len: length of src operand in bytes
 */


static inline void cpacf_klmd(unsigned long func, void *param,
			      const u8 *src, long src_len)
{
	register unsigned long r0 asm("0") = (unsigned long) func;
	register unsigned long r1 asm("1") = (unsigned long) param;
	register unsigned long r2 asm("2") = (unsigned long) src;
	register unsigned long r3 asm("3") = (unsigned long) src_len;

	asm volatile(
                "0:     .insn   rre,%[opc] << 16,0,%[src]\n"
                "       brc     1,0b\n" /* handle partial completion */
		: [src] "+a" (r2), [len] "+d" (r3)
                : [fc] "d" (r0), [pba] "a" (r1), [opc] "i" (CPACF_KLMD)
                : "cc", "memory");
}

Contributors
Person
Tokens
Prop
Commits
CommitProp
Martin Schwidefsky
88
100.00%
3
100.00%
Total
88
100.00%
3
100.00%

/**
 * cpacf_kmac() - executes the KMAC (COMPUTE MESSAGE AUTHENTICATION CODE)
 *                instruction
 * @func: the function code passed to KM; see CPACF_KMAC_xxx defines
 * @param: address of parameter block; see POP for details on each func
 * @src: address of source memory area
 * @src_len: length of src operand in bytes
 *
 * Returns 0 for the query func, number of processed bytes for digest funcs
 */


static inline int cpacf_kmac(unsigned long func, void *param,
			     const u8 *src, long src_len)
{
	register unsigned long r0 asm("0") = (unsigned long) func;
	register unsigned long r1 asm("1") = (unsigned long) param;
	register unsigned long r2 asm("2") = (unsigned long) src;
	register unsigned long r3 asm("3") = (unsigned long) src_len;

	asm volatile(
                "0:     .insn   rre,%[opc] << 16,0,%[src]\n"
                "       brc     1,0b\n" /* handle partial completion */
		: [src] "+a" (r2), [len] "+d" (r3)
                : [fc] "d" (r0), [pba] "a" (r1), [opc] "i" (CPACF_KMAC)
                : "cc", "memory");

	return src_len - r3;
}

Contributors
Person
Tokens
Prop
Commits
CommitProp
Martin Schwidefsky
93
100.00%
2
100.00%
Total
93
100.00%
2
100.00%

/**
 * cpacf_kmctr() - executes the KMCTR (CIPHER MESSAGE WITH COUNTER) instruction
 * @func: the function code passed to KMCTR; see CPACF_KMCTR_xxx defines
 * @param: address of parameter block; see POP for details on each func
 * @dest: address of destination memory area
 * @src: address of source memory area
 * @src_len: length of src operand in bytes
 * @counter: address of counter value
 *
 * Returns 0 for the query func, number of processed bytes for
 * encryption/decryption funcs
 */


static inline int cpacf_kmctr(unsigned long func, void *param, u8 *dest,
			      const u8 *src, long src_len, u8 *counter)
{
	register unsigned long r0 asm("0") = (unsigned long) func;
	register unsigned long r1 asm("1") = (unsigned long) param;
	register unsigned long r2 asm("2") = (unsigned long) src;
	register unsigned long r3 asm("3") = (unsigned long) src_len;
	register unsigned long r4 asm("4") = (unsigned long) dest;
	register unsigned long r6 asm("6") = (unsigned long) counter;

	asm volatile(
                "0:     .insn   rrf,%[opc] << 16,%[dst],%[src],%[ctr],0\n"
                "       brc     1,0b\n" /* handle partial completion */
		: [src] "+a" (r2), [len] "+d" (r3),
                  [dst] "+a" (r4), [ctr] "+a" (r6)
                : [fc] "d" (r0), [pba] "a" (r1), [opc] "i" (CPACF_KMCTR)
                : "cc", "memory");

	return src_len - r3;
}

Contributors
Person
Tokens
Prop
Commits
CommitProp
Martin Schwidefsky
131
100.00%
2
100.00%
Total
131
100.00%
2
100.00%

/**
 * cpacf_prno() - executes the PRNO (PERFORM RANDOM NUMBER OPERATION)
 *                instruction
 * @func: the function code passed to PRNO; see CPACF_PRNO_xxx defines
 * @param: address of parameter block; see POP for details on each func
 * @dest: address of destination memory area
 * @dest_len: size of destination memory area in bytes
 * @seed: address of seed data
 * @seed_len: size of seed data in bytes
 */


static inline void cpacf_prno(unsigned long func, void *param,
			      u8 *dest, unsigned long dest_len,
			      const u8 *seed, unsigned long seed_len)
{
	register unsigned long r0 asm("0") = (unsigned long) func;
	register unsigned long r1 asm("1") = (unsigned long) param;
	register unsigned long r2 asm("2") = (unsigned long) dest;
	register unsigned long r3 asm("3") = (unsigned long) dest_len;
	register unsigned long r4 asm("4") = (unsigned long) seed;
	register unsigned long r5 asm("5") = (unsigned long) seed_len;

	asm volatile (
                "0:     .insn   rre,%[opc] << 16,%[dst],%[seed]\n"
                "       brc     1,0b\n"	  /* handle partial completion */
		: [dst] "+a" (r2), [dlen] "+d" (r3)
                : [fc] "d" (r0), [pba] "a" (r1),
                  [seed] "a" (r4), [slen] "d" (r5), [opc] "i" (CPACF_PRNO)
                : "cc", "memory");
}

Contributors
Person
Tokens
Prop
Commits
CommitProp
Martin Schwidefsky
123
96.85%
3
60.00%
Harald Freudenberger
4
3.15%
2
40.00%
Total
127
100.00%
5
100.00%

/**
 * cpacf_trng() - executes the TRNG subfunction of the PRNO instruction
 * @ucbuf: buffer for unconditioned data
 * @ucbuf_len: amount of unconditioned data to fetch in bytes
 * @cbuf: buffer for conditioned data
 * @cbuf_len: amount of conditioned data to fetch in bytes
 */


static inline void cpacf_trng(u8 *ucbuf, unsigned long ucbuf_len,
			      u8 *cbuf, unsigned long cbuf_len)
{
	register unsigned long r0 asm("0") = (unsigned long) CPACF_PRNO_TRNG;
	register unsigned long r2 asm("2") = (unsigned long) ucbuf;
	register unsigned long r3 asm("3") = (unsigned long) ucbuf_len;
	register unsigned long r4 asm("4") = (unsigned long) cbuf;
	register unsigned long r5 asm("5") = (unsigned long) cbuf_len;

	asm volatile (
                "0:     .insn   rre,%[opc] << 16,%[ucbuf],%[cbuf]\n"
                "       brc     1,0b\n"	  /* handle partial completion */
		: [ucbuf] "+a" (r2), [ucbuflen] "+d" (r3),
                  [cbuf] "+a" (r4), [cbuflen] "+d" (r5)
                : [fc] "d" (r0), [opc] "i" (CPACF_PRNO)
                : "cc", "memory");
}

Contributors
Person
Tokens
Prop
Commits
CommitProp
Harald Freudenberger
103
100.00%
1
100.00%
Total
103
100.00%
1
100.00%

/**
 * cpacf_pcc() - executes the PCC (PERFORM CRYPTOGRAPHIC COMPUTATION)
 *               instruction
 * @func: the function code passed to PCC; see CPACF_KM_xxx defines
 * @param: address of parameter block; see POP for details on each func
 */


static inline void cpacf_pcc(unsigned long func, void *param)
{
	register unsigned long r0 asm("0") = (unsigned long) func;
	register unsigned long r1 asm("1") = (unsigned long) param;

	asm volatile(
                "0:     .insn   rre,%[opc] << 16,0,0\n" /* PCC opcode */
		"       brc     1,0b\n" /* handle partial completion */
		:
                : [fc] "d" (r0), [pba] "a" (r1), [opc] "i" (CPACF_PCC)
                : "cc", "memory");
}

Contributors
Person
Tokens
Prop
Commits
CommitProp
Martin Schwidefsky
52
100.00%
3
100.00%
Total
52
100.00%
3
100.00%

/**
 * cpacf_pckmo() - executes the PCKMO (PERFORM CRYPTOGRAPHIC KEY
 *                MANAGEMENT) instruction
 * @func: the function code passed to PCKMO; see CPACF_PCKMO_xxx defines
 * @param: address of parameter block; see POP for details on each func
 *
 * Returns 0.
 */


static inline void cpacf_pckmo(long func, void *param)
{
	register unsigned long r0 asm("0") = (unsigned long) func;
	register unsigned long r1 asm("1") = (unsigned long) param;

	asm volatile(
                "       .insn   rre,%[opc] << 16,0,0\n" /* PCKMO opcode */
		:
                : [fc] "d" (r0), [pba] "a" (r1), [opc] "i" (CPACF_PCKMO)
                : "cc", "memory");
}

Contributors
Person
Tokens
Prop
Commits
CommitProp
Harald Freudenberger
49
100.00%
1
100.00%
Total
49
100.00%
1
100.00%

#endif	/* _ASM_S390_CPACF_H */
Overall Contributors
Person
Tokens
Prop
Commits
CommitProp
Martin Schwidefsky
1331
84.67%
5
41.67%
Harald Freudenberger
202
12.85%
3
25.00%
David Hildenbrand
31
1.97%
1
8.33%
Jason J. Herne
7
0.45%
2
16.67%
Greg Kroah-Hartman
1
0.06%
1
8.33%
Total
1572
100.00%
12
100.00%
Directory: arch/s390/include/asm

Information contained on this website is for historical information purposes only and does not indicate or represent copyright ownership.