From ac51da48181e56cb45ddd609b50a3549287bdc27 Mon Sep 17 00:00:00 2001 From: Joshua Daniel Franklin Date: Sun, 11 Jan 2004 08:32:09 +0000 Subject: 2004-01-11 Joshua Daniel Franklin * Makefile.in: Add new target for single-file User's Guide, use new cygwin.dsl for output. * cygwin.dsl: New file, DSSSL stylesheet for custom Cygwin output. * cygwin-api.in.sgml: Update to DocBook SGML 4.2 DTD. * cygwin-ug-net.in.sgml: Update to DocBook SGML 4.2 DTD. * cygwin-ug.in.sgml: Update to DocBook SGML 4.2 DTD. * cygwinenv.sgml: Correct some tags. Add description of default values to ntsec, export, and error_start items. * dll.sgml: Add explanation of cyg prefix for DLLs. * effectively.sgml: Use systemitem tag for names of Cygwin packages. * how-programming.texinfo: Add example to FAQ entry. * pathnames.sgml: Add discussion of /proc filesystem. * setup-net.sgml: Correct some typos and grammar. --- winsup/doc/cygwinenv.sgml | 72 +++++++++++++++++++++++++++-------------------- 1 file changed, 42 insertions(+), 30 deletions(-) (limited to 'winsup/doc/cygwinenv.sgml') diff --git a/winsup/doc/cygwinenv.sgml b/winsup/doc/cygwinenv.sgml index c78299e5e..439a22169 100644 --- a/winsup/doc/cygwinenv.sgml +++ b/winsup/doc/cygwinenv.sgml @@ -8,7 +8,7 @@ by prefixing with no . -(no)binmode - if set, non-disk +(no)binmode - if set, non-disk (e.g. pipe and COM ports) file opens default to binary mode (no CRLF translation) instead of text mode. Defaults to set (binary mode). By default, devices are opened in binary mode, so this option @@ -24,24 +24,24 @@ pipe to binary by default. always open in binary mode. -check_case:level - Controls the behaviour of +check_case:level - Controls the behaviour of Cygwin when a user tries to open or create a file using a case different from the case of the path as asved on the disk. level is one of relaxed, adjust and strict. -relaxed which is the default behaviour simply +relaxed which is the default behaviour simply ignores case. That's the default for native Windows applications as well. -adjust behaves mostly invisible. The POSIX input +adjust behaves mostly invisible. The POSIX input path is internally adjusted in case, so that the resulting DOS path uses the correct case throughout. You can see the result when changing the directory using a wrong case and calling /bin/pwd afterwards. -strict results in a error message if the case +strict results in a error message if the case isn't correct. Trying to open a file Foo while a file fOo exists results in a "no such file or directory" error. Trying to create a file BAR while a file @@ -52,7 +52,7 @@ case" error. -codepage:[ansi|oem] - Windows console +codepage:[ansi|oem] - Windows console applications can use different character sets (codepages) for drawing characters. The first setting, called "ansi", is the default. This character set contains various forms of latin characters used @@ -68,22 +68,33 @@ Cygwin, you can use this option to select an appropriate codepage. -(no)envcache - If set, environment variable +(no)envcache - 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. -(no)export - if set, the final values of these -settings are re-exported to the environment as $CYGWIN again. +(no)export - if set, the final values of these +settings are re-exported to the environment as CYGWIN again. +Defaults to off. -error_start:filepath - if set, runs filepath -when cygwin encounters a fatal error. This is useful for debugging. -filepath is usually set to the path to the gdb -program. -(no)glob[:ignorecase] - if set, command line arguments +error_start:filepath - if set, runs +filepath when cygwin encounters a fatal error. This is +useful for debugging. filepath is usually set to the path +to the gdb or dumper program. +There is no default set. + + +forkchunk:32768 - causes fork() +to copy memory some number of bytes at a time, in the above example +32768 bytes (32Kb) at a time. The default is to copy as many bytes as +possible, which is preferable in most cases but may slow some older systems +down. + + +(no)glob[:ignorecase] - 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. @@ -93,40 +104,41 @@ Default is set. If supplied, wildcard matching is case insensitive. The default is noignorecase -(no)ntea - if set, use the full NT Extended +(no)ntea - 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. Warning! This may create additional large files on non-NTFS partitions. -(no)ntsec - if set, use the NT security +(no)ntsec - 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 doesn't -support the NT file security. For more information, read the documentation -in ntsec.sgml. +support the NT file security. Defaults to set. For more information, read +the documentation in . -(no)smbntsec - if set, use `ntsec' on remote +(no)smbntsec - if set, use ntsec on remote drives as well (this is the default). If you encounter problems with NT shares -or Samba drives, setting this to `nosmbntsec' could help. In that case the -permission and owner/group information is faked as on FAT partitions. -A reason for a non working ntsec on remote drives could be insufficient -permissions of the users. Since the needed user rights are somewhat dangerous -(SeRestorePrivilege) it's not always an option to grant that rights to users. -However, this shouldn't be a problem in NT domain environments. +or Samba drives, setting this to nosmbntsec could help. In that +case the permission and owner/group information is faked as on FAT partitions. +A reason for a non working ntsec on remote drives could be +insufficient permissions of the users. Since the needed user rights are +somewhat dangerous (SeRestorePrivilege) it's not always an option to grant that +rights to users. However, this shouldn't be a problem in NT domain +environments. -(no)reset_com - if set, serial ports are reset +(no)reset_com - 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. -(no)strip_title - if set, strips the directory +(no)strip_title - if set, strips the directory part off the window title, if any. Default is not set. -(no)title - if set, the title bar +(no)title - 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 @@ -134,7 +146,7 @@ order not to strip, specify title or title nostrip_title. -(no)tty - if set, Cygwin enables extra support +(no)tty - 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 @@ -144,7 +156,7 @@ This option must be specified before starting a Cygwin shell and it cannot be changed in the shell. -(no)winsymlinks - if set, Cygwin creates +(no)winsymlinks - if set, Cygwin creates symlinks as Windows shortcuts with a special header and the R/O attribute set. If not set, Cygwin creates symlinks as plain files with a magic number, a path and the system attribute set. Defaults to set. -- cgit v1.2.3