* cygwinenv.sgml: Remove CYGWIN=strace option. Update CYGWIN options.
* how-programming.texinfo: Remove stuff about CYGWIN=strace. * setup2.sgml: Remove CYGWIN=strace example.
This commit is contained in:
		| @@ -1,3 +1,9 @@ | |||||||
|  | Sat Nov 18 23:50:12 2000  Christopher Faylor <cgf@cygnus.com> | ||||||
|  |  | ||||||
|  | 	* cygwinenv.sgml: Remove CYGWIN=strace option.  Update CYGWIN options. | ||||||
|  | 	* setup2.sgml: Remove CYGWIN=strace example. | ||||||
|  | 	* how-programming.texinfo: Remove stuff about CYGWIN=strace. | ||||||
|  |  | ||||||
| Thu Oct 26 10:00:00 2000  Corinna Vinschen <corinna@vinschen.de> | Thu Oct 26 10:00:00 2000  Corinna Vinschen <corinna@vinschen.de> | ||||||
|  |  | ||||||
| 	* ntsec.sgml: Slight changes. Fix some errors. | 	* ntsec.sgml: Slight changes. Fix some errors. | ||||||
|   | |||||||
| @@ -29,12 +29,18 @@ contents. Defaults to set.</para> | |||||||
| settings are re-exported to the environment as $CYGWIN again.</para> | settings are re-exported to the environment as $CYGWIN again.</para> | ||||||
| </listitem> | </listitem> | ||||||
| <listitem> | <listitem> | ||||||
| <para><FirstTerm>(no)glob</FirstTerm> - if set, command line arguments | <para><FirstTerm>error_start:filepath</FirstTerm> - if set, runs <filename>filepath</filepath> | ||||||
|  | when cygwin encounters a fatal error.  This is useful for debugging. | ||||||
|  | <filename>filepath</filename> is usually set to the path to the <filename>gdb</filename> | ||||||
|  | program. | ||||||
|  | <para><FirstTerm>(no)glob[:ignorecase]</FirstTerm> - if set, command line arguments | ||||||
| containing UNIX-style file wildcard characters (brackets, question mark, | containing UNIX-style file wildcard characters (brackets, question mark, | ||||||
| asterisk, escaped with \) are expanded into lists of files that match  | asterisk, escaped with \) are expanded into lists of files that match  | ||||||
| those wildcards. | those wildcards. | ||||||
| This is applicable only to programs running from a DOS command line prompt. | This is applicable only to programs running from a DOS command line prompt. | ||||||
| Default is set.</para> | Default is set.</para> | ||||||
|  | <para>This option also accepts an optional <literal>[no]ignorecase</literal> modifer. | ||||||
|  | If supplied, wildcard matching is case insensitive.  The default is <literal>noignorecase</literal></para> | ||||||
| </listitem> | </listitem> | ||||||
| <listitem> | <listitem> | ||||||
| <para><FirstTerm>(no)ntea</FirstTerm> - if set, use the full NT Extended | <para><FirstTerm>(no)ntea</FirstTerm> - if set, use the full NT Extended | ||||||
| @@ -56,16 +62,6 @@ to 9600-8-N-1 with no flow control when used. This is done at open | |||||||
| time and when handles are inherited.  Defaults to set.</para> | time and when handles are inherited.  Defaults to set.</para> | ||||||
| </listitem> | </listitem> | ||||||
| <listitem> | <listitem> | ||||||
| <para><FirstTerm>strace=n[:cache][,filename]</FirstTerm> - configures system |  | ||||||
| tracing.  Off by default, setting various bits in <literal>n</literal> (a |  | ||||||
| bit flag) enables various types of system messages.  Setting |  | ||||||
| <literal>n</literal> to 1 enables most messages.  Other values can be found |  | ||||||
| in <filename>sys/strace.h</filename>.  The <literal>:cache</literal> option |  | ||||||
| lets you specify how many lines to cache before flushing the output |  | ||||||
| (example: <literal>strace=1:20</literal>).  The <literal>filename</literal> |  | ||||||
| option lets you send the messages to a file instead of the screen. </para> |  | ||||||
| </listitem> |  | ||||||
| <listitem> |  | ||||||
| <para><FirstTerm>(no)strip_title</FirstTerm> - if set, strips the directory | <para><FirstTerm>(no)strip_title</FirstTerm> - if set, strips the directory | ||||||
| part off the window title, if any.  Default is not set.</para> | part off the window title, if any.  Default is not set.</para> | ||||||
| </listitem> | </listitem> | ||||||
|   | |||||||
| @@ -397,16 +397,6 @@ programs with various debug and trace messages enabled.  For information | |||||||
| on using @code{strace}, see the Cygwin User's Guide or the file | on using @code{strace}, see the Cygwin User's Guide or the file | ||||||
| @code{winsup/utils/utils.sgml}. | @code{winsup/utils/utils.sgml}. | ||||||
|  |  | ||||||
| Alternatively, you can set the @code{STRACE} environment variable to |  | ||||||
| @code{1}, and get a whole load of debug information on your screen |  | ||||||
| whenever a Cygwin app runs.  This is an especially useful tool to use |  | ||||||
| when tracking bugs down inside the Cygwin library.  @code{STRACE} can be |  | ||||||
| set to different values to achieve different amounts of granularity. |  | ||||||
| You can set it to @code{0x10} for information about syscalls or |  | ||||||
| @code{0x800} for signal/process handling-related info, to name two.  The |  | ||||||
| strace mechanism is well documented in the Cygwin library sources in the |  | ||||||
| file @code{winsup/cygwin/include/sys/strace.h}. |  | ||||||
|  |  | ||||||
| @subsection Why doesn't gdb handle signals? | @subsection Why doesn't gdb handle signals? | ||||||
|  |  | ||||||
| Unfortunately, there is only minimal signal handling support in gdb | Unfortunately, there is only minimal signal handling support in gdb | ||||||
|   | |||||||
| @@ -145,7 +145,7 @@ etc...) using a syntax like this in the DOS shell, before launching bash. | |||||||
| </para> | </para> | ||||||
|  |  | ||||||
| <screen> | <screen> | ||||||
| <prompt>C:\Cygnus\></prompt> <userinput>set CYGWIN=tty notitle strace=0x1</userinput> | <prompt>C:\Cygnus\></prompt> <userinput>set CYGWIN=tty notitle glob</userinput> | ||||||
| </screen> | </screen> | ||||||
|  |  | ||||||
| <para> | <para> | ||||||
|   | |||||||
		Reference in New Issue
	
	Block a user