JehanneOS/newlib
1
0
Fork 0
Code Issues Pull Requests Projects Releases Wiki Activity

* faq-setup.xml: Throughout remove setup.exe, use setup or setup-x86...

Browse Source 
instead.
	(faq.setup.cli): Reproduce latest --help output.
	(faq.setup.noroot): New section.
	(faq.setup.setup-fails-on-ts): Remove section.
	* setup-net.xml (internet-setup): Mention setup-x86{_64} in first
	paragraph.  Add note to allow using setup.exe in subsequent paragraphs.
	Add paragraph to introduce --no-admin option.
This commit is contained in:
Corinna Vinschen 2013-11-11 12:48:31 +00:00
parent 874e065fa1
commit 4146cc5ce7
3 changed files with 111 additions and 74 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

11
winsup/doc/ChangeLog
View File

@ -1,3 +1,14 @@
2013-11-11 Corinna Vinschen <corinna@vinschen.de>
* faq-setup.xml: Throughout remove setup.exe, use setup or setup-x86...
instead.
(faq.setup.cli): Reproduce latest --help output.
(faq.setup.noroot): New section.
(faq.setup.setup-fails-on-ts): Remove section.
* setup-net.xml (internet-setup): Mention setup-x86{_64} in first
paragraph. Add note to allow using setup.exe in subsequent paragraphs.
Add paragraph to introduce --no-admin option.
2013-11-06 Christopher Faylor <me.cygwin2013@cgf.cx>
* Makefile.in: Fix problems accessing xidepend when configured with a

142
winsup/doc/faq-setup.xml
View File

@ -37,10 +37,10 @@ see <ulink url="http://cygwin.com/packages/">http://cygwin.com/packages/</ulink>
<para>The Cygwin Setup program is designed to be interactive, but there are
a few different ways to automate it. If you are deploying to multiple systems,
the best way is to run through a full installation once, saving the entire
downloaded package tree. Then, on target systems, run setup.exe as a "Local
Install" pointed at your downloaded package tree. You could do this
non-interactively with the command line options
<literal>setup.exe -q -L -l x:\cygwin-local\</literal>, where your downloaded
downloaded package tree. Then, on target systems, run Cygwin Setup as a
"Local Install" pointed at your downloaded package tree. You could do this
non-interactively with the command line options
<literal>-q -L -l x:\cygwin-local\</literal>, where your downloaded
package tree is in <literal>x:\cygwin-local\</literal> (see the next FAQ for
an explanation of those options.)
</para>
@ -52,37 +52,67 @@ For other options, search the mailing lists with terms such as
</answer></qandaentry>
<qandaentry id="faq.setup.cli">
<question><para>Does setup.exe accept command-line arguments?</para></question>
<question><para>Does Setup accept command-line arguments?</para></question>
<answer>
<para>Yes, the full listing is written to the <literal>setup.log</literal> file
when you run <literal>setup.exe --help</literal>. The current options are:
when you run <literal>setup-x86.exe --help</literal> or
<literal>setup-x86_64.exe --help</literal>. The current options are:
<screen>
Command Line Options:
-A --disable-buggy-antivirus Disable known or suspected buggy anti
virus software packages during execution.
-C --categories Specify entire categories to install
-D --download Download from internet
-d --no-desktop Disable creation of desktop shortcut
-h --help print help
-K --pubkey URL of extra public key file (gpg format)
-L --local-install Install from local directory
-l --local-package-dir Local package directory
-n --no-shortcuts Disable creation of desktop and start menu
shortcuts
-N --no-startmenu Disable creation of start menu shortcut
-O --only-site Ignore all sites except for -s
-P --packages Specify packages to install
-p --proxy HTTP/FTP proxy (host:port)
-q --quiet-mode Unattended setup mode
-r --no-replaceonreboot Disable replacing in-use files on next
reboot.
-R --root Root installation directory
-S --sexpr-pubkey Extra public key in s-expr format
-s --site Download site
-U --keep-untrusted-keys Use untrusted keys and retain all
-u --untrusted-keys Use untrusted keys from last-extrakeys
-X --no-verify Don't verify setup.ini signatures
-D --download Download from internet
-L --local-install Install from local directory
-s --site Download site
-O --only-site Ignore all sites except for -s
-R --root Root installation directory
-x --remove-packages Specify packages to uninstall
-c --remove-categories Specify categories to uninstall
-P --packages Specify packages to install
-C --categories Specify entire categories to install
-p --proxy HTTP/FTP proxy (host:port)
-a --arch architecture to install (x86_64 or x86)
-q --quiet-mode Unattended setup mode
-M --package-manager Semi-attended chooser-only mode
-B --no-admin Do not check for and enforce running as
Administrator
-h --help print help
-l --local-package-dir Local package directory
-r --no-replaceonreboot Disable replacing in-use files on next
reboot.
-X --no-verify Don't verify setup.ini signatures
-n --no-shortcuts Disable creation of desktop and start menu
shortcuts
-N --no-startmenu Disable creation of start menu shortcut
-d --no-desktop Disable creation of desktop shortcut
-K --pubkey URL of extra public key file (gpg format)
-S --sexpr-pubkey Extra public key in s-expr format
-u --untrusted-keys Use untrusted keys from last-extrakeys
-U --keep-untrusted-keys Use untrusted keys and retain all
-g --upgrade-also also upgrade installed packages
-o --delete-orphans remove orphaned packages
-A --disable-buggy-antivirus Disable known or suspected buggy anti virus
software packages during execution.
</screen>
</para>
</answer></qandaentry>
<qandaentry id="faq.setup.noroot">
<question><para>Can I install Cygwin without administrator rights?</para></question>
<answer>
<para>Yes. The default installation requests administrator rights because
this allows to set up the Cygwin environment so that all users can start
a Cygwin shell out of the box. However, if you don't have administrator
rights for your machine, and the admins don't want to install it for you,
you can install Cygwin just for yourself by downloading
<command>setup-x86.exe</command> (for a 32 bit install) or
<command>setup-x86_64.exe</command> (for a 64 bit install) and then start
it from the command line or via the "Run..." dialog from the start menu
using the <literal>--no-admin</literal> option, for instance:</para>
<para>
<screen>
setup-x86.exe --no-admin
</screen>
</para>
</answer></qandaentry>
@ -168,7 +198,8 @@ archives. If this happens to you, consider disabling your anti-virus
software when running Cygwin Setup. The following procedure should be
a fairly safe way to do that:
</para>
<orderedlist><listitem><para>Download <literal>setup.exe</literal> and scan it explicitly.
<orderedlist><listitem><para>Download <literal>setup-x86.exe</literal> or
<literal>setup-x86_64.exe</literal> and scan it explicitly.
</para>
</listitem>
<listitem><para>Turn off the anti-virus software.
@ -275,10 +306,11 @@ installed, not including the package archives themselves nor the source
code.
</para>
<para>After installation, the package archives remain in your ``Local
Package Directory'', by default the location of <literal>setup.exe</literal>. You
may conserve disk space by deleting the subdirectories there. These
directories will have very weird looking names, being encoded with
their URLs (named <literal>ftp%3a%2f...</literal>).
Package Directory''. By default the location of
<literal>setup-x86{_64}.exe</literal>. You may conserve disk space by
deleting the subdirectories there. These directories will have very weird
looking names, being encoded with their URLs
(named <literal>ftp%3a%2f...</literal>).
</para>
<para>Of course, you can keep them around in case you want to reinstall a
package. If you want to clean out only the outdated packages, Michael Chase
@ -333,35 +365,6 @@ what happened that wasn't supposed to happen, etc.
</para>
</answer></qandaentry>
<qandaentry id="faq.setup.setup-fails-on-ts">
<question><para>My installation on a Terminal Server machine goes wrong. What can I do?</para></question>
<answer>
<para>The problem is that Terminal Server machines do some compatibility
checks when running applications which are not marked as
"Terminal Server-aware", and this compatibility check seems to be buggy,
leaving parts of the application in a non-executable state. Curious enough,
this only happens if DEP (Data Execution Prevention) is turned on for
all applications.</para>
<para>So far, only few Cygwin packages have their binaries marked as
TS-aware, which means there's a good chance that the postinstall scripts
during the installation will break, and that after installation you
can't start a shell, etc.</para>
<para>So, for the time being, here's how you install Cygwin on a Terminal
Server. First, switch DEP to "Turn on DEP for essential Windows programs
and services only" and reboot the machine. Then install via setup.exe.
You can leave it at that and run the Terminal Server in the aforementioned
DEP setting. Or use the peflags tool from the rebase package to set
the TS-aware flag in all executables, switch DEP back to "Turn on DEP for
all programs and services except [...]" and reboot again. However,
please keep in mind that a package update might re-install a binary
with the TS-aware flag switched off again. So you will have to re-use
the peflags utility once in a while.
</para>
</answer></qandaentry>
<qandaentry id="faq.setup.name-with-space">
<question><para>My Windows logon name has a space in it, will this cause problems?</para></question>
<answer>
@ -493,10 +496,11 @@ this in Cygwin by typing <literal>chown -R user /</literal> or by using other
tools such as <literal>CACLS.EXE</literal>.
</para>
</listitem>
<listitem><para>Delete the Cygwin shortcuts on the Desktop and Start Menu, and anything
left by setup.exe in the download directory. However, if you plan to reinstall
Cygwin it's a good idea to keep your setup.exe download directory since you can
reinstall the packages left in its cache without redownloading them.
<listitem><para>Delete the Cygwin shortcuts on the Desktop and Start Menu, and
anything left by setup-x86{_64}.exe in the download directory. However, if you
plan to reinstall Cygwin it's a good idea to keep your setup-x86{_64}.exe
download directory since you can reinstall the packages left in its cache
without redownloading them.
</para>
</listitem>
<listitem><para>If you added Cygwin to your system path, you should remove it unless you
@ -609,7 +613,7 @@ this up for Cygwin 1.7, we might add this information here.
<para>Since Cygwin 1.7, there's nothing important in the registry anymore,
except for the installation directory information stored there for the sake
of setup.exe. There's nothing left to manipulate anymore.
of setup-x86{_64}.exe. There's nothing left to manipulate anymore.
</para></answer></qandaentry>
</qandadiv>

32
winsup/doc/setup-net.xml
View File

@ -8,11 +8,25 @@
<sect1 id="internet-setup">
<title>Internet Setup</title>
<para>To install the Cygwin net release, go to <ulink
url="http://cygwin.com/">http://cygwin.com/</ulink> and click on <ulink
url="http://cygwin.com/setup.exe">"Install Cygwin Now!"</ulink>. This will
download a GUI installer called <command>setup.exe</command> which can
be run to download a complete cygwin installation via the internet.
Follow the instructions on each screen to install Cygwin.
url="http://cygwin.com/">http://cygwin.com/</ulink> and run either
<ulink url="http://cygwin.com/setup-x86.exe">setup-x86.exe</ulink>
to install the 32 bit version of Cygwin, or
<ulink url="http://cygwin.com/setup-x86_64.exe">setup-x86_64.exe</ulink>
to install the 64 bit version of Cygwin. This will download a GUI
installer which can be run to download a complete cygwin installation
via the internet. Follow the instructions on each screen to install Cygwin.
</para>
<para>
<note>
For easier reading the installer is called <command>setup.exe</command>
throughout the following sections. This refers likewise to both
installer applications,
<ulink url="http://cygwin.com/setup-x86.exe">setup-x86.exe</ulink>
for 32 bit, as well as
<ulink url="http://cygwin.com/setup-x86_64.exe">setup-x86_64.exe</ulink>
for 64 bit. Apart from the target architecture they are the same thing.
</note>
</para>
<para>
@ -24,6 +38,14 @@ check the wishlist in the <ulink url="http://sourceware.org/cgi-bin/cvsweb.cgi/s
</ulink>. It may already be present in the CVS version!
</para>
<para>
On Windows Vista and later, <command>setup.exe</command> will check by
default if it runs with administrative privileges and, if not, will try
to elevate the process. If you want to avoid this behaviour and install
under an unprivileged account just for your own usage, run
<command>setup.exe</command> with the <literal>--no-admin</literal> option.
</para>
<para>
Since the default value for each option is the logical choice for
most installations, you can get a working minimal Cygwin environment