/* * SN Platform GRU Driver * * GRU DRIVER TABLES, MACROS, externs, etc * * Copyright (c) 2008 Silicon Graphics, Inc. All Rights Reserved. * * This program is free software; you can redistribute it and/or modify * it under the terms of the GNU General Public License as published by * the Free Software Foundation; either version 2 of the License, or * (at your option) any later version. * * This program is distributed in the hope that it will be useful, * but WITHOUT ANY WARRANTY; without even the implied warranty of * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the * GNU General Public License for more details. * * You should have received a copy of the GNU General Public License * along with this program; if not, write to the Free Software * Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA */ #ifndef __GRUTABLES_H__ #define __GRUTABLES_H__ /* * GRU Chiplet: * The GRU is a user addressible memory accelerator. It provides * several forms of load, store, memset, bcopy instructions. In addition, it * contains special instructions for AMOs, sending messages to message * queues, etc. * * The GRU is an integral part of the node controller. It connects * directly to the cpu socket. In its current implementation, there are 2 * GRU chiplets in the node controller on each blade (~node). * * The entire GRU memory space is fully coherent and cacheable by the cpus. * * Each GRU chiplet has a physical memory map that looks like the following: * * +-----------------+ * |/////////////////| * |/////////////////| * |/////////////////| * |/////////////////| * |/////////////////| * |/////////////////| * |/////////////////| * |/////////////////| * +-----------------+ * | system control | * +-----------------+ _______ +-------------+ * |/////////////////| / | | * |/////////////////| / | | * |/////////////////| / | instructions| * |/////////////////| / | | * |/////////////////| / | | * |/////////////////| / |-------------| * |/////////////////| / | | * +-----------------+ | | * | context 15 | | data | * +-----------------+ | | * | ...... | \ | | * +-----------------+ \____________ +-------------+ * | context 1 | * +-----------------+ * | context 0 | * +-----------------+ * * Each of the "contexts" is a chunk of memory that can be mmaped into user * space. The context consists of 2 parts: * * - an instruction space that can be directly accessed by the user * to issue GRU instructions and to check instruction status. * * - a data area that acts as normal RAM. * * User instructions contain virtual addresses of data to be accessed by the * GRU. The GRU contains a TLB that is used to convert these user virtual * addresses to physical addresses. * * The "system control" area of the GRU chiplet is used by the kernel driver * to manage user contexts and to perform functions such as TLB dropin and * purging. * * One context may be reserved for the kernel and used for cross-partition * communication. The GRU will also be used to asynchronously zero out * large blocks of memory (not currently implemented). * * * Tables: * * VDATA-VMA Data - Holds a few parameters. Head of linked list of * GTS tables for threads using the GSEG * GTS - Gru Thread State - contains info for managing a GSEG context. A * GTS is allocated for each thread accessing a * GSEG. * GTD - GRU Thread Data - contains shadow copy of GRU data when GSEG is * not loaded into a GRU * GMS - GRU Memory Struct - Used to manage TLB shootdowns. Tracks GRUs * where a GSEG has been loaded. Similar to * an mm_struct but for GRU. * * GS - GRU State - Used to manage the state of a GRU chiplet * BS - Blade State - Used to manage state of all GRU chiplets * on a blade * * * Normal task tables for task using GRU. * - 2 threads in process * - 2 GSEGs open in process * - GSEG1 is being used by both threads * - GSEG2 is used only by thread 2 * * task -->| * task ---+---> mm ->------ (notifier) -------+-> gms * | | * |--> vma -> vdata ---> gts--->| GSEG1 (thread1) * | | | * | +-> gts--->| GSEG1 (thread2) * | | * |--> vma -> vdata ---> gts--->| GSEG2 (thread2) * . * . * * GSEGs are marked DONTCOPY on fork * * At open * file.private_data -> NULL * * At mmap, * vma -> vdata * * After gseg reference * vma -> vdata ->gts * * After fork * parent * vma -> vdata -> gts * child * (vma is not copied) * */ #include <linux/rmap.h> #include <linux/interrupt.h> #include <linux/mutex.h> #include <linux/wait.h> #include <linux/mmu_notifier.h> #include "gru.h" #include "grulib.h" #include "gruhandles.h" extern struct gru_stats_s gru_stats; extern struct gru_blade_state *gru_base[]; extern unsigned long gru_start_paddr, gru_end_paddr; extern void *gru_start_vaddr; extern unsigned int gru_max_gids; #define GRU_MAX_BLADES MAX_NUMNODES #define GRU_MAX_GRUS (GRU_MAX_BLADES * GRU_CHIPLETS_PER_BLADE) #define GRU_DRIVER_ID_STR "SGI GRU Device Driver" #define GRU_DRIVER_VERSION_STR "0.85" /* * GRU statistics. */ struct gru_stats_s { atomic_long_t vdata_alloc; atomic_long_t vdata_free; atomic_long_t gts_alloc; atomic_long_t gts_free; atomic_long_t gms_alloc; atomic_long_t gms_free; atomic_long_t gts_double_allocate; atomic_long_t assign_context; atomic_long_t assign_context_failed; atomic_long_t free_context; atomic_long_t load_user_context; atomic_long_t load_kernel_context; atomic_long_t lock_kernel_context; atomic_long_t unlock_kernel_context; atomic_long_t steal_user_context; atomic_long_t steal_kernel_context; atomic_long_t steal_context_failed; atomic_long_t nopfn; atomic_long_t asid_new; atomic_long_t asid_next; atomic_long_t asid_wrap; atomic_long_t asid_reuse; atomic_long_t intr; atomic_long_t intr_cbr; atomic_long_t intr_tfh; atomic_long_t intr_spurious; atomic_long_t intr_mm_lock_failed; atomic_long_t call_os; atomic_long_t call_os_wait_queue; atomic_long_t user_flush_tlb; atomic_long_t user_unload_context; atomic_long_t user_exception; atomic_long_t set_context_option; atomic_long_t check_context_retarget_intr; atomic_long_t check_context_unload; atomic_long_t tlb_dropin; atomic_long_t tlb_preload_page; atomic_long_t tlb_dropin_fail_no_asid; atomic_long_t tlb_dropin_fail_upm; atomic_long_t tlb_dropin_fail_invalid; atomic_long_t tlb_dropin_fail_range_active; atomic_long_t tlb_dropin_fail_idle; atomic_long_t tlb_dropin_fail_fmm; atomic_long_t tlb_dropin_fail_no_exception; atomic_long_t tfh_stale_on_fault; atomic_long_t mmu_invalidate_range; atomic_long_t mmu_invalidate_page; atomic_long_t flush_tlb; atomic_long_t flush_tlb_gru; atomic_long_t flush_tlb_gru_tgh; atomic_long_t flush_tlb_gru_zero_asid; atomic_long_t copy_gpa; atomic_long_t read_gpa; atomic_long_t mesq_receive; atomic_long_t mesq_receive_none; atomic_long_t mesq_send; atomic_long_t mesq_send_failed; atomic_long_t mesq_noop; atomic_long_t mesq_send_unexpected_error; atomic_long_t mesq_send_lb_overflow; atomic_long_t mesq_send_qlimit_reached; atomic_long_t mesq_send_amo_nacked; atomic_long_t mesq_send_put_nacked; atomic_long_t mesq_page_overflow; atomic_long_t mesq_qf_locked; atomic_long_t mesq_qf_noop_not_full; atomic_long_t mesq_qf_switch_head_failed; atomic_long_t mesq_qf_unexpected_error; atomic_long_t mesq_noop_unexpected_error; atomic_long_t mesq_noop_lb_overflow; atomic_long_t mesq_noop_qlimit_reached; atomic_long_t mesq_noop_amo_nacked; atomic_long_t mesq_noop_put_nacked; atomic_long_t mesq_noop_page_overflow; }; enum mcs_op {cchop_allocate, cchop_start, cchop_interrupt, cchop_interrupt_sync, cchop_deallocate, tfhop_write_only, tfhop_write_restart, tghop_invalidate, mcsop_last}; struct mcs_op_statistic { atomic_long_t count; atomic_long_t total; unsigned long max; }; extern struct mcs_op_statistic mcs_op_statistics[mcsop_last]; #define OPT_DPRINT 1 #define OPT_STATS 2 #define IRQ_GRU 110 /* Starting IRQ number for interrupts */ /* Delay in jiffies between attempts to assign a GRU context */ #define GRU_ASSIGN_DELAY ((HZ * 20) / 1000) /* * If a process has it's context stolen, min delay in jiffies before trying to * steal a context from another process. */ #define GRU_STEAL_DELAY ((HZ * 200) / 1000) #define STAT(id) do { \ if (gru_options & OPT_STATS) \ atomic_long_inc(&gru_stats.id); \ } while (0) #ifdef CONFIG_SGI_GRU_DEBUG #define gru_dbg(dev, fmt, x...) \ do { \ if (gru_options & OPT_DPRINT) \ printk(KERN_DEBUG "GRU:%d %s: " fmt, smp_processor_id(), __func__, x);\ } while (0) #else #define gru_dbg(x...) #endif /*----------------------------------------------------------------------------- * ASID management */ #define MAX_ASID 0xfffff0 #define MIN_ASID 8 #define ASID_INC 8 /* number of regions */ /* Generate a GRU asid value from a GRU base asid & a virtual address. */ #define VADDR_HI_BIT 64 #define GRUREGION(addr) ((addr) >> (VADDR_HI_BIT - 3) & 3) #define GRUASID(asid, addr) ((asid) + GRUREGION(addr)) /*------------------------------------------------------------------------------ * File & VMS Tables */ struct gru_state; /* * This structure is pointed to from the mmstruct via the notifier pointer. * There is one of these per address space. */ struct gru_mm_tracker { /* pack to reduce size */ unsigned int mt_asid_gen:24; /* ASID wrap count */ unsigned int mt_asid:24; /* current base ASID for gru */ unsigned short mt_ctxbitmap:16;/* bitmap of contexts using asid */ } __attribute__ ((packed)); struct gru_mm_struct { struct mmu_notifier ms_notifier; atomic_t ms_refcnt; spinlock_t ms_asid_lock; /* protects ASID assignment */ atomic_t ms_range_active;/* num range_invals active */ char ms_released; wait_queue_head_t ms_wait_queue; DECLARE_BITMAP(ms_asidmap, GRU_MAX_GRUS); struct gru_mm_tracker ms_asids[GRU_MAX_GRUS]; }; /* * One of these structures is allocated when a GSEG is mmaped. The * structure is pointed to by the vma->vm_private_data field in the vma struct. */ struct gru_vma_data { spinlock_t vd_lock; /* Serialize access to vma */ struct list_head vd_head; /* head of linked list of gts */ long vd_user_options;/* misc user option flags */ int vd_cbr_au_count; int vd_dsr_au_count; unsigned char vd_tlb_preload_count; }; /* * One of these is allocated for each thread accessing a mmaped GRU. A linked * list of these structure is hung off the struct gru_vma_data in the mm_struct. */ struct gru_thread_state { struct list_head ts_next; /* list - head at vma-private */ struct mutex ts_ctxlock; /* load/unload CTX lock */ struct mm_struct *ts_mm; /* mm currently mapped to context */ struct vm_area_struct *ts_vma; /* vma of GRU context */ struct gru_state *ts_gru; /* GRU where the context is loaded */ struct gru_mm_struct *ts_gms; /* asid & ioproc struct */ unsigned char ts_tlb_preload_count; /* TLB preload pages */ unsigned long ts_cbr_map; /* map of allocated CBRs */ unsigned long ts_dsr_map; /* map of allocated DATA resources */ unsigned long ts_steal_jiffies;/* jiffies when context last stolen */ long ts_user_options;/* misc user option flags */ pid_t ts_tgid_owner; /* task that is using the context - for migration */ short ts_user_blade_id;/* user selected blade */ char ts_user_chiplet_id;/* user selected chiplet */ unsigned short ts_sizeavail; /* Pagesizes in use */ int ts_tsid; /* thread that owns the structure */ int ts_tlb_int_select;/* target cpu if interrupts enabled */ int ts_ctxnum; /* context number where the context is loaded */ atomic_t ts_refcnt; /* reference count GTS */ unsigned char ts_dsr_au_count;/* Number of DSR resources required for contest */ unsigned char ts_cbr_au_count;/* Number of CBR resources required for contest */ char ts_cch_req_slice;/* CCH packet slice */ char ts_blade; /* If >= 0, migrate context if ref from different blade */ char ts_force_cch_reload; char ts_cbr_idx[GRU_CBR_AU];/* CBR numbers of each allocated CB */ int ts_data_valid; /* Indicates if ts_gdata has valid data */ struct gru_gseg_statistics ustats; /* User statistics */ unsigned long ts_gdata[0]; /* save area for GRU data (CB, DS, CBE) */ }; /* * Threaded programs actually allocate an array of GSEGs when a context is * created. Each thread uses a separate GSEG. TSID is the index into the GSEG * array. */ #define TSID(a, v) (((a) - (v)->vm_start) / GRU_GSEG_PAGESIZE) #define UGRUADDR(gts) ((gts)->ts_vma->vm_start + \ (gts)->ts_tsid * GRU_GSEG_PAGESIZE) #define NULLCTX (-1) /* if context not loaded into GRU */ /*----------------------------------------------------------------------------- * GRU State Tables */ /* * One of these exists for each GRU chiplet. */ struct gru_state { struct gru_blade_state *gs_blade; /* GRU state for entire blade */ unsigned long gs_gru_base_paddr; /* Physical address of gru segments (64) */ void *gs_gru_base_vaddr; /* Virtual address of gru segments (64) */ unsigned short gs_gid; /* unique GRU number */ unsigned short gs_blade_id; /* blade of GRU */ unsigned char gs_chiplet_id; /* blade chiplet of GRU */ unsigned char gs_tgh_local_shift; /* used to pick TGH for local flush */ unsigned char gs_tgh_first_remote; /* starting TGH# for remote flush */ spinlock_t gs_asid_lock; /* lock used for assigning asids */ spinlock_t gs_lock; /* lock used for assigning contexts */ /* -- the following are protected by the gs_asid_lock spinlock ---- */ unsigned int gs_asid; /* Next availe ASID */ unsigned int gs_asid_limit; /* Limit of available ASIDs */ unsigned int gs_asid_gen; /* asid generation. Inc on wrap */ /* --- the following fields are protected by the gs_lock spinlock --- */ unsigned long gs_context_map; /* bitmap to manage contexts in use */ unsigned long gs_cbr_map; /* bitmap to manage CB resources */ unsigned long gs_dsr_map; /* bitmap used to manage DATA resources */ unsigned int gs_reserved_cbrs; /* Number of kernel- reserved cbrs */ unsigned int gs_reserved_dsr_bytes; /* Bytes of kernel- reserved dsrs */ unsigned short gs_active_contexts; /* number of contexts in use */ struct gru_thread_state *gs_gts[GRU_NUM_CCH]; /* GTS currently using the context */ int gs_irq[GRU_NUM_TFM]; /* Interrupt irqs */ }; /* * This structure contains the GRU state for all the GRUs on a blade. */ struct gru_blade_state { void *kernel_cb; /* First kernel reserved cb */ void *kernel_dsr; /* First kernel reserved DSR */ struct rw_semaphore bs_kgts_sema; /* lock for kgts */ struct gru_thread_state *bs_kgts; /* GTS for kernel use */ /* ---- the following are used for managing kernel async GRU CBRs --- */ int bs_async_dsr_bytes; /* DSRs for async */ int bs_async_cbrs; /* CBRs AU for async */ struct completion *bs_async_wq; /* ---- the following are protected by the bs_lock spinlock ---- */ spinlock_t bs_lock; /* lock used for stealing contexts */ int bs_lru_ctxnum; /* STEAL - last context stolen */ struct gru_state *bs_lru_gru; /* STEAL - last gru stolen */ struct gru_state bs_grus[GRU_CHIPLETS_PER_BLADE]; }; /*----------------------------------------------------------------------------- * Address Primitives */ #define get_tfm_for_cpu(g, c) \ ((struct gru_tlb_fault_map *)get_tfm((g)->gs_gru_base_vaddr, (c))) #define get_tfh_by_index(g, i) \ ((struct gru_tlb_fault_handle *)get_tfh((g)->gs_gru_base_vaddr, (i))) #define get_tgh_by_index(g, i) \ ((struct gru_tlb_global_handle *)get_tgh((g)->gs_gru_base_vaddr, (i))) #define get_cbe_by_index(g, i) \ ((struct gru_control_block_extended *)get_cbe((g)->gs_gru_base_vaddr,\ (i))) /*----------------------------------------------------------------------------- * Useful Macros */ /* Given a blade# & chiplet#, get a pointer to the GRU */ #define get_gru(b, c) (&gru_base[b]->bs_grus[c]) /* Number of bytes to save/restore when unloading/loading GRU contexts */ #define DSR_BYTES(dsr) ((dsr) * GRU_DSR_AU_BYTES) #define CBR_BYTES(cbr) ((cbr) * GRU_HANDLE_BYTES * GRU_CBR_AU_SIZE * 2) /* Convert a user CB number to the actual CBRNUM */ #define thread_cbr_number(gts, n) ((gts)->ts_cbr_idx[(n) / GRU_CBR_AU_SIZE] \ * GRU_CBR_AU_SIZE + (n) % GRU_CBR_AU_SIZE) /* Convert a gid to a pointer to the GRU */ #define GID_TO_GRU(gid) \ (gru_base[(gid) / GRU_CHIPLETS_PER_BLADE] ? \ (&gru_base[(gid) / GRU_CHIPLETS_PER_BLADE]-> \ bs_grus[(gid) % GRU_CHIPLETS_PER_BLADE]) : \ NULL) /* Scan all active GRUs in a GRU bitmap */ #define for_each_gru_in_bitmap(gid, map) \ for_each_set_bit((gid), (map), GRU_MAX_GRUS) /* Scan all active GRUs on a specific blade */ #define for_each_gru_on_blade(gru, nid, i) \ for ((gru) = gru_base[nid]->bs_grus, (i) = 0; \ (i) < GRU_CHIPLETS_PER_BLADE; \ (i)++, (gru)++) /* Scan all GRUs */ #define foreach_gid(gid) \ for ((gid) = 0; (gid) < gru_max_gids; (gid)++) /* Scan all active GTSs on a gru. Note: must hold ss_lock to use this macro. */ #define for_each_gts_on_gru(gts, gru, ctxnum) \ for ((ctxnum) = 0; (ctxnum) < GRU_NUM_CCH; (ctxnum)++) \ if (((gts) = (gru)->gs_gts[ctxnum])) /* Scan each CBR whose bit is set in a TFM (or copy of) */ #define for_each_cbr_in_tfm(i, map) \ for_each_set_bit((i), (map), GRU_NUM_CBE) /* Scan each CBR in a CBR bitmap. Note: multiple CBRs in an allocation unit */ #define for_each_cbr_in_allocation_map(i, map, k) \ for_each_set_bit((k), (map), GRU_CBR_AU) \ for ((i) = (k)*GRU_CBR_AU_SIZE; \ (i) < ((k) + 1) * GRU_CBR_AU_SIZE; (i)++) /* Scan each DSR in a DSR bitmap. Note: multiple DSRs in an allocation unit */ #define for_each_dsr_in_allocation_map(i, map, k) \ for_each_set_bit((k), (const unsigned long *)(map), GRU_DSR_AU) \ for ((i) = (k) * GRU_DSR_AU_CL; \ (i) < ((k) + 1) * GRU_DSR_AU_CL; (i)++) #define gseg_physical_address(gru, ctxnum) \ ((gru)->gs_gru_base_paddr + ctxnum * GRU_GSEG_STRIDE) #define gseg_virtual_address(gru, ctxnum) \ ((gru)->gs_gru_base_vaddr + ctxnum * GRU_GSEG_STRIDE) /*----------------------------------------------------------------------------- * Lock / Unlock GRU handles * Use the "delresp" bit in the handle as a "lock" bit. */ /* Lock hierarchy checking enabled only in emulator */ /* 0 = lock failed, 1 = locked */ static inline int __trylock_handle(void *h) { return !test_and_set_bit(1, h); } static inline void __lock_handle(void *h) { while (test_and_set_bit(1, h)) cpu_relax(); } static inline void __unlock_handle(void *h) { clear_bit(1, h); } static inline int trylock_cch_handle(struct gru_context_configuration_handle *cch) { return __trylock_handle(cch); } static inline void lock_cch_handle(struct gru_context_configuration_handle *cch) { __lock_handle(cch); } static inline void unlock_cch_handle(struct gru_context_configuration_handle *cch) { __unlock_handle(cch); } static inline void lock_tgh_handle(struct gru_tlb_global_handle *tgh) { __lock_handle(tgh); } static inline void unlock_tgh_handle(struct gru_tlb_global_handle *tgh) { __unlock_handle(tgh); } static inline int is_kernel_context(struct gru_thread_state *gts) { return !gts->ts_mm; } /* * The following are for Nehelem-EX. A more general scheme is needed for * future processors. */ #define UV_MAX_INT_CORES 8 #define uv_cpu_socket_number(p) ((cpu_physical_id(p) >> 5) & 1) #define uv_cpu_ht_number(p) (cpu_physical_id(p) & 1) #define uv_cpu_core_number(p) (((cpu_physical_id(p) >> 2) & 4) | \ ((cpu_physical_id(p) >> 1) & 3)) /*----------------------------------------------------------------------------- * Function prototypes & externs */ struct gru_unload_context_req; extern const struct vm_operations_struct gru_vm_ops; extern struct device *grudev; extern struct gru_vma_data *gru_alloc_vma_data(struct vm_area_struct *vma, int tsid); extern struct gru_thread_state *gru_find_thread_state(struct vm_area_struct *vma, int tsid); extern struct gru_thread_state *gru_alloc_thread_state(struct vm_area_struct *vma, int tsid); extern struct gru_state *gru_assign_gru_context(struct gru_thread_state *gts); extern void gru_load_context(struct gru_thread_state *gts); extern void gru_steal_context(struct gru_thread_state *gts); extern void gru_unload_context(struct gru_thread_state *gts, int savestate); extern int gru_update_cch(struct gru_thread_state *gts); extern void gts_drop(struct gru_thread_state *gts); extern void gru_tgh_flush_init(struct gru_state *gru); extern int gru_kservices_init(void); extern void gru_kservices_exit(void); extern irqreturn_t gru0_intr(int irq, void *dev_id); extern irqreturn_t gru1_intr(int irq, void *dev_id); extern irqreturn_t gru_intr_mblade(int irq, void *dev_id); extern int gru_dump_chiplet_request(unsigned long arg); extern long gru_get_gseg_statistics(unsigned long arg); extern int gru_handle_user_call_os(unsigned long address); extern int gru_user_flush_tlb(unsigned long arg); extern int gru_user_unload_context(unsigned long arg); extern int gru_get_exception_detail(unsigned long arg); extern int gru_set_context_option(unsigned long address); extern void gru_check_context_placement(struct gru_thread_state *gts); extern int gru_cpu_fault_map_id(void); extern struct vm_area_struct *gru_find_vma(unsigned long vaddr); extern void gru_flush_all_tlb(struct gru_state *gru); extern int gru_proc_init(void); extern void gru_proc_exit(void); extern struct gru_thread_state *gru_alloc_gts(struct vm_area_struct *vma, int cbr_au_count, int dsr_au_count, unsigned char tlb_preload_count, int options, int tsid); extern unsigned long gru_reserve_cb_resources(struct gru_state *gru, int cbr_au_count, char *cbmap); extern unsigned long gru_reserve_ds_resources(struct gru_state *gru, int dsr_au_count, char *dsmap); extern int gru_fault(struct vm_area_struct *, struct vm_fault *vmf); extern struct gru_mm_struct *gru_register_mmu_notifier(void); extern void gru_drop_mmu_notifier(struct gru_mm_struct *gms); extern int gru_ktest(unsigned long arg); extern void gru_flush_tlb_range(struct gru_mm_struct *gms, unsigned long start, unsigned long len); extern unsigned long gru_options; #endif /* __GRUTABLES_H__ */