.. -*- coding: utf-8; -*-

=========
 Cygwin.
=========
.. contents::
   :local:

Installation.
=============

Run setup.exe. Use output dir like::

  d:\opt\cygwin

Add to your PATH env var exactly before C:\WINDOWS\system32;C:\WINDOWS values::

  set PATH=d:\opt\cygwin\bin;d:\opt\cygwin\usr\local\bin;%PATH%

  REM Set CYGWIN variable to 'nontsec'. That makes sure that permissions
  REM on your windows machine are not updated as a side effect of cygwin
  REM operations.
  set CYGWIN=binary nontsec nodosfilewarning codepage:cp1251 noglob

  set LANG=ru_RU.cp1251

Set HOME env var (where places config file and projects)::

  set HOME=d:\home

Set TMP and TEMP env vars with good path (without spaces, etc.; these vars
already set as used defined, so you need change their values)::

  set TMP=c:\tmp
  set TEMP=c:\tmp

Also you need edit /etc/passwd to point to correct home path.

apt-cyg package manager
=======================

``apt-cyg`` is based on ``bash``, ``wget``, ``tar``, ``gawk`` and ``bzip2``
packages and provide convenient commands for managing and queries packages::

  $ apt-cyg update
  $ apt-cyg install emacs-w32
  $ apt-cyg remove emacs-w32

Information about package and dependencies::

  $ apt-cyg show emacs-w32
  $ apt-cyg depends wget
  $ apt-cyg rdepends emacs

List installed packages::

  $ apt-cyg list

Search for package with file across installed packages::

  $ apt-cyg search stdio.h

Search for package with file through cygwin.com::

  $ apt-cyg searchall stdio.h

List all packages in ``setup.ini``::

  $ apt-cyg listall

Find package by regex::

  $ apt-cyg listall ^emacs

To search for package name or list packages::

To switch between mirrors::

  $ apt-cyg mirror ftp://ftp.cygwinports.org/pub/cygwinports
  $ apt-cyg update
  $ apt-cyg install php

  $ apt-cyg mirror ftp://www.fruitbat.org/pub/cygwin/circa/2016/08/30/104223

To change a location of directory where packages and ``setup.ini`` downloaded::

  $ apt-cyg cache
  C:\net

  $ apt-cyg cache ~/net
  Cache set to C:\home\net.

https://github.com/transcode-open/apt-cyg/

Installation on Windows XP
==========================

Cygwin from v2.5.5 and Setup version 2.874 (on 25 Aug 2016) is latest version
with Windows XP support. Later versions build with dependencies on newer
syscalls and failt to run in Windows XP.

Latest mirrors avaialble at fruitbat.org:

* 32-bit: ftp://www.fruitbat.org/pub/cygwin/circa/2016/08/30/104223
* 64-bit: ftp://www.fruitbat.org/pub/cygwin/circa/64bit/2016/08/30/104235

To run setup against this mirror::

  cmd> setup.exe 

``setup.exe`` available at:

* 32-bit ftp://www.fruitbat.org/pub/cygwin/setup/snapshots/setup-x86-2.874.exe
* 64-bit ftp://www.fruitbat.org/pub/cygwin/setup/snapshots/setup-x86_64-2.874.exe

Run as (``-X`` disable signature verification, ``-s <url>`` option select a
particular mirror, ``-O`` option disallow any other mirrors)::

  cmd> setup-x86.exe -X -s ftp://www.fruitbat.org/pub/cygwin/circa/2016/08/30/104223 -O

http://www.fruitbat.org/Cygwin/timemachine.html
  Description of Cygwin time machine project.
http://stackoverflow.com/questions/39479826/cygwin-2-5-2-mirror-getting-the-last-xp-release
  Question about Cygwin old mirror.
http://superuser.com/questions/1132000/is-it-still-possible-to-get-cygwin-for-xp
  Question about Cygwin old mirror.
http://cygwin-xp.portfolis.net/
  Another old mirror.

Cygwin ports.
=============

This project provides Cygwin binary and source packages for a large variety of programs and
libraries, including the GNOME  and KDE desktop environments

  http://cygwin-ports.sourceforge.net/
                newest home of the Cygwin Ports project
  http://sourceware.org/cygwinports/
                home page
  http://cygwinports.blogspot.com
                official blog??

Which Cygwin version you run?
=============================
::

  $ uname -r
  1.7.7(0.230/5/3)
  $ cygcheck -c cygwin
  Cygwin Package Information
  Package              Version        Status
  cygwin               1.7.7-1        OK

Recreate /etc/passwd and /etc/groups.
=====================================
::

  $ mkpasswd -d | grep $yourlogin > /etc/passwd  # if you in Windows domain
  $ mkpasswd -l > /etc/passwd                    # if you in Windows domain

  $ mkgroup -l > /etc/group

Adding mount points.
====================

``/etc/fstab``::

  C:/foo /bar/baz ntfs text,posix=0 0 0
  /var /usr/var none bind

Running X Window.
=================
::

  $ XWin -multiwindow&

or::

  $ XWin -clipboard -silent-dup-error -xkblayout "us,ru" -xkboptions "grp:caps_toggle"&

To start X application you must set 'DISPLAY'::

  $ DISPLAY=:0 xterm&

Working with packages.
======================

Installed package list with versions.
-------------------------------------
::

  $ cygcheck -c -d

List of package files.
----------------------
::

  $ cygcheck -l pkg-name

Search package by containing file (only under installed packages).
------------------------------------------------------------------
::

  $ cygcheck -f full-path-to-file

Search packages by containing path (only under installed packages).
-------------------------------------------------------------------
::

  $ for f in /etc/setup/*.lst.gz; do gzip -c -d $f | grep $WORD  2>&1 >/dev/null && { echo $f; break; } || :; done

Search for package.
-------------------

If you have file name or regex use (need internet connection)::

  $ cygcheck -p REGEX

cygcheck use such link:

  http://cygwin.com/cgi-bin2/package-grep.cgi?grep=REGEX

Cygwin installation info.
=========================
::

  $ uname -a
  $ cygcheck -s -r

Cygwin acronyms.
================

  http://www.cygwin.com/acronyms
                One encounters all sorts of acronyms on the Cygwin mailing lists.

Check dll dependency.
=====================
::

  $ ldd my.dll
  $ ldd my.exe
  $ cygcheck ./my.dll
  $ cygcheck ./my.exe

Cygwin alternatives.
====================

  http://www.suacommunity.com/SUA.aspx
                Subsystem for Unix-based Applications and Services for Unix