sarif_gen.ml 4.96 KB
Newer Older
1
2
3
4
5
6
7
8
open Sarif

let frama_c_sarif =
  let name = "frama-c" in
  let version = Config.version_and_codename in
  let semanticVersion = Config.version in
  let fullName = name ^ "-" ^ version in
  let downloadUri = "https://frama-c.com/download.html" in
9
  let sarifLoggerVersion = Mdr_version.version in
10
11
12
13
  Tool.create
    ~name ~version ~semanticVersion
    ~fullName ~downloadUri ~sarifLoggerVersion ()

14

15
16
17
18
19
let get_remarks () =
  let f = Mdr_params.Remarks.get () in
  if f <> "" then Parse_remarks.get_remarks f
  else Datatype.String.Map.empty

20
21
22
23
24
let get_remark remarks label =
  match Datatype.String.Map.find_opt label remarks with
  | None -> []
  | Some l -> l

25
26
27
28
29
let gen_invocation () =
  let commandLine = Array.fold_right (fun s acc -> s ^ " " ^ acc) Sys.argv "" in
  let arguments = List.tl (Array.to_list Sys.argv) in
  Invocation.create ~commandLine ~arguments ()

30
31
32
33
34
35
36
37
38
39
40
41
let gen_remark alarm =
  let open Markdown in
  [ Block
      [ Text
          (plain
             (Printf.sprintf "This alarms represents a potential %s."
                (Alarms.get_description alarm)
             )
          )
      ]
  ]

42
43
44
45
46
47
48
49
50
51
let level_of_status =
  let open Property_status.Feedback in
  let open Sarif.Result_level in
  function
  | Never_tried -> notApplicable
  | Considered_valid | Valid | Valid_under_hyp | Valid_but_dead -> pass
  | Unknown | Unknown_but_dead -> warning
  | Invalid | Invalid_under_hyp | Invalid_but_dead -> error
  | Inconsistent -> note

52
53
let make_message alarm annot remark =
  let open Markdown in
54
55
56
  let name = Alarms.get_name alarm in
  let text = name ^ "." in
  let kind = plain (name ^ ":") in
57
58
  let descr = codelines "acsl" Printer.pp_code_annotation annot in
  let summary = Block [Text kind; descr] in
59
60
61
62
63
  let markdown =
    match remark with
      | [] -> summary :: gen_remark alarm
      | _ -> summary :: remark
  in
64
65
66
  let richText =
    String.trim (Format.asprintf "@[%a@]" Markdown.pp_elements markdown)
  in
67
  Message.create ~text ~richText ()
68
69

let gen_results remarks =
70
  let treat_alarm _e kf s ~rank:_ alarm annot (i, rules, content) =
71
    let prop = Property.ip_of_code_annot_single kf s annot in
72
73
74
75
    let ruleId = Alarms.get_name alarm in
    let rules =
      Datatype.String.Map.add ruleId (Alarms.get_description alarm) rules
    in
76
    let label = "Alarm-" ^ string_of_int i in
77
    let level = level_of_status (Property_status.Feedback.get prop) in
78
79
80
81
    let remark = get_remark remarks label in
    let message = make_message alarm annot remark in
    let locations = [ Location.of_loc (Cil_datatype.Stmt.loc s) ] in
    let res =
82
      Sarif_result.create ~level ~ruleId ~message ~locations ()
83
    in
84
85
86
87
    (i+1, rules, res :: content)
  in
  let _, rules, content =
    Alarms.fold treat_alarm (0, Datatype.String.Map.empty,[])
88
  in
89
  rules, List.rev content
90

91
92
93
94
95
let is_alarm = function
  | Property.IPCodeAnnot (_,_,ca) -> Extlib.has_some (Alarms.find ca)
  | _ -> false

let make_ip_message ip =
96
  let text = Format.asprintf "@[%a.@]" Property.short_pretty ip in
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
  Message.plain_text ~text ()

let gen_status ip =
  let status = Property_status.Feedback.get ip in
  let level = level_of_status status in
  let locations = [ Location.of_loc (Property.location ip) ] in
  let message = make_ip_message ip in
  Sarif_result.create ~level ~locations ~message ()

let gen_statuses () =
  let f ip content =
    if is_alarm ip then content else (gen_status ip) :: content
  in
  List.rev (Property_status.fold f [])

112
113
114
115
116
117
118
119
120
121
let gen_files () =
  let add_src_file f =
    let key = Filename.chop_extension (Filename.basename f) in
    let fileLocation = FileLocation.create ~uri:(Filepath.normalize f) () in
    let roles = [ Role.analysisTarget ] in
    let mimeType = "text/x-csrc" in
    key, File.create ~fileLocation ~roles ~mimeType ()
  in
  List.map add_src_file (Kernel.Files.get ())

122
123
124
125
126
127
128
129
let add_rule id desc l =
  let text = desc ^ "." in
  let shortDescription = Message.plain_text ~text () in
  let rule = Rule.create ~id ~shortDescription () in
  (id, rule) :: l

let make_rule_dictionary rules = Datatype.String.Map.fold add_rule rules []

130
let gen_run remarks =
131
  let tool = frama_c_sarif in
132
  let invocations = [gen_invocation ()] in
Virgile Prevosto's avatar
Virgile Prevosto committed
133
134
135
136
137
138
139
140
141
142
  let rules, results = gen_results remarks in
  let user_annot_results = gen_statuses () in
  let rules =
    match user_annot_results with
      | [] -> rules
      | _ ->
          Datatype.String.Map.add
            "user-spec" "User written ACSL specification" rules
  in
  let rules = make_rule_dictionary rules in
143
  let resources = Resources.create ~rules () in
Virgile Prevosto's avatar
Virgile Prevosto committed
144
  let results = results @ user_annot_results in
145
  let files = gen_files () in
146
  Run.create ~tool ~invocations ~results ~resources ~files ()
147
148

let generate () =
149
150
  let remarks = get_remarks () in
  let runs = [ gen_run remarks ] in
151
152
153
154
155
156
157
158
159
160
161
  let json = Schema.create ~runs () in
  let out = Mdr_params.Output.get () in
  let chan =
    if out = "" then stdout
    else begin
      try open_out out
      with Sys_error s ->
        Mdr_params.abort "Unable to open output file %s: %s" out s
    end
  in
  Yojson.Safe.to_channel chan (Schema.to_yojson json)