Message-Id: <announce.4803A8B6.4080308@cwilson.fastmail.fm>
Date: Mon, 14 Apr 2008 14:55:50 -0400
From: Charles Wilson <cygwin AT cwilson DOT fastmail DOT fm>
User-Agent: Mozilla/5.0 (Windows; U; Windows NT 6.0; en-US; rv:1.8.1.12) Gecko/20080213 Thunderbird/2.0.0.12 Mnenhy/0.7.5.666
MIME-Version: 1.0
To: cygwin AT cygwin DOT com
Subject: [ANNOUNCEMENT] Updated: csih-0.1.4-1
Content-Type: text/plain; charset=ISO-8859-1; format=flowed
Content-Transfer-Encoding: 7bit
Reply-To: cygwin AT cygwin DOT com
Mailing-List: contact cygwin-help AT cygwin DOT com; run by ezmlm
Sender: cygwin-owner AT cygwin DOT com
Mail-Followup-To: cygwin AT cygwin DOT com

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. These may include, among others:
         SeAssignPrimaryTokenPrivilege
         SeCreateTokenPrivilege
         SeTcbPrivilege
         SeDenyInteractiveLogonRight
         SeDenyNetworkLogonRight
         SeDenyRemoteInteractiveLogonRight
         SeIncreaseQuotaPrivilege
         SeServiceLogonRight
* creating a privileged user if one doesn't already exist (assuming the
   caller has permissions to create new users, of course)
* creating "normal" users
* obtaining the (localized) name of well known accounts (Guest,
   Administrator)

It is currently used by inetutils(iu-config, syslogd-config), 
sspi(sspi-config), sysvinit(init-config). 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.


Changes (since 0.1.3-1)
======================
* Add --help, --license, --version options to winProductName.
* Caller can now specify the password when calling
   csih_create_privileged_user
* csih_should_run_as now accepts optional [service_name] argument.
   If specified, then checks to see if [service_name] is already
   installed. If so, the user under which the service is installed
   is returned (if that user has the necessary privileges).
   Should call csih_select_privileged_username first, unless you are
   SURE that [service_name] has already been installed.
* Add [-q] and [service_name] options to csih_select_privileged_username
   See NEWS file
* Associated foo-config scripts that do not themselves install
   a service (such as ssh-user-config) can now query the 'expected'
   account that the associated service will run as (or is already
   installed under). Recommended pattern:
             if csih_is_nt
             then
               if ! cygrunsrv -Q <service> >/dev/null 2>&1
               then
                 csih_select_privileged_username -q <service>
               fi
               service_user=$(csih_service_should_run_as <service>)
               ... continue ...
             fi
* new functions for comparing x.y.z version numbers:
             csih_version_ge A B  --> A >= B
             csih_version_le A B  --> A <= B
             csih_version_gt A B  --> A >  B
             csih_version_lt A B  --> A <  B
             csih_version_ne A B  --> A == B
* Clarified licensing terms and attributions for csih.sh script
   Explicitly MIT/X.
* Removed any direct heritage from cygport due to licensing concerns.

-- 
Chuck

====================================================================

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.


*** CYGWIN-ANNOUNCE UNSUBSCRIBE INFO ***

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:


cygwin-announce-unsubscribe-you=yourdomain DOT com AT cygwin DOT com

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

http://sources.redhat.com/lists.html#unsubscribe-simple

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

--
Unsubscribe info:      http://cygwin.com/ml/#unsubscribe-simple
Problem reports:       http://cygwin.com/problems.html
Documentation:         http://cygwin.com/docs.html
FAQ:                   http://cygwin.com/faq/