2 * yosys -- Yosys Open SYnthesis Suite
4 * Copyright (C) 2012 Clifford Wolf <clifford@clifford.at>
6 * Permission to use, copy, modify, and/or distribute this software for any
7 * purpose with or without fee is hereby granted, provided that the above
8 * copyright notice and this permission notice appear in all copies.
10 * THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES
11 * WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF
12 * MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR
13 * ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
14 * WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN
15 * ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
16 * OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
20 #include "kernel/yosys.h"
28 #define MAX_REG_COUNT 1000
30 bool echo_mode
= false;
31 Pass
*first_queued_pass
;
34 std::map
<std::string
, Frontend
*> frontend_register
;
35 std::map
<std::string
, Pass
*> pass_register
;
36 std::map
<std::string
, Backend
*> backend_register
;
38 std::vector
<std::string
> Frontend::next_args
;
40 Pass::Pass(std::string name
, std::string short_help
) : pass_name(name
), short_help(short_help
)
42 next_queued_pass
= first_queued_pass
;
43 first_queued_pass
= this;
48 void Pass::run_register()
50 log_assert(pass_register
.count(pass_name
) == 0);
51 pass_register
[pass_name
] = this;
54 void Pass::init_register()
56 while (first_queued_pass
) {
57 first_queued_pass
->run_register();
58 first_queued_pass
= first_queued_pass
->next_queued_pass
;
62 void Pass::done_register()
64 frontend_register
.clear();
65 pass_register
.clear();
66 backend_register
.clear();
67 log_assert(first_queued_pass
== NULL
);
74 Pass::pre_post_exec_state_t
Pass::pre_execute()
76 pre_post_exec_state_t state
;
78 state
.begin_ns
= PerformanceTimer::query();
79 state
.parent_pass
= current_pass
;
84 void Pass::post_execute(Pass::pre_post_exec_state_t state
)
86 int64_t time_ns
= PerformanceTimer::query() - state
.begin_ns
;
87 runtime_ns
+= time_ns
;
88 current_pass
= state
.parent_pass
;
90 current_pass
->runtime_ns
-= time_ns
;
96 log("No help message for command `%s'.\n", pass_name
.c_str());
100 void Pass::cmd_log_args(const std::vector
<std::string
> &args
)
102 if (args
.size() <= 1)
104 log("Full command line:");
105 for (size_t i
= 0; i
< args
.size(); i
++)
106 log(" %s", args
[i
].c_str());
110 void Pass::cmd_error(const std::vector
<std::string
> &args
, size_t argidx
, std::string msg
)
112 std::string command_text
;
115 for (size_t i
= 0; i
< args
.size(); i
++) {
117 error_pos
+= args
[i
].size() + 1;
118 command_text
= command_text
+ (command_text
.empty() ? "" : " ") + args
[i
];
121 log("\nSyntax error in command `%s':\n", command_text
.c_str());
124 log_cmd_error("Command syntax error: %s\n> %s\n> %*s^\n",
125 msg
.c_str(), command_text
.c_str(), error_pos
, "");
128 void Pass::extra_args(std::vector
<std::string
> args
, size_t argidx
, RTLIL::Design
*design
, bool select
)
130 for (; argidx
< args
.size(); argidx
++)
132 std::string arg
= args
[argidx
];
134 if (arg
.substr(0, 1) == "-")
135 cmd_error(args
, argidx
, "Unkown option or option in arguments.");
138 cmd_error(args
, argidx
, "Extra argument.");
140 handle_extra_select_args(this, args
, argidx
, args
.size(), design
);
143 // cmd_log_args(args);
146 void Pass::call(RTLIL::Design
*design
, std::string command
)
148 std::vector
<std::string
> args
;
149 char *s
= strdup(command
.c_str()), *sstart
= s
, *saveptr
;
150 s
+= strspn(s
, " \t\r\n");
151 if (*s
== 0 || *s
== '#') {
156 for (s
++; *s
== ' ' || *s
== '\t'; s
++) { }
157 char *p
= s
+ strlen(s
) - 1;
158 while (p
>= s
&& (*p
== '\r' || *p
== '\n'))
160 log_header("Shell command: %s\n", s
);
161 int retCode
= system(s
);
163 log_cmd_error("Shell command returned error code %d.\n", retCode
);
167 for (char *p
= strtok_r(s
, " \t\r\n", &saveptr
); p
; p
= strtok_r(NULL
, " \t\r\n", &saveptr
)) {
169 int strsz
= str
.size();
172 if (strsz
> 0 && str
[strsz
-1] == ';') {
173 int num_semikolon
= 0;
174 while (strsz
> 0 && str
[strsz
-1] == ';')
175 strsz
--, num_semikolon
++;
177 args
.push_back(str
.substr(0, strsz
));
180 if (num_semikolon
== 2)
181 call(design
, "clean");
182 if (num_semikolon
== 3)
183 call(design
, "clean -purge");
191 void Pass::call(RTLIL::Design
*design
, std::vector
<std::string
> args
)
193 if (args
.size() == 0 || args
[0][0] == '#')
197 log("%s", create_prompt(design
, 0));
198 for (size_t i
= 0; i
< args
.size(); i
++)
199 log("%s%s", i
? " " : "", args
[i
].c_str());
203 if (pass_register
.count(args
[0]) == 0)
204 log_cmd_error("No such command: %s (type 'help' for a command overview)\n", args
[0].c_str());
206 size_t orig_sel_stack_pos
= design
->selection_stack
.size();
207 auto state
= pass_register
[args
[0]]->pre_execute();
208 pass_register
[args
[0]]->execute(args
, design
);
209 pass_register
[args
[0]]->post_execute(state
);
210 while (design
->selection_stack
.size() > orig_sel_stack_pos
)
211 design
->selection_stack
.pop_back();
216 void Pass::call_on_selection(RTLIL::Design
*design
, const RTLIL::Selection
&selection
, std::string command
)
218 std::string backup_selected_active_module
= design
->selected_active_module
;
219 design
->selected_active_module
.clear();
220 design
->selection_stack
.push_back(selection
);
222 Pass::call(design
, command
);
224 design
->selection_stack
.pop_back();
225 design
->selected_active_module
= backup_selected_active_module
;
228 void Pass::call_on_selection(RTLIL::Design
*design
, const RTLIL::Selection
&selection
, std::vector
<std::string
> args
)
230 std::string backup_selected_active_module
= design
->selected_active_module
;
231 design
->selected_active_module
.clear();
232 design
->selection_stack
.push_back(selection
);
234 Pass::call(design
, args
);
236 design
->selection_stack
.pop_back();
237 design
->selected_active_module
= backup_selected_active_module
;
240 void Pass::call_on_module(RTLIL::Design
*design
, RTLIL::Module
*module
, std::string command
)
242 std::string backup_selected_active_module
= design
->selected_active_module
;
243 design
->selected_active_module
= module
->name
.str();
244 design
->selection_stack
.push_back(RTLIL::Selection(false));
245 design
->selection_stack
.back().select(module
);
247 Pass::call(design
, command
);
249 design
->selection_stack
.pop_back();
250 design
->selected_active_module
= backup_selected_active_module
;
253 void Pass::call_on_module(RTLIL::Design
*design
, RTLIL::Module
*module
, std::vector
<std::string
> args
)
255 std::string backup_selected_active_module
= design
->selected_active_module
;
256 design
->selected_active_module
= module
->name
.str();
257 design
->selection_stack
.push_back(RTLIL::Selection(false));
258 design
->selection_stack
.back().select(module
);
260 Pass::call(design
, args
);
262 design
->selection_stack
.pop_back();
263 design
->selected_active_module
= backup_selected_active_module
;
266 Frontend::Frontend(std::string name
, std::string short_help
) :
267 Pass(name
.rfind("=", 0) == 0 ? name
.substr(1) : "read_" + name
, short_help
),
268 frontend_name(name
.rfind("=", 0) == 0 ? name
.substr(1) : name
)
272 void Frontend::run_register()
274 log_assert(pass_register
.count(pass_name
) == 0);
275 pass_register
[pass_name
] = this;
277 log_assert(frontend_register
.count(frontend_name
) == 0);
278 frontend_register
[frontend_name
] = this;
281 Frontend::~Frontend()
285 void Frontend::execute(std::vector
<std::string
> args
, RTLIL::Design
*design
)
287 log_assert(next_args
.empty());
291 auto state
= pre_execute();
292 execute(f
, std::string(), args
, design
);
296 } while (!args
.empty());
299 FILE *Frontend::current_script_file
= NULL
;
300 std::string
Frontend::last_here_document
;
302 void Frontend::extra_args(FILE *&f
, std::string
&filename
, std::vector
<std::string
> args
, size_t argidx
)
304 bool called_with_fp
= f
!= NULL
;
307 for (; argidx
< args
.size(); argidx
++)
309 std::string arg
= args
[argidx
];
311 if (arg
.substr(0, 1) == "-")
312 cmd_error(args
, argidx
, "Unkown option or option in arguments.");
314 cmd_error(args
, argidx
, "Extra filename argument in direct file mode.");
317 if (filename
== "<<" && argidx
+1 < args
.size())
318 filename
+= args
[++argidx
];
319 if (filename
.substr(0, 2) == "<<") {
320 if (Frontend::current_script_file
== NULL
)
321 log_error("Unexpected here document '%s' outside of script!\n", filename
.c_str());
322 if (filename
.size() <= 2)
323 log_error("Missing EOT marker in here document!\n");
324 std::string eot_marker
= filename
.substr(2);
325 last_here_document
.clear();
330 if (fgets(block
, 4096, Frontend::current_script_file
) == NULL
)
331 log_error("Unexpected end of file in here document '%s'!\n", filename
.c_str());
333 if (buffer
.size() > 0 && (buffer
[buffer
.size() - 1] == '\n' || buffer
[buffer
.size() - 1] == '\r'))
336 int indent
= buffer
.find_first_not_of(" \t\r\n");
337 if (buffer
.substr(indent
, eot_marker
.size()) == eot_marker
)
339 last_here_document
+= buffer
;
341 f
= fmemopen((void*)last_here_document
.c_str(), last_here_document
.size(), "r");
343 if (filename
.substr(0, 2) == "+/")
344 filename
= proc_share_dirname() + filename
.substr(1);
345 f
= fopen(filename
.c_str(), "r");
348 log_cmd_error("Can't open input file `%s' for reading: %s\n", filename
.c_str(), strerror(errno
));
350 for (size_t i
= argidx
+1; i
< args
.size(); i
++)
351 if (args
[i
].substr(0, 1) == "-")
352 cmd_error(args
, i
, "Found option, expected arguments.");
354 if (argidx
+1 < args
.size()) {
355 next_args
.insert(next_args
.begin(), args
.begin(), args
.begin()+argidx
);
356 next_args
.insert(next_args
.begin()+argidx
, args
.begin()+argidx
+1, args
.end());
357 args
.erase(args
.begin()+argidx
+1, args
.end());
362 cmd_error(args
, argidx
, "No filename given.");
365 args
.push_back(filename
);
367 // cmd_log_args(args);
370 void Frontend::frontend_call(RTLIL::Design
*design
, FILE *f
, std::string filename
, std::string command
)
372 std::vector
<std::string
> args
;
373 char *s
= strdup(command
.c_str());
374 for (char *p
= strtok(s
, " \t\r\n"); p
; p
= strtok(NULL
, " \t\r\n"))
377 frontend_call(design
, f
, filename
, args
);
380 void Frontend::frontend_call(RTLIL::Design
*design
, FILE *f
, std::string filename
, std::vector
<std::string
> args
)
382 if (args
.size() == 0)
384 if (frontend_register
.count(args
[0]) == 0)
385 log_cmd_error("No such frontend: %s\n", args
[0].c_str());
388 auto state
= frontend_register
[args
[0]]->pre_execute();
389 frontend_register
[args
[0]]->execute(f
, filename
, args
, design
);
390 frontend_register
[args
[0]]->post_execute(state
);
391 } else if (filename
== "-") {
392 FILE *f_stdin
= stdin
; // workaround for OpenBSD 'stdin' implementation
393 auto state
= frontend_register
[args
[0]]->pre_execute();
394 frontend_register
[args
[0]]->execute(f_stdin
, "<stdin>", args
, design
);
395 frontend_register
[args
[0]]->post_execute(state
);
397 if (!filename
.empty())
398 args
.push_back(filename
);
399 frontend_register
[args
[0]]->execute(args
, design
);
405 Backend::Backend(std::string name
, std::string short_help
) :
406 Pass(name
.rfind("=", 0) == 0 ? name
.substr(1) : "write_" + name
, short_help
),
407 backend_name(name
.rfind("=", 0) == 0 ? name
.substr(1) : name
)
411 void Backend::run_register()
413 log_assert(pass_register
.count(pass_name
) == 0);
414 pass_register
[pass_name
] = this;
416 log_assert(backend_register
.count(backend_name
) == 0);
417 backend_register
[backend_name
] = this;
424 void Backend::execute(std::vector
<std::string
> args
, RTLIL::Design
*design
)
427 auto state
= pre_execute();
428 execute(f
, std::string(), args
, design
);
434 void Backend::extra_args(FILE *&f
, std::string
&filename
, std::vector
<std::string
> args
, size_t argidx
)
436 bool called_with_fp
= f
!= NULL
;
438 for (; argidx
< args
.size(); argidx
++)
440 std::string arg
= args
[argidx
];
442 if (arg
.substr(0, 1) == "-" && arg
!= "-")
443 cmd_error(args
, argidx
, "Unkown option or option in arguments.");
445 cmd_error(args
, argidx
, "Extra filename argument in direct file mode.");
448 filename
= "<stdout>";
454 f
= fopen(filename
.c_str(), "w");
456 log_cmd_error("Can't open output file `%s' for writing: %s\n", filename
.c_str(), strerror(errno
));
460 args
.push_back(filename
);
462 // cmd_log_args(args);
465 filename
= "<stdout>";
470 void Backend::backend_call(RTLIL::Design
*design
, FILE *f
, std::string filename
, std::string command
)
472 std::vector
<std::string
> args
;
473 char *s
= strdup(command
.c_str());
474 for (char *p
= strtok(s
, " \t\r\n"); p
; p
= strtok(NULL
, " \t\r\n"))
477 backend_call(design
, f
, filename
, args
);
480 void Backend::backend_call(RTLIL::Design
*design
, FILE *f
, std::string filename
, std::vector
<std::string
> args
)
482 if (args
.size() == 0)
484 if (backend_register
.count(args
[0]) == 0)
485 log_cmd_error("No such backend: %s\n", args
[0].c_str());
487 size_t orig_sel_stack_pos
= design
->selection_stack
.size();
490 auto state
= backend_register
[args
[0]]->pre_execute();
491 backend_register
[args
[0]]->execute(f
, filename
, args
, design
);
492 backend_register
[args
[0]]->post_execute(state
);
493 } else if (filename
== "-") {
494 FILE *f_stdout
= stdout
; // workaround for OpenBSD 'stdout' implementation
495 auto state
= backend_register
[args
[0]]->pre_execute();
496 backend_register
[args
[0]]->execute(f_stdout
, "<stdout>", args
, design
);
497 backend_register
[args
[0]]->post_execute(state
);
499 if (!filename
.empty())
500 args
.push_back(filename
);
501 backend_register
[args
[0]]->execute(args
, design
);
504 while (design
->selection_stack
.size() > orig_sel_stack_pos
)
505 design
->selection_stack
.pop_back();
510 struct HelpPass
: public Pass
{
511 HelpPass() : Pass("help", "display help messages") { }
515 log(" help ............. list all commands\n");
516 log(" help <command> ... print help message for given command\n");
517 log(" help -all ........ print complete command reference\n");
520 void escape_tex(std::string
&tex
)
523 while ((pos
= tex
.find('_', pos
)) != std::string::npos
) {
524 tex
.replace(pos
, 1, "\\_");
528 void write_tex(FILE *f
, std::string cmd
, std::string title
, std::string text
)
530 size_t begin
= text
.find_first_not_of("\n"), end
= text
.find_last_not_of("\n");
531 if (begin
!= std::string::npos
&& end
!= std::string::npos
&& begin
< end
)
532 text
= text
.substr(begin
, end
-begin
+1);
533 std::string cmd_unescaped
= cmd
;
536 fprintf(f
, "\\section{%s -- %s}\n", cmd
.c_str(), title
.c_str());
537 fprintf(f
, "\\label{cmd:%s}\n", cmd_unescaped
.c_str());
538 fprintf(f
, "\\begin{lstlisting}[numbers=left,frame=single]\n");
539 fprintf(f
, "%s\n\\end{lstlisting}\n\n", text
.c_str());
541 void escape_html(std::string
&html
)
544 while ((pos
= html
.find_first_of("<>&", pos
)) != std::string::npos
)
547 html
.replace(pos
, 1, "<");
551 html
.replace(pos
, 1, ">");
555 html
.replace(pos
, 1, "&");
560 void write_html(FILE *idxf
, std::string cmd
, std::string title
, std::string text
)
562 FILE *f
= fopen(stringf("cmd_%s.in", cmd
.c_str()).c_str(), "wt");
563 fprintf(idxf
, "<li><a href=\"cmd_%s.html\"> ", cmd
.c_str());
569 fprintf(idxf
, "%s</a> <span>%s</span></a>\n", cmd
.c_str(), title
.c_str());
571 fprintf(f
, "@cmd_header %s@\n", cmd
.c_str());
572 fprintf(f
, "<h1>%s - %s</h1>\n", cmd
.c_str(), title
.c_str());
573 fprintf(f
, "<pre>%s</pre>\n", text
.c_str());
574 fprintf(f
, "@footer@\n");
578 virtual void execute(std::vector
<std::string
> args
, RTLIL::Design
*)
580 if (args
.size() == 1) {
582 for (auto &it
: pass_register
)
583 log(" %-20s %s\n", it
.first
.c_str(), it
.second
->short_help
.c_str());
585 log("Type 'help <command>' for more information on a command.\n");
590 if (args
.size() == 2) {
591 if (args
[1] == "-all") {
592 for (auto &it
: pass_register
) {
594 log("%s -- %s\n", it
.first
.c_str(), it
.second
->short_help
.c_str());
595 for (size_t i
= 0; i
< it
.first
.size() + it
.second
->short_help
.size() + 6; i
++)
601 // this option is undocumented as it is for internal use only
602 else if (args
[1] == "-write-tex-command-reference-manual") {
603 FILE *f
= fopen("command-reference-manual.tex", "wt");
604 fprintf(f
, "%% Generated using the yosys 'help -write-tex-command-reference-manual' command.\n\n");
605 for (auto &it
: pass_register
) {
608 FILE *memf
= open_memstream(&memptr
, &memsize
);
609 log_files
.push_back(memf
);
611 log_files
.pop_back();
613 write_tex(f
, it
.first
, it
.second
->short_help
, memptr
);
618 // this option is undocumented as it is for internal use only
619 else if (args
[1] == "-write-web-command-reference-manual") {
620 FILE *f
= fopen("templates/cmd_index.in", "wt");
621 for (auto &it
: pass_register
) {
624 FILE *memf
= open_memstream(&memptr
, &memsize
);
625 log_files
.push_back(memf
);
627 log_files
.pop_back();
629 write_html(f
, it
.first
, it
.second
->short_help
, memptr
);
634 else if (pass_register
.count(args
[1]) == 0)
635 log("No such command: %s\n", args
[1].c_str());
637 pass_register
.at(args
[1])->help();
645 struct EchoPass
: public Pass
{
646 EchoPass() : Pass("echo", "turning echoing back of commands on and off") { }
652 log("Print all commands to log before executing them.\n");
657 log("Do not print all commands to log before executing them. (default)\n");
660 virtual void execute(std::vector
<std::string
> args
, RTLIL::Design
*)
663 cmd_error(args
, 2, "Unexpected argument.");
665 if (args
.size() == 2) {
668 else if (args
[1] == "off")
671 cmd_error(args
, 1, "Unexpected argument.");
674 log("echo %s\n", echo_mode
? "on" : "off");