summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorMatthias Clasen <matthiasc@src.gnome.org>2007-12-29 05:18:58 +0000
committerMatthias Clasen <matthiasc@src.gnome.org>2007-12-29 05:18:58 +0000
commitfd2803670138d173c28f06ad57fd78a80dc4d977 (patch)
tree8a149a8855dd4b7c8ae9ae6d3362eae4e4a7ab2d
parent35f3f588aeffb19497c595022a3562ec4fe42d1f (diff)
Add a note on restrictions of child setup functions
svn path=/trunk/; revision=6208
-rw-r--r--docs/reference/ChangeLog5
-rw-r--r--docs/reference/glib/tmpl/spawn.sgml6
2 files changed, 11 insertions, 0 deletions
diff --git a/docs/reference/ChangeLog b/docs/reference/ChangeLog
index 85f7b9eec..a1c4d9021 100644
--- a/docs/reference/ChangeLog
+++ b/docs/reference/ChangeLog
@@ -1,3 +1,8 @@
+2007-12-29 Matthias Clasen <mclasen@redhat.com>
+
+ * glib/tmpl/spawn.sgml: Add a warning about allowed functions
+ between fork() and exec().
+
2007-12-24 Benjamin Otte <otte@gnome.org>
* glib/tmpl/timers.sgml: Add a warning about g_thread_init
diff --git a/docs/reference/glib/tmpl/spawn.sgml b/docs/reference/glib/tmpl/spawn.sgml
index f4d6ef0c9..c744cee04 100644
--- a/docs/reference/glib/tmpl/spawn.sgml
+++ b/docs/reference/glib/tmpl/spawn.sgml
@@ -87,6 +87,12 @@ function will thus only affect the child, not the parent.
</para>
<para>
+Note that POSIX allows only async-signal-safe functions (see signal(7))
+to be called in the child between fork() and exec(), which drastically
+limits the usefulness of child setup functions.
+</para>
+
+<para>
On Windows the function is called in the parent. Its usefulness on
Windows is thus questionable. In many cases executing the child setup
function in the parent can have ill effects, and you should be very