~ubuntu-branches/ubuntu/saucy/libbsd/saucy

« back to all changes in this revision

Viewing changes to man/setproctitle.3

  • Committer: Package Import Robot
  • Author(s): Guillem Jover
  • Date: 2013-07-14 14:29:59 UTC
  • mfrom: (8.1.6 sid)
  • Revision ID: package-import@ubuntu.com-20130714142959-0beqv7g3kpxgevk0
Tags: 0.6.0-1
* New upstream release.
  - Move setproctitle() constructor into a new libbsd-ctor static library,
    to avoid breakage on dlopen()+threads+constructor situations, like
    when using samba NSS modules for example.
  - Export setproctitle_init().

Show diffs side-by-side

added added

removed removed

Lines of Context:
33
33
.In sys/types.h
34
34
.In bsd/unistd.h
35
35
.Ft void
 
36
.Fn setproctitle_init "int argc" "char *argv[]" "char *envp[]"
 
37
.Ft void
36
38
.Fn setproctitle "const char *fmt" "..."
37
39
.Sh DESCRIPTION
38
40
The
41
43
.Xr ps 1
42
44
command.
43
45
.Pp
 
46
The
 
47
.Fn setproctitle_init
 
48
library routine only needs to be called (before any call to
 
49
.Fn setproctitle
 
50
and with
 
51
.Fn main
 
52
arguments), if the automatic constructor support has not
 
53
been linked in through the libbsd-ctor pkg-config file.
 
54
.Pp
44
55
The title is set from the executable's name, followed by the
45
56
result of a
46
57
.Xr printf 3
101
112
.Fx 2.2 .
102
113
Other operating systems have
103
114
similar functions.
 
115
.Pp
 
116
The
 
117
.Fn setproctitle_init
 
118
function is a libbsd extension not present on the BSDs, avoid using it
 
119
in portable code.
104
120
.Sh AUTHORS
105
121
.An -nosplit
106
122
.An Peter Wemm Aq peter@FreeBSD.org