Teledyne-lecroy FireInspector - File Based Decoding Manual do Utilizador

2403 Walsh Avenue, Santa Clara, CA 95051-1302 Tel: +1/408.727.6600 Fax: +1/408.727.6622Document Revision 1.0December 17, 2001 730-0026-00CATC™ Scri

4CATC SCRIPTING LANGUAGE 1.0 CHAPTER 2Reference Manual ValuesEscape SequencesThese are the available escape sequences in CSL:ListsA list can hold zero

5CATC SCRIPTING LANGUAGE 1.0 CHAPTER 2Reference Manual Valuesresult = null;VariablesVariables are used to store information, or data, that can be mo

6CATC SCRIPTING LANGUAGE 1.0 CHAPTER 2Reference Manual Valueswill create a local variable called Local, which will only be visible within the function

7CATC SCRIPTING LANGUAGE 1.0 CHAPTER 3Reference Manual ExpressionsCHAPTER 3: EXPRESSIONSAn expression is a statement that calculates a value. The si

8CATC SCRIPTING LANGUAGE 1.0 CHAPTER 3Reference Manual Expressionsx = 10Value_of_x = select {x < 5 : "Less than 5";x >= 5 : "Grea

9CATC SCRIPTING LANGUAGE 1.0 CHAPTER 4Reference Manual OperatorsCHAPTER 4: OPERATORSAn operator is a symbol that represents an action, such as addit

10CATC SCRIPTING LANGUAGE 1.0 CHAPTER 4Reference Manual OperatorsThe associative operator () is used to group parts of the expression, forcing those p

11CATC SCRIPTING LANGUAGE 1.0 CHAPTER 4Reference Manual OperatorsOperator Symbol DescriptionOperand TypesResult Types ExamplesIndex Operator[ ] Inde

12CATC SCRIPTING LANGUAGE 1.0 CHAPTER 4Reference Manual OperatorsEquality Operators== Equal Integer-integer Integer 2 == 2String-string Integer "

13CATC SCRIPTING LANGUAGE 1.0 CHAPTER 4Reference Manual OperatorsBitwise Logical Operators~ Bitwise complementInteger-integer Integer ~0b11111110 =

iiCATC SCRIPTING LANGUAGE 1.0Reference ManualCATC Scripting Language Reference Manual for FireInspector, Document Revision 1.0Document DisclaimerThe i

14CATC SCRIPTING LANGUAGE 1.0 CHAPTER 4Reference Manual Operators

15CATC SCRIPTING LANGUAGE 1.0 CHAPTER 5Reference Manual CommentsCHAPTER 5: COMMENTSComments may be inserted into scripts as a way of documenting wha

16CATC SCRIPTING LANGUAGE 1.0 CHAPTER 5Reference Manual Comments

17CATC SCRIPTING LANGUAGE 1.0 CHAPTER 6Reference Manual KeywordsCHAPTER 6: KEYWORDSKeywords are reserved words that have special meanings within the

18CATC SCRIPTING LANGUAGE 1.0 CHAPTER 6Reference Manual Keywords

19CATC SCRIPTING LANGUAGE 1.0 CHAPTER 7Reference Manual StatementsCHAPTER 7: STATEMENTSStatements are the building blocks of a program. A program is

20CATC SCRIPTING LANGUAGE 1.0 CHAPTER 7Reference Manual Statementsif ( 3 - 3 || 2 - 2 ) Trace ( "Yes" );else Trace ( "No" );will c

21CATC SCRIPTING LANGUAGE 1.0 CHAPTER 7Reference Manual StatementsThe examplefor ( x = 2; x < 5; x = x + 1 ) Trace ( x, "\n" );would ou

22CATC SCRIPTING LANGUAGE 1.0 CHAPTER 7Reference Manual StatementsTrace ( HiThere() );...HiThere(){a = "Hi there";return a;b = "Goodbye

23CATC SCRIPTING LANGUAGE 1.0 CHAPTER 7Reference Manual Statements...<last_statement>;}An example of a compound statement is{x = 2;x + 3;}It&a

iCATC SCRIPTING LANGUAGE 1.0 FOR FIREINSPECTOR Reference Manual Table of ContentsTABLE OF CONTENTSTable of Contents . . . . . . . . . . . . . . . .

24CATC SCRIPTING LANGUAGE 1.0 CHAPTER 7Reference Manual Statements

25CATC SCRIPTING LANGUAGE 1.0 CHAPTER 8Reference Manual PreprocessingCHAPTER 8: PREPROCESSINGThe preprocessing command %include can be used to inser

26CATC SCRIPTING LANGUAGE 1.0 CHAPTER 8Reference Manual Preprocessing

27CATC SCRIPTING LANGUAGE 1.0 CHAPTER 9Reference Manual ContextCHAPTER 9: CONTEXTThe context is the mechanism by which transaction data is passed in

28CATC SCRIPTING LANGUAGE 1.0 CHAPTER 9Reference Manual Context

29CATC SCRIPTING LANGUAGE 1.0 CHAPTER 10Reference Manual Transaction and Packet Context FieldsCHAPTER 10: TRANSACTION AND PACKET CONTEXT FIELDSThis

30CATC SCRIPTING LANGUAGE 1.0 CHAPTER 10Reference Manual Transaction and Packet Context FieldsTarget_Node: Integer. The 1394 node ID of the target nod

31CATC SCRIPTING LANGUAGE 1.0 CHAPTER 10Reference Manual Transaction and Packet Context Fields• Dest_AddressIP Protocol TransactionsThese transactio

32CATC SCRIPTING LANGUAGE 1.0 CHAPTER 10Reference Manual Transaction and Packet Context Fields• Length• ChecksumICMP header fieldsThe following fields

33CATC SCRIPTING LANGUAGE 1.0 CHAPTER 10Reference Manual Transaction and Packet Context FieldsPacket Context FieldsA note about using packets as inp

iiCATC SCRIPTING LANGUAGE 1.0Reference Manual Table of Contents8 Preprocessing . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

34CATC SCRIPTING LANGUAGE 1.0 CHAPTER 10Reference Manual Transaction and Packet Context Fields• 0x16 -- pingNote: values >= 0x10 are phy packets.ra

35CATC SCRIPTING LANGUAGE 1.0 CHAPTER 10Reference Manual Transaction and Packet Context FieldsExampleThe following example is taken from the file IP

36CATC SCRIPTING LANGUAGE 1.0 CHAPTER 10Reference Manual Transaction and Packet Context Fields

37CATC SCRIPTING LANGUAGE 1.0 CHAPTER 11Reference Manual FunctionsCHAPTER 11: FUNCTIONSA function is a named statement or a group of statements that

38CATC SCRIPTING LANGUAGE 1.0 CHAPTER 11Reference Manual Functionsthe parameter x will be assigned to 1, and the parameter y will be assigned to null,

39CATC SCRIPTING LANGUAGE 1.0 CHAPTER 12Reference Manual PrimitivesCHAPTER 12: PRIMITIVESPrimitive functions are called similarly to regular functio

40CATC SCRIPTING LANGUAGE 1.0 CHAPTER 12Reference Manual PrimitivesCommentsFormat is used to control the way that arguments will print out. The format

41CATC SCRIPTING LANGUAGE 1.0 CHAPTER 12Reference Manual Primitives• A space will insert a space before a positive signed integer. This only works w

42CATC SCRIPTING LANGUAGE 1.0 CHAPTER 12Reference Manual Primitivesresult = C # The result is given in hexadecimal. The result in binary is 1100.In t

43CATC SCRIPTING LANGUAGE 1.0 CHAPTER 12Reference Manual PrimitivesResolve()Resolve( <symbol_name string> )Return valueThe value of the symbol

iiiCATC SCRIPTING LANGUAGE 1.0 FOR FIREINSPECTOR Reference Manual Table of ContentsEndCellBlock() . . . . . . . . . . . . . . . . . . . . . . . . .

44CATC SCRIPTING LANGUAGE 1.0 CHAPTER 12Reference Manual Primitives

45CATC SCRIPTING LANGUAGE 1.0 CHAPTER 13Reference Manual Decoder PrimitivesCHAPTER 13: DECODER PRIMITIVESAbort()Abort()Return valueAn integer that s

46CATC SCRIPTING LANGUAGE 1.0 CHAPTER 13Reference Manual Decoder PrimitivesReturn valueNone.CommentsAdds a display cell to the current output context.

47CATC SCRIPTING LANGUAGE 1.0 CHAPTER 13Reference Manual Decoder PrimitivesAddCell( "Warning", "Value5", "Warning cell"

48CATC SCRIPTING LANGUAGE 1.0 CHAPTER 13Reference Manual Decoder PrimitivesExample# Creates a data cell with 2 dwords (32-bit integers) of data.AddDat

49CATC SCRIPTING LANGUAGE 1.0 CHAPTER 13Reference Manual Decoder PrimitivesAddSeparator()AddSeparator(<additional_info any>, ...)Return valueN

50CATC SCRIPTING LANGUAGE 1.0 CHAPTER 13Reference Manual Decoder PrimitivesReturn valueNone.CommentsBegins a cell block and adds a block header cell.

51CATC SCRIPTING LANGUAGE 1.0 CHAPTER 13Reference Manual Decoder Primitives# This cell will be displayed when the red group is collapsed:AddCell( &q

52CATC SCRIPTING LANGUAGE 1.0 CHAPTER 13Reference Manual Decoder PrimitivesThe output of the example is: Complete()Complete()Return valueAn integer th

53CATC SCRIPTING LANGUAGE 1.0 CHAPTER 13Reference Manual Decoder PrimitivesEndCellBlock()EndCellBlock()Return valueNone.CommentsEnds a cell block th

ivCATC SCRIPTING LANGUAGE 1.0Reference Manual Table of Contents

54CATC SCRIPTING LANGUAGE 1.0 CHAPTER 13Reference Manual Decoder PrimitivesPeekNBits()PeekNBits(<bit_count integer>) Return valueNone.CommentsRe

55CATC SCRIPTING LANGUAGE 1.0 CHAPTER 13Reference Manual Decoder PrimitivesReturn valueAn integer that should be passed back to the application unch

56CATC SCRIPTING LANGUAGE 1.0 CHAPTER 13Reference Manual Decoder Primitives

57CATC SCRIPTING LANGUAGE 1.0 CHAPTER 14Reference Manual FireInspector-Specific PrimitivesCHAPTER 14: FIREINSPECTOR-SPECIFIC PRIMITIVESBitfieldInit(

58CATC SCRIPTING LANGUAGE 1.0 CHAPTER 14Reference Manual FireInspector-Specific PrimitivesIn the example, “Identifier” is the value of bitfield_identi

59CATC SCRIPTING LANGUAGE 1.0 CHAPTER 14Reference Manual FireInspector-Specific PrimitivesCommentsBitfieldDialog brings up a dialog box in which the

60CATC SCRIPTING LANGUAGE 1.0 CHAPTER 14Reference Manual FireInspector-Specific PrimitivesExampleSee “Example for FireInspector-Specific Primitives” o

61CATC SCRIPTING LANGUAGE 1.0 CHAPTER 14Reference Manual FireInspector-Specific Primitives# _MENU descriptor and menu_name[_MENU, "Menu entries

62CATC SCRIPTING LANGUAGE 1.0 CHAPTER 14Reference Manual FireInspector-Specific PrimitivesExample OutputThe AddCell entry builds the cell that contain

63CATC SCRIPTING LANGUAGE 1.0 CHAPTER 14Reference Manual FireInspector-Specific PrimitivesThe dialog box displays the data that is referred to by th

1CATC SCRIPTING LANGUAGE 1.0 CHAPTER 1Reference Manual IntroductionCHAPTER 1: INTRODUCTIONCATC Scripting Language (CSL) was developed to create scri

64CATC SCRIPTING LANGUAGE 1.0 CHAPTER 14Reference Manual FireInspector-Specific Primitives

65CATC SCRIPTING LANGUAGE 1.0 CHAPTER 15Reference Manual ModulesCHAPTER 15: MODULESModules are a collection of functions and global data dedicated t

66CATC SCRIPTING LANGUAGE 1.0 CHAPTER 15Reference Manual ModulesModule DataThere are several standard global variables that should be defined in a mod

67CATC SCRIPTING LANGUAGE 1.0 CHAPTER 15Reference Manual ModulesIconOptional. File name of an icon to display on the toolbar. Must be a 19x19 pixe

68CATC SCRIPTING LANGUAGE 1.0 CHAPTER 15Reference Manual Modules

2CATC SCRIPTING LANGUAGE 1.0 CHAPTER 1Reference Manual

3CATC SCRIPTING LANGUAGE 1.0 CHAPTER 2Reference Manual ValuesCHAPTER 2: VALUESThere are five value types that may be manipulated by a script: intege