92 lines
4.2 KiB
Plaintext
92 lines
4.2 KiB
Plaintext
|
<sect1 id="using-cygwinenv"><title>The <EnVar>CYGWIN</EnVar> environment
|
||
|
|
variable</title>
|
||
|
|
|
||
|
|
<para>The <EnVar>CYGWIN</EnVar> environment variable is used to configure
|
||
|
|
many global settings for the Cygwin runtime system. It contains the options
|
||
|
|
listed below, separated by blank characters. Many options can be turned off
|
||
|
|
by prefixing with <literal>no </literal>.</para>
|
||
|
|
|
||
|
|
<itemizedlist Mark="bullet">
|
||
|
|
<listitem>
|
||
|
|
<para><FirstTerm>(no)binmode</FirstTerm> - if set, non-disk
|
||
|
|
(e.g. pipe and COM ports) file opens default to binary mode
|
||
|
|
(no CR/LF/Ctrl-Z translations) instead of text mode.
|
||
|
|
Defaults to set (binary mode). This option must be set
|
||
|
|
before starting a Cygwin shell to have an effect on redirection.
|
||
|
|
</para>
|
||
|
|
<warning><title>Warning!</title><para>If set in 12/98 b20.1, all files
|
||
|
|
always open in binary mode.</para> </warning>
|
||
|
|
</listitem>
|
||
|
|
<listitem>
|
||
|
|
<para><FirstTerm>(no)envcache</FirstTerm> - If set, environment variable
|
||
|
|
conversions (between Win32 and POSIX) are cached. Note that this is may
|
||
|
|
cause problems if the mount table changes, as the cache is not invalidated
|
||
|
|
and may contain values that depend on the previous mount table
|
||
|
|
contents. Defaults to set.</para>
|
||
|
|
</listitem>
|
||
|
|
<listitem>
|
||
|
|
<para><FirstTerm>(no)export</FirstTerm> - if set, the final values of these
|
||
|
|
settings are re-exported to the environment as $CYGWIN again.</para>
|
||
|
|
</listitem>
|
||
|
|
<listitem>
|
||
|
|
<para><FirstTerm>(no)glob</FirstTerm> - if set, command line arguments
|
||
|
|
containing UNIX-style file wildcard characters (brackets, question mark,
|
||
|
|
asterisk, escaped with \) are expanded into lists of files that match
|
||
|
|
those wildcards.
|
||
|
|
This is applicable only to programs running from a DOS command line prompt.
|
||
|
|
Default is set.</para>
|
||
|
|
</listitem>
|
||
|
|
<listitem>
|
||
|
|
<para><FirstTerm>(no)ntea</FirstTerm> - if set, use the full NT Extended
|
||
|
|
Attributes to store UNIX-like inode information.
|
||
|
|
This option only operates under Windows NT. Defaults to not set. </para>
|
||
|
|
<Warning><Title>Warning!</Title> <para>This may create additional
|
||
|
|
<emphasis>large</emphasis> files on non-NTFS partitions.</para></Warning>
|
||
|
|
</listitem>
|
||
|
|
<listitem>
|
||
|
|
<para><FirstTerm>(no)ntsec</FirstTerm> - if set, use the NT security
|
||
|
|
model to set UNIX-like permissions on files and processes. The
|
||
|
|
file permissions can only be set on NTFS partitions. FAT and SAMBA doesn't
|
||
|
|
support the NT file security. For more information, read the documentation
|
||
|
|
in <citation>ntsec.sgml</citation>.</para>
|
||
|
|
</listitem>
|
||
|
|
<listitem>
|
||
|
|
<para><FirstTerm>(no)reset_com</FirstTerm> - if set, serial ports are reset
|
||
|
|
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>
|
||
|
|
</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
|
||
|
|
part off the window title, if any. Default is not set.</para>
|
||
|
|
</listitem>
|
||
|
|
<listitem>
|
||
|
|
<para><FirstTerm>(no)title</FirstTerm> - if set, the title bar
|
||
|
|
reflects the name of the program currently running. Default is not
|
||
|
|
set. Note that under Win9x the title bar is always enabled and it is
|
||
|
|
stripped by default, but this is because of the way Win9x works. In
|
||
|
|
order not to strip, specify <literal>title</literal> or <literal>title
|
||
|
|
nostrip_title</literal>.</para>
|
||
|
|
</listitem>
|
||
|
|
<listitem>
|
||
|
|
<para><FirstTerm>(no)tty</FirstTerm> - if set, Cygwin enables extra support
|
||
|
|
(i.e., termios) for UNIX-like ttys.
|
||
|
|
It is not compatible with some Windows programs.
|
||
|
|
Defaults to not set, in which case the tty is opened in text mode
|
||
|
|
with ^Z as EOF. Note that this has been changed such that ^D works as
|
||
|
|
expected instead of ^Z, and is settable via stty.
|
||
|
|
This option must be specified before starting a Cygwin shell
|
||
|
|
and it cannot be changed in the shell.</para>
|
||
|
|
</listitem>
|
||
|
|
</itemizedlist>
|
||
|
|
</sect1>
|