You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.

1469 lines
62 KiB

(*
* Copyright (c) 2009 - 2013 Monoidics ltd.
* Copyright (c) 2013 - present Facebook, Inc.
* All rights reserved.
*
* This source code is licensed under the BSD style license found in the
* LICENSE file in the root directory of this source tree. An additional grant
* of patent rights can be found in the PATENTS file in the same directory.
*)
open! IStd
module L = Logging
module F = Format
(** {1 Dotty} *)
(* When false it prints only the retain cycle part of a prop.
When true it prints the full property (maybe useful for debug) *)
let print_full_prop = ref false
type kind_of_dotty_prop =
| Generic_proposition
| Spec_precondition
| Spec_postcondition of Prop.normal Prop.t (** the precondition associated with the post *)
| Lambda_pred of int * int * bool
(* the kind of links between different kinds of nodes*)
type kind_of_links =
| LinkExpToExp
| LinkExpToStruct
| LinkStructToExp
| LinkStructToStruct
| LinkToArray
| LinkArrayToExp
| LinkArrayToStruct
| LinkToSSL
| LinkToDLL
| LinkRetainCycle
[@@deriving compare]
(* coordinate identifies a node using two dimension: id is an numerical identifier of the node,*)
(* lambda identifies in which hpred parameter id lays in*)
type coordinate = {
id: int;
lambda: int;
} [@@deriving compare]
(* define a link between two nodes. src_fld/trg_fld define the label of the src/trg field. It is*)
(* useful for having nodes from within a struct and/or to inside a struct *)
type link = {
kind: kind_of_links;
src: coordinate;
src_fld: string;
trg: coordinate;
trg_fld: string;
} [@@deriving compare]
let equal_link = [%compare.equal : link]
(* type of the visualized boxes/nodes in the graph*)
type dotty_node =
| Dotnil of coordinate (* nil box *)
(* Dotdangling(coo,e,c): dangling box for expression e at coordinate coo and color c *)
| Dotdangling of coordinate * Exp.t * string
(* Dotpointsto(coo,e,c): basic memory cell box for expression e at coordinate coo and color c *)
| Dotpointsto of coordinate * Exp.t * string
(* Dotstruct(coo,e,l,c): struct box for expression e with field list l at coordinate coo and color c *)
| Dotstruct of coordinate * Exp.t * (Typ.Fieldname.t * Sil.strexp) list * string * Exp.t
(* Dotarray(coo,e1,e2,l,t,c): array box for expression e1 with field list l at coordinate coo and color c*)
(* e2 is the len and t is the type *)
| Dotarray of coordinate * Exp.t * Exp.t * (Exp.t * Sil.strexp) list * Typ.t * string
(* Dotlseg(coo,e1,e2,k,h,c): list box from e1 to e2 at coordinate coo and color c*)
| Dotlseg of coordinate * Exp.t * Exp.t * Sil.lseg_kind * Sil.hpred list * string
(* Dotlseg(coo,e1,e2,e3,e4,k,h,c): doubly linked-list box from with parameters (e1,e2,e3,e4) at coordinate coo and color c*)
| Dotdllseg of
coordinate * Exp.t * Exp.t * Exp.t * Exp.t * Sil.lseg_kind * Sil.hpred list * string
let mk_coordinate i l = { id = i; lambda = l }
let mk_link k s sf t tf = { kind = k; src = s; src_fld = sf; trg = t; trg_fld = tf }
(* list of dangling boxes*)
let dangling_dotboxes = ref []
(* list of nil boxes*)
let nil_dotboxes = ref []
let exps_neq_zero = ref []
(* list of fields in the structs *)
let fields_structs = ref []
let struct_exp_nodes = ref []
(* general unique counter to assign a different number to boxex, *)
(* clusters,subgraphs etc. *)
let dotty_state_count = ref 0
let spec_counter = ref 0
let post_counter = ref 0
let lambda_counter = ref 0
let proposition_counter = ref 0
let target_invisible_arrow_pre = ref 0
let current_pre = ref 0
let spec_id = ref 0
let invisible_arrows = ref false
let print_stack_info = ref false
(* replace a dollar sign in a name with a D. We need this because dotty get confused if there is*)
(* a dollar sign i a label*)
let strip_special_chars b =
let replace st c c' =
if String.contains st c then begin
let idx = String.index_exn st c in
try
String.set st idx c';
st
with Invalid_argument _ ->
L.internal_error "@\n@\nstrip_special_chars: Invalid argument!@\n@."; assert false
end else st in
let s0 = replace b '(' 'B' in
let s1 = replace s0 '$' 'D' in
let s2 = replace s1 '#' 'H' in
let s3 = replace s2 '&' 'E' in
let s4 = replace s3 '@' 'A' in
let s5 = replace s4 ')' 'B' in
let s6 = replace s5 '+' 'P' in
let s7 = replace s6 '-' 'M' in
s7
let rec strexp_to_string pe coo f se =
match se with
| Sil.Eexp (Exp.Lvar pvar, _) -> F.fprintf f "%a" (Pvar.pp pe) pvar
| Sil.Eexp (Exp.Var id, _) ->
if !print_full_prop then
F.fprintf f "%a" (Ident.pp pe) id
else ()
| Sil.Eexp (e, _) ->
if !print_full_prop then
F.fprintf f "%a" (Sil.pp_exp_printenv pe) e
else F.fprintf f "_"
| Sil.Estruct (ls, _) -> F.fprintf f " STRUCT | { %a } " (struct_to_dotty_str pe coo) ls
| Sil.Earray(e, idx, _) -> F.fprintf f " ARRAY[%a] | { %a } " (Sil.pp_exp_printenv pe) e (get_contents pe coo) idx
and struct_to_dotty_str pe coo f ls : unit =
match ls with
| [] -> ()
| (fn, se)::[]-> F.fprintf f "{ <%s%iL%i> %s: %a } " (Typ.Fieldname.to_string fn) coo.id coo.lambda (Typ.Fieldname.to_string fn) (strexp_to_string pe coo) se
| (fn, se):: ls'-> F.fprintf f " { <%s%iL%i> %s: %a } | %a" (Typ.Fieldname.to_string fn) coo.id coo.lambda (Typ.Fieldname.to_string fn) (strexp_to_string pe coo) se (struct_to_dotty_str pe coo) ls'
and get_contents_sexp pe coo f se =
match se with
| Sil.Eexp (e', _) ->
F.fprintf f "%a" (Sil.pp_exp_printenv pe) e'
| Sil.Estruct (se', _) ->
F.fprintf f "| { %a }" (struct_to_dotty_str pe coo) se'
| Sil.Earray(e', [], _) ->
F.fprintf f "(ARRAY Size: %a) | { }" (Sil.pp_exp_printenv pe) e'
| Sil.Earray(e', ((idx, a):: linner), _) ->
F.fprintf f "(ARRAY Size: %a) | { %a: %a | %a }" (Sil.pp_exp_printenv pe) e' (Sil.pp_exp_printenv pe) idx
(strexp_to_string pe coo) a (get_contents pe coo) linner
and get_contents_single pe coo f (e, se) =
let e_no_special_char = strip_special_chars (Exp.to_string e) in
F.fprintf f "{ <%s> %a : %a }"
e_no_special_char (Sil.pp_exp_printenv pe) e (get_contents_sexp pe coo) se
and get_contents pe coo f = function
| [] -> ()
| [idx_se] ->
F.fprintf f "%a" (get_contents_single pe coo) idx_se
| idx_se:: l ->
F.fprintf f "%a | %a" (get_contents_single pe coo) idx_se (get_contents pe coo) l
(* true if node is the sorce node of the expression e*)
let is_source_node_of_exp e node =
match node with
| Dotpointsto (_, e', _) -> Exp.equal e e'
| _ -> false
(* given a node returns its coordinates and the expression. Return -1 in case the expression doesn't*)
(* make sense for that case *)
let get_coordinate_and_exp dotnode =
match dotnode with
| Dotnil(coo) -> (coo, Exp.minus_one)
| Dotarray (coo, _, _, _, _, _) -> (coo, Exp.minus_one)
| Dotpointsto (coo, b, _)
| Dotlseg (coo, b, _, _, _, _)
| Dotdllseg (coo, b, _, _, _, _, _, _)
| Dotstruct (coo, b, _, _, _)
| Dotdangling(coo, b, _) -> (coo, b)
(* true if a node is of a Dotstruct *)
let is_not_struct node =
match node with
| Dotstruct _ -> false
| _ -> true
(* returns the id field of the coordinate of node *)
let get_coordinate_id node =
let coo = fst (get_coordinate_and_exp node) in
coo.id
let rec look_up_for_back_pointer e dotnodes lambda =
match dotnodes with
| [] -> []
| Dotdllseg(coo, _, _, _, e4, _, _, _):: dotnodes' ->
if Exp.equal e e4 && Int.equal lambda coo.lambda then [coo.id + 1]
else look_up_for_back_pointer e dotnodes' lambda
| _:: dotnodes' -> look_up_for_back_pointer e dotnodes' lambda
(* get the nodes corresponding to an expression and a lambda*)
let rec select_nodes_exp_lambda dotnodes e lambda =
match dotnodes with
| [] -> []
| node:: l' ->
let (coo, e') = get_coordinate_and_exp node in
if (Exp.equal e e') && Int.equal lambda coo.lambda
then node:: select_nodes_exp_lambda l' e lambda
else select_nodes_exp_lambda l' e lambda
(* look-up the coordinate id in the list of dotnodes those nodes which correspond to expression e*)
(* this is written in this strange way for legacy reason. It should be changed a bit*)
let look_up dotnodes e lambda =
let r = select_nodes_exp_lambda dotnodes e lambda in
let r'= List.map ~f:get_coordinate_id r in
r' @ look_up_for_back_pointer e dotnodes lambda
let reset_proposition_counter () = proposition_counter:= 0
let reset_dotty_spec_counter () = spec_counter:= 0
let color_to_str (c : Pp.color) =
match c with
| Black -> "black"
| Blue -> "blue"
| Green -> "green"
| Orange -> "orange"
| Red -> "red"
let make_dangling_boxes pe allocated_nodes (sigma_lambda: (Sil.hpred * int) list) =
let exp_color hpred (exp : Exp.t) =
if Pp.equal_color (pe.Pp.cmap_norm (Obj.repr hpred)) Pp.Red then Pp.Red
else pe.Pp.cmap_norm (Obj.repr exp) in
let get_rhs_predicate (hpred, lambda) =
let n = !dotty_state_count in
incr dotty_state_count;
let coo = mk_coordinate n lambda in
(match hpred with
| Sil.Hpointsto (_, Sil.Eexp (e, _), _)
when not (Exp.equal e Exp.zero) && !print_full_prop ->
let e_color_str = color_to_str (exp_color hpred e) in
[Dotdangling(coo, e, e_color_str)]
| Sil.Hlseg (_, _, _, e2, _) when not (Exp.equal e2 Exp.zero) ->
let e2_color_str = color_to_str (exp_color hpred e2) in
[Dotdangling(coo, e2, e2_color_str)]
| Sil.Hdllseg (_, _, _, e2, e3, _, _) ->
let e2_color_str = color_to_str (exp_color hpred e2) in
let e3_color_str = color_to_str (exp_color hpred e3) in
let ll = if not (Exp.equal e2 Exp.zero) then
[Dotdangling(coo, e2, e2_color_str)]
else [] in
if not (Exp.equal e3 Exp.zero) then Dotdangling(coo, e3, e3_color_str):: ll
else ll
| Sil.Hpointsto (_, _, _)
| _ -> [] (* arrays and struct do not give danglings*)
) in
let is_allocated d =
match d with
| Dotdangling(_, e, _) ->
List.exists ~f:(fun a -> match a with
| Dotpointsto(_, e', _)
| Dotarray(_, _, e', _, _, _)
| Dotlseg(_, e', _, _, _, _)
| Dotdllseg(_, e', _, _, _, _, _, _) -> Exp.equal e e'
| _ -> false
) allocated_nodes
| _ -> false (*this should never happen since d must be a dangling node *) in
let rec filter_duplicate l seen_exp =
match l with
| [] -> []
| Dotdangling(coo, e, color):: l' ->
if (List.exists ~f:(Exp.equal e) seen_exp) then filter_duplicate l' seen_exp
else Dotdangling(coo, e, color):: filter_duplicate l' (e:: seen_exp)
| box:: l' -> box:: filter_duplicate l' seen_exp (* this case cannot happen*) in
let rec subtract_allocated candidate_dangling =
match candidate_dangling with
| [] -> []
| d:: candidates ->
if (is_allocated d) then subtract_allocated candidates
else d:: subtract_allocated candidates in
let candidate_dangling = List.concat_map ~f:get_rhs_predicate sigma_lambda in
let candidate_dangling = filter_duplicate candidate_dangling [] in
let dangling = subtract_allocated candidate_dangling in
dangling_dotboxes:= dangling
let rec dotty_mk_node pe sigma =
let n = !dotty_state_count in
incr dotty_state_count;
let do_hpred_lambda exp_color = function
| (Sil.Hpointsto (e, Sil.Earray (e', l, _), Exp.Sizeof {typ={Typ.desc=Tarray (t, _, _)}}),
lambda) ->
incr dotty_state_count; (* increment once more n+1 is the box for the array *)
let e_color_str = color_to_str (exp_color e) in
let e_color_str'= color_to_str (exp_color e') in
[Dotpointsto((mk_coordinate n lambda), e, e_color_str);
Dotarray((mk_coordinate (n + 1) lambda), e, e', l, t, e_color_str')]
| (Sil.Hpointsto (e, Sil.Estruct (l, _), te), lambda) ->
incr dotty_state_count; (* increment once more n+1 is the box for the struct *)
let e_color_str = color_to_str (exp_color e) in
(* [Dotpointsto((mk_coordinate n lambda), e, l, true, e_color_str)] *)
[Dotpointsto((mk_coordinate n lambda), e, e_color_str);
Dotstruct((mk_coordinate (n + 1) lambda), e, l, e_color_str, te);]
| (Sil.Hpointsto (e, _, _), lambda) ->
let e_color_str = color_to_str (exp_color e) in
if List.mem ~equal:Exp.equal !struct_exp_nodes e then [] else
[Dotpointsto((mk_coordinate n lambda), e, e_color_str)]
| (Sil.Hlseg (k, hpara, e1, e2, _), lambda) ->
incr dotty_state_count; (* increment once more n+1 is the box for last element of the list *)
let eq_color_str = color_to_str (exp_color e1) in
[Dotlseg((mk_coordinate n lambda), e1, e2, k, hpara.Sil.body, eq_color_str)]
| (Sil.Hdllseg (k, hpara_dll, e1, e2, e3, e4, _), lambda) ->
let e1_color_str = color_to_str (exp_color e1) in
incr dotty_state_count; (* increment once more n+1 is the box for e4 *)
[Dotdllseg((mk_coordinate n lambda), e1, e2, e3, e4, k, hpara_dll.Sil.body_dll, e1_color_str)] in
match sigma with
| [] -> []
| (hpred, lambda) :: sigma' ->
let exp_color (exp : Exp.t) =
if Pp.equal_color (pe.Pp.cmap_norm (Obj.repr hpred)) Pp.Red then Pp.Red
else pe.Pp.cmap_norm (Obj.repr exp) in
do_hpred_lambda exp_color (hpred, lambda) @ dotty_mk_node pe sigma'
let set_exps_neq_zero pi =
let f = function
| Sil.Aneq (e, Exp.Const (Const.Cint i)) when IntLit.iszero i ->
exps_neq_zero := e :: !exps_neq_zero
| _ -> () in
exps_neq_zero := [];
List.iter ~f pi
let box_dangling e =
let entry_e = List.filter ~f:(fun b -> match b with
| Dotdangling(_, e', _) -> Exp.equal e e' | _ -> false ) !dangling_dotboxes in
match entry_e with
|[] -> None
| Dotdangling(coo, _, _):: _ -> Some coo.id
| _ -> None (* NOTE: this cannot be possible since entry_e can be composed only by Dotdangling, see def of entry_e*)
(* construct a Dotnil and returns it's id *)
let make_nil_node lambda =
let n = !dotty_state_count in
incr dotty_state_count;
nil_dotboxes:= Dotnil(mk_coordinate n lambda)::!nil_dotboxes;
n
let compute_fields_struct sigma =
fields_structs:=[];
let rec do_strexp se in_struct =
match se with
| Sil.Eexp (e, _) -> if in_struct then fields_structs:= e ::!fields_structs else ()
| Sil.Estruct (l, _) -> List.iter ~f:(fun e -> do_strexp e true) (snd (List.unzip l))
| Sil.Earray (_, l, _) -> List.iter ~f:(fun e -> do_strexp e false) (snd (List.unzip l)) in
let rec fs s =
match s with
| [] -> ()
| Sil.Hpointsto(_, se, _):: s' -> do_strexp se false; fs s'
| _:: s' -> fs s' in
fs sigma
let compute_struct_exp_nodes sigma =
struct_exp_nodes:=[];
let rec sen s =
match s with
| [] -> ()
| Sil.Hpointsto(e, Sil.Estruct _, _):: s' -> struct_exp_nodes:= e::!struct_exp_nodes; sen s'
| _:: s' -> sen s' in
sen sigma
(* returns the expression of a node*)
let get_node_exp n = snd (get_coordinate_and_exp n)
let is_nil e prop =
(Exp.equal e Exp.zero) || (Prover.check_equal (Tenv.create ()) prop e Exp.zero)
(* an edge is in cycle *)
let in_cycle cycle edge =
match cycle with
| Some cycle' ->
let (fn, se) = edge in
List.exists
~f:(fun (_,fn',se') -> Typ.Fieldname.equal fn fn' && Sil.equal_strexp se se')
cycle'
| _ -> false
let node_in_cycle cycle node =
match cycle, node with
| Some _, Dotstruct(_, _, l, _,_) -> (* only struct nodes can be in cycle *)
List.exists ~f:(in_cycle cycle) l
| _ -> false
(* compute a list of (kind of link, field name, coo.id target, name_target) *)
let rec compute_target_struct_fields dotnodes list_fld p f lambda cycle =
let find_target_one_fld (fn, se) =
match se with
| Sil.Eexp (e, _) ->
if is_nil e p then begin
let n'= make_nil_node lambda in
if !print_full_prop then
[(LinkStructToExp, Typ.Fieldname.to_string fn, n',"")]
else []
end else
let nodes_e = select_nodes_exp_lambda dotnodes e lambda in
(match nodes_e with
| [] ->
(match box_dangling e with
| None -> []
| Some n' -> [(LinkStructToExp, Typ.Fieldname.to_string fn, n',"")]
)
| [node] | [Dotpointsto _ ; node] | [node; Dotpointsto _] ->
let n = get_coordinate_id node in
if List.mem ~equal:Exp.equal !struct_exp_nodes e then begin
let e_no_special_char = strip_special_chars (Exp.to_string e) in
let link_kind = if (in_cycle cycle (fn, se)) && (not !print_full_prop) then
LinkRetainCycle
else LinkStructToStruct in
[(link_kind, Typ.Fieldname.to_string fn, n, e_no_special_char)]
end else
[(LinkStructToExp, Typ.Fieldname.to_string fn, n,"")]
| _ -> (* by construction there must be at most 2 nodes for an expression*)
L.internal_error "@\n Too many nodes! Error! @\n@."; assert false)
| Sil.Estruct (_, _) -> [] (* inner struct are printed by print_struc function *)
| Sil.Earray _ -> [] (* inner arrays are printed by print_array function *) in
match list_fld with
| [] -> []
| a:: list_fld' ->
let targets_a = find_target_one_fld a in
targets_a @ compute_target_struct_fields dotnodes list_fld' p f lambda cycle
(* compute a list of (kind of link, field name, coo.id target, name_target) *)
let rec compute_target_array_elements dotnodes list_elements p f lambda =
let find_target_one_element (idx, se) =
match se with
| Sil.Eexp (e, _) ->
if is_nil e p then begin
let n'= make_nil_node lambda in
[(LinkArrayToExp, Exp.to_string idx, n',"")]
end else
let nodes_e = select_nodes_exp_lambda dotnodes e lambda in
(match nodes_e with
| [] ->
(match box_dangling e with
| None -> []
| Some n' -> [(LinkArrayToExp, Exp.to_string idx, n',"")]
)
| [node] | [Dotpointsto _ ; node] | [node; Dotpointsto _] ->
let n = get_coordinate_id node in
if List.mem ~equal:Exp.equal !struct_exp_nodes e then begin
let e_no_special_char = strip_special_chars (Exp.to_string e) in
[(LinkArrayToStruct, Exp.to_string idx, n, e_no_special_char)]
end else
[(LinkArrayToExp, Exp.to_string idx, n,"")]
| _ -> (* by construction there must be at most 2 nodes for an expression*)
L.internal_error "@\nToo many nodes! Error!@\n@."; assert false
)
| Sil.Estruct (_, _) -> [] (* inner struct are printed by print_struc function *)
| Sil.Earray _ ->[] (* inner arrays are printed by print_array function *)
in
match list_elements with
| [] -> []
| a:: list_ele' ->
let targets_a = find_target_one_element a in
targets_a @ compute_target_array_elements dotnodes list_ele' p f lambda
let compute_target_from_eexp dotnodes e p lambda =
if is_nil e p then
let n'= make_nil_node lambda in
[(LinkExpToExp, n', "")]
else
let nodes_e = select_nodes_exp_lambda dotnodes e lambda in
let nodes_e_no_struct = List.filter ~f:is_not_struct nodes_e in
let trg = List.map ~f:get_coordinate_id nodes_e_no_struct in
(match trg with
| [] ->
(match box_dangling e with
| None -> []
| Some n -> [(LinkExpToExp, n, "")]
)
| _ -> List.map ~f:(fun n -> (LinkExpToExp, n, "")) trg
)
(* build the set of edges between nodes *)
let rec dotty_mk_set_links dotnodes sigma p f cycle =
let make_links_for_arrays e lie lambda sigma' = (* used for both Earray and ENarray*)
let src = look_up dotnodes e lambda in
match src with
| [] -> assert false
| n:: nl ->
let target_list = compute_target_array_elements dotnodes lie p f lambda in
(* below it's n+1 because n is the address, n+1 is the actual array node*)
let ff n =
List.map
~f:(fun (k, lab_src, m, lab_trg) ->
mk_link
k
(mk_coordinate (n + 1) lambda)
(strip_special_chars lab_src)
(mk_coordinate m lambda)
(strip_special_chars lab_trg))
target_list in
let links_from_elements = List.concat_map ~f:ff (n:: nl) in
let trg_label = strip_special_chars (Exp.to_string e) in
let lnk = mk_link (LinkToArray) (mk_coordinate n lambda) "" (mk_coordinate (n + 1) lambda) trg_label in
lnk :: links_from_elements @ dotty_mk_set_links dotnodes sigma' p f cycle in
match sigma with
| [] -> []
| (Sil.Hpointsto (e, Sil.Earray(_, lie, _), _), lambda):: sigma' ->
make_links_for_arrays e lie lambda sigma'
| (Sil.Hpointsto (e, Sil.Estruct (lfld, _), _), lambda):: sigma' ->
let src = look_up dotnodes e lambda in
(match src with
| [] -> assert false
| nl ->
(* L.out "@\n@\n List of nl= "; List.iter ~f:(L.out " %i ") nl; L.out "@.@.@."; *)
let target_list = compute_target_struct_fields dotnodes lfld p f lambda cycle in
let ff n = List.map ~f:(fun (k, lab_src, m, lab_trg) ->
mk_link k (mk_coordinate n lambda) lab_src (mk_coordinate m lambda) lab_trg
) target_list in
let nodes_e = select_nodes_exp_lambda dotnodes e lambda in
let address_struct_id =
try get_coordinate_id (List.hd_exn (List.filter ~f:(is_source_node_of_exp e) nodes_e))
with exn when SymOp.exn_not_failure exn -> assert false in
(* we need to exclude the address node from the sorce of fields. no fields should start from there*)
let nl'= List.filter ~f:(fun id -> address_struct_id <> id) nl in
let links_from_fields = List.concat_map ~f:ff nl' in
let lnk_from_address_struct = if !print_full_prop then
let trg_label = strip_special_chars (Exp.to_string e) in
[mk_link (LinkExpToStruct) (mk_coordinate address_struct_id lambda) ""
(mk_coordinate (address_struct_id + 1) lambda) trg_label]
else [] in
lnk_from_address_struct @ links_from_fields @
dotty_mk_set_links dotnodes sigma' p f cycle)
| (Sil.Hpointsto (e, Sil.Eexp (e', _), _), lambda):: sigma' ->
let src = look_up dotnodes e lambda in
(match src with
| [] -> assert false
| nl -> if !print_full_prop then
let target_list = compute_target_from_eexp dotnodes e' p lambda in
let ff n = List.map ~f:(fun (k, m, lab_target) ->
mk_link k (mk_coordinate n lambda) ""
(mk_coordinate m lambda) (strip_special_chars lab_target)
) target_list in
let ll = List.concat_map ~f:ff nl in
ll @ dotty_mk_set_links dotnodes sigma' p f cycle
else dotty_mk_set_links dotnodes sigma' p f cycle)
| (Sil.Hlseg (_, _, e1, e2, _), lambda):: sigma' ->
let src = look_up dotnodes e1 lambda in
(match src with
| [] -> assert false
| n:: _ ->
let (_, m, lab) = List.hd_exn (compute_target_from_eexp dotnodes e2 p lambda) in
let lnk = mk_link LinkToSSL (mk_coordinate (n + 1) lambda) "" (mk_coordinate m lambda) lab in
lnk:: dotty_mk_set_links dotnodes sigma' p f cycle
)
| (Sil.Hdllseg (_, _, e1, e2, e3, _, _), lambda):: sigma' ->
let src = look_up dotnodes e1 lambda in
(match src with
| [] -> assert false
| n:: _ -> (* n is e1's box and n+1 is e4's box *)
let targetF = look_up dotnodes e3 lambda in
let target_Flink = (match targetF with
| [] -> []
| m:: _ -> [mk_link LinkToDLL (mk_coordinate (n + 1) lambda) "" (mk_coordinate m lambda) ""]
) in
let targetB = look_up dotnodes e2 lambda in
let target_Blink = (match targetB with
| [] -> []
| m:: _ -> [mk_link LinkToDLL (mk_coordinate n lambda) "" (mk_coordinate m lambda) ""]
) in
target_Blink @ target_Flink @ dotty_mk_set_links dotnodes sigma' p f cycle
)
let print_kind f kind =
incr dotty_state_count;
match kind with
| Spec_precondition ->
incr dotty_state_count;
current_pre:=!dotty_state_count;
F.fprintf f "@\n PRE%iL0 [label=\"PRE %i \", style=filled, color= yellow]@\n"
!dotty_state_count !spec_counter;
print_stack_info:= true;
| Spec_postcondition _ ->
F.fprintf f "@\n POST%iL0 [label=\"POST %i \", style=filled, color= yellow]@\n"
!dotty_state_count !post_counter;
print_stack_info:= true;
| Generic_proposition ->
if !print_full_prop then
F.fprintf f "@\n HEAP%iL0 [label=\"HEAP %i \", style=filled, color= yellow]@\n"
!dotty_state_count
!proposition_counter
| Lambda_pred (no, lev, array) ->
match array with
| false ->
F.fprintf f "style=dashed; color=blue \
@\n state%iL%i \
[label=\"INTERNAL STRUCTURE %i \", style=filled, color= lightblue]@\n"
!dotty_state_count !lambda_counter !lambda_counter ;
F.fprintf f "state%iL%i -> state%iL%i [color=\"lightblue \" arrowhead=none] @\n"
!dotty_state_count !lambda_counter no lev;
| true ->
F.fprintf f "style=dashed; color=blue \
@\n state%iL%i \
[label=\"INTERNAL STRUCTURE %i \", style=filled, color= lightblue]@\n"
!dotty_state_count !lambda_counter !lambda_counter ;
(* F.fprintf f "state%iL%i -> struct%iL%i:%s [color=\"lightblue \" arrowhead=none] @\n"
!dotty_state_count !lambda_counter no lev lab;*)
incr dotty_state_count
(* print a link between two nodes in the graph *)
let dotty_pp_link f link =
let n1 = link.src.id in
let lambda1 = link.src.lambda in
let n2 = link.trg.id in
let lambda2 = link.trg.lambda in
let src_fld = link.src_fld in
let trg_fld = link.trg_fld in
match n2, link.kind with
| 0, _ when !print_full_prop ->
F.fprintf f "state%iL%i -> state%iL%i[label=\"%s DANG\", color= red];@\n"
n1 lambda1 n2 lambda2 src_fld
| _, LinkToArray when !print_full_prop ->
F.fprintf f "state%iL%i -> struct%iL%i:%s%iL%i[label=\"\"]@\n"
n1 lambda1 n2 lambda2 trg_fld n2 lambda2
| _, LinkExpToStruct when !print_full_prop ->
F.fprintf f "state%iL%i -> struct%iL%i:%s%iL%i[label=\"\"]@\n"
n1 lambda1 n2 lambda2 trg_fld n2 lambda2
| _, LinkStructToExp when !print_full_prop ->
F.fprintf f "struct%iL%i:%s%iL%i -> state%iL%i[label=\"\"]@\n"
n1 lambda1 src_fld n1 lambda1 n2 lambda2
| _, LinkRetainCycle ->
F.fprintf f "struct%iL%i:%s%iL%i -> struct%iL%i:%s%iL%i[label=\"\", color= red]@\n"
n1 lambda1 src_fld n1 lambda1 n2 lambda2 trg_fld n2 lambda2
| _, LinkStructToStruct when !print_full_prop ->
F.fprintf f "struct%iL%i:%s%iL%i -> struct%iL%i:%s%iL%i[label=\"\"]@\n"
n1 lambda1 src_fld n1 lambda1 n2 lambda2 trg_fld n2 lambda2
| _, LinkArrayToExp when !print_full_prop ->
F.fprintf f "struct%iL%i:%s -> state%iL%i[label=\"\"]@\n" n1 lambda1 src_fld n2 lambda2
| _, LinkArrayToStruct when !print_full_prop ->
F.fprintf f "struct%iL%i:%s -> struct%iL%i[label=\"\"]@\n" n1 lambda1 src_fld n2 lambda2
| _, _ -> if !print_full_prop then
F.fprintf f "state%iL%i -> state%iL%i[label=\"%s\"];@\n" n1 lambda1 n2 lambda2 src_fld
else ()
(* given the list of nodes and links get rid of spec nodes that are not pointed to by anybody*)
let filter_useless_spec_dollar_box (nodes: dotty_node list) (links: link list) =
let tmp_nodes = ref nodes in
let tmp_links = ref links in
let remove_links_from ln =
List.filter
~f:(fun n' -> not (List.mem ~equal:equal_link ln n'))
!tmp_links in
let remove_node n ns =
List.filter ~f:(fun n' -> match n' with
| Dotpointsto _ -> (get_coordinate_id n') <> (get_coordinate_id n)
| _ -> true
) ns in
let rec boxes_pointed_by n lns =
match lns with
| [] -> []
| l:: ln' -> let n_id = get_coordinate_id n in
if Int.equal l.src.id n_id && String.equal l.src_fld "" then (
(*L.out "@\n Found link (%i,%i)" l.src.id l.trg.id;*)
l:: boxes_pointed_by n ln'
)
else boxes_pointed_by n ln' in
let rec boxes_pointing_at n lns =
match lns with
| [] -> []
| l:: ln' -> let n_id = get_coordinate_id n in
if Int.equal l.trg.id n_id && String.equal l.trg_fld "" then (
(*L.out "@\n Found link (%i,%i)" l.src.id l.trg.id;*)
l:: boxes_pointing_at n ln' )
else boxes_pointing_at n ln' in
let is_spec_variable = function
| Exp.Var id ->
Ident.is_normal id && Ident.equal_name (Ident.get_name id) Ident.name_spec
| _ -> false in
let handle_one_node node =
match node with
| Dotpointsto _ ->
let e = get_node_exp node in
if is_spec_variable e then begin
let links_from_node = boxes_pointed_by node links in
let links_to_node = boxes_pointing_at node links in
if List.is_empty links_to_node then begin
tmp_links:= remove_links_from links_from_node ;
tmp_nodes:= remove_node node !tmp_nodes;
end
end
| _ -> () in
List.iter ~f:handle_one_node nodes;
(!tmp_nodes,!tmp_links)
(* print a struct node *)
let rec print_struct f pe e te l coo c =
let print_type = match te with
| Exp.Sizeof {typ} ->
let str_t = Typ.to_string typ in
(match Str.split_delim (Str.regexp_string Config.anonymous_block_prefix) str_t with
| [_; _] -> "BLOCK object"
| _ -> str_t)
| _ -> Exp.to_string te in
let n = coo.id in
let lambda = coo.lambda in
let e_no_special_char = strip_special_chars (Exp.to_string e) in
F.fprintf f "subgraph structs_%iL%i {@\n" n lambda ;
if !print_full_prop then
F.fprintf f
" node [shape=record]; @\n struct%iL%i \
[label=\"{<%s%iL%i> STRUCT: %a } | %a\" ] fontcolor=%s@\n"
n lambda
e_no_special_char n lambda (Sil.pp_exp_printenv pe) e (struct_to_dotty_str pe coo) l c
else
F.fprintf f
" node [shape=record]; @\n struct%iL%i \
[label=\"{<%s%iL%i> OBJECT: %s } | %a\" ] fontcolor=%s@\n"
n lambda e_no_special_char n lambda print_type (struct_to_dotty_str pe coo) l c;
F.fprintf f "}@\n"
and print_array f pe e1 e2 l coo c =
let n = coo.id in
let lambda = coo.lambda in
let e_no_special_char = strip_special_chars (Exp.to_string e1) in
F.fprintf f "subgraph structs_%iL%i {@\n" n lambda ;
F.fprintf f " node [shape=record]; @\n struct%iL%i \
[label=\"{<%s%iL%i> ARRAY| SIZE: %a } | %a\" ] fontcolor=%s@\n"
n lambda e_no_special_char n lambda (Sil.pp_exp_printenv pe) e2 (get_contents pe coo) l c;
F.fprintf f "}@\n"
and print_sll f pe nesting k e1 coo =
let n = coo.id in
let lambda = coo.lambda in
let n' = !dotty_state_count in
incr dotty_state_count;
begin
match k with
| Sil.Lseg_NE ->
F.fprintf f "subgraph cluster_%iL%i { \
style=filled; color=lightgrey; node [style=filled,color=white]; \
label=\"list NE\";" n' lambda (*pp_nesting nesting*)
| Sil.Lseg_PE ->
F.fprintf f "subgraph cluster_%iL%i { \
style=filled; color=lightgrey; node [style=filled,color=white]; \
label=\"list PE\";" n' lambda (*pp_nesting nesting *)
end;
F.fprintf f "state%iL%i [label=\"%a\"]@\n" n lambda (Sil.pp_exp_printenv pe) e1;
let n' = !dotty_state_count in
incr dotty_state_count;
F.fprintf f "state%iL%i [label=\"... \" style=filled color=lightgrey] @\n" n' lambda ;
F.fprintf f "state%iL%i -> state%iL%i [label=\" \"] @\n" n lambda n' lambda ;
F.fprintf f "state%iL%i [label=\" \"] @\n" (n + 1) lambda ;
F.fprintf f "state%iL%i -> state%iL%i [label=\" \"] }" n' lambda (n + 1) lambda ;
incr lambda_counter;
pp_dotty f (Lambda_pred(n + 1, lambda, false))
(Prop.normalize (Tenv.create ()) (Prop.from_sigma nesting)) None
and print_dll f pe nesting k e1 e4 coo =
let n = coo.id in
let lambda = coo.lambda in
let n' = !dotty_state_count in
incr dotty_state_count;
begin
match k with
| Sil.Lseg_NE ->
F.fprintf f "subgraph cluster_%iL%i { \
style=filled; color=lightgrey; node [style=filled,color=white]; \
label=\"doubly-linked list NE\";" n' lambda (*pp_nesting nesting *)
| Sil.Lseg_PE ->
F.fprintf f "subgraph cluster_%iL%i { \
style=filled; color=lightgrey; node [style=filled,color=white]; \
label=\"doubly-linked list PE\";" n' lambda (*pp_nesting nesting *)
end;
F.fprintf f "state%iL%i [label=\"%a\"]@\n" n lambda (Sil.pp_exp_printenv pe) e1;
let n' = !dotty_state_count in
incr dotty_state_count;
F.fprintf f "state%iL%i [label=\"... \" style=filled color=lightgrey] @\n" n' lambda;
F.fprintf f "state%iL%i -> state%iL%i [label=\" \"]@\n" n lambda n' lambda;
F.fprintf f "state%iL%i -> state%iL%i [label=\" \"]@\n" n' lambda n lambda;
F.fprintf f "state%iL%i [label=\"%a\"]@\n" (n + 1) lambda (Sil.pp_exp_printenv pe) e4;
F.fprintf f "state%iL%i -> state%iL%i [label=\" \"]@\n" (n + 1) lambda n' lambda;
F.fprintf f "state%iL%i -> state%iL%i [label=\" \"]}@\n" n' lambda (n + 1) lambda ;
incr lambda_counter;
pp_dotty f (Lambda_pred(n', lambda, false))
(Prop.normalize (Tenv.create ()) (Prop.from_sigma nesting)) None
and dotty_pp_state f pe cycle dotnode =
let dotty_exp coo e c is_dangling =
let n = coo.id in
let lambda = coo.lambda in
if is_dangling then
F.fprintf f "state%iL%i [label=\"%a \", color=red, style=dashed, fontcolor=%s]@\n"
n lambda (Sil.pp_exp_printenv pe) e c
else
F.fprintf f "state%iL%i [label=\"%a\" fontcolor=%s]@\n"
n lambda (Sil.pp_exp_printenv pe) e c in
match dotnode with
| Dotnil coo when !print_full_prop ->
F.fprintf f "state%iL%i [label=\"NIL \", color=green, style=filled]@\n" coo.id coo.lambda
| Dotdangling(coo, e, c) when !print_full_prop -> dotty_exp coo e c true
| Dotpointsto(coo, e1, c) when !print_full_prop -> dotty_exp coo e1 c false
| Dotstruct(coo, e1, l, c,te) ->
let l' = if !print_full_prop then l
else List.filter ~f:(fun edge -> in_cycle cycle edge) l in
print_struct f pe e1 te l' coo c
| Dotarray(coo, e1, e2, l, _, c) when !print_full_prop -> print_array f pe e1 e2 l coo c
| Dotlseg(coo, e1, _, Sil.Lseg_NE, nesting, _) when !print_full_prop ->
print_sll f pe nesting Sil.Lseg_NE e1 coo
| Dotlseg(coo, e1, _, Sil.Lseg_PE, nesting, _) when !print_full_prop ->
print_sll f pe nesting Sil.Lseg_PE e1 coo
| Dotdllseg(coo, e1, _, _, e4, Sil.Lseg_NE, nesting, _) when !print_full_prop ->
print_dll f pe nesting Sil.Lseg_NE e1 e4 coo
| Dotdllseg(coo, e1, _, _, e4, Sil.Lseg_PE, nesting, _) when !print_full_prop ->
print_dll f pe nesting Sil.Lseg_PE e1 e4 coo
| _ -> ()
(* Build the graph data structure to be printed *)
and build_visual_graph f pe p cycle =
let sigma = p.Prop.sigma in
compute_fields_struct sigma;
compute_struct_exp_nodes sigma;
(* L.out "@\n@\n Computed fields structs: ";
List.iter ~f:(fun e -> L.out " %a " (Sil.pp_exp_printenv pe) e) !fields_structs;
L.out "@\n@.";
L.out "@\n@\n Computed exp structs nodes: ";
List.iter ~f:(fun e -> L.out " %a " (Sil.pp_exp_printenv pe) e) !struct_exp_nodes;
L.out "@\n@."; *)
let sigma_lambda = List.map ~f:(fun hp -> (hp,!lambda_counter)) sigma in
let nodes = (dotty_mk_node pe) sigma_lambda in
if !print_full_prop then make_dangling_boxes pe nodes sigma_lambda;
let links = dotty_mk_set_links nodes sigma_lambda p f cycle in
filter_useless_spec_dollar_box nodes links
and display_pure_info f pe prop =
let print_invisible_objects () =
for j = 1 to 4 do
F.fprintf f " inv_%i%i [style=invis]@\n" !spec_counter j;
F.fprintf f " inv_%i%i%i [style=invis]@\n" !spec_counter j j;
F.fprintf f " inv_%i%i%i%i [style=invis]@\n" !spec_counter j j j;
done;
for j = 1 to 4 do
F.fprintf f " state_pi_%i -> inv_%i%i [style=invis]@\n" !proposition_counter !spec_counter j;
F.fprintf f " inv_%i%i -> inv_%i%i%i [style=invis]@\n" !spec_counter j !spec_counter j j;
F.fprintf f " inv_%i%i%i -> inv_%i%i%i%i [style=invis]@\n"
!spec_counter j j !spec_counter j j j;
done in
let pure = Prop.get_pure prop in
F.fprintf f "subgraph {@\n";
F.fprintf f " node [shape=box]; \
@\n state_pi_%i [label=\"STACK \\n\\n %a\" color=orange style=filled]@\n"
!proposition_counter (Prop.pp_pi pe) pure;
if !invisible_arrows then print_invisible_objects ();
F.fprintf f "}@\n"
(** Pretty print a proposition in dotty format. *)
and pp_dotty f kind (_prop: Prop.normal Prop.t) cycle =
incr proposition_counter;
let pe, prop = match kind with
| Spec_postcondition pre ->
target_invisible_arrow_pre:=!proposition_counter;
let diff = Propgraph.compute_diff Black (Propgraph.from_prop pre) (Propgraph.from_prop _prop) in
let cmap_norm = Propgraph.diff_get_colormap false diff in
let cmap_foot = Propgraph.diff_get_colormap true diff in
let pe = { (Prop.prop_update_obj_sub Pp.text pre) with cmap_norm; cmap_foot } in
(* add stack vars from pre *)
let pre_stack = fst (Prop.sigma_get_stack_nonstack true pre.Prop.sigma) in
let prop = Prop.set _prop ~sigma:(pre_stack @ _prop.Prop.sigma) in
pe, Prop.normalize (Tenv.create ()) prop
| _ ->
let pe = Prop.prop_update_obj_sub Pp.text _prop in
pe, _prop in
dangling_dotboxes := [];
nil_dotboxes :=[];
set_exps_neq_zero prop.Prop.pi;
incr dotty_state_count;
F.fprintf f "@\n subgraph cluster_prop_%i { color=black @\n" !proposition_counter;
print_kind f kind;
if !print_stack_info then begin
display_pure_info f pe prop;
print_stack_info:= false
end;
(* F.fprintf f "@\n subgraph cluster_%i { color=black @\n" !dotty_state_count; *)
let (nodes, links) = build_visual_graph f pe prop cycle in
let all_nodes = (nodes @ !dangling_dotboxes @ !nil_dotboxes) in
if !print_full_prop then
List.iter ~f:((dotty_pp_state f pe) cycle) all_nodes
else
List.iter ~f:(fun node ->
if node_in_cycle cycle node then (dotty_pp_state f pe) cycle node) all_nodes;
List.iter ~f:(dotty_pp_link f) links;
(* F.fprintf f "@\n } @\n"; *)
F.fprintf f "@\n } @\n"
let pp_dotty_one_spec f pre posts =
post_counter := 0;
incr spec_counter;
incr proposition_counter;
incr dotty_state_count;
F.fprintf f "@\n subgraph cluster_%i { color=blue @\n" !dotty_state_count;
incr dotty_state_count;
F.fprintf f "@\n state%iL0 [label=\"SPEC %i \", style=filled, color= lightblue]@\n"
!dotty_state_count !spec_counter;
spec_id:=!dotty_state_count;
invisible_arrows:= true;
pp_dotty f Spec_precondition pre None;
invisible_arrows:= false;
List.iter ~f:(fun (po, _) -> incr post_counter ; pp_dotty f (Spec_postcondition pre) po None;
for j = 1 to 4 do
F.fprintf f " inv_%i%i%i%i -> state_pi_%i [style=invis]@\n"
!spec_counter
j
j
j
!target_invisible_arrow_pre;
done
) posts;
F.fprintf f "@\n } @\n"
(* this is used to print a list of proposition when considered in a path of nodes *)
let pp_dotty_prop_list_in_path f plist prev_n curr_n =
try
incr proposition_counter;
incr dotty_state_count;
F.fprintf f "@\n subgraph cluster_%i { color=blue @\n" !dotty_state_count;
incr dotty_state_count;
F.fprintf f "@\n state%iN [label=\"NODE %i \", style=filled, color= lightblue]@\n"
curr_n curr_n;
List.iter ~f:(fun po -> incr proposition_counter ;
pp_dotty f Generic_proposition po None) plist;
if prev_n <> - 1 then F.fprintf f "@\n state%iN ->state%iN@\n" prev_n curr_n;
F.fprintf f "@\n } @\n"
with exn when SymOp.exn_not_failure exn ->
()
let pp_dotty_prop fmt (prop, cycle) =
reset_proposition_counter ();
Format.fprintf fmt "@\n@\n@\ndigraph main { @\nnode [shape=box]; @\n";
Format.fprintf fmt "@\n compound = true; rankdir =LR; @\n";
pp_dotty fmt Generic_proposition prop (Some cycle);
Format.fprintf fmt "@\n}"
let dotty_prop_to_str prop cycle =
try
Some (F.asprintf "%a" (pp_dotty_prop) (prop, cycle))
with exn when SymOp.exn_not_failure exn -> None
(* create a dotty file with a single proposition *)
let dotty_prop_to_dotty_file fname prop cycle =
try
let out_dot = Out_channel.create fname in
let fmt_dot = Format.formatter_of_out_channel out_dot in
pp_dotty_prop fmt_dot (prop, cycle);
Out_channel.close out_dot
with exn when SymOp.exn_not_failure exn ->
()
(* This is used only to print a list of prop parsed with the external parser. Basically
deprecated.*)
let pp_proplist_parsed2dotty_file filename plist =
try
let pp_list f plist =
reset_proposition_counter ();
F.fprintf f "@\n@\n@\ndigraph main { @\nnode [shape=box];@\n";
F.fprintf f "@\n compound = true; @\n";
F.fprintf f "@\n /* size=\"12,7\"; ratio=fill;*/ @\n";
ignore (List.map ~f:(pp_dotty f Generic_proposition) plist);
F.fprintf f "@\n}" in
let outc = Out_channel.create filename in
let fmt = F.formatter_of_out_channel outc in
F.fprintf fmt "#### Dotty version: ####@.%a@.@." pp_list plist;
Out_channel.close outc
with exn when SymOp.exn_not_failure exn ->
()
(********** START of Print interprocedural cfgs in dotty format *)
(********** Print control flow graph (in dot form) for fundec to *)
(* channel. You have to compute an interprocedural cfg first *)
let pp_cfgnodename pname fmt (n : Procdesc.Node.t) =
F.fprintf fmt "\"%s_%d\"" (Typ.Procname.to_filename pname) (Procdesc.Node.get_id n :> int)
let pp_etlist fmt etl =
List.iter ~f:(fun (id, ty) ->
Format.fprintf fmt " %a:%a" Mangled.pp id (Typ.pp_full Pp.text) ty) etl
let pp_local_list fmt etl =
List.iter ~f:(fun (id, ty) ->
Format.fprintf fmt " %a:%a" Mangled.pp id (Typ.pp_full Pp.text) ty) etl
let pp_cfgnodelabel pdesc fmt (n : Procdesc.Node.t) =
let pp_label fmt n =
match Procdesc.Node.get_kind n with
| Procdesc.Node.Start_node pname ->
let pname_string = Typ.Procname.to_string pname in
Format.fprintf fmt "Start %s\\nFormals: %a\\nLocals: %a"
pname_string
pp_etlist (Procdesc.get_formals pdesc)
pp_local_list (Procdesc.get_locals pdesc);
if List.length (Procdesc.get_captured pdesc) <> 0 then
Format.fprintf fmt "\\nCaptured: %a"
pp_local_list (Procdesc.get_captured pdesc);
let attributes = Procdesc.get_attributes pdesc in
let method_annotation = attributes.ProcAttributes.method_annotation in
if not (Annot.Method.is_empty method_annotation) then
Format.fprintf fmt "\\nAnnotation: %a" (Annot.Method.pp pname_string) method_annotation
| Procdesc.Node.Exit_node pname ->
Format.fprintf fmt "Exit %s" (Typ.Procname.to_string pname)
| Procdesc.Node.Join_node ->
Format.fprintf fmt "+"
| Procdesc.Node.Prune_node (is_true_branch, _, _) ->
Format.fprintf fmt "Prune (%b branch)" is_true_branch
| Procdesc.Node.Stmt_node s -> Format.fprintf fmt " %s" s
| Procdesc.Node.Skip_node s -> Format.fprintf fmt "Skip %s" s in
let instr_string i =
let pp f = Sil.pp_instr Pp.text f i in
let str = F.asprintf "%t" pp in
Escape.escape_dotty str in
let pp_instrs fmt instrs =
List.iter ~f:(fun i -> F.fprintf fmt " %s\\n " (instr_string i)) instrs in
let instrs = Procdesc.Node.get_instrs n in
F.fprintf fmt "%d: %a \\n %a" (Procdesc.Node.get_id n :> int) pp_label n pp_instrs instrs
let pp_cfgnodeshape fmt (n: Procdesc.Node.t) =
match Procdesc.Node.get_kind n with
| Procdesc.Node.Start_node _
| Procdesc.Node.Exit_node _ -> F.fprintf fmt "color=yellow style=filled"
| Procdesc.Node.Prune_node _ -> F.fprintf fmt "shape=\"invhouse\""
| Procdesc.Node.Skip_node _ -> F.fprintf fmt "color=\"gray\""
| Procdesc.Node.Stmt_node _ -> F.fprintf fmt "shape=\"box\""
| _ -> F.fprintf fmt ""
let pp_cfgnode pdesc fmt (n: Procdesc.Node.t) =
let pname = Procdesc.get_proc_name pdesc in
F.fprintf fmt "%a [label=\"%a\" %a]@\n\t@\n"
(pp_cfgnodename pname) n
(pp_cfgnodelabel pdesc) n
pp_cfgnodeshape n;
let print_edge n1 n2 is_exn =
let color = if is_exn then "[color=\"red\" ]" else "" in
match Procdesc.Node.get_kind n2 with
| Procdesc.Node.Exit_node _
when is_exn -> (* don't print exception edges to the exit node *)
()
| _ ->
F.fprintf fmt "@\n\t %a -> %a %s;"
(pp_cfgnodename pname) n1
(pp_cfgnodename pname) n2
color in
List.iter ~f:(fun n' -> print_edge n n' false) (Procdesc.Node.get_succs n);
List.iter ~f:(fun n' -> print_edge n n' true) (Procdesc.Node.get_exn n)
(* * print control flow graph (in dot form) for fundec to channel let *)
(* print_cfg_channel (chan : out_channel) (fd : fundec) = let pnode (s: *)
(* stmt) = fprintf chan "%a@\n" d_cfgnode s in forallStmts pnode fd * *)
(* Print control flow graph (in dot form) for fundec to file let *)
(* print_cfg_filename (filename : string) (fd : fundec) = let chan = *)
(* open_out filename in begin print_cfg_channel chan fd; close_out chan; *)
(* end *)
(* Print the extra information related to the inteprocedural aspect, ie., *)
(* special node, and call / return edges *)
let print_icfg source fmt cfg =
let print_node pdesc node =
let loc = Procdesc.Node.get_loc node in
if (Config.dotty_cfg_libs || SourceFile.equal loc.Location.file source) then
F.fprintf fmt "%a@\n" (pp_cfgnode pdesc) node in
Cfg.iter_all_nodes ~sorted:true print_node cfg
let write_icfg_dotty_to_file source cfg fname =
let chan = Out_channel.create fname in
let fmt = Format.formatter_of_out_channel chan in
(* avoid phabricator thinking this file was generated by substituting substring with %s *)
F.fprintf fmt "/* %@%s */@\ndigraph iCFG {@\n" "generated";
print_icfg source fmt cfg;
F.fprintf fmt "}@\n";
Out_channel.close chan
let print_icfg_dotty source cfg =
let fname =
match Config.icfg_dotty_outfile with
| Some file -> file
| None when Config.frontend_tests ->
(SourceFile.to_abs_path source) ^ ".test.dot"
| None ->
DB.filename_to_string
(DB.Results_dir.path_to_filename
(DB.Results_dir.Abs_source_dir source)
[Config.dotty_output]) in
write_icfg_dotty_to_file source cfg fname
(********** END of Printing dotty files ***********)
(** Dotty printing for specs *)
let pp_speclist_dotty f (splist: Prop.normal Specs.spec list) =
let pp_simple_saved = !Config.pp_simple in
Config.pp_simple := true;
reset_proposition_counter ();
reset_dotty_spec_counter ();
F.fprintf f "@\n@\n@\ndigraph main { @\nnode [shape=box]; @\n";
F.fprintf f "@\n compound = true; @\n";
(* F.fprintf f "@\n size=\"12,7\"; ratio=fill; @\n"; *)
List.iter
~f:(fun s -> pp_dotty_one_spec f (Specs.Jprop.to_prop s.Specs.pre) s.Specs.posts)
splist;
F.fprintf f "@\n}";
Config.pp_simple := pp_simple_saved
let pp_speclist_to_file (filename : DB.filename) spec_list =
let pp_simple_saved = !Config.pp_simple in
Config.pp_simple := true;
let outc = Out_channel.create (DB.filename_to_string (DB.filename_add_suffix filename ".dot")) in
let fmt = F.formatter_of_out_channel outc in
let () = F.fprintf fmt "#### Dotty version: ####@\n%a@\n@\n" (pp_speclist_dotty) spec_list in
Out_channel.close outc;
Config.pp_simple := pp_simple_saved
let pp_speclist_dotty_file (filename : DB.filename) spec_list =
try pp_speclist_to_file filename spec_list
with exn when SymOp.exn_not_failure exn ->
()
(**********************************************************************)
(* Code prodicing a xml version of a graph *)
(**********************************************************************)
(* each node has an unique integer identifier *)
type visual_heap_node =
| VH_dangling of int * Exp.t
| VH_pointsto of int * Exp.t * Sil.strexp * Exp.t (* VH_pointsto(id,address,content,type) *)
| VH_lseg of int * Exp.t * Exp.t * Sil.lseg_kind (*VH_lseg(id,address,content last cell, kind) *)
(*VH_dllseg(id, address, content first cell, content last cell, address last cell, kind) *)
| VH_dllseg of int * Exp.t * Exp.t * Exp.t * Exp.t * Sil.lseg_kind
(* an edge is a pair of node identifiers*)
type visual_heap_edge = {
src: int;
trg: int;
lab: string
}
let mk_visual_heap_edge s t l = { src = s; trg = t; lab = l }
(* used to generate unique identifier for all the nodes in the set of visual graphs used to *)
(* represent a proposition*)
let global_node_counter = ref 0
let working_list = ref []
let set_dangling_nodes = ref []
(* convert an exp into a string which is xml friendly, ie. special character are replaced by*)
(* the proper xml way to visualize them*)
let exp_to_xml_string e =
F.asprintf "%a" (Sil.pp_exp_printenv (Pp.html Black)) e
(* convert an atom into an xml-friendly string without special characters *)
let atom_to_xml_string a =
F.asprintf "%a" (Sil.pp_atom (Pp.html Black)) a
(* return the dangling node corresponding to an expression it exists or None *)
let exp_dangling_node e =
let entry_e = List.filter ~f:(fun b -> match b with
| VH_dangling(_, e') -> Exp.equal e e' | _ -> false ) !set_dangling_nodes in
match entry_e with
|[] -> None
| VH_dangling(n, e') :: _ -> Some (VH_dangling(n, e'))
| _ -> None (* NOTE: this cannot be possible since entry_e can be composed only by VH_dangling, see def of entry_e*)
(* make nodes and when it finds a list records in the working list *)
(* to do (n, prop) where n is the integer identifier of the list node. *)
(* This allow to keep the connection between the list node and the graph *)
(* that displays its contents. *)
let rec make_visual_heap_nodes sigma =
let n = !global_node_counter in
incr global_node_counter;
match sigma with
| [] -> []
| Sil.Hpointsto (e, se, t):: sigma' ->
VH_pointsto(n, e, se, t):: make_visual_heap_nodes sigma'
| Sil.Hlseg (k, hpara, e1, e2, _):: sigma' ->
working_list:= (n, hpara.Sil.body)::!working_list;
VH_lseg(n, e1, e2, k):: make_visual_heap_nodes sigma'
| Sil.Hdllseg (k, hpara_dll, e1, e2, e3, e4, _):: sigma'->
working_list:= (n, hpara_dll.Sil.body_dll)::!working_list;
VH_dllseg(n, e1, e2, e3, e4, k):: make_visual_heap_nodes sigma'
(* given a node returns its id and address*)
let get_node_id_and_addr node =
match node with
| VH_dangling(n, e)
| VH_pointsto(n, e, _, _)
| VH_lseg(n, e, _ , _)
| VH_dllseg(n, e, _, _, _, _) -> (n, e)
(* return node's id*)
let get_node_id node = fst (get_node_id_and_addr node)
(* return node's address*)
let get_node_addr node = snd (get_node_id_and_addr node)
(* return the nodes corresponding to an address given by an expression *)
let rec select_node_at_address nodes e =
match nodes with
| [] -> None
| n:: l' ->
let e' = get_node_addr n in
if (Exp.equal e e') then Some n
else select_node_at_address l' e
(* look-up the ids in the list of nodes corresponding to expression e*)
(* let look_up_nodes_ids nodes e =
List.map ~f:get_node_id (select_nodes_exp nodes e) *)
(* create a list of dangling nodes *)
let make_set_dangling_nodes allocated_nodes (sigma: Sil.hpred list) =
let make_new_dangling e =
let n = !global_node_counter in
incr global_node_counter;
VH_dangling(n, e) in
let get_rhs_predicate hpred =
(match hpred with
| Sil.Hpointsto (_, Sil.Eexp (e, _), _) when not (Exp.equal e Exp.zero) -> [e]
| Sil.Hlseg (_, _, _, e2, _) when not (Exp.equal e2 Exp.zero) -> [e2]
| Sil.Hdllseg (_, _, _, e2, e3, _, _) ->
if (Exp.equal e2 Exp.zero) then
if (Exp.equal e3 Exp.zero) then []
else [e3]
else [e2; e3]
| Sil.Hpointsto (_, _, _)
| _ -> [] (* arrays and struct do not give danglings. CHECK THIS!*)
) in
let is_not_allocated e =
let allocated = List.exists ~f:(fun a -> match a with
| VH_pointsto(_, e', _, _)
| VH_lseg(_, e', _ , _)
| VH_dllseg(_, e', _, _, _, _) -> Exp.equal e e'
| _ -> false ) allocated_nodes in
not allocated in
let rec filter_duplicate l seen_exp =
match l with
| [] -> []
| e:: l' ->
if (List.exists ~f:(Exp.equal e) seen_exp) then filter_duplicate l' seen_exp
else e:: filter_duplicate l' (e:: seen_exp) in
let rhs_exp_list = List.concat_map ~f:get_rhs_predicate sigma in
let candidate_dangling_exps = filter_duplicate rhs_exp_list [] in
(* get rid of allocated ones*)
let dangling_exps = List.filter ~f:is_not_allocated candidate_dangling_exps in
List.map ~f:make_new_dangling dangling_exps
(* return a list of pairs (n,field_lab) where n is a target node*)
(* corresponding to se and is going to be used a target for and edge*)
(* field_lab is the name of the field which points to n (if any)*)
let rec compute_target_nodes_from_sexp nodes se prop field_lab =
match se with
| Sil.Eexp (e, _) when is_nil e prop ->
(* Nil is not represented by a node, it's just a value which should be printed*)
[]
| Sil.Eexp (e, _) ->
let e_node = select_node_at_address nodes e in
(match e_node with
| None ->
(match exp_dangling_node e with
| None -> []
| Some dang_node -> [(dang_node, field_lab)]
)
| Some n -> [(n, field_lab)]
)
| Sil.Estruct (lfld, inst) ->
(match lfld with
| [] -> []
| (fn, se2):: l' ->
compute_target_nodes_from_sexp nodes se2 prop (Typ.Fieldname.to_string fn) @
compute_target_nodes_from_sexp nodes (Sil.Estruct (l', inst)) prop ""
)
| Sil.Earray (len, lie, inst) ->
(match lie with
| [] -> []
| (idx, se2):: l' ->
let lab ="["^exp_to_xml_string idx^"]" in
compute_target_nodes_from_sexp nodes se2 prop lab @
compute_target_nodes_from_sexp nodes (Sil.Earray (len, l', inst)) prop ""
)
(* build the set of edges between nodes *)
let rec make_visual_heap_edges nodes sigma prop =
let combine_source_target_label n (m, lab) =
mk_visual_heap_edge (get_node_id n) (get_node_id m) lab in
match sigma with
| [] -> []
| Sil.Hpointsto (e, se, _):: sigma' ->
let e_node = select_node_at_address nodes e in
(match e_node with
| None -> assert false
| Some n ->
let target_nodes = compute_target_nodes_from_sexp nodes se prop "" in
let ll = List.map ~f:(combine_source_target_label n) target_nodes in
ll @ make_visual_heap_edges nodes sigma' prop
)
| Sil.Hlseg (_, _, e1, e2, _):: sigma' ->
let e1_node = select_node_at_address nodes e1 in
(match e1_node with
| None -> assert false
| Some n ->
let target_nodes = compute_target_nodes_from_sexp nodes (Sil.Eexp (e2, Sil.inst_none)) prop "" in
let ll = List.map ~f:(combine_source_target_label n) target_nodes in
ll @ make_visual_heap_edges nodes sigma' prop
)
| Sil.Hdllseg (_, _, e1, e2, e3, _, _):: sigma' ->
let e1_node = select_node_at_address nodes e1 in
(match e1_node with
| None -> assert false
| Some n ->
let target_nodesF = compute_target_nodes_from_sexp nodes (Sil.Eexp (e3, Sil.inst_none)) prop "" in
let target_nodesB = compute_target_nodes_from_sexp nodes (Sil.Eexp (e2, Sil.inst_none)) prop "" in
let llF = List.map ~f:(combine_source_target_label n) target_nodesF in
let llB = List.map ~f:(combine_source_target_label n) target_nodesB in
llF @ llB @ make_visual_heap_edges nodes sigma' prop
)
(* from a prop generate and return visual proposition *)
let prop_to_set_of_visual_heaps prop =
let result = ref [] in
working_list := [(!global_node_counter, prop.Prop.sigma)];
incr global_node_counter;
while (!working_list <> []) do
set_dangling_nodes:=[];
let (n, h) = List.hd_exn !working_list in
working_list:= List.tl_exn !working_list;
let nodes = make_visual_heap_nodes h in
set_dangling_nodes:= make_set_dangling_nodes nodes h;
let edges = make_visual_heap_edges nodes h prop in
result:= !result @ [(n, nodes @ !set_dangling_nodes, edges)];
done;
!result
let rec pointsto_contents_to_xml (co: Sil.strexp) : Io_infer.Xml.node =
match co with
| Sil.Eexp (e, _) ->
Io_infer.Xml.create_tree "cell" [("content-value", exp_to_xml_string e)] []
| Sil.Estruct (fel, _) ->
let f (fld, exp) = Io_infer.Xml.create_tree "struct-field" [("id", Typ.Fieldname.to_string fld)] [(pointsto_contents_to_xml exp)] in
Io_infer.Xml.create_tree "struct" [] (List.map ~f fel)
| Sil.Earray (len, nel, _) ->
let f (e, se) = Io_infer.Xml.create_tree "array-element" [("index", exp_to_xml_string e)] [pointsto_contents_to_xml se] in
Io_infer.Xml.create_tree "array" [("size", exp_to_xml_string len)] (List.map ~f nel)
(* Convert an atom to xml in a light version. Namely, the expressions are not fully blown-up into *)
(* xml tree but visualized as strings *)
let atom_to_xml_light (a: Sil.atom) : Io_infer.Xml.node =
let kind_info = match a with
| Sil.Aeq _ when Prop.atom_is_inequality a ->
"inequality"
| Sil.Aeq _ ->
"equality"
| Sil.Aneq _ ->
"disequality"
| Sil.Apred _ ->
"pred"
| Sil.Anpred _ ->
"npred" in
Io_infer.Xml.create_tree "stack-variable" [("type", kind_info); ("instance", atom_to_xml_string a)] []
let xml_pure_info prop =
let pure = Prop.get_pure prop in
let xml_atom_list = List.map ~f:atom_to_xml_light pure in
Io_infer.Xml.create_tree "stack" [] xml_atom_list
(** Return a string describing the kind of a pointsto address *)
let pointsto_addr_kind = function
| Exp.Lvar pv ->
if Pvar.is_global pv
then "global"
else if Pvar.is_local pv && Mangled.equal (Pvar.get_name pv) Ident.name_return
then "return"
else if Pvar.is_local pv
then "parameter"
else "other"
| _ -> "other"
let heap_node_to_xml node =
match node with
| VH_dangling(id, addr) ->
let atts =[("id", string_of_int id); ("address", exp_to_xml_string addr); ("node-type","dangling"); ("memory-type", pointsto_addr_kind addr)] in
Io_infer.Xml.create_tree "node" atts []
| VH_pointsto(id, addr, cont, _) ->
let atts =[("id", string_of_int id); ("address", exp_to_xml_string addr); ("node-type","allocated"); ("memory-type", pointsto_addr_kind addr)] in
let contents = pointsto_contents_to_xml cont in
Io_infer.Xml.create_tree "node" atts [contents]
| VH_lseg(id, addr, _, Sil.Lseg_NE) ->
let atts =[("id", string_of_int id); ("address", exp_to_xml_string addr); ("node-type","single linked list"); ("list-type","non-empty"); ("memory-type", "other")] in
Io_infer.Xml.create_tree "node" atts []
| VH_lseg(id, addr, _, Sil.Lseg_PE) ->
let atts =[("id", string_of_int id); ("address", exp_to_xml_string addr); ("node-type","single linked list"); ("list-type","possibly empty"); ("memory-type", "other")] in
Io_infer.Xml.create_tree "node" atts []
| VH_dllseg(id, addr1, cont1, cont2, addr2, _) ->
let contents1 = pointsto_contents_to_xml (Sil.Eexp (cont1, Sil.inst_none)) in
let contents2 = pointsto_contents_to_xml (Sil.Eexp (cont2, Sil.inst_none)) in
let atts =[("id", string_of_int id); ("addr-first", exp_to_xml_string addr1); ("addr-last", exp_to_xml_string addr2); ("node-type","double linked list"); ("memory-type", "other") ] in
Io_infer.Xml.create_tree "node" atts [contents1 ; contents2]
let heap_edge_to_xml edge =
let atts =[("source", string_of_int edge.src); ("target", string_of_int edge.trg); ("label", edge.lab) ] in
Io_infer.Xml.create_tree "edge" atts []
let visual_heap_to_xml heap =
let (n, nodes, edges) = heap in
let xml_heap_nodes = List.map ~f:heap_node_to_xml nodes in
let xml_heap_edges = List.map ~f:heap_edge_to_xml edges in
Io_infer.Xml.create_tree "heap" [("id", string_of_int n)] (xml_heap_nodes @ xml_heap_edges)
(** convert a proposition to xml with the given tag and id *)
let prop_to_xml prop tag_name id =
let visual_heaps = prop_to_set_of_visual_heaps prop in
let xml_visual_heaps = List.map ~f:visual_heap_to_xml visual_heaps in
let xml_pure_part = xml_pure_info prop in
let xml_graph = Io_infer.Xml.create_tree tag_name [("id", string_of_int id)] (xml_visual_heaps @ [xml_pure_part]) in
xml_graph
(** reset the counter used for node and heap identifiers *)
let reset_node_counter () =
global_node_counter := 0
let print_specs_xml signature specs loc fmt =
reset_node_counter ();
let do_one_spec pre posts n =
let add_stack_to_prop _prop =
(* add stack vars from pre *)
let pre_stack = fst (Prop.sigma_get_stack_nonstack true pre.Prop.sigma) in
let _prop' = Prop.set _prop ~sigma:(pre_stack @ _prop.Prop.sigma) in
Prop.normalize (Tenv.create ()) _prop' in
let jj = ref 0 in
let xml_pre = prop_to_xml pre "precondition" !jj in
let xml_spec =
xml_pre ::
(List.map ~f:(fun (po, _) ->
jj := !jj + 1; prop_to_xml (add_stack_to_prop po) "postcondition" !jj
) posts) in
Io_infer.Xml.create_tree "specification" [("id", string_of_int n)] xml_spec in
let j = ref 0 in
let list_of_specs_xml =
List.map
~f:(fun s ->
j:=!j + 1;
do_one_spec (Specs.Jprop.to_prop s.Specs.pre) s.Specs.posts !j)
specs in
let xml_specifications = Io_infer.Xml.create_tree "specifications" [] list_of_specs_xml in
let xml_signature = Io_infer.Xml.create_tree "signature" [("name", signature)] [] in
let proc_summary = Io_infer.Xml.create_tree "procedure"
[("file", SourceFile.to_string loc.Location.file);
("line", string_of_int loc.Location.line)]
[xml_signature; xml_specifications] in
Io_infer.Xml.pp_document true fmt proc_summary