Annotation of os2sdk/tools/rbin/cv.hlp, revision 1.1.1.1

1.1       root        1: BW03 IIntroducing Help&KKeyboard/MouseRRun CommandsDDisplay CommandsEExpressions
                      2: WWatch/BreakMMemory OperationsSSystem CommandsXRegular Xpressions��p���0�4�� p�p�뇇�9p�?�tp��&�b@�&�
                      3: ��
�3���_'     =U
                      4: � -  �#
                      5: 
                      6: �&
�)�,�
�0�|3r�5.8k�:�u=)��K �# 1
                      7: �� �CODEVIEW (R) HELP SYSTEM
                      8: �
                      9:  �You can enter the Help system in one of two ways:
                     10: �
                     11: � �1. Click on Help or press �ALT+H� to open the Help menu; then make a menu
                     12: �� �   selection to go directly to a category (each has 1-4 screens).
                     13: �
                     14: � �2. By entering �H� or pressing �F1�, you go directly to this screen.
                     15: �
                     16:  �Once in the Help system, move forward or backward to another screen by
                     17: � �clicking one of the selection boxes below, or pressing one of the high-
                     18: � �lighted hot keys. Colors and syntax used in the screens are described below:
                     19: �
                     20:   �Headings and titles� �Headings�� �   �Indicates that �item� is� [�item�]
                     21: �  �Key terms or punctuation   �Key terms�� �   �  optional
                     22: �  �Explanatory text� Text�    �   �Indicates either �a� or �b�   �a� | �b
                     23: �  �Information you supply� �Placeholders
                     24: ��- �SCREEN 1 OF 1 (Introducing Help)
                     25: � �Description� ��
 �Keyboard� �� �  Mouse� �# 2
                     26: ���������
                     27: � �Enter Help system� � �F1� �   �� �Use �Help� menu
                     28: � �Open register window� � �F2� �   �� �Use �Options� menu
                     29: � �Toggle display mode� � �F3� �   �� �Use �View �menu
                     30: � �Switch to Output screen  � �F4� �   �� �Use� View� menu
                     31: � �Go� � �F5� �   �� �Click left on �Go
                     32: � �Switch cursor window� � �� �F6� �   �� �None
                     33: � �Execute cursor line� � �F7 �at location  �   �   �� �Click right on source line
                     34: � �Trace through routine� � �F8� �  �� �Click left on Trace
                     35: � �Set breakpoint at cursor � �F9 �at location  �� �  �� �Click left on source line
                     36: � �Step over routine� � �F10� �  �� �Click right on Trace
                     37: � �Make window grow�    � �CONTROL+G�
                     38:  �   �� �Drag line up or down
                     39: � �Make window tiny�    � �CONTROL+T�
                     40:  �   �� �Drag line up or down
                     41: � �Scroll up a line�    � Move cursor off top   �� �Click left on up arrow
                     42: � �Scroll up a page�    � �PGUP� �   �� �Click above elevator
                     43: � �Scroll down a line� � Move cursor off bottom�� �Click left on down arrow
                     44: � �Scroll down a page� � �PGDN� �   �� �Click below elevator
                     45: � �������SCREEN 1 OF 1 (Keyboard/Mouse)
                     46: � �Trace�      �T �[�count�]� Executes current source line or� �# 3
                     47: � �� �(�F8�)� instruction. If �count� is given,
                     48: � �� �(Click left on �Trace�)   repeats �count� times. Traces through
                     49: � �� �� routines and interrupts.
                     50: �
                     51:  �Program Step  �P �[�count�]� Executes current source line or
                     52: � �� �(�F10�)� instruction. If �count� is given,
                     53: � �� �(Click right on �Trace�)  repeats �count� times. Steps over
                     54: � �� �� routines and interrupts.
                     55: �
                     56:  �Go� �G �[�address�]�
 Executes until debugger encounters
                     57: � �� �(�F5�)� �address�, a previously set breakpoint,
                     58: � �� �(Click on �Go�)� or the end of the program.
                     59: �
                     60: 
                     61:  �Execute�� �E�� Executes in slow motion until you
                     62: ��' �press a key.
                     63: �
                     64: �0 �SCREEN 1 OF 1 (Run Commands)
                     65: �Display Expression�   ��0 �# 4
                     66: �
                     67:   �?� �expression�[�,�format�]   � �Evaluates �expression� and displays the value. If
                     68: �� �format� is given, the value is displayed in the
                     69: �� �corresponding format, as shown below:
                     70: �
                     71:   �Specifier�  �Input Type�   �Output Format
                     72: �  ��  ������'�
                     73: �   �d �or� i  �� �Integer  � �� �Signed decimal integer
                     74: �   �u� �� �Integer  � �� �Unsigned decimal integer
                     75: �   �o� �� �Integer  � �� �Unsigned octal integer
                     76: �   �x �or� X  �� �Integer  � �� �Hexadecimal integer
                     77: �   �f� �� �Real� � �� �Floating point
                     78: �   �e �or� E  �� �Real� � �� �Scientific notation
                     79: �   �g �or� G  �� �Real� � �� �"E" or "f," whichever is more compact
                     80: �   �c� �� �Character� �� �ASCII equivalent of character
                     81: �   �s� �� �String   � �� �C null-terminated string
                     82: �  ��  ������'�
                     83: �  �Integers can have �l� or �s� prefix.� �SCREEN 1 OF 3 (Display Commands)
                     84: �Display Symbols� ��) �# 5
                     85: �
                     86: �  �X�[�?�[�module�!�][�routine�.�]�symbol�|�*�]� Displays symbols as described below:
                     87: �
                     88:  �����1�
                     89: � �X?�module�!�routine�.�symbol�   �� �This �symbol� in �routine� in �module�.
                     90: � �X?�module�!�routine�.*� �� �All symbols in �routine� in �module�.
                     91: � �X?�module�!�symbol�� �� �This �symbol� in �module� (must be static).
                     92: � �X?�module�!*� �� �All static symbols in �module�. Will not find
                     93: � �� �� � local or dynamic variables.
                     94: � �X?�routine�.�symbol��
                     95:  �� �This �symbol� in �routine�. Searches all modules.
                     96: � �X?�routine�.*� �� �All symbols in �routine�. Searches all modules.
                     97: � �X?�symbol�� �� �Looks for �symbol� in this order:
                     98: � �� �� � current routine, current module, all modules.
                     99: � �X?*� �� �All symbols in current routine.
                    100: � �X*� �� �All module names.
                    101: � �X� �� �All symbols in all modules.
                    102: �
                    103: �- �SCREEN 2 OF 3 (Display Commands)
                    104: � �Set Mode� �S�[�+�|�-�|�&�]��
                    105:  �Sets display mode to source (�+�),� �# 6
                    106: � �� �� �assembly (�-�), or mixed (�&�).
                    107: �
                    108:  �Current Location   �.� �Puts current line in center of display
                    109: � �� �� �window.
                    110: �
                    111:  �Stack Trace� �K� �Displays routines and their arguments.
                    112: � �� �(�ALT+C�)�� �The current routine is on top; the
                    113: � �� �� �initial routine is on bottom.
                    114: �
                    115:  �Unassemble�   �U �[�range�]��         �Displays instructions in �range�. If no
                    116: � �� �� �range� is given, scrolls down one screen.
                    117: �
                    118:  �View� �V�[�expression�]�� �Displays source lines, starting at
                    119: �� �V�[�.�[�file�:�]�line�]�   �expression� or �line�. If �file� is given,
                    120: ��& �loads source file. If no arguments are
                    121: ��& �given, scrolls down one screen.
                    122: �
                    123: �- �SCREEN 3 OF 3 (Display Commands)
                    124: �CodeView Expressions�
 ��* �# 7
                    125: �
                    126:  �Expressions in CodeView commands consist of symbols, constants, and/or
                    127: � �operators. Operators join symbols and constants into larger expressions.
                    128: � �For example, "+" joins the constants "4" and "5" in the expression "4+5".
                    129: � �Syntax for operators and constants is presented in the next three screens.
                    130: �
                    131: �Changing Expression Evaluators
                    132: �
                    133:  �USE� [�language�]� Changes evaluator to �AUTO�, �C�, �FORTRAN�, or �BASIC�. If
                    134: �� �language� is not given, displays current evaluator.
                    135: �
                    136:  �You can also choose evaluators with the Language menu. �AUTO� uses source-
                    137: � �file extension to select evaluator (with C as default choice).
                    138: �
                    139: �Notes on Extended Operators (�.� and �:�)
                    140: �
                    141: �[�routine�.�]�variable�   � �Local or global variable
                    142: �.�[�module�:�]�linenumber� � �Source-line address� �SCREEN 1 OF 4 (Expressions)
                    143: �C Expressions� ��0 �# 8
                    144: �
                    145: 
                    146:   �Precedence  �  �Operators�   �� �Syntax� Radix
                    147: �  �����&��   ��      ����
                    148: �  �highest  1 �� �()�  �[]�  �->�  �.�� �   �0�number�  �� �Octal
                    149: �  ��   2 �� �!�  �~�  �-�  �(�type�)�  �++�  �--�  �*�  �&�  �sizeof�   �0n�number� �� �Decimal
                    150: �  ��   3 �� �*  /  %  :� �   �0x�number� �� �Hexadecimal
                    151: �  ��   4 �� �+  -�! �   ��    ����
                    152: �  ��   5 �� �<  >  <=  >=
                    153: �  ��   6 �� �==  !=� �� �Memory Operators
                    154: �  ��   7 �� �&&�# �   ���
                    155: �  ��   8 �� �||�# �   �BY� �n�  Return byte at �n
                    156: �  ��   9 �� �=  +=  -=  *=  /=  %=� �   �WO� �n�  Return word at �n
                    157: �  �lowest  10 �� �BY  WO  DW� �   �DW� �n�  Return dbl. word
                    158: �  �����&��   ���
                    159: �
                    160:   �See Screens #7 and #13 for use of extended
                    161: �  �operators (�.� and �:�).� �   �SCREEN 2 OF 4 (Expressions)
                    162: �FORTRAN Expressions� ��" �# 9
                    163: �
                    164:   � Precedence� Operators
                    165: �  ������
                    166: �   �highest 1 � �()
                    167: �� �2 � �.  :
                    168: �� �3 � �+  -  �(unary)�� �  Constant� Radix
                    169: �� �4 � �*  /� ��
����
                    170: �� �5 � �+  -  �(binary)�� �number� � Default radix
                    171: �� �6 � �.LT. .LE. .EQ. .NE. .GT. .GE.   �radix�#�number � Specified radix
                    172: �� �7 � �.NOT.� #�number� � Hexadecimal
                    173: �� �8 � �.AND.� ��
����
                    174: �   �� 9 �� �.OR.
                    175: �   �� 10 �� �.EQV. .NEQV.
                    176: �   �lowest 11 �� �=
                    177: �  ������
                    178: �
                    179:   �See Screens #7 and #13 for use of extended
                    180: �  �operators (�.� and �:�).� � �SCREEN 3 OF 4 (Expressions)
                    181: �BASIC Expressions� ��" �#10
                    182: ��. �  Constant� Radix
                    183: �� �Precedence� Operators� �� ��
����
                    184: �   ��������  �number� �� �Default radix
                    185: �� �highest 1 � �()� &O�number   �� �Octal
                    186: ��
 �2 � �.  :� &�number� �� �Octal
                    187: ��
 �3 � �+  -  �(unary)�� &H�number   �� �Hexadecimal
                    188: ��
 �4 � �*  /� ��
����
                    189: ��
 �5 � �\  MOD
                    190: ��
 �6 � �+  -  �(binary)�� �  �  Suffix� Type
                    191: ��
 �7 � �=  <>  <  >  <=  >=� �  ��  ����
                    192: ��
 �8 � �NOT� �� �%  � ��  �Integer
                    193: �� �� 9 �� �AND� �� �&  � ��  �Long
                    194: �� �� 10 �� �OR� �� �!  � ��  �Single
                    195: �� �� 11 �� �XOR� �� �#  � ��  �Double
                    196: �� �� 12 �� �EQV� �  ��     ����
                    197: �� �� 13 �� �IMP� �See Screens #7 & #13 for use of
                    198: �� �lowest 14 �� �LET �variable� =� �extended operators (�.� and �:�).
                    199: �   ��������
                    200:  �SCREEN 4 OF 4 (Expressions)
                    201: �Watch�        �  �W? �expression�[�,�format�]�   �  �Displays �expression� in �format�,  �#11
                    202: �Expression� �  �W�[�type�]� �range�� �  �or �range� in �type� format. See
                    203: �� �  �� �  �Screen #4 for format information,
                    204: �� �  �� �  �and #13 for type information.
                    205: �
                    206: Watchpoint� �  �WP? �expression�� �  �Breaks execution when �expression
                    207: �� �  �� �  �is true (non-zero).
                    208: �
                    209: Tracepoint� �  �TP? �expression�[�,�format�]�  �  �Breaks when �expression� or any
                    210: �� �  �TP�[�type�]� �range�� �  �value in �range� changes. Displays
                    211: �� �  �� �  �same as Watch Expression.
                    212: �
                    213: Watch List� �  �W� �  �Lists watch statements.
                    214: �
                    215: 
                    216: Watch Delete  �  �Y �number�|�*� �  �Deletes indicated watch
                    217: ��+ �statement, or all if �*� is given.
                    218: �
                    219: �0 �SCREEN 1 OF 2 (Watch/Break)
                    220: �Breakpoint  �BP �addr� �[�count�] [�"�cmnd�"�]�  �Sets breakpoint at address �addr�. If  �#12
                    221: �Set�   �� �count� is given, breakpoint is taken
                    222: �� �� �after �count� times. If �cmnd� is given,
                    223: �� �� �the command is executed at each break.
                    224: �
                    225: Breakpoint  �BC �list� �|� *� �Deletes breakpoints in �list�, or all
                    226: �Clear� �� �breakpoints if �*� is given instead.
                    227: �
                    228: Breakpoint  �BD �list� �|� *� �Disables breakpoints in �list�, or all
                    229: �Disable� �� �breakpoints if �*� is given instead.
                    230: �
                    231: Breakpoint  �BE �list� �|� *� �Enables breakpoints in �list�, or all
                    232: �Enable� �� �breakpoints if �*� is given instead.
                    233: �
                    234: Breakpoint  �BL� �List breakpoints, including status,
                    235: �List� �� �location, pass count, and associated
                    236: ��& �commands.
                    237: �
                    238: �0 �SCREEN 2 OF 2 (Watch/Break)
                    239: �Memory Type Formats--used with Dump, Watch, and Enter commands:� �#13
                    240: �
                    241:   �A  ��  �ASCII-format string
                    242: �  �B  ��  �Byte (8-bit hexadecimal unsigned integer)
                    243: �  �I  ��  �Integer (16-bit decimal)
                    244: �  �U  ��  �Unsigned (16-bit decimal unsigned integer)
                    245: �  �W  ��  �Word (16-bit unsigned hexadecimal)
                    246: �  �D  ��  �Double Word (32-bit unsigned hexadecimal)
                    247: �  �S  ��  �Short Real (4 bytes)
                    248: �  �L  ��  �Long Real (8 bytes)
                    249: �  �T  ��  �Ten-byte Real
                    250: �
                    251: �Specifying Addresses and Address Ranges
                    252: �
                    253:   �expression1 �[�:�expression2�]�   �Specifies offset or segmented address.
                    254: �  �address1 address2� �Range from �address1� to �address2�.
                    255: �  �address1 �L� size� �Range beginning at �address1� and of length
                    256: �� �size�.
                    257: ��- �SCREEN 1 OF 3 (Memory Operations)
                    258: �Enter� �E�[�type�] �addr� [�list�]�   �Enters values of �type�, beginning at �addr�.  �#14
                    259: ��
                    260:  � �� �Debugger will prompt if �list� is not given.
                    261: ��
                    262:  � �� �Items in �list� are separated by spaces.
                    263: �
                    264: Dump� �D�[�type�]� �[�range�]�� �Dumps values of �type� in �range�. Previous or
                    265: ��
                    266:  � �� �default type assumed if �type� is not given.
                    267: �
                    268: Assemble  �A� �[�address�]�� �Assembles mnemonic instructions beginning
                    269: ��
                    270:  � �� �at �address�. Assumes next instruction if
                    271: ��
                    272:  � �� address� is not given.
                    273: �
                    274: Register  �R�[�reg �[�expression�]]�   �Sets one of the following registers: �AX�, �BX�,
                    275: ��
                    276:  � �� �CX�, �DX�, �SP�, �BP�, �SI�, �DI�, �DS�, �ES�, �SS�, �CS�, �IP�,
                    277: ��
                    278:  � �� �or 386 extended register.
                    279: �
                    280: �
                    281:  �RF �[�flag�]� �  �Sets a condition from one of these pairs:
                    282: ��  �OV�-�NV�,� DN�-�UP�,� EI�-�DI�,� NG�-�PL�,� ZR�-�NZ�,� AC�-�NA�,
                    283: ��  �PE�-�PO�,� CY�-�NC�.
                    284: ��- �SCREEN 2 OF 3 (Memory Operations)
                    285: �Search Memory� �S �range list� �Displays each address in �range� that� �#15
                    286: �� �  �� �begins a sequence matching each byte
                    287: �� �  �� �in �list�.
                    288: �
                    289: Compare Memory   �C �range address� �Compares bytes in �range� to an equal-
                    290: �� �  �� �sized block beginning at �address�.
                    291: �
                    292: Fill Memory� �F �range list� �Fills �range� with byte values in �list�,
                    293: �� �  �� �repeating values until �range� filled.
                    294: �
                    295: Move Memory� �M �range address� �Copies values in �range� to an equal-
                    296: �� �  �� �sized block beginning at �address�.
                    297: �
                    298: Port Input� �I �port�
 �Displays value at �port�.
                    299: �Port Output� �O �port byte� �Assigns �byte� to �port�.
                    300: �
                    301: �8087�
                    302:  �   �7�� �Displays 8087 registers and stack.
                    303: �
                    304: �- �SCREEN 3 OF 3 (Memory Operations)
                    305: �Help� �H� �  �Enters CodeView Help System.� � �#16
                    306: �
                    307: 
                    308: Load� �L� [�arguments�]� �  �Reloads program. Uses new command-line
                    309: ��
                    310:  � �� �  �arguments� if given.
                    311: �
                    312: Option� �O�[{�F�|�B�|�C�|�3�}[�+�|�-�]]  �  �Sets (�+�), clears (�-�), or displays the
                    313: ��
                    314:  � �� �  �status of �F�lip/Swap, �B�ytes Coded, �C�ase
                    315: ��
                    316:  � �� �  �Sense, or �3�86 option.
                    317: �
                    318: Quit� �Q�� �  �Exits the CodeView debugger.
                    319: �
                    320: 
                    321: Radix� �N� [�radix�]�
                    322:  �  �Sets radix to 8, 10, or 16, if �radix� is
                    323: ��
                    324:  �� �  �given; otherwise displays current radix.
                    325: �
                    326: Redraw� �@� �  �Redraws display screen.
                    327: �
                    328: �- �SCREEN 1 OF 3 (System Commands)
                    329: ��K �#17
                    330: �Screen Exchange   �\�
 �Displays the output screen. Press any key
                    331: �� �� �to return to the debugging screen.
                    332: �
                    333: Shell Escape� �!�[�command�]�� �Starts a new DOS shell and executes the
                    334: �� �� �program or DOS command given as �command�.
                    335: �� �� �If �command� is not given, user can enter
                    336: �� �� �commands from the DOS prompt, and then
                    337: �� �� �enter �EXIT� when ready to return to the
                    338: �� �� �DOS prompt.
                    339: �
                    340: Tab Set� �#�number�� �Sets the number of spaces per tab, to
                    341: ��  �number�.
                    342: �
                    343: 
                    344: 
                    345: 
                    346: 
                    347: �- �SCREEN 2 OF 3 (System Commands)
                    348: �Redirection Commands ��6 �#18
                    349: �
                    350:    �[�T�]�>�[�>�]�device�� Redirects command output to �device� (file or device). If
                    351: �   �� �T� given, output is echoed on CodeView screen. If second
                    352: �   �� �>� given, output is appended.
                    353: �
                    354:    �<�device�� Redirects command input from �device� (file or device).
                    355: �
                    356:    �=�device�� Redirects both command input and command output.
                    357: �
                    358: �Commands Used with Redirection
                    359: �
                    360:    �*�comment�� �  �Displays �comment� but does not attempt to execute.
                    361: �
                    362:    �"� �  �Pauses until user presses a key.
                    363: �
                    364:    �:� �  �Delays for half a second.
                    365: �
                    366: �- �SCREEN 3 OF 3 (System Commands)
                    367: �Search Command� ��2 �#19
                    368: �
                    369:    �/�[�regex�]� Searches from cursor line for �regex�, or previous regular
                    370: �� �expression if �regex� not given--�regex� consists of text and
                    371: �� �(optionally) any of the following special characters:
                    372: �
                    373:  �Character� � �Function
                    374: � ��
���>�
                    375: �  �\�� ��  �Removes special meaning (if any) of next character, so
                    376: �� ��  �that it is treated as ordinary text. Special characters
                    377: �� ��  �are �\  .  *  [  ]  ^  $�.
                    378: �  � �� �
                    379: �  �.�� ��  �Matches any character.
                    380: �  � �� �
                    381: �  �*�� ��  �Matches zero or more repetitions of previous character.
                    382: �  � �� �
                    383: �  �^� or �$� �� ��  �Matches beginning or end of line, respectively.
                    384: �
                    385:  �Continued on next screen.� �SCREEN 1 OF 2 (Regular Expressions)
                    386: ��K �#20
                    387: � �Character� �  �Function
                    388: � ��
���>�
                    389: �� �
                    390: � �[�characters�]� ��   �Matches any of the characters within brackets. The
                    391: �� ��   �following characters have special meaning within brackets:
                    392: �
                    393: � �^  ��   �When appearing at the beginning of characters,
                    394: �� ��   �reverses the function of the brackets so that all
                    395: �� ��   �characters will be matched except those in the
                    396: �� ��   �brackets. (Example: "[^a]" matches all characters
                    397: �� ��   �except "a.")
                    398: �� �
                    399: �� �-�  ��   �Matches characters in range specified by characters
                    400: �� ��   �on either side of �-�. (Example: "[a-c]" matches "a,"
                    401: �� ��   �"b," or "c.") To nullify special meaning of �-�,
                    402: �� ��   �place at start or end of characters. (Example:
                    403: �� ��   �"[-ac]".)
                    404: ��+ �SCREEN 2 OF 2 (Regular Expressions)
                    405: 
                    406: ======== Execute Code =========   =============== Examine Data ================
                    407: T [<count>] ............. Trace   ? <expr>[,format] ........ Display Expression
                    408: P [<count>] ...... Program Step   X?[mod!][fun.][sym][*] ...... Examine Symbols
                    409: G [<addr>] ................. Go   D[<type>] [<range>] .................... Dump
                    410: E ..................... Execute   R [<reg>] [[=]<expr>] .............. Register
                    411: L [<args>] ............ Restart   7 ........................ 8087 Register Dump
                    412: ================ Breakpoints ===================  ====== Watch Statements =====
                    413: BP [<addr>] [<count>] ["<cmd>"] . Breakpoint Set  W? <expr> ............. Watch
                    414: BC [<list>] ................... Breakpoint Clear  W[<type>] <range> ..... Watch
                    415: BD [<list>] ................. Breakpoint Disable  WP? <expr> ....... Watchpoint
                    416: BE [<list>] .................. Breakpoint Enable  TP? <expr> ....... Tracepoint
                    417: BL ............................. Breakpoint List  TP[<type> <range>  Tracepoint
                    418: ==================== Modify ====================  Y<list> ........ Delete Watch
                    419: A [<addr>] ............................ Assemble  W ................ List Watch
                    420: E[<type>] [<list>] ....................... Enter  ========== Memory ===========
                    421: ==== Examine Source ====  === System Control ===  C <range> <addr> .... Compare
                    422: S[+|-|&] ...... Set Mode  N[<radix>] . Set Radix  F <range> <list> ....... Fill
                    423: U [<range>] . Unassemble  Q ............... Quit  M <range> <addr> ....... Move
                    424: V [<addr>] . View Source  /[<regex>] .... Search  S <range> <list> ..... Search
                    425: . ..... Current Location  \ .... Screen Exchange  I <port> ......... Port Input
                    426: K .......... Stack Trace  #[<num>] ..... Tab Set  O <port> <byte> . Port Output
                    427:                           O[F|B|C|3[+|-]] Option  
                    428:                           ![<cmd>]  Shell Escape
                    429: 

unix.superglobalmegacorp.com

This archive runs on limited infrastructure. Preserving old code on modern bandwidth. Automated agents are requested to crawl responsibly.