|
|
|
|
@ -4,6 +4,9 @@
|
|
|
|
|
|
|
|
|
|
@subsection Where's the documentation?
|
|
|
|
|
|
|
|
|
|
@strong{(Please note: This section has not yet been updated for the latest
|
|
|
|
|
net release.)}
|
|
|
|
|
|
|
|
|
|
There are links to quite a lot of it on the main Cygwin project WWW page:
|
|
|
|
|
@file{http://sourceware.cygnus.com/cygwin/}
|
|
|
|
|
Be sure to at least read the Release Notes on the main WWW page, if
|
|
|
|
|
@ -14,6 +17,9 @@ Tool-specific documentation is available at:
|
|
|
|
|
|
|
|
|
|
@subsection What Cygwin mailing lists can I join?
|
|
|
|
|
|
|
|
|
|
@strong{(Please note: This section has not yet been updated for the latest
|
|
|
|
|
net release.)}
|
|
|
|
|
|
|
|
|
|
To subscribe to the main list, send a message to
|
|
|
|
|
cygwin-subscribe@@sourceware.cygnus.com. To unsubscribe from the
|
|
|
|
|
main list, send a message to cygwin-unsubscribe@@sourceware.cygnus.com.
|
|
|
|
|
@ -34,6 +40,9 @@ There's an archive of the main mailing list at
|
|
|
|
|
|
|
|
|
|
@subsection Why won't you/the mailing list answer my questions?
|
|
|
|
|
|
|
|
|
|
@strong{(Please note: This section has not yet been updated for the latest
|
|
|
|
|
net release.)}
|
|
|
|
|
|
|
|
|
|
Perhaps your question has an answer that's already in the FAQ.
|
|
|
|
|
Perhaps nobody has time to answer your question. Perhaps nobody
|
|
|
|
|
knows the answer...
|
|
|
|
|
@ -42,6 +51,9 @@ knows the answer...
|
|
|
|
|
|
|
|
|
|
@subsection Why is the install of the tools failing?
|
|
|
|
|
|
|
|
|
|
@strong{(Please note: This section has not yet been updated for the latest
|
|
|
|
|
net release.)}
|
|
|
|
|
|
|
|
|
|
If you are getting an error message saying "The decompression of
|
|
|
|
|
%s failed. There may not be enough free disk space in the TEMP
|
|
|
|
|
directory.", read on.
|
|
|
|
|
@ -60,17 +72,26 @@ That will get rid of any files with conflicting names and solve the
|
|
|
|
|
|
|
|
|
|
@subsection Help! I haven't created /tmp and tools are behaving strangely!
|
|
|
|
|
|
|
|
|
|
@strong{(Please note: This section has not yet been updated for the latest
|
|
|
|
|
net release.)}
|
|
|
|
|
|
|
|
|
|
Many Unix tools (bash, byacc, etc.) expect that /tmp always exists.
|
|
|
|
|
This is not guaranteed in Win32 land. You should create /tmp or "mount"
|
|
|
|
|
the directory of your choice to /tmp to avoid this problem.
|
|
|
|
|
|
|
|
|
|
@subsection Why does bash spew out "49054596: No such file or directory"?
|
|
|
|
|
|
|
|
|
|
@strong{(Please note: This section has not yet been updated for the latest
|
|
|
|
|
net release.)}
|
|
|
|
|
|
|
|
|
|
Are you sure you created a /tmp? The bash shell will print a
|
|
|
|
|
warning if it doesn't find a /tmp directory.
|
|
|
|
|
|
|
|
|
|
@subsection How do I set /etc up?
|
|
|
|
|
|
|
|
|
|
@strong{(Please note: This section has not yet been updated for the latest
|
|
|
|
|
net release.)}
|
|
|
|
|
|
|
|
|
|
If you want a valid /etc set up (so "ls -l" will display correct
|
|
|
|
|
user information for example) and if you are running NT (preferably
|
|
|
|
|
with an NTFS file system), you should just need to create the /etc
|
|
|
|
|
@ -81,6 +102,9 @@ you're running Windows 95/98.
|
|
|
|
|
|
|
|
|
|
@subsection Bash says that it can't vfork (or just hangs). Why?
|
|
|
|
|
|
|
|
|
|
@strong{(Please note: This section has not yet been updated for the latest
|
|
|
|
|
net release.)}
|
|
|
|
|
|
|
|
|
|
Most often this is because it can't find itself in the path. Make sure
|
|
|
|
|
that your path includes the directory where bash lives, before you start
|
|
|
|
|
it.
|
|
|
|
|
@ -92,6 +116,9 @@ can't find @code{/bin/sh}.
|
|
|
|
|
|
|
|
|
|
@subsection How can I get bash to read my .bashrc file on startup?
|
|
|
|
|
|
|
|
|
|
@strong{(Please note: This section has not yet been updated for the latest
|
|
|
|
|
net release.)}
|
|
|
|
|
|
|
|
|
|
Your .bashrc is read from your home directory specified by the HOME
|
|
|
|
|
environment variable. It uses /.bashrc if HOME is not set. So you need
|
|
|
|
|
to set HOME correctly, or move your .bashrc to the top of the drive
|
|
|
|
|
@ -99,10 +126,16 @@ mounted as / in Cygwin.
|
|
|
|
|
|
|
|
|
|
@subsection How can I get bash filename completion to be case insensitive?
|
|
|
|
|
|
|
|
|
|
@strong{(Please note: This section has not yet been updated for the latest
|
|
|
|
|
net release.)}
|
|
|
|
|
|
|
|
|
|
"shopt -s nocaseglob" should do the trick.
|
|
|
|
|
|
|
|
|
|
@subsection Can I use paths/filenames containing spaces in them?
|
|
|
|
|
|
|
|
|
|
@strong{(Please note: This section has not yet been updated for the latest
|
|
|
|
|
net release.)}
|
|
|
|
|
|
|
|
|
|
Cygwin does support spaces in filenames and paths. That said, some
|
|
|
|
|
utilities that use the library may not, since files don't typically
|
|
|
|
|
contain spaces in Unix. If you stumble into problems with this, you
|
|
|
|
|
@ -111,6 +144,9 @@ used by Cygwin tools.
|
|
|
|
|
|
|
|
|
|
@subsection Why can't I cd into a shortcut to a directory?
|
|
|
|
|
|
|
|
|
|
@strong{(Please note: This section has not yet been updated for the latest
|
|
|
|
|
net release.)}
|
|
|
|
|
|
|
|
|
|
Cygwin does not follow MS Windows Explorer Shortcuts (*.lnk
|
|
|
|
|
files) yet. It sees a shortcut as a regular file and this you
|
|
|
|
|
cannot "cd" into it.
|
|
|
|
|
@ -122,6 +158,9 @@ under native Win32 non-Cygwin applications such as Explorer.
|
|
|
|
|
|
|
|
|
|
@subsection I'm having basic problems with find. Why?
|
|
|
|
|
|
|
|
|
|
@strong{(Please note: This section has not yet been updated for the latest
|
|
|
|
|
net release.)}
|
|
|
|
|
|
|
|
|
|
Make sure you are using the find that came with the Cygwin tools
|
|
|
|
|
and that you aren't picking up the Win32 find command instead. You
|
|
|
|
|
can verify that you are getting the right one by doing a "type find"
|
|
|
|
|
@ -129,6 +168,9 @@ in bash.
|
|
|
|
|
|
|
|
|
|
@subsection Why don't cursor keys work under Win95/Win98?
|
|
|
|
|
|
|
|
|
|
@strong{(Please note: This section has not yet been updated for the latest
|
|
|
|
|
net release.)}
|
|
|
|
|
|
|
|
|
|
Careful examination shows that they not just non-functional, but
|
|
|
|
|
rather behave strangely, for example, with NumLock off, keys on numeric
|
|
|
|
|
keyboard work, until you press usual cursor keys, when even numeric
|
|
|
|
|
@ -156,6 +198,9 @@ properly).
|
|
|
|
|
|
|
|
|
|
@subsection Is it OK to have multiple copies of the DLL?
|
|
|
|
|
|
|
|
|
|
@strong{(Please note: This section has not yet been updated for the latest
|
|
|
|
|
net release.)}
|
|
|
|
|
|
|
|
|
|
It's a bad idea to have multiple versions of the cygwin DLL in
|
|
|
|
|
your path. They often conflict in funny ways. If you have
|
|
|
|
|
multiple versions, it's usually OK to get rid of (or rename)
|
|
|
|
|
@ -168,6 +213,9 @@ in your path, though.
|
|
|
|
|
|
|
|
|
|
@subsection Why aren't man, groff, etc. included in the betas?
|
|
|
|
|
|
|
|
|
|
@strong{(Please note: This section has not yet been updated for the latest
|
|
|
|
|
net release.)}
|
|
|
|
|
|
|
|
|
|
For obvious reasons, it isn't feasible for us to maintain and provide
|
|
|
|
|
binary distributions of every tool ported to work with the Cygwin
|
|
|
|
|
tools. However, it's likely that a man command will show up in a
|
|
|
|
|
@ -179,6 +227,9 @@ available for download there.
|
|
|
|
|
|
|
|
|
|
@subsection Where can I find "less"?
|
|
|
|
|
|
|
|
|
|
@strong{(Please note: This section has not yet been updated for the latest
|
|
|
|
|
net release.)}
|
|
|
|
|
|
|
|
|
|
The less pager binary is available for the first time in the 20.1
|
|
|
|
|
release. You will get it if you upgrade. It is also available from
|
|
|
|
|
various ftp locations on the Net. Search the mailing list archives for
|
|
|
|
|
@ -186,16 +237,25 @@ the details.
|
|
|
|
|
|
|
|
|
|
@subsection Where can I find "more"?
|
|
|
|
|
|
|
|
|
|
@strong{(Please note: This section has not yet been updated for the latest
|
|
|
|
|
net release.)}
|
|
|
|
|
|
|
|
|
|
If you are looking for the "more" pager, you should use the "less" pager
|
|
|
|
|
instead. See the last question and answer for more information.
|
|
|
|
|
|
|
|
|
|
@subsection Where can I find "which"?
|
|
|
|
|
|
|
|
|
|
@strong{(Please note: This section has not yet been updated for the latest
|
|
|
|
|
net release.)}
|
|
|
|
|
|
|
|
|
|
While we don't include a which command, you can use the bash built
|
|
|
|
|
in "type" command which does something fairly similar.
|
|
|
|
|
|
|
|
|
|
@subsection How can I access other drives?
|
|
|
|
|
|
|
|
|
|
@strong{(Please note: This section has not yet been updated for the latest
|
|
|
|
|
net release.)}
|
|
|
|
|
|
|
|
|
|
The best way is to use the "mount" command to mount the drive letter so
|
|
|
|
|
that you can refer to it with only single slashes:
|
|
|
|
|
|
|
|
|
|
@ -237,6 +297,9 @@ must be more than one character long.
|
|
|
|
|
|
|
|
|
|
@subsection How can I copy and paste into Cygwin console windows?
|
|
|
|
|
|
|
|
|
|
@strong{(Please note: This section has not yet been updated for the latest
|
|
|
|
|
net release.)}
|
|
|
|
|
|
|
|
|
|
Under Windows NT, open the properties dialog of the console window.
|
|
|
|
|
The options contain a toggle button, named "Quick edit mode". It must
|
|
|
|
|
be ON. Save the properties.
|
|
|
|
|
@ -246,6 +309,9 @@ Select the Misc tab. Uncheck Fast Pasting. Check QuickEdit.
|
|
|
|
|
|
|
|
|
|
@subsection What does "mount failed: Device or resource busy" mean?
|
|
|
|
|
|
|
|
|
|
@strong{(Please note: This section has not yet been updated for the latest
|
|
|
|
|
net release.)}
|
|
|
|
|
|
|
|
|
|
This usually means that you are trying to mount to a location
|
|
|
|
|
already in use by mount. For example, if c: is mounted as '/'
|
|
|
|
|
and you try to mount d: there as well, you will get this error
|
|
|
|
|
@ -261,6 +327,9 @@ Cygwin library.
|
|
|
|
|
|
|
|
|
|
@subsection How can I share files between Unix and Windows?
|
|
|
|
|
|
|
|
|
|
@strong{(Please note: This section has not yet been updated for the latest
|
|
|
|
|
net release.)}
|
|
|
|
|
|
|
|
|
|
During development, we have both Unix boxes running Samba and
|
|
|
|
|
NT/Windows 95/98 machines. We often build with cross-compilers
|
|
|
|
|
under Unix and copy binaries and source to the Windows system
|
|
|
|
|
@ -270,6 +339,9 @@ filesystem so we can also access the files under Windows 9x.
|
|
|
|
|
|
|
|
|
|
@subsection Are mixed-case filenames possible with Cygwin?
|
|
|
|
|
|
|
|
|
|
@strong{(Please note: This section has not yet been updated for the latest
|
|
|
|
|
net release.)}
|
|
|
|
|
|
|
|
|
|
Several Unix programs expect to be able to use to filenames
|
|
|
|
|
spelled the same way, but with different case. A prime example
|
|
|
|
|
of this is perl's configuration script, which wants @code{Makefile} and
|
|
|
|
|
@ -283,6 +355,9 @@ code for beta 16.
|
|
|
|
|
|
|
|
|
|
@subsection What about DOS special filenames?
|
|
|
|
|
|
|
|
|
|
@strong{(Please note: This section has not yet been updated for the latest
|
|
|
|
|
net release.)}
|
|
|
|
|
|
|
|
|
|
Files cannot be named com1, lpt1, or aux (to name a few); either as
|
|
|
|
|
the root filename or as the extension part. If you do, you'll have
|
|
|
|
|
trouble. Unix programs don't avoid these names which can make things
|
|
|
|
|
@ -293,6 +368,9 @@ letters 'aux' in it will hang.
|
|
|
|
|
|
|
|
|
|
@subsection When it hangs, how do I get it back?
|
|
|
|
|
|
|
|
|
|
@strong{(Please note: This section has not yet been updated for the latest
|
|
|
|
|
net release.)}
|
|
|
|
|
|
|
|
|
|
If something goes wrong and the tools hang on you for some reason (easy
|
|
|
|
|
to do if you try and read a file called aux.sh), first try hitting ^C to
|
|
|
|
|
return to bash or the cmd prompt.
|
|
|
|
|
@ -306,6 +384,9 @@ This should never be necessary under Windows NT.
|
|
|
|
|
|
|
|
|
|
@subsection Why the weird directory structure?
|
|
|
|
|
|
|
|
|
|
@strong{(Please note: This section has not yet been updated for the latest
|
|
|
|
|
net release.)}
|
|
|
|
|
|
|
|
|
|
Why are cpp.exe, cc1.exe, etc., not in the bin directory?
|
|
|
|
|
|
|
|
|
|
Why more than one lib and include directory?
|
|
|
|
|
@ -346,6 +427,9 @@ it's worth it for people with more complex installations.
|
|
|
|
|
|
|
|
|
|
@subsection How do anti-virus programs like Cygwin?
|
|
|
|
|
|
|
|
|
|
@strong{(Please note: This section has not yet been updated for the latest
|
|
|
|
|
net release.)}
|
|
|
|
|
|
|
|
|
|
One person reported that McAfee VirusScan for NT (and others?) is
|
|
|
|
|
incompatible with Cygwin. This is because it tries to scan the
|
|
|
|
|
newly loaded shared memory in the cygwin.dll, which can cause fork()s
|
|
|
|
|
@ -353,6 +437,9 @@ to fail, wreaking havoc on many of the tools.
|
|
|
|
|
|
|
|
|
|
@subsection Why can't I run bash as a shell under NT Emacs?
|
|
|
|
|
|
|
|
|
|
@strong{(Please note: This section has not yet been updated for the latest
|
|
|
|
|
net release.)}
|
|
|
|
|
|
|
|
|
|
Place the following code in your startup file and try again:
|
|
|
|
|
|
|
|
|
|
@smallexample
|
|
|
|
|
@ -366,6 +453,9 @@ Place the following code in your startup file and try again:
|
|
|
|
|
|
|
|
|
|
@subsection Where did the man/info pages go?
|
|
|
|
|
|
|
|
|
|
@strong{(Please note: This section has not yet been updated for the latest
|
|
|
|
|
net release.)}
|
|
|
|
|
|
|
|
|
|
In order to save space and download times, we have stopped providing
|
|
|
|
|
the man/info files for the tools with the binary install since we are
|
|
|
|
|
not yet providing a man page or info reader. Both types of
|
|
|
|
|
@ -374,6 +464,9 @@ site. Or consult the online documentation over the WWW.
|
|
|
|
|
|
|
|
|
|
@subsection Why can't B20's "cygcheck -s" find cpp?
|
|
|
|
|
|
|
|
|
|
@strong{(Please note: This section has not yet been updated for the latest
|
|
|
|
|
net release.)}
|
|
|
|
|
|
|
|
|
|
This is a confusingly worded warning that will be reworded in future
|
|
|
|
|
versions. In fact, cygcheck should normally *not* find cpp; if it does,
|
|
|
|
|
it may be a problem (e.g. it might pick up Borland's cpp, which would
|
|
|
|
|
@ -381,6 +474,9 @@ cause problems).
|
|
|
|
|
|
|
|
|
|
@subsection Why do I get a message saying Out of Queue slots?
|
|
|
|
|
|
|
|
|
|
@strong{(Please note: This section has not yet been updated for the latest
|
|
|
|
|
net release.)}
|
|
|
|
|
|
|
|
|
|
"Out of queue slots!" generally occurs when you're trying to remove
|
|
|
|
|
many files that you do not have permission to remove (either because
|
|
|
|
|
you don't have permission, they are opened exclusively, etc). What
|
|
|
|
|
@ -395,6 +491,9 @@ this explanation).
|
|
|
|
|
|
|
|
|
|
@subsection Why don't symlinks work on samba-mounted filesystems?
|
|
|
|
|
|
|
|
|
|
@strong{(Please note: This section has not yet been updated for the latest
|
|
|
|
|
net release.)}
|
|
|
|
|
|
|
|
|
|
Symlinks are marked with "system" file attribute. Samba does not
|
|
|
|
|
enable this attribute by default. To enable it, consult your Samba
|
|
|
|
|
documentation and then add these lines to your samba configuration
|
|
|
|
|
@ -409,12 +508,18 @@ Note that the 0775 can be anything as long as the 0010 bit is set.
|
|
|
|
|
|
|
|
|
|
@subsection Why does df report sizes incorrectly.
|
|
|
|
|
|
|
|
|
|
@strong{(Please note: This section has not yet been updated for the latest
|
|
|
|
|
net release.)}
|
|
|
|
|
|
|
|
|
|
There is a bug in the Win32 API function GetFreeDiskSpace that
|
|
|
|
|
makes it return incorrect values for disks larger than 2 GB in size.
|
|
|
|
|
Perhaps that may be your problem?
|
|
|
|
|
|
|
|
|
|
@subsection Has the screen program been ported yet?
|
|
|
|
|
|
|
|
|
|
@strong{(Please note: This section has not yet been updated for the latest
|
|
|
|
|
net release.)}
|
|
|
|
|
|
|
|
|
|
Screen requires either unix domain sockets or fifoes. Neither of
|
|
|
|
|
them have been implemented in Cygwin yet.
|
|
|
|
|
|
|
|
|
|
@ -422,6 +527,9 @@ them have been implemented in Cygwin yet.
|
|
|
|
|
|
|
|
|
|
@subsection How does everything work?
|
|
|
|
|
|
|
|
|
|
@strong{(Please note: This section has not yet been updated for the latest
|
|
|
|
|
net release.)}
|
|
|
|
|
|
|
|
|
|
There's a C library which provides a Unix-style API. The
|
|
|
|
|
applications are linked with it and voila - they run on Windows.
|
|
|
|
|
|
|
|
|
|
@ -440,6 +548,9 @@ WWW site.
|
|
|
|
|
|
|
|
|
|
@subsection Are development snapshots for the Cygwin library available?
|
|
|
|
|
|
|
|
|
|
@strong{(Please note: This section has not yet been updated for the latest
|
|
|
|
|
net release.)}
|
|
|
|
|
|
|
|
|
|
Yes. They're made whenever anything interesting happens inside the
|
|
|
|
|
Cygwin library (usually roughly on a nightly basis, depending on how much
|
|
|
|
|
is going on). They are only intended for those people who wish to
|
|
|
|
|
@ -451,6 +562,9 @@ http://sourceware.cygnus.com/cygwin/snapshots/
|
|
|
|
|
|
|
|
|
|
@subsection How is the DOS/Unix CR/LF thing handled?
|
|
|
|
|
|
|
|
|
|
@strong{(Please note: This section has not yet been updated for the latest
|
|
|
|
|
net release.)}
|
|
|
|
|
|
|
|
|
|
Let's start with some background.
|
|
|
|
|
|
|
|
|
|
In UNIX, a file is a file and what the file contains is whatever the
|
|
|
|
|
@ -502,6 +616,9 @@ Explanation adapted from mailing list email by Earnie Boyd
|
|
|
|
|
|
|
|
|
|
@subsection Is the Cygwin library multi-thread-safe?
|
|
|
|
|
|
|
|
|
|
@strong{(Please note: This section has not yet been updated for the latest
|
|
|
|
|
net release.)}
|
|
|
|
|
|
|
|
|
|
No.
|
|
|
|
|
|
|
|
|
|
There is an experimental configure option (--enable-threadsafe), which
|
|
|
|
|
@ -533,6 +650,9 @@ should be fine.
|
|
|
|
|
|
|
|
|
|
@subsection Why is some functionality only supported in Windows NT?
|
|
|
|
|
|
|
|
|
|
@strong{(Please note: This section has not yet been updated for the latest
|
|
|
|
|
net release.)}
|
|
|
|
|
|
|
|
|
|
Windows 9x: n.
|
|
|
|
|
32 bit extensions and a graphical shell for a 16 bit patch to an
|
|
|
|
|
8 bit operating system originally coded for a 4 bit microprocessor,
|
|
|
|
|
@ -545,6 +665,9 @@ is not supported in Win 9x.
|
|
|
|
|
|
|
|
|
|
@subsection How is fork() implemented?
|
|
|
|
|
|
|
|
|
|
@strong{(Please note: This section has not yet been updated for the latest
|
|
|
|
|
net release.)}
|
|
|
|
|
|
|
|
|
|
Cygwin fork() essentially works like a non-copy on write version
|
|
|
|
|
of fork() (like old Unix versions used to do). Because of this it
|
|
|
|
|
can be a little slow. In most cases, you are better off using the
|
|
|
|
|
@ -571,6 +694,9 @@ shared area and then returns from fork itself.
|
|
|
|
|
|
|
|
|
|
@subsection How does wildcarding (globbing) work?
|
|
|
|
|
|
|
|
|
|
@strong{(Please note: This section has not yet been updated for the latest
|
|
|
|
|
net release.)}
|
|
|
|
|
|
|
|
|
|
If an application using CYGWIN.DLL starts up, and can't find the
|
|
|
|
|
@code{PID} environment variable, it assumes that it has been started
|
|
|
|
|
from the a DOS style command prompt. This is pretty safe, since the
|
|
|
|
|
@ -587,6 +713,9 @@ Beware: globbing uses @code{malloc}. If your application defines
|
|
|
|
|
|
|
|
|
|
@subsection How do symbolic links work?
|
|
|
|
|
|
|
|
|
|
@strong{(Please note: This section has not yet been updated for the latest
|
|
|
|
|
net release.)}
|
|
|
|
|
|
|
|
|
|
CYGWIN.DLL generates link files with a magic header. When
|
|
|
|
|
you open a file or directory that is a link to somewhere else, it
|
|
|
|
|
opens the file or directory listed in the magic header. Because we
|
|
|
|
|
@ -599,6 +728,9 @@ attribute.
|
|
|
|
|
|
|
|
|
|
@subsection Why do some files, which are not executables have the 'x' type.
|
|
|
|
|
|
|
|
|
|
@strong{(Please note: This section has not yet been updated for the latest
|
|
|
|
|
net release.)}
|
|
|
|
|
|
|
|
|
|
When working out the unix-style attribute bits on a file, the library
|
|
|
|
|
has to fill out some information not provided by the WIN32 API.
|
|
|
|
|
|
|
|
|
|
@ -607,6 +739,9 @@ ones which have a "#!" as their first characters.
|
|
|
|
|
|
|
|
|
|
@subsection How secure is Cygwin in a multi-user environment?
|
|
|
|
|
|
|
|
|
|
@strong{(Please note: This section has not yet been updated for the latest
|
|
|
|
|
net release.)}
|
|
|
|
|
|
|
|
|
|
Cygwin is not secure in a multi-user environment. For
|
|
|
|
|
example if you have a long running daemon such as "inetd"
|
|
|
|
|
running as admin while ordinary users are logged in, or if
|
|
|
|
|
@ -621,6 +756,9 @@ all processes.
|
|
|
|
|
|
|
|
|
|
@subsection How do the net-related functions work?
|
|
|
|
|
|
|
|
|
|
@strong{(Please note: This section has not yet been updated for the latest
|
|
|
|
|
net release.)}
|
|
|
|
|
|
|
|
|
|
The network support in Cygwin is supposed to provide the Unix API, not
|
|
|
|
|
the Winsock API.
|
|
|
|
|
|
|
|
|
|
@ -668,6 +806,9 @@ As of the b19 release, this information may be slightly out of date.
|
|
|
|
|
|
|
|
|
|
@subsection I don't want Unix sockets, how do I use normal Win32 winsock?
|
|
|
|
|
|
|
|
|
|
@strong{(Please note: This section has not yet been updated for the latest
|
|
|
|
|
net release.)}
|
|
|
|
|
|
|
|
|
|
To use the vanilla Win32 winsock, you just need to #define Win32_Winsock
|
|
|
|
|
and #include "windows.h" at the top of your source file(s). You'll also
|
|
|
|
|
want to add -lwsock32 to the compiler's command line so you link against
|
|
|
|
|
@ -675,6 +816,9 @@ libwsock32.a.
|
|
|
|
|
|
|
|
|
|
@subsection What version numbers are associated with Cygwin?
|
|
|
|
|
|
|
|
|
|
@strong{(Please note: This section has not yet been updated for the latest
|
|
|
|
|
net release.)}
|
|
|
|
|
|
|
|
|
|
There is a cygwin.dll major version number that gets incremented
|
|
|
|
|
every time we make a new Cygwin release available. This
|
|
|
|
|
corresponds to the name of the release (e.g. beta 19's major
|
|
|
|
|
@ -699,6 +843,9 @@ This has been "B15.0" since the beta 15 release.
|
|
|
|
|
|
|
|
|
|
@subsection Why isn't _timezone set correctly?
|
|
|
|
|
|
|
|
|
|
@strong{(Please note: This section has not yet been updated for the latest
|
|
|
|
|
net release.)}
|
|
|
|
|
|
|
|
|
|
Did you explicitly call tzset() before checking the value of _timezone?
|
|
|
|
|
If not, you must do so.
|
|
|
|
|
|
|
|
|
|
@ -706,6 +853,9 @@ If not, you must do so.
|
|
|
|
|
|
|
|
|
|
@subsection Why is gcc failing?
|
|
|
|
|
|
|
|
|
|
@strong{(Please note: This section has not yet been updated for the latest
|
|
|
|
|
net release.)}
|
|
|
|
|
|
|
|
|
|
If the error is "gcc: installation problem, cannot exec `cpp':
|
|
|
|
|
No such file or directory", the GCC_EXEC_PREFIX environment variable
|
|
|
|
|
hasn't been set correctly. The current release does not need
|
|
|
|
|
@ -715,6 +865,9 @@ see this message.
|
|
|
|
|
|
|
|
|
|
@subsection Why can't bison find bison.simple or bison.hairy?
|
|
|
|
|
|
|
|
|
|
@strong{(Please note: This section has not yet been updated for the latest
|
|
|
|
|
net release.)}
|
|
|
|
|
|
|
|
|
|
If you are getting a warning to this effect, you need to set
|
|
|
|
|
the BISONLIB environment variable. The value should be the directory
|
|
|
|
|
in which bison.simple and bison.hairy are installed. This will be
|
|
|
|
|
@ -724,6 +877,9 @@ systems, you would want to set it to @code{C:/cygnus/cygwin-b20/share}.
|
|
|
|
|
|
|
|
|
|
@subsection Why is make behaving badly?
|
|
|
|
|
|
|
|
|
|
@strong{(Please note: This section has not yet been updated for the latest
|
|
|
|
|
net release.)}
|
|
|
|
|
|
|
|
|
|
Starting with the beta 19 release, make defaults to a win32 mode in
|
|
|
|
|
which backslashes in filenames are permitted and cmd.exe/command.com
|
|
|
|
|
is used as the sub-shell. In this mode, escape characters aren't
|
|
|
|
|
@ -748,10 +904,16 @@ install sets MAKE_MODE to UNIX.
|
|
|
|
|
|
|
|
|
|
@subsection Why the undefined reference to "WinMain@@16"?
|
|
|
|
|
|
|
|
|
|
@strong{(Please note: This section has not yet been updated for the latest
|
|
|
|
|
net release.)}
|
|
|
|
|
|
|
|
|
|
Try adding an empty main() function to one of your sources.
|
|
|
|
|
|
|
|
|
|
@subsection How do I use Win32 API calls?
|
|
|
|
|
|
|
|
|
|
@strong{(Please note: This section has not yet been updated for the latest
|
|
|
|
|
net release.)}
|
|
|
|
|
|
|
|
|
|
It's pretty simple actually. Cygwin tools require that you explicitly
|
|
|
|
|
link the import libraries for whatever Win32 API functions that you
|
|
|
|
|
are going to use, with the exception of kernel32, which is linked
|
|
|
|
|
@ -801,12 +963,18 @@ the file that makes the reference.
|
|
|
|
|
|
|
|
|
|
@subsection How do I compile a Win32 executable that doesn't use Cygwin?
|
|
|
|
|
|
|
|
|
|
@strong{(Please note: This section has not yet been updated for the latest
|
|
|
|
|
net release.)}
|
|
|
|
|
|
|
|
|
|
The -mno-cygwin flag to gcc makes gcc link against standard Microsoft
|
|
|
|
|
DLLs instead of Cygwin. This is desirable for native Windows programs
|
|
|
|
|
that don't need a UNIX emulation layer.
|
|
|
|
|
|
|
|
|
|
@subsection How do I make the console window go away?
|
|
|
|
|
|
|
|
|
|
@strong{(Please note: This section has not yet been updated for the latest
|
|
|
|
|
net release.)}
|
|
|
|
|
|
|
|
|
|
The default during compilation is to produce a console application.
|
|
|
|
|
It you are writing a GUI program, you should either compile with
|
|
|
|
|
-mwindows as explained above, or add the string
|
|
|
|
|
@ -814,12 +982,18 @@ It you are writing a GUI program, you should either compile with
|
|
|
|
|
|
|
|
|
|
@subsection Why does make complain about a "missing separator"?
|
|
|
|
|
|
|
|
|
|
@strong{(Please note: This section has not yet been updated for the latest
|
|
|
|
|
net release.)}
|
|
|
|
|
|
|
|
|
|
This problem usually occurs as a result of someone editing a Makefile
|
|
|
|
|
with a text editor that replaces tab characters with spaces. Command
|
|
|
|
|
lines must start with tabs.
|
|
|
|
|
|
|
|
|
|
@subsection Why can't we redistribute Microsoft's Win32 headers?
|
|
|
|
|
|
|
|
|
|
@strong{(Please note: This section has not yet been updated for the latest
|
|
|
|
|
net release.)}
|
|
|
|
|
|
|
|
|
|
Subsection 2.d.f of the `Microsoft Open Tools License agreement' looks like
|
|
|
|
|
it says that can not "permit further redistribution of the
|
|
|
|
|
Redistributables to their end users". We take this to mean that we can
|
|
|
|
|
@ -829,6 +1003,9 @@ Win32 headers which are pretty complete.
|
|
|
|
|
|
|
|
|
|
@subsection How do I link against .lib files?
|
|
|
|
|
|
|
|
|
|
@strong{(Please note: This section has not yet been updated for the latest
|
|
|
|
|
net release.)}
|
|
|
|
|
|
|
|
|
|
1. Build a C file with a function table. Put all functions you intend
|
|
|
|
|
to use in that table. This forces the linker to include all the object
|
|
|
|
|
files from the .lib. Maybe there is an option to force LINK.EXE to
|
|
|
|
|
@ -857,6 +1034,9 @@ rewriting the runtime library in question from specs...
|
|
|
|
|
|
|
|
|
|
@subsection How do I rebuild the tools on my NT box?
|
|
|
|
|
|
|
|
|
|
@strong{(Please note: This section has not yet been updated for the latest
|
|
|
|
|
net release.)}
|
|
|
|
|
|
|
|
|
|
Assuming that you have the src installed as /src, will build in
|
|
|
|
|
the directory /obj, and want to install the tools in /install:
|
|
|
|
|
|
|
|
|
|
@ -870,6 +1050,9 @@ make install > install.log 2>&1
|
|
|
|
|
|
|
|
|
|
@subsection How can I compile a powerpc NT toolchain?
|
|
|
|
|
|
|
|
|
|
@strong{(Please note: This section has not yet been updated for the latest
|
|
|
|
|
net release.)}
|
|
|
|
|
|
|
|
|
|
Unfortunately, this will be difficult. It hasn't been built for
|
|
|
|
|
some time (late 1996) since Microsoft has dropped development of
|
|
|
|
|
powerpc NT. Exception handling/signals support semantics/args have been
|
|
|
|
|
@ -879,12 +1062,18 @@ Please send us patches if you do this work!
|
|
|
|
|
|
|
|
|
|
@subsection How can I compile an Alpha NT toolchain?
|
|
|
|
|
|
|
|
|
|
@strong{(Please note: This section has not yet been updated for the latest
|
|
|
|
|
net release.)}
|
|
|
|
|
|
|
|
|
|
We have not ported the tools to Alpha NT and do not have plans to
|
|
|
|
|
do so at the present time. We would be happy to add support
|
|
|
|
|
for Alpha NT if someone contributes the changes to us.
|
|
|
|
|
|
|
|
|
|
@subsection How can I adjust the heap/stack size of an application?
|
|
|
|
|
|
|
|
|
|
@strong{(Please note: This section has not yet been updated for the latest
|
|
|
|
|
net release.)}
|
|
|
|
|
|
|
|
|
|
Pass heap/stack linker arguments to gcc. To create foo.exe with
|
|
|
|
|
a heap size of 1024 and a stack size of 4096, you would invoke
|
|
|
|
|
gcc as:
|
|
|
|
|
@ -893,20 +1082,32 @@ gcc as:
|
|
|
|
|
|
|
|
|
|
@subsection How can I find out which dlls are needed by an executable?
|
|
|
|
|
|
|
|
|
|
@strong{(Please note: This section has not yet been updated for the latest
|
|
|
|
|
net release.)}
|
|
|
|
|
|
|
|
|
|
objdump -p provides this information.
|
|
|
|
|
|
|
|
|
|
@subsection How do I build a DLL?
|
|
|
|
|
|
|
|
|
|
@strong{(Please note: This section has not yet been updated for the latest
|
|
|
|
|
net release.)}
|
|
|
|
|
|
|
|
|
|
There's documentation that explains the process on the main Cygwin
|
|
|
|
|
project web page (http://sourceware.cygnus.com/cygwin/).
|
|
|
|
|
|
|
|
|
|
@subsection How can I set a breakpoint at MainCRTStartup?
|
|
|
|
|
|
|
|
|
|
@strong{(Please note: This section has not yet been updated for the latest
|
|
|
|
|
net release.)}
|
|
|
|
|
|
|
|
|
|
Set a breakpoint at *0x401000 in gdb and then run the program in
|
|
|
|
|
question.
|
|
|
|
|
|
|
|
|
|
@subsection How can I build a relocatable dll?
|
|
|
|
|
|
|
|
|
|
@strong{(Please note: This section has not yet been updated for the latest
|
|
|
|
|
net release.)}
|
|
|
|
|
|
|
|
|
|
You must execute the following sequence of five commands, in this
|
|
|
|
|
order:
|
|
|
|
|
|
|
|
|
|
@ -1005,6 +1206,9 @@ like -ltcl80 in your linker command.
|
|
|
|
|
|
|
|
|
|
@subsection How can I debug what's going on?
|
|
|
|
|
|
|
|
|
|
@strong{(Please note: This section has not yet been updated for the latest
|
|
|
|
|
net release.)}
|
|
|
|
|
|
|
|
|
|
You can debug your application using @code{gdb}. Make sure you
|
|
|
|
|
compile it with the -g flag! If your application calls functions in
|
|
|
|
|
MS dlls, gdb will complain about not being able to load debug information
|
|
|
|
|
@ -1014,6 +1218,9 @@ info would not be compatible with gdb).
|
|
|
|
|
|
|
|
|
|
@subsection Can I use a system trace mechanism instead?
|
|
|
|
|
|
|
|
|
|
@strong{(Please note: This section has not yet been updated for the latest
|
|
|
|
|
net release.)}
|
|
|
|
|
|
|
|
|
|
Yes. If you have a newer cygwin with the @code{strace.exe} program,
|
|
|
|
|
@code{strace} can run other cygwin programs with various debug and
|
|
|
|
|
trace messages enabled. For information on using the @code{strace}
|
|
|
|
|
@ -1033,6 +1240,9 @@ mechanism is well documented in the Cygwin library sources in the file
|
|
|
|
|
|
|
|
|
|
@subsection The linker complains that it can't find something.
|
|
|
|
|
|
|
|
|
|
@strong{(Please note: This section has not yet been updated for the latest
|
|
|
|
|
net release.)}
|
|
|
|
|
|
|
|
|
|
A common error is to put the library on the command line before
|
|
|
|
|
the thing that needs things from it.
|
|
|
|
|
|
|
|
|
|
@ -1042,19 +1252,31 @@ This is right @code{gcc hello.cc -lstdc++}.
|
|
|
|
|
@subsection I use a function I know is in the API, but I still get a link
|
|
|
|
|
error.
|
|
|
|
|
|
|
|
|
|
@strong{(Please note: This section has not yet been updated for the latest
|
|
|
|
|
net release.)}
|
|
|
|
|
|
|
|
|
|
The function probably isn't declared in the header files, or
|
|
|
|
|
the UNICODE stuff for it isn't filled in.
|
|
|
|
|
|
|
|
|
|
@subsection Can you make DLLs that are linked against libc ?
|
|
|
|
|
|
|
|
|
|
@strong{(Please note: This section has not yet been updated for the latest
|
|
|
|
|
net release.)}
|
|
|
|
|
|
|
|
|
|
Yes.
|
|
|
|
|
|
|
|
|
|
@subsection Where is malloc.h?
|
|
|
|
|
|
|
|
|
|
@strong{(Please note: This section has not yet been updated for the latest
|
|
|
|
|
net release.)}
|
|
|
|
|
|
|
|
|
|
Include stdlib.h instead of malloc.h.
|
|
|
|
|
|
|
|
|
|
@subsection Can I use my own malloc?
|
|
|
|
|
|
|
|
|
|
@strong{(Please note: This section has not yet been updated for the latest
|
|
|
|
|
net release.)}
|
|
|
|
|
|
|
|
|
|
If you define a function called @code{malloc} in your own code, and link
|
|
|
|
|
with the DLL, the DLL @emph{will} call your @code{malloc}. Needless to
|
|
|
|
|
say, you will run into serious problems if your malloc is buggy.
|
|
|
|
|
@ -1067,12 +1289,18 @@ to occur after @code{main} is called, then this will surely break.
|
|
|
|
|
|
|
|
|
|
@subsection Can I mix objects compiled with msvc++ and gcc?
|
|
|
|
|
|
|
|
|
|
@strong{(Please note: This section has not yet been updated for the latest
|
|
|
|
|
net release.)}
|
|
|
|
|
|
|
|
|
|
Yes, but only if you are combining C object files. MSVC C++ uses a
|
|
|
|
|
different mangling scheme than GNU C++, so you will have difficulties
|
|
|
|
|
combining C++ objects.
|
|
|
|
|
|
|
|
|
|
@subsection Can I use the gdb debugger to debug programs built by VC++?
|
|
|
|
|
|
|
|
|
|
@strong{(Please note: This section has not yet been updated for the latest
|
|
|
|
|
net release.)}
|
|
|
|
|
|
|
|
|
|
No, not for full (high level source language) debugging.
|
|
|
|
|
The Microsoft compilers generate a different type of debugging
|
|
|
|
|
symbol information, which gdb does not understand.
|
|
|
|
|
@ -1085,6 +1313,9 @@ data types, line numbers, local variables etc.
|
|
|
|
|
|
|
|
|
|
@subsection Where can I find info on x86 assembly?
|
|
|
|
|
|
|
|
|
|
@strong{(Please note: This section has not yet been updated for the latest
|
|
|
|
|
net release.)}
|
|
|
|
|
|
|
|
|
|
CPU reference manuals for Intel's current chips are available in
|
|
|
|
|
downloadable PDF form on Intel's web site:
|
|
|
|
|
|
|
|
|
|
@ -1092,12 +1323,18 @@ downloadable PDF form on Intel's web site:
|
|
|
|
|
|
|
|
|
|
@subsection Shell scripts aren't running properly from my makefiles?
|
|
|
|
|
|
|
|
|
|
@strong{(Please note: This section has not yet been updated for the latest
|
|
|
|
|
net release.)}
|
|
|
|
|
|
|
|
|
|
You need to have . (dot) in your $PATH. You should NOT need to add
|
|
|
|
|
/bin/sh in front of each and every shell script invoked in your
|
|
|
|
|
Makefiles.
|
|
|
|
|
|
|
|
|
|
@subsection What preprocessor do I need to know about?
|
|
|
|
|
|
|
|
|
|
@strong{(Please note: This section has not yet been updated for the latest
|
|
|
|
|
net release.)}
|
|
|
|
|
|
|
|
|
|
We use _WIN32 to signify access to the Win32 API and __CYGWIN__ for
|
|
|
|
|
access to the Cygwin environment provided by the dll.
|
|
|
|
|
|
|
|
|
|
@ -1108,11 +1345,17 @@ be compiled with VC++.
|
|
|
|
|
|
|
|
|
|
@subsection Where can I get f77 and objc components for B20 EGCS 1.1?
|
|
|
|
|
|
|
|
|
|
@strong{(Please note: This section has not yet been updated for the latest
|
|
|
|
|
net release.)}
|
|
|
|
|
|
|
|
|
|
B20-compatible versions of the f77 and objc components are available
|
|
|
|
|
from @file{http://www.xraylith.wisc.edu/~khan/software/gnu-win32/}.
|
|
|
|
|
|
|
|
|
|
@subsection How should I port my Unix GUI to Windows?
|
|
|
|
|
|
|
|
|
|
@strong{(Please note: This section has not yet been updated for the latest
|
|
|
|
|
net release.)}
|
|
|
|
|
|
|
|
|
|
There are two basic strategies for porting Unix GUIs to Windows.
|
|
|
|
|
|
|
|
|
|
The first is to use a portable graphics library such as tcl/tk, X11, or
|
|
|
|
|
@ -1129,6 +1372,9 @@ advantages inherent in using Cygwin.
|
|
|
|
|
|
|
|
|
|
@subsection Why not use DJGPP ?
|
|
|
|
|
|
|
|
|
|
@strong{(Please note: This section has not yet been updated for the latest
|
|
|
|
|
net release.)}
|
|
|
|
|
|
|
|
|
|
DJGPP is a similar idea, but for DOS instead of Win32. DJGPP uses a
|
|
|
|
|
"DOS extender" to provide a more reasonable operating interface for its
|
|
|
|
|
applications. The Cygwin toolset doesn't have to do this since all of
|
|
|
|
|
|
David Starks-Browning