d/freebsd-dev
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity
613e383e81
freebsd-dev/lib/libc/gen/setproctitle.3

122 lines
3.2 KiB
Groff
Raw Normal View History

Bring in an initial version of setproctitle().. This is intended to replace the dozen other various hacks in the code that do all sorts of crude things including spamming the envrionment strings with the new argv string. This version is mainly inspired by the sendmail version, with a couple of ideas taken from the NetBSD implementation as well.
1995-12-26 22:50:08 +00:00
.\" Copyright (c) 1995 Peter Wemm <peter@freebsd.org>
.\" All rights reserved.
.\"
.\" Redistribution and use in source and binary forms, with or without
.\" modification, is permitted provided that the following conditions
.\" are met:
.\" 1. Redistributions of source code must retain the above copyright
.\" notice immediately at the beginning of the file, without modification,
.\" this list of conditions, and the following disclaimer.
.\" 2. Redistributions in binary form must reproduce the above copyright
.\" notice, this list of conditions and the following disclaimer in the
.\" documentation and/or other materials provided with the distribution.
.\" 3. This work was done expressly for inclusion into FreeBSD. Other use
.\" is permitted provided this notation is included.
.\" 4. Absolutely no warranty of function or purpose is made by the author
.\" Peter Wemm.
.\" 5. Modifications may be freely made to this file providing the above
.\" conditions are met.
.\"
$Id$ -> $FreeBSD$
1999-08-28 00:22:10 +00:00
.\" $FreeBSD$
Bring in an initial version of setproctitle().. This is intended to replace the dozen other various hacks in the code that do all sorts of crude things including spamming the envrionment strings with the new argv string. This version is mainly inspired by the sendmail version, with a couple of ideas taken from the NetBSD implementation as well.
1995-12-26 22:50:08 +00:00
.\"
.\" The following requests are required for all man pages.
.Dd December 16, 1995
mdoc(7) police: removed HISTORY info from the .Os call.
2001-07-10 13:41:46 +00:00
.Os
Bring in an initial version of setproctitle().. This is intended to replace the dozen other various hacks in the code that do all sorts of crude things including spamming the envrionment strings with the new argv string. This version is mainly inspired by the sendmail version, with a couple of ideas taken from the NetBSD implementation as well.
1995-12-26 22:50:08 +00:00
.Dt SETPROCTITLE 3
.Sh NAME
.Nm setproctitle
Add warnings about trusting user-supplied data. Reviewed by: ru Approved by: murray Obtained from: OpenBSD
2001-05-25 20:42:40 +00:00
.Nd set process title
Bring in an initial version of setproctitle().. This is intended to replace the dozen other various hacks in the code that do all sorts of crude things including spamming the envrionment strings with the new argv string. This version is mainly inspired by the sendmail version, with a couple of ideas taken from the NetBSD implementation as well.
1995-12-26 22:50:08 +00:00
.Sh SYNOPSIS
mdoc(7) police: Use the new .In macro for #include statements.
2001-10-01 16:09:29 +00:00
.In sys/types.h
.In unistd.h
Bring in an initial version of setproctitle().. This is intended to replace the dozen other various hacks in the code that do all sorts of crude things including spamming the envrionment strings with the new argv string. This version is mainly inspired by the sendmail version, with a couple of ideas taken from the NetBSD implementation as well.
1995-12-26 22:50:08 +00:00
.Ft void
.Fn setproctitle "const char *fmt" "..."
.Sh DESCRIPTION
The
Spelling/mdoc police.
1996-12-30 21:08:45 +00:00
.Fn setproctitle
Bring in an initial version of setproctitle().. This is intended to replace the dozen other various hacks in the code that do all sorts of crude things including spamming the envrionment strings with the new argv string. This version is mainly inspired by the sendmail version, with a couple of ideas taken from the NetBSD implementation as well.
1995-12-26 22:50:08 +00:00
library routine sets the process title that appears on the
.Xr ps 1
command.
.Pp
The title is set from the executable's name, followed by the
result of a
.Xr printf 3
style expansion of the arguments as specified by the
.Va fmt
argument.
If the format string passed to setproctitle begins with a '-' character, skip the program name when setting the process title. Ansified with extreme prejudice. Reviewed by: peter
2000-08-01 06:37:09 +00:00
If the
.Va fmt
argument begins with a
.Dq -
character, the executable's name is skipped.
Bring in an initial version of setproctitle().. This is intended to replace the dozen other various hacks in the code that do all sorts of crude things including spamming the envrionment strings with the new argv string. This version is mainly inspired by the sendmail version, with a couple of ideas taken from the NetBSD implementation as well.
1995-12-26 22:50:08 +00:00
.Pp
If
.Va fmt
Make setproctitle(NULL) restore all of the original arguments (if it's able).
1999-11-17 21:12:17 +00:00
is NULL, the process title is restored.
Bring in an initial version of setproctitle().. This is intended to replace the dozen other various hacks in the code that do all sorts of crude things including spamming the envrionment strings with the new argv string. This version is mainly inspired by the sendmail version, with a couple of ideas taken from the NetBSD implementation as well.
1995-12-26 22:50:08 +00:00
.Sh EXAMPLES
Fix punctuation: "it's" -> "its"
1997-04-17 23:31:47 +00:00
To set the title on a daemon to indicate its activity:
Bring in an initial version of setproctitle().. This is intended to replace the dozen other various hacks in the code that do all sorts of crude things including spamming the envrionment strings with the new argv string. This version is mainly inspired by the sendmail version, with a couple of ideas taken from the NetBSD implementation as well.
1995-12-26 22:50:08 +00:00
.Bd -literal -offset indent
setproctitle("talking to %s", inet_ntoa(addr));
.Ed
.Sh SEE ALSO
.Xr ps 1 ,
.Xr w 1 ,
.Xr kvm 3 ,
.Xr kvm_getargv 3 ,
.Xr printf 3
.Sh STANDARDS
mdoc(7) police: "The .Fn function".
2002-12-18 10:13:54 +00:00
The
Spelling/mdoc police.
1996-12-30 21:08:45 +00:00
.Fn setproctitle
mdoc(7) police: "The .Fn function".
2002-12-18 10:13:54 +00:00
function
Mechanically kill hard sentence breaks.
2004-07-02 23:52:20 +00:00
is implicitly non-standard.
Other methods of causing the
Bring in an initial version of setproctitle().. This is intended to replace the dozen other various hacks in the code that do all sorts of crude things including spamming the envrionment strings with the new argv string. This version is mainly inspired by the sendmail version, with a couple of ideas taken from the NetBSD implementation as well.
1995-12-26 22:50:08 +00:00
.Xr ps 1
command line to change, including copying over the argv[0] string are
Mechanically kill hard sentence breaks.
2004-07-02 23:52:20 +00:00
also implicitly non-portable.
It is preferable to use an operating system
Bring in an initial version of setproctitle().. This is intended to replace the dozen other various hacks in the code that do all sorts of crude things including spamming the envrionment strings with the new argv string. This version is mainly inspired by the sendmail version, with a couple of ideas taken from the NetBSD implementation as well.
1995-12-26 22:50:08 +00:00
supplied
Spelling/mdoc police.
1996-12-30 21:08:45 +00:00
.Fn setproctitle
Bring in an initial version of setproctitle().. This is intended to replace the dozen other various hacks in the code that do all sorts of crude things including spamming the envrionment strings with the new argv string. This version is mainly inspired by the sendmail version, with a couple of ideas taken from the NetBSD implementation as well.
1995-12-26 22:50:08 +00:00
if present.
.Pp
Unfortunately, it is possible that there are other calling conventions
to other versions of
Spelling/mdoc police.
1996-12-30 21:08:45 +00:00
.Fn setproctitle ,
Mechanically kill hard sentence breaks.
2004-07-02 23:52:20 +00:00
although none have been found by the author as yet.
This is believed to be
Bring in an initial version of setproctitle().. This is intended to replace the dozen other various hacks in the code that do all sorts of crude things including spamming the envrionment strings with the new argv string. This version is mainly inspired by the sendmail version, with a couple of ideas taken from the NetBSD implementation as well.
1995-12-26 22:50:08 +00:00
the predominant convention.
.Pp
Another round of spelling fixes.
1996-01-30 18:13:11 +00:00
It is thought that the implementation is compatible with other systems,
Bring in an initial version of setproctitle().. This is intended to replace the dozen other various hacks in the code that do all sorts of crude things including spamming the envrionment strings with the new argv string. This version is mainly inspired by the sendmail version, with a couple of ideas taken from the NetBSD implementation as well.
1995-12-26 22:50:08 +00:00
including
mdoc(7)'fy Reviewed by: mpp
1999-09-21 19:39:27 +00:00
.Nx
Bring in an initial version of setproctitle().. This is intended to replace the dozen other various hacks in the code that do all sorts of crude things including spamming the envrionment strings with the new argv string. This version is mainly inspired by the sendmail version, with a couple of ideas taken from the NetBSD implementation as well.
1995-12-26 22:50:08 +00:00
and
mdoc(7) police: s;BSD/OS;.Bsx; where appropriate.
2001-08-13 17:07:40 +00:00
.Bsx .
Bring in an initial version of setproctitle().. This is intended to replace the dozen other various hacks in the code that do all sorts of crude things including spamming the envrionment strings with the new argv string. This version is mainly inspired by the sendmail version, with a couple of ideas taken from the NetBSD implementation as well.
1995-12-26 22:50:08 +00:00
.Sh HISTORY
mdoc(7) police: "The .Fn function".
2002-12-18 10:13:54 +00:00
The
Spelling/mdoc police.
1996-12-30 21:08:45 +00:00
.Fn setproctitle
mdoc(7) police: "The .Fn function".
2002-12-18 10:13:54 +00:00
function
Some minor man page cleanup.
1996-08-23 20:52:53 +00:00
first appeared in
.Fx 2.2 .
Other operating systems have
Bring in an initial version of setproctitle().. This is intended to replace the dozen other various hacks in the code that do all sorts of crude things including spamming the envrionment strings with the new argv string. This version is mainly inspired by the sendmail version, with a couple of ideas taken from the NetBSD implementation as well.
1995-12-26 22:50:08 +00:00
similar functions.
.Sh AUTHORS
log
2000-11-22 09:23:54 +00:00
.An -nosplit
.Sh AUTHOR -> .Sh AUTHORS. Use .An/.Aq
1998-03-19 07:34:22 +00:00
.An Peter Wemm Aq peter@FreeBSD.org
Bring in an initial version of setproctitle().. This is intended to replace the dozen other various hacks in the code that do all sorts of crude things including spamming the envrionment strings with the new argv string. This version is mainly inspired by the sendmail version, with a couple of ideas taken from the NetBSD implementation as well.
1995-12-26 22:50:08 +00:00
stole the idea from the
Some minor man page cleanup.
1996-08-23 20:52:53 +00:00
.Sy "Sendmail 8.7.3"
Bring in an initial version of setproctitle().. This is intended to replace the dozen other various hacks in the code that do all sorts of crude things including spamming the envrionment strings with the new argv string. This version is mainly inspired by the sendmail version, with a couple of ideas taken from the NetBSD implementation as well.
1995-12-26 22:50:08 +00:00
source code by
.Sh AUTHOR -> .Sh AUTHORS. Use .An/.Aq
1998-03-19 07:34:22 +00:00
.An Eric Allman Aq eric@sendmail.org .
Add warnings about trusting user-supplied data. Reviewed by: ru Approved by: murray Obtained from: OpenBSD
2001-05-25 20:42:40 +00:00
.Sh BUGS
Never pass a string with user-supplied data as a format without using
.Ql %s .
Remove whitespace at EOL.
2001-07-15 07:53:42 +00:00
An attacker can put format specifiers in the string to mangle your stack,
Add warnings about trusting user-supplied data. Reviewed by: ru Approved by: murray Obtained from: OpenBSD
2001-05-25 20:42:40 +00:00
leading to a possible security hole.
This holds true even if the string was built using a function like
.Fn snprintf ,
as the resulting string may still contain user-supplied conversion specifiers
for later interpolation by
.Fn setproctitle .
.Pp
Always use the proper secure idiom:
.Pp
.Dl setproctitle("%s", string);
Reference in New Issue Copy Permalink