Typo fixes. Fixes bug#1093
[gnupg.git] / doc / sysnotes.texi
1 @c Copyright (C) 2004 Free Software Foundation, Inc.
2 @c This is part of the GnuPG manual.
3 @c For copying conditions, see the file gnupg.texi.
4
5 @node System Notes
6 @chapter Notes pertaining to certain OSes.
7
8 GnuPG has been developed on GNU/Linux systems and is know to work on
9 almost all Free OSes.  All modern POSIX systems should be supported
10 right now, however there are probably a lot of smaller glitches we need
11 to fix first.  The major problem areas are:
12
13 @itemize
14 @item 
15 For logging to sockets and other internal operations the
16 @code{fopencookie} function (@code{funopen} under *BSD) is used.  This
17 is a very convenient function which makes it possible to create outputs in
18 a structures and easy maintainable way.  The drawback however is that
19 most proprietary OSes don't support this function.  At g10@tie{}Code we
20 have looked into several ways on how to overcome this limitation but no
21 sufficiently easy and maintainable way has been found.  Porting
22 @emph{glibc} to a general POSIX system is of course an option and would
23 make writing portable software much easier; this it has not yet been
24 done and the system administrator would need to cope with the GNU
25 specific admin things in addition to the generic ones of his system.
26
27 We have now settled to use explicit stdio wrappers with a functionality
28 similar to funopen.  Although the code for this has already been written
29 (@emph{libestream}), we have not yet changed GnuPG to use it.
30
31 This means that on systems not supporting either @code{funopen} or
32 @code{fopencookie}, logging to a socket won't work, prompts are not
33 formatted as pretty as they should be and @command{gpgsm}'s
34 @code{LISTKEYS} Assuan command does not work.
35
36 @item
37 We are planning to use file descriptor passing for interprocess
38 communication.  This will allow us save a lot of resources and improve
39 performance of certain operations a lot.  Systems not supporting this
40 won't gain these benefits but we try to keep them working the standard
41 way as it is done today.
42
43 @item
44 We require more or less full POSIX compatibility.  This has been
45 around for 15 years now and thus we don't believe it makes sense to
46 support non POSIX systems anymore.  Well, we of course the usual
47 workarounds for near POSIX systems well be applied.
48
49 There is one exception of this rule: Systems based the Microsoft Windows
50 API (called here @emph{W32}) will be supported to some extend.
51
52 @end itemize
53
54
55 @menu
56 * W32 Notes::             Microsoft Windows Notes
57 @end menu
58
59
60 @node W32 Notes
61 @section Microsoft Windows Notes
62
63 @noindent
64 Current limitations are:
65
66 @itemize
67
68 @item
69 @command{gpgconf} does not create backup files, so in case of trouble
70 your configuration file might get lost.
71
72 @item
73 @command{watchgnupg} is not available.  Logging to sockets is not
74 possible.
75
76 @item
77 The periodical smartcard status checking done by @command{scdaemon} is
78 not yet supported.
79
80 @end itemize
81
82
83
84
85
86