Skip to content

Commit

Permalink
Help and version updated
Browse files Browse the repository at this point in the history
  • Loading branch information
Dman95 committed Apr 2, 2014
1 parent dded1f6 commit 3ccf3d6
Show file tree
Hide file tree
Showing 6 changed files with 43 additions and 33 deletions.
Binary file modified Linux/share/doc/sasm/changelog.gz
Binary file not shown.
11 changes: 7 additions & 4 deletions help.html
Original file line number Diff line number Diff line change
Expand Up @@ -31,6 +31,9 @@ <H1>Краткая справка.</H1>
Начиная с версии 2.2 добавлена возможность переназначать горячие клавиши. Файл с ними находится по пути "Linux/share/sasm/keys.ini" ("/usr/share/sasm/keys.ini" при установке) в Linux и по пути "Windows/keys.ini" в Windows.
</P>
<P>
С версии 2.3 SASM поддерживает работу в двух режимах - x64 и x86, переключаться между которыми можно в настройках на вкладке &quot;Построение&quot;. Библиотека макросов "io.inc" работает одинаково для каждого из режимов. Там же можно изменить опции ассемблера и компоновщика.
</P>
<P>
&nbsp;
</P>
<H3>Библиотека макросов "io.inc"</H3>
Expand All @@ -53,7 +56,7 @@ <H3>Библиотека макросов "io.inc"</H3>
<tr>
<td width="242" valign="top"><a name="PRINT_UDEC">PRINT_UDEC</a> <em>size, data</em></p>
<p><a name="PRINT_DEC">PRINT_DEC</a><em> size, data</em></td>
<td width="390" valign="top">Вывод числовых данных заданных параметром <em>data</em> в 10-чном представлении. Параметр <em>size</em> – число, указывающее размерность данность в байтах; допускаются значения 1, 2, 4. В качестве параметра <em>data</em> может выступать числовая константа, символьная константа, имя переменной, имя регистра или адресное выражение (без спецификатора размера данных в памяти). Если задается регистр большего размера, то берется заданное параметром <em>size</em> количество младших разрядов. PRINT_UDEC интерпретирует число как беззнаковое, PRINT_DEC — как знаковое.</td>
<td width="390" valign="top">Вывод числовых данных заданных параметром <em>data</em> в 10-чном представлении. Параметр <em>size</em> – число, указывающее размерность данность в байтах; допускаются значения 1, 2, 4, 8 (x64). В качестве параметра <em>data</em> может выступать числовая константа, символьная константа, имя переменной, имя регистра или адресное выражение (без спецификатора размера данных в памяти). Если задается регистр большего размера, то берется заданное параметром <em>size</em> количество младших разрядов. PRINT_UDEC интерпретирует число как беззнаковое, PRINT_DEC — как знаковое.</td>
</tr>
<tr>
<td width="242" valign="top"><a name="PRINT_HEX">PRINT_HEX</a> <em>size, data</em></td>
Expand All @@ -74,7 +77,7 @@ <H3>Библиотека макросов "io.inc"</H3>
<tr>
<td width="242" valign="top"><a name="GET_UDEC">GET_UDEC</a> <em>size</em>, <em>data</em></p>
<p><a name="GET_DEC">GET_DEC</a> <em>size</em>, <em>data</em></td>
<td width="390" valign="top">Ввод числовых данных в 10-чном представлении с клавиатуры. Размер вводимых данных ограничен параметром <em>size</em>, который задается числом (1, 2, 4). Введенные данные обрезаются соответствующим образом. Параметр <em>data</em> &#8211; либо имя переменной, либо имя регистра, либо адресное выражение (без спецификатора размера данных в памяти). Если задается регистр большего размера, то старшие разряды заполняются знаковым битом в случае GET_DEC и нулями в случае GET_UDEC. GET_UDEC считывает беззнаковое число, GET_DEC — знаковое. Запрещается использовать в качестве параметра регистр esp.</td>
<td width="390" valign="top">Ввод числовых данных в 10-чном представлении с клавиатуры. Размер вводимых данных ограничен параметром <em>size</em>, который задается числом (1, 2, 4, 8 (x64)). Введенные данные обрезаются соответствующим образом. Параметр <em>data</em> &#8211; либо имя переменной, либо имя регистра, либо адресное выражение (без спецификатора размера данных в памяти). Если задается регистр большего размера, то старшие разряды заполняются знаковым битом в случае GET_DEC и нулями в случае GET_UDEC. GET_UDEC считывает беззнаковое число, GET_DEC — знаковое. Запрещается использовать в качестве параметра регистр esp.</td>
</tr>
<tr>
<td width="242" valign="top"><a name="GET_HEX">GET_HEX</a> <em>size, data</em></td>
Expand Down Expand Up @@ -151,7 +154,7 @@ <H3>Немного об отладчике:</H3>
<P>&nbsp;</P>
<H3>Реализация:</H3>
<H4>Windows</H4>
<P>В качестве компилятора для NASM используется nasm 2.11.02, в качестве компоновщика - gcc 4.6.2. Версии
<P>В качестве компилятора для NASM используется nasm 2.11.02, в качестве компоновщика - gcc 4.6.2 из MinGW (gcc 4.8.1 из MinGW64 в режиме x64). Версии
компиляторов и компоновщиков подобраны с учетом рекомендуемых программ для курса &quot;Архитектура ЭВМ и язык
ассемблера&quot; 1-го потока ВМК МГУ (<A HREF="http://asmcourse.cs.msu.ru/?page_id=169">http://asmcourse.cs.msu.ru/?page_id=169</A>).
Также в программу включен отладчик gdb из пакета MinGW и немного измененная с учетом требований отладки библиотека макросов
Expand Down Expand Up @@ -181,7 +184,7 @@ <H3>Предупреждения:</H3>
_main (Windows) или main (Linux) или использовать библиотеку макросов &quot;io.inc&quot; с меткой CMAIN.
</P>
<P STYLE="margin-left: 0.5in; text-indent: -0.25in">2)<SPAN STYLE="font-variant: normal">&nbsp;&nbsp;&nbsp;
Перед отладкой проверьте – все ли функции формируют фреймы (mov ebp, esp). Это правило должно быть выполнено для всех функций, включая main.
Перед отладкой проверьте – все ли функции формируют фреймы (mov ebp, esp или mov rbp, rsp). Это правило должно быть выполнено для всех функций, включая main.
При невыполнении данного условия правильная работа отладчика не гарантирована.
</P>
<P STYLE="margin-left: 0.5in; text-indent: -0.25in">3)<SPAN STYLE="font-variant: normal">&nbsp;&nbsp;&nbsp;
Expand Down
11 changes: 7 additions & 4 deletions helpENG.html
Original file line number Diff line number Diff line change
Expand Up @@ -22,6 +22,9 @@ <H1>Brief help.</H1>
Starting with version 2.2 it is possible to reassign the hotkeys. File with them located on the path "Linux/share/sasm/keys.ini" ("/usr/share/sasm/keys.ini" if SASM was installed) in Linux and on the path "Windows/keys.ini" in Windows.
</P>
<P>
Starting with version 2.3 SASM supports 2 modes - x64 and x86. You can choose mode in settings on "Build" tab. "io.inc" macro library works with both modes. Also there you can change assembler and linker options.
</P>
<P>
&nbsp;
</P>
<H3>"io.inc" macro library</H3>
Expand All @@ -42,7 +45,7 @@ <H3>"io.inc" macro library</H3>
<tr>
<td width="242" valign="top"><a name="PRINT_UDEC">PRINT_UDEC</a> <em>size, data</em></p>
<p><a name="PRINT_DEC">PRINT_DEC</a><em> size, data</em></td>
<td width="390" valign="top">Print number <em>data</em> in decimal representation. <em>size</em> – number, giving size of <em>data</em> in bytes - 1, 2 or 4.
<td width="390" valign="top">Print number <em>data</em> in decimal representation. <em>size</em> – number, giving size of <em>data</em> in bytes - 1, 2, 4 or 8 (x64).
<em>data</em> must be number or symbol constant, name of variable, register or address expression without size qualifier (byte[], etc.). PRINT_UDEC print number as unsigned, PRINT_DEC — as signed.</td>
</tr>
<tr>
Expand All @@ -64,7 +67,7 @@ <H3>"io.inc" macro library</H3>
<tr>
<td width="242" valign="top"><a name="GET_UDEC">GET_UDEC</a> <em>size</em>, <em>data</em></p>
<p><a name="GET_DEC">GET_DEC</a> <em>size</em>, <em>data</em></td>
<td width="390" valign="top">Input number data in decimal representation from stdin. <em>size</em> – number, giving size of <em>data</em> in bytes - 1, 2 or 4. <em>data</em> must be name of variable or register or address expression without size qualifier (byte[], etc.). GET_UDEC input number as unsigned, GET_DEC — as signed. It is not allowed to use esp register.</td>
<td width="390" valign="top">Input number data in decimal representation from stdin. <em>size</em> – number, giving size of <em>data</em> in bytes - 1, 2, 4 or 8 (x64). <em>data</em> must be name of variable or register or address expression without size qualifier (byte[], etc.). GET_UDEC input number as unsigned, GET_DEC — as signed. It is not allowed to use esp register.</td>
</tr>
<tr>
<td width="242" valign="top"><a name="GET_HEX">GET_HEX</a> <em>size, data</em></td>
Expand Down Expand Up @@ -127,7 +130,7 @@ <H3>A little bit about the debugger:</H3>
<P>&nbsp;</P>
<H3>Implementation:</H3>
<H4>Windows</H4>
<P>As NASM compiler used nasm 2.11.02, as linker - gcc 4.6.2. Also SASM contains gdb debugger from MinGW and "io.inc" macro library. On Windows SASM is ready for work immediately after installation.</P>
<P>As NASM compiler used nasm 2.11.02, as linker - gcc 4.6.2 from MinGW (gcc 4.8.1 from MinGW64 in x64 mode). . Also SASM contains gdb debugger from MinGW and "io.inc" macro library. On Windows SASM is ready for work immediately after installation.</P>
<H4>Linux</H4>
<P>
For correct working on Linux must be installed next packages: nasm, gcc, gdb (for debugging).</P>
Expand All @@ -142,7 +145,7 @@ <H3>Warnings:</H3>
Program enter point should be marked with global label _main (in Windows) or main (in Linux) or CMAIN from "io.inc" (see initial text).
</P>
<P STYLE="margin-left: 0.5in; text-indent: -0.25in">2)<SPAN STYLE="font-variant: normal">&nbsp;&nbsp;&nbsp;
Before debugging make all functions formed frames (mov ebp, esp). This rule should be done for all functions, including main.
Before debugging make all functions formed frames (mov ebp, esp or mov rbp, rsp). This rule should be done for all functions, including main.
if this condition is not met, the correct work of the debugger is not guaranteed.
</P>
<P STYLE="margin-left: 0.5in; text-indent: -0.25in">3)<SPAN STYLE="font-variant: normal">&nbsp;&nbsp;&nbsp;
Expand Down
Binary file modified language_ru.qm
Binary file not shown.
Loading

0 comments on commit 3ccf3d6

Please sign in to comment.