Updated: csih-0.1.9-2

Charles Wilson cygwin@cwilson.fastmail.fm
Sun Apr 5 09:30:00 GMT 2009

csih (cygwin-service-installation-helper) provides a library
of shell functions that can be used by other cygwin packages
that provide servers and daemons. It can assist in various
service installation tasks, such as:

* identifying the underlying Windows OS
* detecting whether a "privileged user" exists and what its
  name is (that is, a user account with enhanced privileges
  necessary for some services)
* creating a privileged user if one doesn't already exist
  (assuming the caller has permissions to create new users)
* creating "normal" users
* obtaining the (localized) name of well known account
  (Guest, Administrator)

It is currently used by inetutils(iu-config, syslogd-config),
openssh (ssh-host-config, ssh-user-config), sspi(sspi-config),
sysvinit(init-config), and various others.  csih should not be
used directly; instead, config scripts like the ones mentioned
above should 'source' the csih script, and then use the
functions provided.

This is a bugfix and feature enhancement. This release is for
both cygwin-1.5 and for cygwin-1.7.  

[[ cygwin binary utilities compiled using gcc-3.4.4-999 ]]
[[ native binary utilities compiled using gcc-3.4.4-999 and gcc-mingw-core-20050522-1 ]]

CHANGES (since 0.18-1)
This release hopefully addresses several long-standing issues with csih:

* correct csih_check_access behavior
* suppress errors in _csih_setup
* No longer restrict contents of CYGWIN variable (Corinna Vinschen)
* New -f option for csih_select_privileged_username to accomodate
  unattended installs (Julio Costa). This requires foo-config to
  use the -f option when appropriate (typically, when one of
  foo-config's own commandline options was '-y' or '-n').
* New '-u default_user' for csih_select_privileged_username for
  another way to accomodate unattended installs. Allows caller
  to specify explicitly the account to use for the service, thus
  bypassing the 'Do you want to use another name?' prompt. Requires
  foo-config to pass that option when calling
  csih_select_privileged_username, perhaps as the result of a
  new option of its own:
     --service-account ARG
* Now warn user when an account is specified in /etc/passwd,
  but is not found in the SAM. This is ok if the account is
  a domain account, but the user should be aware of the issue.
  Herb Maeder
* Updated winProductName to reflect Windows 7, Server 2008 R2
* csih has new functions related to detecting Windows 7 and
  Server 2008 R2.
* correct setup.hint dependencies (Karl Herrick)

NOTE for maintainers: if a script that uses csih is part of
a postinstall sequence automatically invoked by setup, then
it may fail in that context on cygwin-1.5 (it will succeed
if invoked manually). The reason is that the cygwin-1.5 setup.exe
runs the postinstall scripts in a limited-functionality
environment.  One of the missing pieces of functionality is
accurate unix ownership and permissions; therefore, the rigorous
checks and manipulation performed by csih will fail in that
context.  There is no fix, and it is likely that there will
not be; these issues do NOT arise when using the cygwin-1.7
setup.exe.  For legacy systems, the workaround is simply to
have users invoked the postinstall script by hand; or do not
use csih as part of a postinstall script.

Charles Wilson
volunteer csih maintainer for cygwin


To update your installation, click on the "Install Cygwin now" link
on the http://cygwin.com/ web page.  This downloads setup.exe to
your system.  Then, run setup and answer all of the questions.


If you want to unsubscribe from the cygwin-announce mailing list, look
at the "List-Unsubscribe: " tag in the email header of this message.
Send email to the address specified there.  It will be in the format:


If you need more information on unsubscribing, start reading here:


Please read *all* of the information on unsubscribing that is
available starting at this URL.

More information about the Cygwin-announce mailing list