head	1.12;
access;
symbols
	pkgsrc-2005Q3:1.12.0.10
	pkgsrc-2005Q3-base:1.12
	pkgsrc-2005Q2:1.12.0.8
	pkgsrc-2005Q2-base:1.12
	pkgsrc-2005Q1:1.12.0.6
	pkgsrc-2005Q1-base:1.12
	pkgsrc-2004Q4:1.12.0.4
	pkgsrc-2004Q4-base:1.12
	pkgsrc-2004Q3:1.12.0.2
	pkgsrc-2004Q3-base:1.12
	pkgsrc-2004Q2:1.11.0.2
	pkgsrc-2004Q2-base:1.11
	pkgsrc-2004Q1:1.5.0.2
	pkgsrc-2004Q1-base:1.5
	bootstrap-pkgsrc-20040311:1.1.1.1
	TNF:1.1.1;
locks; strict;
comment	@# @;


1.12
date	2004.08.23.20.43.13;	author tv;	state Exp;
branches;
next	1.11;

1.11
date	2004.05.02.03.38.21;	author tv;	state Exp;
branches;
next	1.10;

1.10
date	2004.04.30.20.44.44;	author tv;	state Exp;
branches;
next	1.9;

1.9
date	2004.04.27.14.03.24;	author tv;	state Exp;
branches;
next	1.8;

1.8
date	2004.04.27.13.58.43;	author tv;	state Exp;
branches;
next	1.7;

1.7
date	2004.04.21.20.34.16;	author tv;	state Exp;
branches;
next	1.6;

1.6
date	2004.03.29.02.22.32;	author tv;	state Exp;
branches;
next	1.5;

1.5
date	2004.03.27.14.46.59;	author grant;	state Exp;
branches;
next	1.4;

1.4
date	2004.03.12.00.16.42;	author tv;	state Exp;
branches;
next	1.3;

1.3
date	2004.03.11.20.47.56;	author tv;	state Exp;
branches;
next	1.2;

1.2
date	2004.03.11.17.09.37;	author tv;	state Exp;
branches;
next	1.1;

1.1
date	2004.03.11.13.03.59;	author grant;	state Exp;
branches
	1.1.1.1;
next	;

1.1.1.1
date	2004.03.11.13.03.59;	author grant;	state Exp;
branches;
next	;


desc
@@


1.12
log
@Emphasize that UNIX Perl must not be installed, and that case-sensitive
filesystems are a must.

Add instructions on how to change these things after SFU is already
installed (so a reinstall is not necessary).
@
text
@$NetBSD: README.Interix,v 1.11 2004/05/02 03:38:21 tv Exp $

Please read the general README file as well.

Interix is a POSIX compatible subsystem for the Windows NT kernel,
providing a Unix-like environment with a tighter kernel integration than
available with Cygwin.  It is part of the Windows Services for Unix
package, available for free for any licensed copy of Windows 2000, XP,
or 2003.  SFU can be downloaded from:

    http://www.microsoft.com/windows/sfu/

Services for Unix 3.5, current as of this writing, has been tested.  3.0
or 3.1 may work, but are not officially supported.  (The main difference
in 3.0/3.1 is lack of pthreads.)

A prebuilt bootstrap kit and prebuilt binary packages for Interix 3.5 are
available from the pkgsrc information page:

    http://www.netbsd.org/Documentation/software/packages.html

=====

At an absolute minimum, the following packages must be installed from
the Windows Services for Unix 3.5 distribution in order to use pkgsrc:

    Utilities -> Base Utilities
    Interix GNU Components -> (all)
    Remote Connectivity
    Interix SDK

When using pkgsrc on Interix, DO NOT install the Utilities subcomponent 
"UNIX Perl".  That is Perl 5.6 without shared module support, installed to 
/usr/local, and will only cause confusion. Instead, install Perl 5.8 from 
pkgsrc (or from a binary package available at the URL above).

The Remote Connectivity subcomponent "Windows Remote Shell Service" does
not need to be installed, but Remote Connectivity itself should be
installed in order to have a working inetd.

Finally, during installation you may be asked whether to enable setuid 
behavior for Interix programs, and whether to make pathnames default to 
case-sensitive.  Setuid should be enabled, and case-sensitivity MUST be 
enabled.  (Without case-sensitivity, a large number of packages including 
perl will not build.)

=====

If SFU is already installed and you wish to alter these settings to work 
with pkgsrc:

* To uninstall UNIX Perl, use Add/Remove Programs, select Microsoft 
  Windows Services for UNIX, then click Change.  In the installer, choose 
  Add or Remove, then uncheck Utilities->UNIX Perl.

* To enable case-sensitivity for the filesystem, run REGEDIT.EXE, and 
  change the following registry key:

  HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Control\Session Manager\kernel

  Set the DWORD value "obcaseinsensitive" to 0; then reboot.

* To enable setuid binaries (optional), run REGEDIT.EXE, and change the 
  following registry key:

  HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Services for UNIX

  Set the DWORD value "EnableSetuidBinaries" to 1; then reboot.

=====

IMPORTANT NOTES

* The package imanager (either the pkgsrc "su" user, or the user
  running "pkg_add") must be a member of the local Administrators
  group.  Such a user must also be used to run the bootstrap.  This is
  slightly relaxed from the normal pkgsrc requirement of "root".

* The package manager should use a umask of 002.  "make install" will
  automatically complain if this is not the case.  This ensures that
  directories written in /var/db/pkg are Administrators-group writeable. 

* The popular Interix binary packages from http://www.interopsystems.com/
  use an older version of pkgsrc's pkg_* tools.  Ideally, these should
  NOT be used in conjunction with pkgsrc.  If you choose to use them at
  the same time as the pkgsrc packages, ensure that you use the proper
  pkg_* tools for each type of binary package.

=====

KNOWN ISSUES

* It is not necessary, in general, to have a "root" user on the Windows
  system; any member of the local Administrators group will suffice. 
  However, some packages currently assume that the user named "root" is
  the privileged user (these will eventually be fixed).  To accommodate
  these, you may create such a user; make sure it is in the local group
  Administrators.

* "pkg_add" creates directories of mode 0755, not 0775, in $PKG_DBDIR.
  This will be fixed.

  For the time being, install packages as Administrator, or use a
  "chmod -R g+w $PKG_DBDIR" after installing a package to work around it.

=====
@


1.11
log
@No, setgid works, but apparently needs some particular NTFS permissions
(researching for a future rev of this doc).
@
text
@d1 1
a1 1
$NetBSD: README.Interix,v 1.10 2004/04/30 20:44:44 tv Exp $
d32 4
a35 5
When using pkgsrc on Interix, it is best NOT to install the Utilities
subcomponent "UNIX Perl".  That is Perl 5.6 without shared module
support, installed to /usr/local, and will only cause confusion. 
Instead, install Perl 5.8 from pkgsrc (or from a binary package
available at the URL above).
d41 28
a68 4
Finally, during installation you may be asked whether to enable setuid
behavior for Interix programs, and whether to make pathnames default to
case-sensitive.  Both options should be enabled.  (If you choose to
disable setuid, many system programs from pkgsrc may not work.)
a99 3
And the following issue means that binary packages (pkg_add) should be
installed by Administrator for the time being:

d103 3
@


1.10
log
@Add a note about needing to be Administrator to install setgid files.
@
text
@d1 1
a1 1
$NetBSD: README.Interix,v 1.9 2004/04/27 14:03:24 tv Exp $
d77 1
a77 1
And the following two issues mean that binary packages (pkg_add) should be
a82 3
* set-gid files in Interix seem to require using Administrator to install
  the setgid file.  (I'm working to confirm this.)

@


1.9
log
@Actually reference the pkgsrc info page as implied by the perl paragraph.
@
text
@d1 1
a1 1
$NetBSD: README.Interix,v 1.8 2004/04/27 13:58:43 tv Exp $
a69 3
* "pkg_add" creates directories of mode 0755, not 0775, in $PKG_DBDIR.
  This will be fixed.

d77 9
@


1.8
log
@Revise, and add note that "UNIX Perl" should not be installed from SFU.
@
text
@d1 1
a1 1
$NetBSD: README.Interix,v 1.7 2004/04/21 20:34:16 tv Exp $
d17 7
@


1.7
log
@umask 002, not 022.
@
text
@d1 1
a1 1
$NetBSD: README.Interix,v 1.6 2004/03/29 02:22:32 tv Exp $
d5 5
a9 8
NOTE:  Currently, Interix support in pkgsrc is unstable, so errors and
problems are expected.  Known caveats are listed at the bottom of this
document.

Interix is a POSIX compatible subsystem for the Windows NT kernel, providing
a Unix-like environment with a tighter kernel integration than available
with Cygwin.  It is part of the Windows Services for Unix package, available
for Windows 2000, XP, and 2003.  SFU can be downloaded from:
d13 3
a15 2
Services for Unix 3.5 (current as of this writing) has been tested.  3.0 may
work, but is not officially supported.
d17 2
a18 2
At an absolute minimum, the following packages must be installed from the
Windows Services for Unix 3.5 distribution in order to use bootstrap-pkgsrc:
d25 14
a38 8
The Remote Connectivity subcomponent, Windows Remote Shell Service, does not
need to be installed, but Remote Connectivity itself should be installed in
order to have a working inetd.

Last but not least, if the installer prompts whether to change the default
POSIX behavior to case-sensitive, answer Yes.  If the filename handling
remains as case-insensitive, then "bootstrap" will require the
"--ignore-case-check" option.
d42 1
a42 1
KNOWN CAVEATS
d53 13
d73 1
a73 11
* The popular Interix binary packages from http://www.interopsystems.com/
  use an older version of pkgsrc's pkg_* tools and occupy the /var/db/pkg
  directory (though the packages install to /usr/local).  If you want to
  have both kinds of packages installed in the system, supply the option
  "--pkgdbdir=DIRECTORY" to "bootstrap".

* On Windows under Interix, the "root" user is actually named
  "Administrator".  This may require some modification to pkgsrc to
  introduce a parameterized root user for installation purposes.  
  (Likewise, the bootstrap script sets the root group to
  "+Administrators".)
@


1.6
log
@Add more caveat text.
@
text
@d1 1
a1 1
$NetBSD: README.Interix,v 1.5 2004/03/27 14:46:59 grant Exp $
d45 1
a45 1
* The package manager should use a umask of 022.  "make install" will
@


1.5
log
@kill a redundant comment about missing mk files.
@
text
@d1 1
a1 1
$NetBSD: README.Interix,v 1.4 2004/03/12 00:16:42 tv Exp $
d16 3
d40 9
d52 1
a52 1
  the privileged user (these will eventually be fixed).  To accomodate
d57 4
a60 4
  use OpenBSD's pkg_* tools and occupy the /var/db/pkg directory (though
  the packages install to /usr/local).  If you want to have both kinds of
  packages installed in the system, supply "--pkgdbdir=DIRECTORY" to
  "bootstrap" to use an alternative package database directory.
d65 2
a66 1
  (Likewise, the bootstrap script sets the root group to "+Administrators".)
@


1.4
log
@Add notes about root user and the packages from interopsystems.com.
@
text
@d1 1
a1 1
$NetBSD: README.Interix,v 1.3 2004/03/11 20:47:56 tv Exp $
a49 3
* As of this writing, the necessary Interix support stubs have not yet been
  added to pkgsrc/mk.

@


1.3
log
@Interix has the possibility of case-insensitive filesystems too.  Add the
same check used for Darwin, and a doc fragment to README.Interix.
@
text
@d1 1
a1 1
$NetBSD: README.Interix,v 1.2 2004/03/11 17:09:37 tv Exp $
d37 13
@


1.2
log
@Fix comment about Administrator user.
@
text
@d1 1
a1 1
$NetBSD: README.Interix,v 1.1.1.1 2004/03/11 13:03:59 grant Exp $
d28 5
@


1.1
log
@Initial revision
@
text
@d1 1
a1 1
$NetBSD: README.Interix,v 1.1 2004/03/10 23:37:42 tv Exp $
d36 1
a36 1
  "+Administrator".  This may require some modification to pkgsrc to
@


1.1.1.1
log
@import the required bits of bootstrap-pkgsrc from 20040311.
@
text
@@

.