xref: /openbmc/linux/drivers/s390/cio/vfio_ccw_cp.h (revision 9a87ffc99ec8eb8d35eed7c4f816d75f5cc9662e)
1  /* SPDX-License-Identifier: GPL-2.0 */
2  /*
3   * channel program interfaces
4   *
5   * Copyright IBM Corp. 2017
6   *
7   * Author(s): Dong Jia Shi <bjsdjshi@linux.vnet.ibm.com>
8   *            Xiao Feng Ren <renxiaof@linux.vnet.ibm.com>
9   */
10  
11  #ifndef _VFIO_CCW_CP_H_
12  #define _VFIO_CCW_CP_H_
13  
14  #include <asm/cio.h>
15  #include <asm/scsw.h>
16  
17  #include "orb.h"
18  #include "vfio_ccw_trace.h"
19  
20  /*
21   * Max length for ccw chain.
22   * XXX: Limit to 256, need to check more?
23   */
24  #define CCWCHAIN_LEN_MAX	256
25  
26  /**
27   * struct channel_program - manage information for channel program
28   * @ccwchain_list: list head of ccwchains
29   * @orb: orb for the currently processed ssch request
30   * @initialized: whether this instance is actually initialized
31   *
32   * @ccwchain_list is the head of a ccwchain list, that contents the
33   * translated result of the guest channel program that pointed out by
34   * the iova parameter when calling cp_init.
35   */
36  struct channel_program {
37  	struct list_head ccwchain_list;
38  	union orb orb;
39  	bool initialized;
40  	struct ccw1 *guest_cp;
41  };
42  
43  int cp_init(struct channel_program *cp, union orb *orb);
44  void cp_free(struct channel_program *cp);
45  int cp_prefetch(struct channel_program *cp);
46  union orb *cp_get_orb(struct channel_program *cp, struct subchannel *sch);
47  void cp_update_scsw(struct channel_program *cp, union scsw *scsw);
48  bool cp_iova_pinned(struct channel_program *cp, u64 iova, u64 length);
49  
50  #endif
51