S2sbind - Revision history

Ivailop: /* Options */

2009-01-20T00:45:59Z

Options

← Older revision		Revision as of 00:45, 20 January 2009
Line 15:		Line 15:
	!width="200pt"\|'''Option'''		!width="200pt"\|'''Option'''
	!width="500pt"\|'''Description'''		!width="500pt"\|'''Description'''
			\|-
			\| '''--version'''
			\| Print version information.
	\|-		\|-
	\| '''--input_database='''<i><file></i>		\| '''--input_database='''<i><file></i>

Ivailop: /* Options */

2008-10-31T23:24:16Z

Options

← Older revision		Revision as of 23:24, 31 October 2008
Line 26:		Line 26:
	\|-		\|-
	\| '''--output='''<i><file></i><br>'''-o'''<i><file></i>		\| '''--output='''<i><file></i><br>'''-o'''<i><file></i>
	\| Output database file.		\| Output database file. This option is required.
	\|-		\|-
	\| '''--options_file='''<i><file></i>		\| '''--options_file='''<i><file></i>

Ivailop: /* Syntax */

2008-10-31T23:23:44Z

Syntax

← Older revision		Revision as of 23:23, 31 October 2008
Line 8:		Line 8:
	=== Syntax ===		=== Syntax ===

	s2sbind [<i>options</i>] <i>meta_file1</i> [<i>meta_fileN</i>]		s2sbind [<i>options</i>] --output=<i>database_file</i> <i>meta_file1</i> [<i>meta_fileN</i>]

	=== Options ===		=== Options ===

Ivailop: /* The STRIDE Database Binder Utility */

2008-10-01T18:32:38Z

The STRIDE Database Binder Utility

Ivailop: /* The STRIDE Database Binder Utility */

2008-10-01T18:26:00Z

The STRIDE Database Binder Utility

← Older revision		Revision as of 18:26, 1 October 2008
Line 1:		Line 1:
	== The STRIDE Database Binder Utility ==		== The STRIDE Database Binder Utility ==

	The '''s2sbind~~.exe~~''' executable binds meta files (output from '''s2scompile~~.exe~~''') into a single .sidb file. In order for the binding process to succeed, the following conditions must be met:		The '''s2sbind''' executable binds meta files (output from '''s2scompile''') into a single .sidb file. In order for the binding process to succeed, the following conditions must be met:
	* All the target options (options starting with the "targ" prefix) used when invoking '''s2scompile~~.exe~~''' must be consistent across all meta files. If present, the input database is taken as the target standard. If not present, then the first meta file processed is considered to be the target standard. Any subsequent meta files must match or an error is generated and it is not processed.		* All the target options (options starting with the "targ" prefix) used when invoking '''s2scompile''' must be consistent across all meta files. If present, the input database is taken as the target standard. If not present, then the first meta file processed is considered to be the target standard. Any subsequent meta files must match or an error is generated and it is not processed.
	* The binding process validates that scl descriptions of all types are consistent across all processed meta files. Certain conflicts (termed scl conflicts) will be flagged as warnings. Others will be flagged as errors and prevent the binding of the .meta file containing the conflict.		* The binding process validates that scl descriptions of all types are consistent across all processed meta files. Certain conflicts (termed scl conflicts) will be flagged as warnings. Others will be flagged as errors and prevent the binding of the .meta file containing the conflict.

Line 8:		Line 8:
	=== Syntax ===		=== Syntax ===

	s2sbind [<i>options</i>] <i>meta_file1</i> [<i>meta_fileN</i>]		s2sbind [<i>options</i>] <i>meta_file1</i> [<i>meta_fileN</i>]

	=== Options ===		=== Options ===

Robg at 00:06, 30 September 2008

2008-09-30T00:06:47Z

← Older revision		Revision as of 00:06, 30 September 2008
Line 16:		Line 16:
	!width="500pt"\|'''Description'''		!width="500pt"\|'''Description'''
	\|-		\|-
	\| --input_database=<i><file></i>		\| '''--input_database='''<i><file></i>
	\| An existing .sidb file that is used as the starting point for the binding. Allows for incremental binding. By default the binding is not incremental.		\| An existing .sidb file that is used as the starting point for the binding. Allows for incremental binding. By default the binding is not incremental.
	\|-		\|-
	\| --starting_suid=<i><N></i>		\| '''--starting_suid='''<i><N></i>
	\| Specifies the starting SUID. Default is 1. This option is ignored if an input_database was specified. Otherwise SUID autonumbering will start at this number. The number can be from 1 to 2<sup>24</sup>-1. If the number of interfaces plus the starting SUID exceeds 2<sup>24</sup>-1 then the number will "wrap" (roll over to 1 when 2<sup>24</sup> is called for).		\| Specifies the starting SUID. Default is 1. This option is ignored if an input_database was specified. Otherwise SUID autonumbering will start at this number. The number can be from 1 to 2<sup>24</sup>-1. If the number of interfaces plus the starting SUID exceeds 2<sup>24</sup>-1 then the number will "wrap" (roll over to 1 when 2<sup>24</sup> is called for).
	\|-		\|-
	\| --no_warning		\| '''--no_warning'''
	\| Suppress all warnings in the bind phase.		\| Suppress all warnings in the bind phase.
	\|-		\|-
	\| --output=<i><file></i><br>-o<i><file></i>		\| '''--output='''<i><file></i><br>'''-o'''<i><file></i>
	\| Output database file.		\| Output database file.
	\|-		\|-
	\| --options_file=<i><file></i>		\| '''--options_file='''<i><file></i>
	\| A file that contains command line options. The format is the same as the command line with the only addition that it could be split on multiple lines. A line starting with "#" symbol is ignored.		\| A file that contains command line options. The format is the same as the command line with the only addition that it could be split on multiple lines. A line starting with "#" symbol is ignored.
	This option is necessary if the length of the command line string exceeds system limits. Otherwise it is provided only as a convenience.		This option is necessary if the length of the command line string exceeds system limits. Otherwise it is provided only as a convenience.

Stevel at 21:31, 21 August 2008

2008-08-21T21:31:33Z

← Older revision		Revision as of 21:31, 21 August 2008
Line 45:		Line 45:
	=== Examples ===		=== Examples ===
	Refer to the [[Build_Tools#Database_Binding\|Database Binding]] section of the Build Tools Examples.		Refer to the [[Build_Tools#Database_Binding\|Database Binding]] section of the Build Tools Examples.

			[[Category:Build_Tools]]

Ivailop: /* Options */

2008-07-17T23:26:42Z

Options

← Older revision		Revision as of 23:26, 17 July 2008
Line 29:		Line 29:
	\|-		\|-
	\| --options_file=<i><file></i>		\| --options_file=<i><file></i>
	\| A file that contains command line options. The format is the same as the command line with the only addition that it could be split on multiple lines. A line starting with "#" symbol is ignored. This option is necessary if the length of the command line string exceeds system limits. Otherwise it is provided only as a convenience.		\| A file that contains command line options. The format is the same as the command line with the only addition that it could be split on multiple lines. A line starting with "#" symbol is ignored.
			This option is necessary if the length of the command line string exceeds system limits. Otherwise it is provided only as a convenience.
	\|}		\|}

Ivailop: /* Options */

2008-07-17T23:14:41Z

Options

← Older revision		Revision as of 23:14, 17 July 2008
Line 29:		Line 29:
	\|-		\|-
	\| --options_file=<i><file></i>		\| --options_file=<i><file></i>
	\| A file that contains command line options~~. This option is necessary if the length of the command line string exceeds system limits. Otherwise it is provided only as a convenience~~. The format is the same as the command line with the only addition that it could be split on multiple lines. A line starting with "#" symbol is ignored.		\| A file that contains command line options. The format is the same as the command line with the only addition that it could be split on multiple lines. A line starting with "#" symbol is ignored. This option is necessary if the length of the command line string exceeds system limits. Otherwise it is provided only as a convenience.
	\|}		\|}

Ivailop: /* Options */

2008-07-17T23:13:39Z

Options

← Older revision		Revision as of 23:13, 17 July 2008
Line 29:		Line 29:
	\|-		\|-
	\| --options_file=<i><file></i>		\| --options_file=<i><file></i>
	\| A file that contains command line options. This option is necessary if the length of the command line string exceeds system limits. Otherwise it is provided only as a convenience.		\| A file that contains command line options. This option is necessary if the length of the command line string exceeds system limits. Otherwise it is provided only as a convenience. The format is the same as the command line with the only addition that it could be split on multiple lines. A line starting with "#" symbol is ignored.
	\|}		\|}

← Older revision		Revision as of 18:32, 1 October 2008
Line 1:		Line 1:
	== The STRIDE Database Binder Utility ==		== The STRIDE Database Binder Utility ==

	The '''s2sbind''' executable binds meta files (output from '''s2scompile''') into a single .sidb file. In order for the binding process to succeed, the following conditions must be met:		The '''s2sbind''' executable binds meta files (output from '''[[s2scompile]]''') into a single .sidb file. In order for the binding process to succeed, the following conditions must be met:
	* All the target options (options starting with the "targ" prefix) used when invoking '''s2scompile''' must be consistent across all meta files. If present, the input database is taken as the target standard. If not present, then the first meta file processed is considered to be the target standard. Any subsequent meta files must match or an error is generated and it is not processed.		* All the target options (options starting with the "targ" prefix) used when invoking '''s2scompile''' must be consistent across all meta files. If present, the input database is taken as the target standard. If not present, then the first meta file processed is considered to be the target standard. Any subsequent meta files must match or an error is generated and it is not processed.
	* The binding process validates that scl descriptions of all types are consistent across all processed meta files. Certain conflicts (termed scl conflicts) will be flagged as warnings. Others will be flagged as errors and prevent the binding of the .meta file containing the conflict.		* The binding process validates that scl descriptions of all types are consistent across all processed meta files. Certain conflicts (termed scl conflicts) will be flagged as warnings. Others will be flagged as errors and prevent the binding of the .meta file containing the conflict.
Line 17:		Line 17:
	\|-		\|-
	\| '''--input_database='''<i><file></i>		\| '''--input_database='''<i><file></i>
	\| An existing .sidb file that is used as the starting point for the binding. Allows for incremental binding. By default the binding is not incremental.		\| An existing database (.sidb) file that is used as the starting point for the binding. Allows for incremental binding. By default the binding is not incremental.
	\|-		\|-
	\| '''--starting_suid='''<i><N></i>		\| '''--starting_suid='''<i><N></i>
Line 37:		Line 37:
	When no input .sidb file is specified, '''s2sbind''' will assign interfaces SUIDs with the number given by the '''--starting_suid''' option, or 1 if no such option is specified. Interfaces are numbered in alphabetical order.		When no input .sidb file is specified, '''s2sbind''' will assign interfaces SUIDs with the number given by the '''--starting_suid''' option, or 1 if no such option is specified. Interfaces are numbered in alphabetical order.

	When an input .sidb file is specified then the following will take place.		When an input database (.sidb) file is specified then the following will take place.
	* any '''--starting_suid''' option is ignored		* any '''--starting_suid''' option is ignored
	* For every interface in the input .sidb file with name <F> and SUID <N>, if <F> is in the .sidb file after the bind it will have SUID <N>, otherwise <N> is not used.		* For every interface in the input .sidb file with name <F> and SUID <N>, if <F> is in the .sidb file after the bind it will have SUID <N>, otherwise <N> is not used.