791 lines
37 KiB
Plaintext
791 lines
37 KiB
Plaintext
(*
|
|
* Copyright 2014, General Dynamics C4 Systems
|
|
* Copyright 2020, Data61, CSIRO (ABN 41 687 119 230)
|
|
*
|
|
* SPDX-License-Identifier: GPL-2.0-only
|
|
*)
|
|
|
|
theory Schedule_C
|
|
imports Tcb_C
|
|
begin
|
|
|
|
(*FIXME: arch_split: move up?*)
|
|
context Arch begin
|
|
context begin global_naming global
|
|
requalify_facts
|
|
Thread_H.switchToIdleThread_def
|
|
Thread_H.switchToThread_def
|
|
end
|
|
end
|
|
|
|
context kernel_m begin
|
|
|
|
lemma Arch_switchToIdleThread_ccorres:
|
|
"ccorres dc xfdc invs_no_cicd' UNIV []
|
|
Arch.switchToIdleThread (Call Arch_switchToIdleThread_'proc)"
|
|
apply (cinit simp: RISCV64_H.switchToIdleThread_def)
|
|
apply (rule ccorres_pre_getIdleThread)
|
|
apply (rule ccorres_symb_exec_r)
|
|
apply (ctac (no_vcg) add: setVMRoot_ccorres)
|
|
apply vcg
|
|
apply (rule conseqPre, vcg)
|
|
apply clarsimp
|
|
apply (clarsimp simp: invs_no_cicd'_def valid_pspace'_def valid_idle'_tcb_at'_ksIdleThread)
|
|
done
|
|
|
|
lemma switchToIdleThread_ccorres:
|
|
"ccorres dc xfdc invs_no_cicd' UNIV hs
|
|
switchToIdleThread (Call switchToIdleThread_'proc)"
|
|
apply (cinit)
|
|
apply (rule ccorres_symb_exec_l)
|
|
apply (ctac (no_vcg) add: Arch_switchToIdleThread_ccorres)
|
|
apply (simp add: setCurThread_def)
|
|
apply (rule_tac P="\<lambda>s. thread = ksIdleThread s" and P'=UNIV in ccorres_from_vcg)
|
|
apply (rule allI, rule conseqPre, vcg)
|
|
apply (clarsimp simp: simpler_modify_def)
|
|
apply (clarsimp simp: rf_sr_def cstate_relation_def Let_def
|
|
carch_state_relation_def cmachine_state_relation_def)
|
|
apply (wpsimp simp: RISCV64_H.switchToIdleThread_def)+
|
|
done
|
|
|
|
lemma Arch_switchToThread_ccorres:
|
|
"ccorres dc xfdc
|
|
(all_invs_but_ct_idle_or_in_cur_domain' and tcb_at' t)
|
|
(UNIV \<inter> \<lbrace>\<acute>tcb = tcb_ptr_to_ctcb_ptr t\<rbrace>)
|
|
[]
|
|
(Arch.switchToThread t) (Call Arch_switchToThread_'proc)"
|
|
apply (cinit lift: tcb_')
|
|
apply (unfold RISCV64_H.switchToThread_def)[1]
|
|
apply (ctac (no_vcg) add: setVMRoot_ccorres)
|
|
apply (simp (no_asm) del: Collect_const)
|
|
apply clarsimp
|
|
done
|
|
|
|
|
|
|
|
|
|
(* FIXME: move *)
|
|
lemma switchToThread_ccorres:
|
|
"ccorres dc xfdc
|
|
(all_invs_but_ct_idle_or_in_cur_domain' and tcb_at' t)
|
|
(UNIV \<inter> \<lbrace>\<acute>thread = tcb_ptr_to_ctcb_ptr t\<rbrace>)
|
|
hs
|
|
(switchToThread t)
|
|
(Call switchToThread_'proc)"
|
|
apply (cinit lift: thread_')
|
|
apply (ctac (no_vcg) add: Arch_switchToThread_ccorres)
|
|
apply (ctac (no_vcg) add: tcbSchedDequeue_ccorres)
|
|
apply (rule_tac P=\<top> and P'=UNIV in ccorres_from_vcg)
|
|
apply clarsimp
|
|
apply (rule conseqPre, vcg)
|
|
apply (clarsimp simp: setCurThread_def simpler_modify_def)
|
|
apply (clarsimp simp: rf_sr_def cstate_relation_def Let_def
|
|
carch_state_relation_def cmachine_state_relation_def)
|
|
apply wp+
|
|
apply (clarsimp simp: all_invs_but_ct_idle_or_in_cur_domain'_def valid_state'_def)
|
|
done
|
|
|
|
lemma get_tsType_ccorres2:
|
|
"ccorres (\<lambda>r r'. r' = thread_state_to_tsType r) ret__unsigned_longlong_' (tcb_at' thread)
|
|
(UNIV \<inter> {s. f s = tcb_ptr_to_ctcb_ptr thread} \<inter>
|
|
{s. cslift s (Ptr &(f s\<rightarrow>[''tcbState_C''])) = Some (thread_state_' s)}) []
|
|
(getThreadState thread) (Call thread_state_get_tsType_'proc)"
|
|
unfolding getThreadState_def
|
|
apply (rule ccorres_from_spec_modifies [where P=\<top>, simplified])
|
|
apply (rule thread_state_get_tsType_spec)
|
|
apply (rule thread_state_get_tsType_modifies)
|
|
apply simp
|
|
apply (frule (1) obj_at_cslift_tcb)
|
|
apply (clarsimp simp: typ_heap_simps)
|
|
apply (rule bexI [rotated, OF threadGet_eq], assumption)
|
|
apply simp
|
|
apply (drule ctcb_relation_thread_state_to_tsType)
|
|
apply simp
|
|
done
|
|
|
|
lemma activateThread_ccorres:
|
|
"ccorres dc xfdc
|
|
(ct_in_state' activatable' and (\<lambda>s. sch_act_wf (ksSchedulerAction s) s)
|
|
and valid_queues and valid_objs')
|
|
UNIV []
|
|
activateThread
|
|
(Call activateThread_'proc)"
|
|
apply (cinit)
|
|
apply (rule ccorres_pre_getCurThread)
|
|
apply (ctac add: get_tsType_ccorres2 [where f="\<lambda>s. ksCurThread_' (globals s)"])
|
|
apply (rule_tac P="activatable' rv" in ccorres_gen_asm)
|
|
apply (wpc)
|
|
apply (rule_tac P=\<top> and P'=UNIV in ccorres_inst, simp)
|
|
apply (rule_tac P=\<top> and P'=UNIV in ccorres_inst, simp)
|
|
apply (rule_tac P=\<top> and P'=UNIV in ccorres_inst, simp)
|
|
apply simp
|
|
apply (rule ccorres_cond_true)
|
|
apply (rule ccorres_return_Skip)
|
|
apply (rule_tac P=\<top> and P'=UNIV in ccorres_inst, simp)
|
|
apply (simp add: "StrictC'_thread_state_defs" del: Collect_const)
|
|
apply (rule ccorres_cond_false)
|
|
apply (rule ccorres_cond_false)
|
|
apply (rule ccorres_cond_true)
|
|
apply (rule_tac P=\<top> and P'=UNIV in ccorres_from_vcg)
|
|
apply (rule allI, rule conseqPre, vcg)
|
|
apply (clarsimp simp: activateIdleThread_def return_def)
|
|
apply (rule_tac P=\<top> and P'=UNIV in ccorres_inst, simp)
|
|
apply (simp add: "StrictC'_thread_state_defs" del: Collect_const)
|
|
apply (rule ccorres_cond_false)
|
|
apply (rule ccorres_cond_true)
|
|
apply (rule ccorres_rhs_assoc)+
|
|
apply csymbr
|
|
apply (ctac)
|
|
apply (ctac add: setNextPC_ccorres)
|
|
apply ctac
|
|
apply (wp | simp add: valid_tcb_state'_def)+
|
|
apply vcg
|
|
apply wp
|
|
apply vcg
|
|
apply (wp gts_wp')
|
|
apply vcg
|
|
apply (clarsimp simp: ct_in_state'_def)
|
|
apply (rule conjI, clarsimp)
|
|
apply (clarsimp simp: st_tcb_at'_def)
|
|
apply (rule conjI, clarsimp simp: obj_at'_def)
|
|
apply clarsimp
|
|
apply (drule (1) obj_at_cslift_tcb)
|
|
apply (subgoal_tac "ksCurThread_' (globals s') = tcb_ptr_to_ctcb_ptr (ksCurThread s)")
|
|
prefer 2
|
|
apply (clarsimp simp: rf_sr_def cstate_relation_def Let_def)
|
|
apply (clarsimp simp: typ_heap_simps ThreadState_Running_def mask_def)
|
|
done
|
|
|
|
lemma ceqv_Guard_UNIV_Skip:
|
|
"ceqv Gamma xf v s s' (a ;; Guard F UNIV Skip) a"
|
|
apply (rule ceqvI)
|
|
apply (safe elim!: exec_Normal_elim_cases)
|
|
apply (case_tac s'a, auto intro: exec.intros elim!: exec_Normal_elim_cases)[1]
|
|
apply (cases s', auto intro: exec.intros)
|
|
done
|
|
|
|
lemma ceqv_tail_Guard_onto_Skip:
|
|
"ceqv Gamma xf v s s'
|
|
(a ;; Guard F G b) ((a ;; Guard F G Skip) ;; b)"
|
|
apply (rule ceqvI)
|
|
apply (safe elim!: exec_Normal_elim_cases)
|
|
apply (case_tac s'a, auto intro: exec.intros elim!: exec_Normal_elim_cases)[1]
|
|
apply (case_tac s'aa, auto intro: exec.intros elim!: exec_Normal_elim_cases)[1]
|
|
done
|
|
|
|
lemma ceqv_remove_tail_Guard_Skip:
|
|
"\<lbrakk> \<And>s. s \<in> G \<rbrakk> \<Longrightarrow> ceqv Gamma xf v s s' (a ;; Guard F G Skip) a"
|
|
apply (rule ceqvI)
|
|
apply (safe elim!: exec_Normal_elim_cases)
|
|
apply (case_tac s'a, auto intro: exec.intros elim!: exec_Normal_elim_cases)[1]
|
|
apply (case_tac s', auto intro: exec.intros elim!: exec_Normal_elim_cases)[1]
|
|
done
|
|
|
|
lemmas ccorres_remove_tail_Guard_Skip
|
|
= ccorres_abstract[where xf'="\<lambda>_. ()", OF ceqv_remove_tail_Guard_Skip]
|
|
|
|
(* FIXME x64: does this need machine_word? *)
|
|
lemma queue_in_range_pre:
|
|
"\<lbrakk> (qdom :: word32) \<le> ucast maxDom; prio \<le> ucast maxPrio \<rbrakk>
|
|
\<Longrightarrow> qdom * of_nat numPriorities + prio < of_nat (numDomains * numPriorities)"
|
|
by (clarsimp simp: cready_queues_index_to_C_def word_less_nat_alt
|
|
word_le_nat_alt unat_ucast maxDom_def seL4_MaxPrio_def
|
|
numPriorities_def unat_word_ariths numDomains_def)
|
|
|
|
lemmas queue_in_range' = queue_in_range_pre[unfolded numDomains_def numPriorities_def, simplified]
|
|
|
|
lemma switchToThread_ccorres':
|
|
"ccorres (\<lambda>_ _. True) xfdc
|
|
(all_invs_but_ct_idle_or_in_cur_domain' and tcb_at' t)
|
|
(UNIV \<inter> \<lbrace>\<acute>thread = tcb_ptr_to_ctcb_ptr t\<rbrace>)
|
|
hs
|
|
(switchToThread t)
|
|
(Call switchToThread_'proc)"
|
|
apply (rule ccorres_guard_imp2)
|
|
apply (ctac (no_vcg) add: switchToThread_ccorres[simplified dc_def])
|
|
apply auto
|
|
done
|
|
|
|
lemmas word_log2_max_word_word_size = word_log2_max[where 'a=machine_word_len, simplified word_size, simplified]
|
|
|
|
lemma chooseThread_ccorres:
|
|
"ccorres dc xfdc all_invs_but_ct_idle_or_in_cur_domain' UNIV [] chooseThread (Call chooseThread_'proc)"
|
|
proof -
|
|
|
|
note prio_and_dom_limit_helpers [simp]
|
|
note ksReadyQueuesL2Bitmap_nonzeroI [simp]
|
|
note Collect_const_mem [simp]
|
|
|
|
have invs_no_cicd'_max_CurDomain[intro]:
|
|
"\<And>s. invs_no_cicd' s \<Longrightarrow> ksCurDomain s \<le> maxDomain"
|
|
by (simp add: invs_no_cicd'_def)
|
|
|
|
show ?thesis
|
|
apply (cinit)
|
|
apply (simp add: numDomains_def word_sless_alt word_sle_def)
|
|
apply (ctac (no_vcg) add: getCurDomain_ccorres_dom_')
|
|
apply clarsimp
|
|
apply (rename_tac curdom)
|
|
apply (rule_tac P="curdom \<le> maxDomain" in ccorres_cross_over_guard_no_st)
|
|
apply (rule ccorres_Guard)
|
|
apply (rule ccorres_pre_getReadyQueuesL1Bitmap)
|
|
apply (rename_tac l1)
|
|
apply (rule_tac R="\<lambda>s. l1 = ksReadyQueuesL1Bitmap s curdom \<and> curdom \<le> maxDomain"
|
|
in ccorres_cond)
|
|
subgoal by (fastforce dest!: rf_sr_cbitmap_L1_relation simp: cbitmap_L1_relation_def)
|
|
prefer 2 \<comment> \<open>switchToIdleThread\<close>
|
|
apply (ctac(no_vcg) add: switchToIdleThread_ccorres)
|
|
apply clarsimp
|
|
apply (rule ccorres_rhs_assoc)+
|
|
|
|
apply (rule ccorres_split_nothrow_novcg)
|
|
apply (rule_tac xf'=prio_' in ccorres_call)
|
|
apply (rule getHighestPrio_ccorres[simplified getHighestPrio_def'])
|
|
apply simp+
|
|
apply ceqv
|
|
apply clarsimp
|
|
apply (rename_tac prio)
|
|
apply (rule_tac P="curdom \<le> maxDomain" in ccorres_cross_over_guard_no_st)
|
|
apply (rule_tac P="prio \<le> maxPriority" in ccorres_cross_over_guard_no_st)
|
|
apply (rule ccorres_pre_getQueue)
|
|
apply (rule_tac P="queue \<noteq> []" in ccorres_cross_over_guard_no_st)
|
|
apply (rule ccorres_symb_exec_l)
|
|
apply (rule ccorres_assert)
|
|
apply csymbr
|
|
apply (rule ccorres_Guard_Seq)+
|
|
apply (rule ccorres_symb_exec_r)
|
|
apply (simp only: ccorres_seq_skip)
|
|
apply (rule ccorres_call[OF switchToThread_ccorres']; simp)
|
|
apply vcg
|
|
apply (rule conseqPre, vcg)
|
|
apply clarsimp
|
|
apply (wp isRunnable_wp)+
|
|
apply (simp add: isRunnable_def)
|
|
apply wp
|
|
apply (clarsimp simp: Let_def guard_is_UNIV_def)
|
|
apply (drule invs_no_cicd'_queues)
|
|
apply (case_tac queue, simp)
|
|
apply (clarsimp simp: tcb_queue_relation'_def cready_queues_index_to_C_def
|
|
numPriorities_def )
|
|
apply (simp add: word_less_nat_alt word_le_nat_alt)
|
|
apply (rule_tac x="unat curdom * 256" and xmax="unat maxDomain * 256" in nat_add_less_by_max)
|
|
subgoal by (simp add: word_le_nat_alt[symmetric])
|
|
subgoal by (simp add: maxDomain_def numDomains_def maxPriority_def numPriorities_def)
|
|
apply wp
|
|
apply clarsimp
|
|
apply (frule invs_no_cicd'_queues)
|
|
apply (frule invs_no_cicd'_max_CurDomain)
|
|
apply (frule invs_no_cicd'_queues)
|
|
apply (clarsimp simp: valid_queues_def lookupBitmapPriority_le_maxPriority)
|
|
apply (intro conjI impI)
|
|
apply (fastforce dest: bitmapQ_from_bitmap_lookup simp: valid_bitmapQ_bitmapQ_simp)
|
|
apply (fastforce dest: lookupBitmapPriority_obj_at'
|
|
simp: pred_conj_def comp_def obj_at'_def st_tcb_at'_def)
|
|
done
|
|
qed
|
|
|
|
lemma ksDomSched_length_relation[simp]:
|
|
"\<lbrakk>cstate_relation s s'\<rbrakk> \<Longrightarrow> length (kernel_state.ksDomSchedule s) = unat (ksDomScheduleLength)"
|
|
apply (auto simp: cstate_relation_def cdom_schedule_relation_def Let_def ksDomScheduleLength_def)
|
|
done
|
|
|
|
lemma ksDomSched_length_dom_relation[simp]:
|
|
"\<lbrakk>cdom_schedule_relation (kernel_state.ksDomSchedule s) kernel_all_global_addresses.ksDomSchedule \<rbrakk> \<Longrightarrow> length (kernel_state.ksDomSchedule s) = unat (ksDomScheduleLength)"
|
|
apply (auto simp: cstate_relation_def cdom_schedule_relation_def Let_def ksDomScheduleLength_def)
|
|
done
|
|
|
|
lemma nextDomain_ccorres:
|
|
"ccorres dc xfdc invs' UNIV [] nextDomain (Call nextDomain_'proc)"
|
|
apply (cinit)
|
|
apply (simp add: ksDomScheduleLength_def sdiv_word_def sdiv_int_def)
|
|
apply (rule_tac P=invs' and P'=UNIV in ccorres_from_vcg)
|
|
apply (rule allI, rule conseqPre, vcg)
|
|
apply (clarsimp simp: simpler_modify_def Let_def
|
|
rf_sr_def cstate_relation_def
|
|
carch_state_relation_def cmachine_state_relation_def)
|
|
apply (rule conjI)
|
|
apply clarsimp
|
|
apply (subgoal_tac "ksDomScheduleIdx \<sigma> = unat (ksDomScheduleLength - 1)")
|
|
apply (fastforce simp add: cdom_schedule_relation_def dom_schedule_entry_relation_def dschDomain_def dschLength_def ksDomScheduleLength_def sdiv_word_def sdiv_int_def simp del: ksDomSched_length_dom_relation)
|
|
apply (simp add: ksDomScheduleLength_def)
|
|
apply (frule invs'_ksDomScheduleIdx)
|
|
apply (simp add: invs'_ksDomSchedule newKernelState_def)
|
|
apply (simp only: Abs_fnat_hom_1 Abs_fnat_hom_add)
|
|
apply (drule unat_le_helper)
|
|
apply (simp add: sdiv_int_def sdiv_word_def)
|
|
apply (clarsimp simp: cdom_schedule_relation_def)
|
|
apply (simp only: Abs_fnat_hom_1 Abs_fnat_hom_add word_not_le)
|
|
apply clarsimp
|
|
apply (subst (asm) of_nat_Suc[symmetric])
|
|
apply (drule iffD1[OF of_nat_mono_maybe'[where x=3, simplified, symmetric], rotated 2])
|
|
apply simp
|
|
apply (frule invs'_ksDomScheduleIdx)
|
|
apply (simp add: invs'_ksDomSchedule newKernelState_def)
|
|
apply (clarsimp simp: cdom_schedule_relation_def)
|
|
apply (clarsimp simp: ksDomScheduleLength_def)
|
|
apply (subst of_nat_Suc[symmetric])+
|
|
apply (subst unat_of_nat64)
|
|
apply (simp add: word_bits_def)
|
|
apply (subst unat_of_nat64)
|
|
apply (simp add: word_bits_def)
|
|
apply (fastforce simp add: cdom_schedule_relation_def dom_schedule_entry_relation_def dschDomain_def dschLength_def simp del: ksDomSched_length_dom_relation)
|
|
apply simp
|
|
done
|
|
|
|
lemma scheduleChooseNewThread_ccorres:
|
|
"ccorres dc xfdc
|
|
(\<lambda>s. invs' s \<and> ksSchedulerAction s = ChooseNewThread) UNIV hs
|
|
(do domainTime \<leftarrow> getDomainTime;
|
|
y \<leftarrow> when (domainTime = 0) nextDomain;
|
|
chooseThread
|
|
od)
|
|
(Call scheduleChooseNewThread_'proc)"
|
|
apply (cinit')
|
|
apply (rule ccorres_pre_getDomainTime)
|
|
apply (rule ccorres_split_nothrow)
|
|
apply (rule_tac R="\<lambda>s. ksDomainTime s = domainTime" in ccorres_when)
|
|
apply (fastforce simp: rf_sr_ksDomainTime)
|
|
apply (rule_tac xf'=xfdc in ccorres_call[OF nextDomain_ccorres] ; simp)
|
|
apply ceqv
|
|
apply (ctac (no_vcg) add: chooseThread_ccorres)
|
|
apply (wp nextDomain_invs_no_cicd')
|
|
apply clarsimp
|
|
apply (vcg exspec=nextDomain_modifies)
|
|
apply (clarsimp simp: if_apply_def2 invs'_invs_no_cicd')
|
|
done
|
|
|
|
lemma isHighestPrio_ccorres:
|
|
"ccorres (\<lambda>rv rv'. rv = to_bool rv') ret__unsigned_long_'
|
|
(\<lambda>s. d \<le> maxDomain \<and> bitmapQ_no_L1_orphans s)
|
|
(UNIV \<inter> \<lbrace>\<acute>dom = ucast d\<rbrace> \<inter> \<lbrace>\<acute>prio = ucast p\<rbrace>) hs
|
|
(isHighestPrio d p)
|
|
(Call isHighestPrio_'proc)"
|
|
supply Collect_const [simp del]
|
|
supply dc_simp [simp del]
|
|
supply prio_and_dom_limit_helpers[simp]
|
|
supply Collect_const_mem [simp]
|
|
(* FIXME: these should likely be in simpset for CRefine, or even in general *)
|
|
supply from_bool_eq_if[simp] from_bool_eq_if'[simp] from_bool_0[simp]
|
|
ccorres_IF_True[simp] if_cong[cong]
|
|
apply (cinit lift: dom_' prio_')
|
|
apply clarsimp
|
|
apply (rule ccorres_move_const_guard)
|
|
apply (rule ccorres_pre_getReadyQueuesL1Bitmap, rename_tac l1)
|
|
apply (rule ccorres_rhs_assoc2)
|
|
apply (rule ccorres_cond_seq2[THEN iffD1])
|
|
apply ccorres_rewrite
|
|
apply (rule_tac xf'=ret__int_' and val="from_bool (l1 = 0)"
|
|
and R="\<lambda>s. l1 = ksReadyQueuesL1Bitmap s d \<and> d \<le> maxDomain" and R'=UNIV
|
|
in ccorres_symb_exec_r_known_rv)
|
|
apply vcg
|
|
apply clarsimp
|
|
apply (fastforce simp: rf_sr_ksReadyQueuesL1Bitmap_simp)
|
|
apply ceqv
|
|
apply clarsimp
|
|
apply (rule ccorres_cond[where R=\<top>], blast)
|
|
apply (rule_tac P="l1 = 0" in ccorres_gen_asm, clarsimp)
|
|
apply (rule ccorres_return_C; clarsimp)
|
|
apply (rule ccorres_rhs_assoc)+
|
|
apply (ctac add: getHighestPrio_ccorres[simplified])
|
|
apply (rename_tac hprio hprio')
|
|
apply csymbr
|
|
apply (rule ccorres_return_C, simp, simp, simp)
|
|
apply (rule wp_post_taut)
|
|
apply (vcg exspec=getHighestPrio_modifies)+
|
|
apply (clarsimp simp: word_le_nat_alt true_def to_bool_def split: if_splits)
|
|
done
|
|
|
|
lemma schedule_ccorres:
|
|
"ccorres dc xfdc invs' UNIV [] schedule (Call schedule_'proc)"
|
|
supply Collect_const [simp del]
|
|
supply dc_simp [simp del]
|
|
supply prio_and_dom_limit_helpers[simp]
|
|
supply Collect_const_mem [simp]
|
|
(* FIXME: these should likely be in simpset for CRefine, or even in general *)
|
|
supply from_bool_eq_if[simp] from_bool_eq_if'[simp] from_bool_0[simp]
|
|
ccorres_IF_True[simp] if_cong[cong]
|
|
apply (cinit)
|
|
apply (rule ccorres_pre_getCurThread)
|
|
apply (rule ccorres_pre_getSchedulerAction)
|
|
apply wpc
|
|
(* toplevel case: action is resume current thread *)
|
|
apply (rule ccorres_cond_false_seq)
|
|
apply simp
|
|
apply (rule_tac P=\<top> and P'="{s. ksSchedulerAction_' (globals s) = NULL }" in ccorres_from_vcg)
|
|
apply (clarsimp simp: dc_def return_def split: prod.splits)
|
|
apply (rule conseqPre, vcg, clarsimp)
|
|
(* toplevel case: action is choose new thread *)
|
|
apply (rule ccorres_cond_true_seq)
|
|
apply (rule ccorres_rhs_assoc)+
|
|
apply csymbr
|
|
(* ct runnable? *)
|
|
apply (ctac add: isRunnable_ccorres, rename_tac runnable)
|
|
apply (clarsimp simp: to_bool_def)
|
|
apply (rule ccorres_split_nothrow_dc)
|
|
(* enqueue if runnable *)
|
|
apply (simp add: when_def)
|
|
apply (rule ccorres_cond[where R=\<top>], clarsimp)
|
|
apply csymbr
|
|
apply (ctac add: tcbSchedEnqueue_ccorres)
|
|
apply (rule ccorres_from_vcg[where P=\<top> and P'=UNIV])
|
|
apply (clarsimp, rule conseqPre, vcg)
|
|
apply (clarsimp simp: dc_def return_def)
|
|
apply (rule ccorres_cond_true_seq)
|
|
(* isolate haskell part before setting thread action *)
|
|
apply (simp add: scheduleChooseNewThread_def)
|
|
apply (rule ccorres_lhs_assoc)+
|
|
apply (rule ccorres_split_nothrow_dc)
|
|
apply (simp add: bind_assoc)
|
|
apply (ctac add: scheduleChooseNewThread_ccorres)
|
|
apply (ctac(no_simp) add: ccorres_setSchedulerAction)
|
|
apply (wpsimp simp: cscheduler_action_relation_def
|
|
| vcg exspec=scheduleChooseNewThread_modifies exspec=tcbSchedEnqueue_modifies)+
|
|
(* toplevel case: action is switch to candidate *)
|
|
apply (rename_tac candidate)
|
|
apply (rule_tac P="\<lambda>s. ksSchedulerAction s = SwitchToThread candidate \<and> invs' s" in ccorres_cross_over_guard)
|
|
apply (rule ccorres_cond_true_seq)
|
|
apply (rule ccorres_rhs_assoc)+
|
|
apply csymbr
|
|
(* ct runnable? *)
|
|
apply (ctac add: isRunnable_ccorres, rename_tac runnable runnable')
|
|
apply (clarsimp simp: to_bool_def)
|
|
apply (rule ccorres_split_nothrow_dc)
|
|
(* enqueue if runnable *)
|
|
apply (simp add: when_def)
|
|
apply (rule ccorres_cond[where R=\<top>], clarsimp)
|
|
apply csymbr
|
|
apply (ctac add: tcbSchedEnqueue_ccorres)
|
|
apply (rule ccorres_from_vcg[where P=\<top> and P'=UNIV])
|
|
apply (clarsimp, rule conseqPre, vcg)
|
|
apply (clarsimp simp: dc_def return_def)
|
|
apply (rule ccorres_cond_false_seq)
|
|
|
|
apply (rule_tac xf'=was_runnable_' in ccorres_abstract, ceqv)
|
|
apply (rename_tac was_runnable')
|
|
apply (rule_tac P="was_runnable' = runnable'" in ccorres_gen_asm2, clarsimp)
|
|
apply (rule ccorres_symb_exec_l3[OF _ git_wp _ empty_fail_getIdleThread], rename_tac it)
|
|
apply (rule ccorres_pre_threadGet, rename_tac targetPrio)
|
|
apply (rule ccorres_pre_threadGet, rename_tac curPrio)
|
|
apply (rule ccorres_rhs_assoc)+
|
|
apply (rule_tac xf'=candidate_' and val="tcb_ptr_to_ctcb_ptr candidate"
|
|
and R="\<lambda>s. ksSchedulerAction s = SwitchToThread candidate" and R'=UNIV
|
|
in ccorres_symb_exec_r_known_rv)
|
|
apply (rule conseqPre, vcg, clarsimp)
|
|
apply (fastforce dest!: rf_sr_cscheduler_relation simp: cscheduler_action_relation_def)
|
|
apply ceqv
|
|
(* split off fastfail calculation *)
|
|
apply (rule ccorres_rhs_assoc2)
|
|
apply (rule ccorres_rhs_assoc2)
|
|
apply (rule_tac r'="\<lambda>rv rv'. rv = to_bool rv'" and xf'=fastfail_' in ccorres_split_nothrow)
|
|
apply (clarsimp simp: scheduleSwitchThreadFastfail_def dc_simp)
|
|
apply (rule ccorres_cond_seq2[THEN iffD1])
|
|
apply (rule_tac xf'=ret__int_' and val="from_bool (curThread = it)"
|
|
and R="\<lambda>s. it = ksIdleThread s \<and> curThread = ksCurThread s" and R'=UNIV
|
|
in ccorres_symb_exec_r_known_rv)
|
|
apply (rule conseqPre, vcg, fastforce simp: rf_sr_ksCurThread rf_sr_ksIdleThread)
|
|
apply ceqv
|
|
apply clarsimp
|
|
apply (rule ccorres_cond2'[where R=\<top>], fastforce)
|
|
apply clarsimp
|
|
apply (rule ccorres_return[where R'=UNIV], clarsimp, vcg)
|
|
apply (rule_tac P="\<lambda>s. obj_at' (\<lambda>tcb. tcbPriority tcb = curPrio) curThread s
|
|
\<and> curThread = ksCurThread s
|
|
\<and> obj_at' (\<lambda>tcb. tcbPriority tcb = targetPrio) candidate s"
|
|
and P'=UNIV in ccorres_from_vcg)
|
|
apply clarsimp
|
|
apply (rule conseqPre, vcg)
|
|
apply (clarsimp simp: return_def cur_tcb'_def rf_sr_ksCurThread)
|
|
apply (drule (1) obj_at_cslift_tcb)+
|
|
apply (clarsimp simp: typ_heap_simps ctcb_relation_def to_bool_def split: if_split)
|
|
apply unat_arith
|
|
apply (wpsimp wp: threadGet_obj_at2)
|
|
apply vcg
|
|
apply ceqv
|
|
(* fastfail calculation complete *)
|
|
apply (rename_tac fastfail fastfail')
|
|
apply (rule ccorres_pre_curDomain)
|
|
(* rest of the calculation: fastfail \<and> \<not> highest *)
|
|
apply (rule ccorres_rhs_assoc2)
|
|
apply (rule_tac r'="\<lambda>hprio rv'. to_bool rv' = (fastfail \<and> \<not>hprio)" and xf'=ret__int_'
|
|
in ccorres_split_nothrow)
|
|
apply (csymbr)
|
|
apply (clarsimp simp: to_bool_def)
|
|
apply (rule ccorres_Cond_rhs ; clarsimp)
|
|
apply (rule ccorres_move_c_guard_tcb)
|
|
apply (rule ccorres_add_return2)
|
|
apply (ctac add: isHighestPrio_ccorres, clarsimp)
|
|
apply (clarsimp simp: to_bool_def)
|
|
apply (rule ccorres_inst[where P=\<top> and P'=UNIV])
|
|
apply (rule ccorres_return)
|
|
apply (rule conseqPre, vcg)
|
|
apply clarsimp
|
|
apply (rule wp_post_taut)
|
|
apply (vcg exspec=isHighestPrio_modifies)
|
|
apply (rule_tac P=\<top> and P'="{s. ret__int_' s = 0}" in ccorres_from_vcg)
|
|
apply clarsimp
|
|
apply (rule conseqPre, vcg)
|
|
apply (fastforce simp: isHighestPrio_def' gets_def return_def get_def
|
|
NonDetMonad.bind_def
|
|
split: prod.split)
|
|
apply ceqv
|
|
apply (clarsimp simp: to_bool_def)
|
|
(* done with calculation of main acceptance criterion for candidate *)
|
|
apply (rule ccorres_cond_seq)
|
|
apply (rule ccorres_cond[where R=\<top>], blast)
|
|
(* candidate is not the best one, enqueue and choose new thread *)
|
|
apply (rule ccorres_rhs_assoc)+
|
|
apply (ctac add: tcbSchedEnqueue_ccorres)
|
|
apply clarsimp
|
|
apply (ctac(no_simp) add: ccorres_setSchedulerAction)
|
|
apply (clarsimp simp: cscheduler_action_relation_def)
|
|
(* isolate haskell part before setting thread action *)
|
|
apply (simp add: scheduleChooseNewThread_def)
|
|
apply (rule ccorres_lhs_assoc)+
|
|
apply (rule ccorres_split_nothrow_dc)
|
|
apply (simp add: bind_assoc)
|
|
apply (ctac add: scheduleChooseNewThread_ccorres)
|
|
apply (ctac(no_simp) add: ccorres_setSchedulerAction)
|
|
apply (wpsimp simp: cscheduler_action_relation_def)+
|
|
apply (vcg exspec=scheduleChooseNewThread_modifies)
|
|
apply (wp add: setSchedulerAction_invs' setSchedulerAction_direct del: ssa_wp)
|
|
apply (clarsimp | vcg exspec=tcbSchedEnqueue_modifies | wp wp_post_taut)+
|
|
(* secondary check, when on equal prio and ct was running, prefer ct *)
|
|
apply (rule ccorres_rhs_assoc)
|
|
apply (rule_tac xf'=ret__int_' and val="from_bool (runnable' \<noteq> 0 \<and> curPrio = targetPrio)"
|
|
and R="\<lambda>s. curThread = ksCurThread s
|
|
\<and> obj_at' (\<lambda>tcb. tcbPriority tcb = curPrio) (ksCurThread s) s
|
|
\<and> obj_at' (\<lambda>tcb. tcbPriority tcb = targetPrio) candidate s"
|
|
and R'=UNIV
|
|
in ccorres_symb_exec_r_known_rv)
|
|
apply clarsimp
|
|
apply (rule conseqPre, vcg)
|
|
apply (clarsimp simp: false_def cur_tcb'_def rf_sr_ksCurThread)
|
|
|
|
apply (drule (1) obj_at_cslift_tcb)+
|
|
apply (clarsimp simp: typ_heap_simps ctcb_relation_def to_bool_def split: if_split)
|
|
apply (solves unat_arith)
|
|
apply ceqv
|
|
apply clarsimp
|
|
apply (rule ccorres_cond_seq)
|
|
apply (rule ccorres_cond[where R=\<top>], blast)
|
|
(* candidate does not beat running ct, append and choose new thread *)
|
|
apply (rule ccorres_rhs_assoc)+
|
|
apply (ctac add: tcbSchedAppend_ccorres)
|
|
apply clarsimp
|
|
apply (ctac(no_simp) add: ccorres_setSchedulerAction)
|
|
apply (clarsimp simp: cscheduler_action_relation_def)
|
|
(* isolate haskell part before setting thread action *)
|
|
apply (simp add: scheduleChooseNewThread_def)
|
|
apply (rule ccorres_lhs_assoc)+
|
|
apply (rule ccorres_split_nothrow_dc)
|
|
apply (simp add: bind_assoc)
|
|
apply (ctac add: scheduleChooseNewThread_ccorres)
|
|
apply (ctac(no_simp) add: ccorres_setSchedulerAction)
|
|
apply (wpsimp simp: cscheduler_action_relation_def)+
|
|
apply (vcg exspec=scheduleChooseNewThread_modifies)
|
|
apply (wp add: setSchedulerAction_invs' setSchedulerAction_direct del: ssa_wp)
|
|
apply (clarsimp | vcg exspec=tcbSchedEnqueue_modifies | wp wp_post_taut)+
|
|
(* candidate is best, switch to it *)
|
|
apply (ctac add: switchToThread_ccorres)
|
|
apply clarsimp
|
|
apply (ctac(no_simp) add: ccorres_setSchedulerAction)
|
|
apply (clarsimp simp: cscheduler_action_relation_def)
|
|
apply (wpsimp wp: wp_post_taut)
|
|
apply (vcg exspec=switchToThread_modifies)
|
|
apply clarsimp
|
|
apply vcg
|
|
apply clarsimp
|
|
apply (strengthen invs'_invs_no_cicd')
|
|
apply (wp | wp (once) hoare_drop_imp)+
|
|
apply clarsimp
|
|
apply (vcg exspec=isHighestPrio_modifies)
|
|
apply clarsimp
|
|
apply (wp (once) hoare_drop_imps)
|
|
apply wp
|
|
apply (strengthen strenghten_False_imp[where P="a = ResumeCurrentThread" for a])
|
|
apply (clarsimp simp: conj_ac invs_queues invs_valid_objs' cong: conj_cong)
|
|
apply wp
|
|
apply (clarsimp, vcg exspec=tcbSchedEnqueue_modifies)
|
|
apply (clarsimp, vcg exspec=tcbSchedEnqueue_modifies)
|
|
apply (clarsimp simp: to_bool_def true_def)
|
|
apply (strengthen ko_at'_obj_at'_field)
|
|
apply (clarsimp cong: imp_cong simp: ko_at'_obj_at'_field to_bool_def true_def)
|
|
apply wp
|
|
apply clarsimp
|
|
(* when runnable tcbSchedEnqueue curThread *)
|
|
apply (rule_tac Q="\<lambda>rv s. invs' s \<and> ksCurThread s = curThread
|
|
\<and> ksSchedulerAction s = SwitchToThread candidate" in hoare_post_imp)
|
|
apply (clarsimp simp: invs'_bitmapQ_no_L1_orphans invs_ksCurDomain_maxDomain')
|
|
apply (fastforce dest: invs_sch_act_wf')
|
|
|
|
apply (wp | clarsimp simp: dc_def)+
|
|
apply (vcg exspec=tcbSchedEnqueue_modifies)
|
|
apply wp
|
|
apply (clarsimp simp: to_bool_def false_def)
|
|
apply vcg
|
|
|
|
apply (clarsimp simp: tcb_at_invs' rf_sr_ksCurThread if_apply_def2 invs_queues invs_valid_objs'
|
|
dc_def)+
|
|
apply (frule invs_sch_act_wf')
|
|
apply (frule tcb_at_invs')
|
|
apply (rule conjI)
|
|
apply (clarsimp dest!: rf_sr_cscheduler_relation simp: cscheduler_action_relation_def)
|
|
apply (rule conjI; clarsimp)
|
|
apply (frule (1) obj_at_cslift_tcb)
|
|
apply (clarsimp simp: cscheduler_action_relation_def typ_heap_simps max_word_not_0
|
|
split: scheduler_action.splits)
|
|
apply (frule (1) obj_at_cslift_tcb)
|
|
apply (clarsimp dest!: rf_sr_cscheduler_relation invs_sch_act_wf'
|
|
simp: cscheduler_action_relation_def)
|
|
apply (intro conjI impI allI; clarsimp simp: typ_heap_simps ctcb_relation_def to_bool_def)
|
|
apply (fastforce simp: tcb_at_not_NULL tcb_at_1 dest: pred_tcb_at')+
|
|
done
|
|
|
|
(* FIXME: move *)
|
|
lemma map_to_tcbs_upd:
|
|
"map_to_tcbs (ksPSpace s(t \<mapsto> KOTCB tcb')) = map_to_tcbs (ksPSpace s)(t \<mapsto> tcb')"
|
|
apply (rule ext)
|
|
apply (clarsimp simp: map_comp_def projectKOs split: option.splits if_splits)
|
|
done
|
|
|
|
(* FIXME: move *)
|
|
lemma cep_relations_drop_fun_upd:
|
|
"\<lbrakk> f x = Some v; tcbEPNext_C v' = tcbEPNext_C v; tcbEPPrev_C v' = tcbEPPrev_C v \<rbrakk>
|
|
\<Longrightarrow> cendpoint_relation (f (x \<mapsto> v')) = cendpoint_relation f"
|
|
"\<lbrakk> f x = Some v; tcbEPNext_C v' = tcbEPNext_C v; tcbEPPrev_C v' = tcbEPPrev_C v \<rbrakk>
|
|
\<Longrightarrow> cnotification_relation (f (x \<mapsto> v')) = cnotification_relation f"
|
|
by (intro ext cendpoint_relation_upd_tcb_no_queues[where thread=x]
|
|
cnotification_relation_upd_tcb_no_queues[where thread=x]
|
|
| simp split: if_split)+
|
|
|
|
lemma threadSet_timeSlice_ccorres [corres]:
|
|
"ccorres dc xfdc (tcb_at' thread) {s. thread' s = tcb_ptr_to_ctcb_ptr thread \<and> unat (v' s) = v} hs
|
|
(threadSet (tcbTimeSlice_update (\<lambda>_. v)) thread)
|
|
(Basic (\<lambda>s. globals_update (t_hrs_'_update (hrs_mem_update (heap_update (Ptr &(thread' s\<rightarrow>[''tcbTimeSlice_C''])::machine_word ptr) (v' s)))) s))"
|
|
apply (rule ccorres_guard_imp2)
|
|
apply (rule threadSet_ccorres_lemma4 [where P=\<top> and P'=\<top>])
|
|
apply vcg
|
|
prefer 2
|
|
apply (rule conjI, simp)
|
|
apply assumption
|
|
apply clarsimp
|
|
apply (clarsimp simp: rf_sr_def cstate_relation_def Let_def)
|
|
apply (clarsimp simp: cmachine_state_relation_def carch_state_relation_def cpspace_relation_def)
|
|
apply (clarsimp simp: update_tcb_map_tos typ_heap_simps')
|
|
apply (simp add: map_to_ctes_upd_tcb_no_ctes tcb_cte_cases_def
|
|
map_to_tcbs_upd cteSizeBits_def)
|
|
|
|
apply (simp add: cep_relations_drop_fun_upd cvariable_relation_upd_const
|
|
ko_at_projectKO_opt)
|
|
apply (rule conjI)
|
|
defer
|
|
apply (erule cready_queues_relation_not_queue_ptrs)
|
|
apply (rule ext, simp split: if_split)
|
|
apply (rule ext, simp split: if_split)
|
|
apply (drule ko_at_projectKO_opt)
|
|
apply (erule (2) cmap_relation_upd_relI)
|
|
apply (simp add: ctcb_relation_def)
|
|
apply assumption
|
|
apply simp
|
|
done
|
|
|
|
lemma timerTick_ccorres:
|
|
"ccorres dc xfdc invs' UNIV [] timerTick (Call timerTick_'proc)"
|
|
apply (cinit)
|
|
apply (rule ccorres_pre_getCurThread)
|
|
apply (ctac add: get_tsType_ccorres2 [where f="\<lambda>s. ksCurThread_' (globals s)"])
|
|
apply (rule ccorres_split_nothrow_novcg)
|
|
apply wpc
|
|
apply (simp add: "StrictC'_thread_state_defs", rule ccorres_cond_false, rule ccorres_return_Skip[unfolded dc_def])+
|
|
(* thread_state.Running *)
|
|
apply simp
|
|
apply (rule ccorres_cond_true)
|
|
apply (rule ccorres_pre_threadGet)
|
|
apply (rule_tac P="cur_tcb'" and P'=\<top> in ccorres_move_c_guards(8))
|
|
apply (clarsimp simp: cur_tcb'_def)
|
|
apply (drule (1) tcb_at_h_t_valid)
|
|
apply (clarsimp simp: rf_sr_def cstate_relation_def Let_def)
|
|
apply (rule_tac Q="\<lambda>s. obj_at' (\<lambda>tcb. tcbTimeSlice tcb = rva) (ksCurThread s) s"
|
|
and Q'=\<top> in ccorres_cond_both')
|
|
apply clarsimp
|
|
apply (drule (1) obj_at_cslift_tcb)
|
|
apply (clarsimp simp: rf_sr_def cstate_relation_def Let_def)
|
|
apply (clarsimp simp: typ_heap_simps)
|
|
apply (clarsimp simp: ctcb_relation_def word_less_nat_alt)
|
|
apply (rule_tac P="cur_tcb'" and P'=\<top> in ccorres_move_c_guards(8))
|
|
apply (clarsimp simp: cur_tcb'_def)
|
|
apply (fastforce simp: rf_sr_def cstate_relation_def Let_def typ_heap_simps dest: tcb_at_h_t_valid)
|
|
apply (rule_tac P="cur_tcb'" and P'=\<top> in ccorres_move_c_guards(8))
|
|
apply (clarsimp simp: cur_tcb'_def)
|
|
apply (fastforce simp: rf_sr_def cstate_relation_def Let_def typ_heap_simps dest: tcb_at_h_t_valid)
|
|
apply (ctac add: threadSet_timeSlice_ccorres[unfolded dc_def])
|
|
apply (rule ccorres_rhs_assoc)+
|
|
apply (ctac)
|
|
apply simp
|
|
apply (ctac (no_vcg) add: tcbSchedAppend_ccorres)
|
|
apply (ctac add: rescheduleRequired_ccorres[unfolded dc_def])
|
|
apply (wp weak_sch_act_wf_lift_linear threadSet_valid_queues
|
|
threadSet_pred_tcb_at_state tcbSchedAppend_valid_objs' threadSet_valid_objs' threadSet_tcbDomain_triv
|
|
| clarsimp simp: st_tcb_at'_def o_def split: if_splits)+
|
|
apply (vcg exspec=tcbSchedDequeue_modifies)
|
|
apply (simp add: "StrictC'_thread_state_defs", rule ccorres_cond_false, rule ccorres_return_Skip[unfolded dc_def])+
|
|
apply ceqv
|
|
apply (simp add: when_def numDomains_def decDomainTime_def)
|
|
apply (rule ccorres_split_nothrow_novcg)
|
|
apply (rule_tac rrel=dc and xf=xfdc and P=\<top> and P'=UNIV in ccorres_from_vcg)
|
|
apply (rule allI, rule conseqPre, vcg)
|
|
apply (clarsimp simp: simpler_modify_def)
|
|
apply (clarsimp simp: rf_sr_def cstate_relation_def Let_def
|
|
carch_state_relation_def cmachine_state_relation_def)
|
|
apply ceqv
|
|
apply (rule ccorres_pre_getDomainTime)
|
|
apply (rename_tac rva rv'a rvb)
|
|
apply (rule_tac P'="{s. ksDomainTime_' (globals s) = rvb}" in ccorres_inst, simp)
|
|
apply (case_tac "rvb = 0")
|
|
apply clarsimp
|
|
apply (rule ccorres_guard_imp2)
|
|
apply (rule ccorres_cond_true)
|
|
apply (ctac add: rescheduleRequired_ccorres[unfolded dc_def])
|
|
apply clarsimp
|
|
apply assumption
|
|
apply clarsimp
|
|
apply (rule ccorres_guard_imp2)
|
|
apply (rule ccorres_cond_false)
|
|
apply (rule ccorres_return_Skip[unfolded dc_def])
|
|
apply clarsimp
|
|
apply wp
|
|
apply (clarsimp simp: guard_is_UNIV_def)
|
|
apply (wp hoare_vcg_conj_lift hoare_vcg_all_lift hoare_drop_imps)
|
|
apply (wpc | wp threadSet_weak_sch_act_wf threadSet_valid_objs' rescheduleRequired_weak_sch_act_wf
|
|
tcbSchedAppend_valid_objs' weak_sch_act_wf_lift_linear threadSet_st_tcb_at2 threadGet_wp
|
|
| simp split del: if_splits)+
|
|
apply (clarsimp simp: guard_is_UNIV_def Collect_const_mem word_sle_def word_sless_def)
|
|
apply (wp gts_wp')
|
|
apply vcg
|
|
apply (clarsimp simp: invs_weak_sch_act_wf)
|
|
apply (fold cur_tcb'_def)
|
|
apply (rule conjI, clarsimp)
|
|
apply (rule conjI, clarsimp)
|
|
apply (rule conjI)
|
|
apply (clarsimp simp: invs'_def valid_state'_def)
|
|
apply (auto simp: obj_at'_def inQ_def weak_sch_act_wf_def st_tcb_at'_def
|
|
valid_pspace'_def ct_idle_or_in_cur_domain'_def valid_tcb'_def valid_idle'_def projectKOs)[1]
|
|
apply (rule conjI, clarsimp simp: invs'_def valid_state'_def valid_tcb'_def)+
|
|
apply (auto simp: obj_at'_def inQ_def weak_sch_act_wf_def st_tcb_at'_def
|
|
valid_pspace'_def ct_idle_or_in_cur_domain'_def valid_tcb'_def valid_idle'_def projectKOs)[1]
|
|
apply (auto simp: invs'_def valid_state'_def valid_tcb'_def tcb_cte_cases_def
|
|
cteSizeBits_def)[1]
|
|
|
|
apply (frule invs_cur')
|
|
apply (clarsimp simp: cur_tcb'_def)
|
|
apply (drule (1) obj_at_cslift_tcb)
|
|
apply (clarsimp simp: rf_sr_def cstate_relation_def Let_def typ_heap_simps' timeSlice_def)
|
|
apply (subst unat_sub)
|
|
apply simp
|
|
apply (clarsimp simp: ctcb_relation_def)
|
|
done
|
|
|
|
end
|
|
|
|
end
|