Update from Joshua Daniel Franklin

This commit is contained in:
Christopher Faylor 2002-06-25 01:16:23 +00:00
parent 0fa276e1d5
commit 0914e17db5
1 changed files with 163 additions and 122 deletions

View File

@ -8,14 +8,15 @@ specifically for Cygwin.</para>
<sect2 id="cygcheck"><title>cygcheck</title> <sect2 id="cygcheck"><title>cygcheck</title>
<screen> <screen>
Usage: cygcheck [-s] [-v] [-r] [-h] [program ...] Usage: cygcheck [OPTIONS] [program ...]
-c check current package setup -c, --check-setup check packages installed via setup.exe
-h give help about the info -s, --sysinfo system information (not with -k)
-s system information -v, --verbose verbose output (indented) (for -s or programs)
-v verbose output (indented) (for -s or programs) -r, --registry registry search (requires -s)
-r registry search (requires -s) -k, --keycheck perform a keyboard check session (not with -s)
-V version info -h, --help give help about the info (not with -c)
You must at least give either -s or a program name -V, --version output version information and exit
You must at least give either -s or -k or a program name
</screen> </screen>
<para>The <command>cygcheck</command> program is a diagnostic utility <para>The <command>cygcheck</command> program is a diagnostic utility
@ -71,29 +72,32 @@ or if you know what everything is already, just leave this out.</para>
<sect2 id="cygpath"><title>cygpath</title> <sect2 id="cygpath"><title>cygpath</title>
<screen> <screen>
Usage: cygpath [-p|--path] (-w|--windows) ([-s|--short-name]|[-l|--long-name]) filename Usage: cygpath.exe (-u|-w|-t TYPE) [-c HANDLE] [-f FILE] [options] NAME
Usage: cygpath [-p|--path] (-u|--unix) filename cygpath.exe [-ADHPSW]
Usage: cygpath (-H|--homeroot)|(-S|--sysdir)|(-W|--windir) [-s|--short-name] Output type options (required):
Usage: cygpath [-A|--allusers] (-D|--desktop)|(-P|--smprograms) [-s|--short-name] -u|--unix print Unix form of NAME (default)
-w|--windows print Windows form of NAME
-t|--type print Windows form of NAME with TYPE one of
dos drive letter with backslashes (C:\WINNT)
mixed drive letter with regular slashes (C:/WINNT)
Path conversion options:
-a|--absolute output absolute path -a|--absolute output absolute path
-c|--close handle close handle (for use in captured process) -c|--close HANDLE close HANDLE (for use in captured process)
-f|--file file read file for input path information -f|--file FILE read FILE for input; use - to read from STDIN
-i|--ignore ignore missing argument -i|--ignore ignore missing argument
-l|--long-name print Windows long form of filename -l|--long-name print Windows long form of NAME (with -w only)
-p|--path filename argument is a path -p|--path NAME is a PATH list (i.e., '/bin:/usr/bin')
-s|--short-name print Windows short form of filename -s|--short-name print Windows short form of NAME (with -w only)
-u|--unix print Unix form of filename System information output:
-t|--type print Windows form of filename with specified
dos drive letter with backslashes (c:\winnt)
mixed drive letter with regular slashes (c:/winnt)
-v|--version output version information and exit
-w|--windows print Windows form of filename
-A|--allusers use `All Users' instead of current user for -D, -P -A|--allusers use `All Users' instead of current user for -D, -P
-H|--homeroot output `Profiles' directory (home root) and exit
-D|--desktop output `Desktop' directory and exit -D|--desktop output `Desktop' directory and exit
-H|--homeroot output `Profiles' directory (home root) and exit
-P|--smprograms output Start Menu `Programs' directory and exit -P|--smprograms output Start Menu `Programs' directory and exit
-S|--sysdir output system directory and exit -S|--sysdir output system directory and exit
-W|--windir output `Windows' directory and exit -W|--windir output `Windows' directory and exit
Other options:
-h|--help output usage information and exit
-v|--version output version information and exit
</screen> </screen>
<para>The <command>cygpath</command> program is a utility that <para>The <command>cygpath</command> program is a utility that
@ -159,9 +163,13 @@ The <literal>-ws</literal> options can be combined with the capital options.
<sect2 id="kill"><title>kill</title> <sect2 id="kill"><title>kill</title>
<screen> <screen>
Usage: kill [-f] [-sigN] [-s sigN] pid1 [pid2 ...] Usage: kill [-f] [-signal] [-s signal] pid1 [pid2 ...]
Usage: kill -l [signal] kill -l [signal]
Usage: Kill -h -f, --force force, using win32 interface if necessary
-l, --list print a list of signal names
-s, --signal send signal (use kill --list for a list)
-h, --help output usage information and exit
-v, --version output version information and exit
</screen> </screen>
<para>The <command>kill</command> program allows you to send arbitrary <para>The <command>kill</command> program allows you to send arbitrary
@ -241,20 +249,25 @@ SIGUSR2 31 user defined signal 2
<sect2 id="mkgroup"><title>mkgroup</title> <sect2 id="mkgroup"><title>mkgroup</title>
<screen> <screen>
usage: mkgroup [options] [domain] Usage: mkgroup [OPTION]... [domain]
This program prints a /etc/group file to stdout
Options: This program prints a /etc/group file to stdout
-l,--local print local group information
-d,--domain print global group information from the domain Options:
specified (or from the current domain if there is -l,--local print local group information
no domain specified) -d,--domain print global group information from the domain
-o,--id-offset offset change the default offset (10000) added to uids specified (or from the current domain if there is
in domain accounts. no domain specified)
-s,--no-sids don't print SIDs in pwd field -o,--id-offset offset change the default offset (10000) added to uids
(this affects ntsec) in domain accounts.
-u,--users print user list in gr_mem field -s,--no-sids don't print SIDs in pwd field
-?,--help print this message (this affects ntsec)
One of `-l' or `-d' must be given on NT/W2K. -u,--users print user list in gr_mem field
-h,--help print this message
-v,--version print version information and exit
One of `-l' or `-d' must be given on NT/W2K.
</screen> </screen>
<para>The <command>mkgroup</command> program can be used to help <para>The <command>mkgroup</command> program can be used to help
@ -284,25 +297,27 @@ local machine or the default (or given) domain.</para>
<sect2 id="mkpasswd"><title>mkpasswd</title> <sect2 id="mkpasswd"><title>mkpasswd</title>
<screen> <screen>
Usage: mkpasswd [options] [domain] Usage: mkpasswd [OPTION]... [domain]
Usage: mkpasswd [OPTION]... [domain]
This program prints a /etc/passwd file to stdout This program prints a /etc/passwd file to stdout
Options:
-l,--local print local user accounts Options:
-d,--domain print domain accounts (from current domain -l,--local print local user accounts
if no domain specified) -d,--domain print domain accounts (from current domain
-o,--id-offset offset change the default offset (10000) added to uids if no domain specified)
in domain accounts. -o,--id-offset offset change the default offset (10000) added to uids
-g,--local-groups print local group information too in domain accounts.
if no domain specified -g,--local-groups print local group information too
-m,--no-mount don't use mount points for home dir if no domain specified
-s,--no-sids don't print SIDs in GCOS field -m,--no-mount don't use mount points for home dir
(this affects ntsec) -s,--no-sids don't print SIDs in GCOS field
-p,--path-to-home path if user account has no home dir, use (this affects ntsec)
path instead of /home/ -p,--path-to-home path use specified path instead of user account home dir
-u,--username username only return information for the specified user -u,--username username only return information for the specified user
-?,--help displays this message -h,--help displays this message
One of `-l', `-d' or `-g' must be given on NT/W2K. -v,--version version information and exit
One of `-l', `-d' or `-g' must be given on NT/W2K.
</screen> </screen>
<para>The <command>mkpasswd</command> program can be used to help <para>The <command>mkpasswd</command> program can be used to help
@ -331,16 +346,24 @@ local machine or the default (or given) domain.</para>
<sect2 id="passwd"><title>passwd</title> <sect2 id="passwd"><title>passwd</title>
<screen> <screen>
Usage passwd [name] Usage: passwd (-l|-u|-S) [USER]
passwd [-x max] [-n min] [-i inact] [-L len] passwd [-i NUM] [-n MINDAYS] [-x MAXDAYS] [-L LEN]
passwd {-l|-u|-S} name
-x max set max age of passwords User operations:
-n min set min age of passwords -l, --lock lock USER's account
-i inact disables account after inact days of expiry -u, --unlock unlock USER's account
-L len set min password length -S, --status display password status for USER (locked, expired, etc.)
-l lock an account
-u unlock an account System operations:
-S show account information -i, --inactive set NUM of days before inactive accounts are disabled
(inactive accounts are those with expired passwords)
-n, --minage set system minimum password age to MINDAYS
-x, --maxage set system maximum password age to MAXDAYS
-L, --length set system minimum password length to LEN
Other options:
-h, --help output usage information and exit
-v, --version output version information and exit
</screen> </screen>
<para> <command>passwd</command> changes passwords for user accounts. <para> <command>passwd</command> changes passwords for user accounts.
@ -400,29 +423,25 @@ some systems.</para>
<sect2 id="mount"><title>mount</title> <sect2 id="mount"><title>mount</title>
<screen> <screen>
Usage mount Usage: mount [OPTION] [<win32path> <posixpath>]
mount [options] &lt;win32path&gt; &lt;posixpath&gt;
-b, --binary text files are equivalent to binary files -b, --binary text files are equivalent to binary files
(newline = \n) (newline = \n)
-c, --change-cygdrive-prefix change the cygdrive path prefix to &lt;posixpath&gt; -c, --change-cygdrive-prefix change the cygdrive path prefix to <posixpath>
-f, --force force mount, don't warn about missing mount -f, --force force mount, don't warn about missing mount
point directories point directories
-i, --import-old-mounts copy old registry mount table mounts into the current -h, --help output usage information and exit
mount areas
-p, --show-cygdrive-prefix show user and/or system cygdrive path prefix
-s, --system (default) add mount point to system-wide registry location
-t, --text (default) text files get \r\n line endings
-u, --user add mount point to user registry location
-x, --executable treat all files under mount point as executables
-X, --cygwin-executable treat all files under mount point as cygwin
executables. Use to speed up file access.
-E, --no-executable don't open files to see if they contain executable
magic. Use to speed up file access.
-m, --mount-commands write mount commands to replace user and -m, --mount-commands write mount commands to replace user and
system mount points and cygdrive prefixes system mount points and cygdrive prefixes
-p, --show-cygdrive-prefix show user and/or system cygdrive path prefix
When invoked without any arguments, mount displays the current mount table. -s, --system (default) add system-wide mount point
-t, --text (default) text files get \r\n line endings
-u, --user add user-only mount point
-v, --version output version information and exit
-x, --executable treat all files under mount point as executables
-E, --no-executable treat all files under mount point as
non-executables
-X, --cygwin-executable treat all files under mount point as cygwin
executables
</screen> </screen>
<para>The <command>mount</command> program is used to map your drives <para>The <command>mount</command> program is used to map your drives
@ -593,13 +612,17 @@ find <filename>mtpt</filename>.
<sect2 id="ps"><title>ps</title> <sect2 id="ps"><title>ps</title>
<screen> <screen>
Usage ps [-aefl] [-u uid] Usage: ps [-aefls] [-u UID]
-a, -e show processes of all users -a, --all show processes of all users
-f show process uids, ppids -e, --everyone show processes of all users
-l show process uids, ppids, pgids, winpids -f, --full show process uids, ppids
-s short process listing -h, --help output usage information and exit
-u uid show processes owned by uid -l, --long show process uids, ppids, pgids, winpids
-W show all windows processes, not just cygwin processes -s, --summary show process summary
-u, --user list processes owned by UID
-v, --version output version information and exit
-W, --windows show windows as well as cygwin processes
With no options, ps outputs the long format by default
</screen> </screen>
<para>The <command>ps</command> program gives the status of all the <para>The <command>ps</command> program gives the status of all the
@ -615,13 +638,15 @@ program.</para>
<sect2 id="umount"><title>umount</title> <sect2 id="umount"><title>umount</title>
<screen> <screen>
Usage umount [options] &lt;posixpath&gt; Usage: umount.exe [OPTION] [<posixpath>]
-A, --remove-all-mounts remove all mounts -A, --remove-all-mounts remove all mounts
-c, --remove-cygdrive-prefix remove cygdrive prefix -c, --remove-cygdrive-prefix remove cygdrive prefix
-h, --help output usage information and exit
-s, --system remove system mount (default) -s, --system remove system mount (default)
-S, --remove-system-mounts remove all system mounts -S, --remove-system-mounts remove all system mounts
-u, --user remove user mount -u, --user remove user mount
-U, --remove-user-mounts remove all user mounts -U, --remove-user-mounts remove all user mounts
-v, --version output version information and exit
</screen> </screen>
<para>The <command>umount</command> program removes mounts from the <para>The <command>umount</command> program removes mounts from the
@ -644,8 +669,8 @@ table.</para>
<sect2 id="strace"><title>strace</title> <sect2 id="strace"><title>strace</title>
<screen> <screen>
Usage: strace [OPTIONS] <command-line> Usage: strace.exe [OPTIONS] <command-line>
Usage: strace [OPTIONS] -p <pid> Usage: strace.exe [OPTIONS] -p <pid>
-b, --buffer-size=SIZE set size of output file buffer -b, --buffer-size=SIZE set size of output file buffer
-d, --no-delta don't display the delta-t microsecond timestamp -d, --no-delta don't display the delta-t microsecond timestamp
-f, --trace-children trace child processes (toggle - default true) -f, --trace-children trace child processes (toggle - default true)
@ -684,12 +709,13 @@ Usage: strace [OPTIONS] -p <pid>
sigp 0x00800 (_STRACE_SIGP) Trace signal and process handling. sigp 0x00800 (_STRACE_SIGP) Trace signal and process handling.
minimal 0x01000 (_STRACE_MINIMAL) Very minimal strace output. minimal 0x01000 (_STRACE_MINIMAL) Very minimal strace output.
exitdump 0x04000 (_STRACE_EXITDUMP) Dump strace cache on exit. exitdump 0x04000 (_STRACE_EXITDUMP) Dump strace cache on exit.
system 0x08000 (_STRACE_SYSTEM) Cache strace messages. system 0x08000 (_STRACE_SYSTEM) Serious error; goes to console and log.
nomutex 0x10000 (_STRACE_NOMUTEX) Don't use mutex for synchronization. nomutex 0x10000 (_STRACE_NOMUTEX) Don't use mutex for synchronization.
malloc 0x20000 (_STRACE_MALLOC) Trace malloc calls. malloc 0x20000 (_STRACE_MALLOC) Trace malloc calls.
thread 0x40000 (_STRACE_THREAD) Thread-locking calls. thread 0x40000 (_STRACE_THREAD) Thread-locking calls.
</screen> </screen>
<para>The <command>strace</command> program executes a program, and <para>The <command>strace</command> program executes a program, and
optionally the children of the program, reporting any Cygwin DLL output optionally the children of the program, reporting any Cygwin DLL output
from the program(s) to file. This program is mainly useful for debugging from the program(s) to file. This program is mainly useful for debugging
@ -699,30 +725,45 @@ the Cygwin DLL itself.</para>
<sect2 id="regtool"><title>regtool</title> <sect2 id="regtool"><title>regtool</title>
<screen> <screen>
Regtool Copyright (c) 2000 Red Hat Inc Usage: regtool.exe [OPTION] (add | check | get | list | remove | unset) KEY
regtool -h - print this message
regtool [-v|-p|-k|-l] list [key] - list subkeys and values Actions:
-p=postfix, like ls -p, appends / postfix to key names add KEY\SUBKEY add new SUBKEY
-k=keys, lists only keys check KEY exit 0 if KEY exists, 1 if not
-l=values, lists only values get KEY\VALUE prints VALUE to stdout
regtool [-v] add [key\subkey] - add new subkey list KEY list SUBKEYs and VALUEs
regtool [-v] remove [key] - remove key remove KEY remove KEY
regtool [-v|-q] check [key] - exit 0 if key exists, 1 if not set KEY\VALUE [data ...] set VALUE
regtool [-i|-s|-e|-m] set [key\value] [data ...] - set value unset KEY\VALUE removes VALUE from KEY
-i=integer -s=string -e=expand-string -m=multi-string
regtool [-v] unset [key\value] - removes value from key Options for 'list' Action:
regtool [-q] get [key\value] - prints value to stdout -k, --keys print only KEYs
-q=quiet, no error msg, just return nonzero exit if key/value missing -l, --list print only VALUEs
key is in the format [host]\prefix\KEY\KEY\VALUE, where host is optional -p, --postfix like ls -p, appends '\' postfix to KEY names
remote host in either \\hostname or hostname: format and prefix is any of:
root HKCR HKEY_CLASSES_ROOT (local only) Options for 'set' Action:
config HKCC HKEY_CURRENT_CONFIG (local only) -e, --expand-string set type to REG_EXPAND_SZ
user HKCU HKEY_CURRENT_USER (local only) -i, --integer set type to REG_DWORD
machine HKLM HKEY_LOCAL_MACHINE -m, --multi-string set type to REG_MULTI_SZ
users HKU HKEY_USERS -s, --string set type to REG_SZ
You can use forward slash ('/') as a separator instead of backslash, in
that case backslash is treated as escape character. Other Options:
example: \user\software\Microsoft\Clock\iFormat -h, --help output usage information and exit
-q, --quiet no error output, just nonzero return if KEY/VALUE missing
-v, --verbose verbose output, including VALUE contents when applicable
-V, --version output version information and exit
KEY is in the format [host]\prefix\KEY\KEY\VALUE, where host is optional
remote host in either \\hostname or hostname: format and prefix is any of:
root HKCR HKEY_CLASSES_ROOT (local only)
config HKCC HKEY_CURRENT_CONFIG (local only)
user HKCU HKEY_CURRENT_USER (local only)
machine HKLM HKEY_LOCAL_MACHINE
users HKU HKEY_USERS
You can use forward slash ('/') as a separator instead of backslash, in
that case backslash is treated as escape character
Example: regtool.exe get '\user\software\Microsoft\Clock\iFormat'
</screen> </screen>
<para>The <command>regtool</command> program allows shell scripts <para>The <command>regtool</command> program allows shell scripts