--- utils.sgml-orig 2002-07-08 21:27:06.000000000 -0500 +++ utils.sgml 2002-07-08 21:26:05.000000000 -0500 @@ -268,12 +268,12 @@ The format for ACL output is as follows: Usage: kill [-f] [-signal] [-s signal] pid1 [pid2 ...] -kill -l [signal] --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 + kill -l [signal] + -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 The kill program allows you to send arbitrary @@ -388,9 +388,11 @@ One of `-l' or `-d' must be given on NT/ The mkgroup program can be used to help configure your Windows system to be more UNIX-like by creating an initial /etc/group substitute (some commands need this -file) from your system information. It only works on NT. -To initially set up your machine, -you'd do something like this: +file) from your system information. It only works on the NT series +(Windows NT, 2000, and XP). mkgroup does not work on +the Win9x series (Windows 95, 98, and Me) because they lack the security model +to support it. To initially set up your machine, you'd do something like +this: Setting up the groups file @@ -405,7 +407,16 @@ for it to have the new information.The -d and -l options allow you to specify where the information comes from, either the -local machine or the default (or given) domain. +local machine or the default (or given) domain. The -o +option allows for special cases (such as multiple domains) where the GIDs +might match otherwise. The -s +option omits the NT Security Identifier (SID). For more information on +SIDs, see in the Cygwin User's Guide. The +-u option causes mkgroup to +enumerate the users for each group, placing the group members in the +gr_mem (last) field. Note that this can greatly increase +the time for mkgroup to run in a large domain. + @@ -438,8 +449,11 @@ One of `-l', `-d' or `-g' must be given The mkpasswd program can be used to help configure your Windows system to be more UNIX-like by creating an initial /etc/passwd substitute (some commands -need this file) from your system information. It only works on NT. -To initially set up your machine, you'd do something like this: +need this file) from your system information. It only works on the NT series +(Windows NT, 2000, and XP). mkpasswd does not work on +the Win9x series (Windows 95, 98, and Me) because they lack the security model +to support it. To initially set up your machine, you'd do something like +this: Setting up the passwd file @@ -454,84 +468,28 @@ for it to have the new information.The -d and -l options allow you to specify where the information comes from, either the -local machine or the default (or given) domain. - - - -passwd +local machine or the default (or given) domain. The -o +option allows for special cases (such as multiple domains) where the UIDs +might match otherwise. The -g option creates a local +user that corresponds to each local group. This is because NT assigns groups +file ownership. The -m option bypasses the current +mount table so that, for example, two users who have a Windows home +directory of H: could mount them differently. The -s +option omits the NT Security Identifier (SID). For more information on +SIDs, see in the Cygwin User's Guide. The +-p option causes mkpasswd to +use a prefix other than /home/. For example, this command: +Using an alternate home root -Usage: passwd (-l|-u|-S) [USER] - passwd [-i NUM] [-n MINDAYS] [-x MAXDAYS] [-L LEN] - -User operations: - -l, --lock lock USER's account - -u, --unlock unlock USER's account - -S, --status display password status for USER (locked, expired, etc.) - -System operations: - -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 +$ mkpasswd -l -p "$(cygpath -H)" > /etc/passwd + - passwd changes passwords for user accounts. -A normal user may only change the password for their own account, -the administrators may change the password for any account. -passwd also changes account information, such as -password expiry dates and intervals. - -Password changes: The user is first prompted for their old -password, if one is present. This password is then encrypted and -compared against the stored password. The user has only one chance to -enter the correct password. The administrators are permitted to -bypass this step so that forgotten passwords may be changed. - -The user is then prompted for a replacement password. -passwd will prompt again and compare the second entry -against the first. Both entries are require to match in order for the -password to be changed. - -After the password has been entered, password aging information -is checked to see if the user is permitted to change their password -at this time. If not, passwd refuses to change the -password and exits. - -Password expiry and length: The password aging information may be -changed by the administrators with the -x, --n and -i options. The --x option is used to set the maximum number of days -a password remains valid. After max days, the -password is required to be changed. The -n option is -used to set the minimum number of days before a password may be changed. -The user will not be permitted to change the password until -min days have elapsed. The -i -option is used to disable an account after the password has been expired -for a number of days. After a user account has had an expired password -for inact days, the user may no longer sign on to -the account. Allowed values for the above options are 0 to 999. The --L option sets the minimum length of allowed passwords -for users, which doesn't belong to the administrators group, to -len characters. Allowed values for the minimum -password length are 0 to 14. In any of the above cases, a value of 0 -means `no restrictions'. - -Account maintenance: User accounts may be locked and unlocked with the --l and -u flags. The --l option disables an account. The -u -option re-enables an account. - -The account status may be given with the -S -option. The status information is self explanatory. - -Limitations: Users may not be able to change their password on -some systems. +would put local users' home directories in the Windows 'Profiles' directory. +The -u option allows mkpasswd to +search for a specific username, greatly reducing the amount of time it +takes in a large domain. @@ -574,15 +532,16 @@ will display the current mount table for Displaying the current set of mount points -c:\cygnus\> mount -Device Directory Type Flags -D: /d user textmode -C: / system textmode +c:\cygwin\> mount +c:\cygwin\bin on /usr/bin type system (binmode) +c:\cygwin\lib on /usr/lib type system (binmode) +c:\cygwin on / type system (binmode) +c: on /c type user (binmode,noumount) +d: on /d type user (binmode,noumount) -In this example, the C -drive is the POSIX root and D drive is mapped to +In this example, c:\cygwin is the POSIX root and D drive is mapped to /d. Note that in this case, the root mount is a system-wide mount point that is visible to all users running Cygwin programs, whereas the /d mount is only visible @@ -591,31 +550,23 @@ to the current user. The mount utility is also the mechanism for adding new mounts to the mount table. The following example demonstrates how to mount the directory -C:\cygnus\cygwin-b20\H-i586-cygwin32\bin -to /bin and the network directory \\pollux\home\joe\data to /data. -/bin is assumed to already exist. + Adding mount points -c:\cygnus\> ls /bin /data +c:\cygwin\> ls /data ls: /data: No such file or directory -c:\cygnus\> mount C:\cygnus\cygwin-b20\H-i586-cygwin32\bin /bin -c:\cygnus\> mount \\pollux\home\joe\data /data -Warning: /data does not exist! -c:\cygnus\> mount -Device Directory Type Flags -\\pollux\home\joe\data /data user textmode -C:\cygnus\cygwin-b20\H-i586-cygwin32\bin /bin user textmode -D: /d user textmode -\\.\tape1: /dev/st1 user textmode -\\.\tape0: /dev/st0 user textmode -\\.\b: /dev/fd1 user textmode -\\.\a: /dev/fd0 user textmode -C: / system textmode -c:\cygnus\> ls /bin/sh -/bin/sh +c:\cygwin\> mount \\pollux\home\joe\data /data +mount: warning - /data does not exist! +c:\cygwin\> mount +\\pollux\home\joe\data on /data type sytem (binmode) +c:\cygwin\bin on /usr/bin type system (binmode) +c:\cygwin\lib on /usr/lib type system (binmode) +c:\cygwin on / type system (binmode) +c: on /c type user (binmode,noumount) +d: on /d type user (binmode,noumount) @@ -624,7 +575,7 @@ command shell in the previous example. bash, it is legal and convenient to use the forward "/" in Win32 pathnames since the "\" is the shell's escape character. -The "-s" flag to mount is used to add a mount +The -s flag to mount is used to add a mount in the system-wide mount table used by all Cygwin users on the system, instead of the user-specific one. System-wide mounts are displayed by mount as being of the "system" type, as is the @@ -634,25 +585,38 @@ permitted to modify the system-wide moun Note that a given POSIX path may only exist once in the user table and once in the global, system-wide table. Attempts to replace -the mount will fail with a busy error. The "-f" (force) flag causes +the mount will fail with a busy error. The -f (force) flag causes the old mount to be silently replaced with the new one. It will also silence warnings about the non-existence of directories at the Win32 path location. -The "-b" flag is used to instruct Cygwin to treat binary and +The -b flag is used to instruct Cygwin to treat binary and text files in the same manner by default. Binary mode mounts are marked as "binmode" in the Flags column of mount output. By default, mounts are in text mode ("textmode" in the Flags column). -The "-x" flag is used to instruct Cygwin that the mounted file -is "executable". If the "-x" flag is used with a directory then -all files in the directory are executable. Files ending in certain -extensions (.exe, .com, .bat, .cmd) are assumed to be executable -by default. Files whose first two characters begin with '#!' are -also considered to be executable. This option allows other files -to be marked as executable and avoids the overhead of opening each -file to check for a '#!'. +Normally, files ending in certain extensions (.exe, .com, .bat, .cmd) +are assumed to be executable. Files whose first two characters begin with +'#!' are also considered to be executable. +The -x flag is used to instruct Cygwin that the +mounted file is "executable". If the -x flag is used +with a directory then all files in the directory are executable. +This option allows other files to be marked as executable and avoids the +overhead of opening each file to check for a '#!'. The -X +option is very similar to -x, but also prevents Cygwin +from setting up commands and environment variables for a normal Windows +program, adding another small performance gain. The opposite of these +flags is the -E flag, which means that no files should be +marked as executable. + + +The -m option causes the mount utility +to output a series of commands that could recreate both user and system mount +points. You can save this output as a backup when experimenting with the +mount table. It also makes moving your settings to a different machine +much easier. + @@ -662,29 +626,27 @@ file to check for a '#!'. from a particular Win32 path to a POSIX one, Cygwin will, instead, convert to a POSIX path using a default mount point: /cygdrive. For example, if Cygwin accesses -Z:\foo and the Z drive is not currently in the -mount table, then Z:\ will be accessible as -/cygdrive/Z. The default prefix of -/cygdrive may be changed via the - command. - -The mount utility can be used to change this -default automount prefix through the use of the -"--change-cygdrive-prefix" flag. In the following example, we will +z:\foo and the z drive is not currently in the +mount table, then z:\ will be accessible as +/cygdrive/z. The mount utility +can be used to change this default automount prefix through the use of the +"--change-cygdrive-prefix" option. In the following example, we will set the automount prefix to /: Changing the default prefix -c:\cygnus\> mount --change-cygdrive-prefix / +c:\cygwin\> mount --change-cygdrive-prefix / Note that you if you set a new prefix in this manner, you can -specify the "-s" flag to make this the system-wide default prefix. By -default, the cygdrive-prefix applies only to the current user. In the -same way, you can specify the "-b" flag such that all new automounted -filesystems default to binary mode file accesses. +specify the -s flag to make this the system-wide default +prefix. By default, the cygdrive-prefix applies only to the current user. +You can always see the user and system cygdrive prefixes with the +-p option. Using the -b +flag with --change-cygdrive-prefix makes all new +automounted filesystems default to binary mode file accesses. @@ -724,6 +686,83 @@ find mtpt. +passwd + + +Usage: passwd (-l|-u|-S) [USER] + passwd [-i NUM] [-n MINDAYS] [-x MAXDAYS] [-L LEN] + +User operations: + -l, --lock lock USER's account + -u, --unlock unlock USER's account + -S, --status display password status for USER (locked, expired, etc.) + +System operations: + -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 + + + passwd changes passwords for user accounts. +A normal user may only change the password for their own account, +the administrators may change the password for any account. +passwd also changes account information, such as +password expiry dates and intervals. + +Password changes: The user is first prompted for their old +password, if one is present. This password is then encrypted and +compared against the stored password. The user has only one chance to +enter the correct password. The administrators are permitted to +bypass this step so that forgotten passwords may be changed. + +The user is then prompted for a replacement password. +passwd will prompt again and compare the second entry +against the first. Both entries are require to match in order for the +password to be changed. + +After the password has been entered, password aging information +is checked to see if the user is permitted to change their password +at this time. If not, passwd refuses to change the +password and exits. + +Password expiry and length: The password aging information may be +changed by the administrators with the -x, +-n and -i options. The +-x option is used to set the maximum number of days +a password remains valid. After max days, the +password is required to be changed. The -n option is +used to set the minimum number of days before a password may be changed. +The user will not be permitted to change the password until +min days have elapsed. The -i +option is used to disable an account after the password has been expired +for a number of days. After a user account has had an expired password +for inact days, the user may no longer sign on to +the account. Allowed values for the above options are 0 to 999. The +-L option sets the minimum length of allowed passwords +for users, which doesn't belong to the administrators group, to +len characters. Allowed values for the minimum +password length are 0 to 14. In any of the above cases, a value of 0 +means `no restrictions'. + +Account maintenance: User accounts may be locked and unlocked with the +-l and -u flags. The +-l option disables an account. The -u +option re-enables an account. + +The account status may be given with the -S +option. The status information is self explanatory. + +Limitations: Users may not be able to change their password on +some systems. + + + ps