Document prctl() via $0 assignment (7636ea95c5) in perldelta
Ævar Arnfjörð Bjarmason [Mon, 19 Apr 2010 19:47:43 +0000 (20:47 +0100)]
pod/perl5130delta.pod

index 93cd22e..a1a2d0e 100644 (file)
@@ -39,6 +39,15 @@ still be dispatched within the same statement as they were previously - if
 this is not the case, or it is possible to create uninterruptable loops, this
 is a bug, and reports are encouraged of how to recreate such issues.
 
+=head2 Assignment to C<$0> sets the legacy process name with C<prctl()> on Linux
+
+On Linux the legacy process name will be set with L<prctl(2)>, in
+addition to altering the POSIX name via C<argv[0]> as perl has done
+since version 4.000. Now system utilities that read the legacy process
+name such as ps, top and killall will recognize the name you set when
+assigning to C<$0>. The string you supply will be cut off at 16 bytes,
+this is a limitation imposed by Linux.
+
 =head1 New Platforms
 
 XXX List any platforms that this version of perl compiles on, that previous