Current File : //usr/man/man1/dbus-cleanup-sockets.1

'\" te
.TH dbus-cleanup-sockets 1 "25 Feb 2009" "SunOS 5.11" "User Commands"
.SH "NAME"
dbus-cleanup-sockets \- clean up leftover sockets in a directory
.SH "SYNOPSIS"
.PP
\fBdbus-cleanup-sockets\fR [-\fB-help\fR] [-\fB-version\fR] [\fB\fIdirectory\fR\fR]
.SH "DESCRIPTION"
.PP
The dbus-cleanup-sockets command cleans up unused D\-Bus connection sockets\&.
.PP
If given no arguments, \fBdbus-cleanup-sockets\fR cleans up sockets in the
standard default socket directory for the per-user-login-session message bus;
this is usually \fB/tmp\fR\&.  Optionally, you can pass a
different directory on the command line\&.
.PP
On Linux, this program is essentially useless, because D\-Bus defaults to using
"abstract sockets" that exist only in memory and do not have a
corresponding file in \fB/tmp\fR\&.
.PP
On most other flavors of UNIX, it is possible for the socket files to leak when
programs using D\-Bus exit abnormally or without closing their D\-Bus
connections\&. Thus, it might be interesting to run \fBdbus-cleanup-sockets\fR in a
cron job to clean up any leaked sockets\&.  Or you can just ignore the leaked
sockets, they are not really hurting anything, other than cluttering the
\fB/tmp\fR directory\&.
.SH "OPTIONS"
.PP
The following options are supported:
.sp
.ne 2
.mk
\fB-\fB-help\fR\fR
.sp .6
.in +4
Show help information on standard output and exit\&.
.sp
.sp 1
.in -4
.sp
.ne 2
.mk
\fB-\fB-version\fR\fR
.sp .6
.in +4
Print the version of \fBdbus-cleanup-sockets\fR
.sp
.sp 1
.in -4
.SH "OPERANDS"
.PP
The following operands are supported:
.sp
.ne 2
.mk
\fB\fB\fIdirectory\fR\fR\fR
.in +16n
.rt
Clean up sockets in the specified \fIdirectory\fR
rather than the default socket directory\&.
.sp
.sp 1
.in -16n
.SH "EXIT STATUS"
.PP
The following exit values are returned:
.sp
.ne 2
.mk
\fB\fB0\fR\fR
.in +9n
.rt
Application exited successfully
.sp
.sp 1
.in -9n
.sp
.ne 2
.mk
\fB\fB>0\fR\fR
.in +9n
.rt
Application exited with failure
.sp
.sp 1
.in -9n
.SH "FILES"
.PP
The following files are used by this application:
.sp
.ne 2
.mk
\fB\fB/usr/bin/dbus-cleanup-sockets\fR\fR
.in +32n
.rt
Executable for \fBdbus-cleanup-sockets\fR
.sp
.sp 1
.in -32n
.sp
.ne 2
.mk
\fB\fB/tmp\fR\fR
.in +32n
.rt
Default location for D\-Bus connection sockets
.sp
.sp 1
.in -32n
.SH "ATTRIBUTES"
.PP
See
\fBattributes\fR(5)
for descriptions of the following attributes:
.sp
.TS
tab() allbox;
cw(2.750000i)| cw(2.750000i)
lw(2.750000i)| lw(2.750000i).
ATTRIBUTE TYPEATTRIBUTE VALUE
Availabilitysystem/library/dbus
Interface stabilityVolatile
.TE
.sp
.SH "SEE ALSO"
.PP
More information can be found at:
.PP
\fBhttp://www\&.freedesktop\&.org/software/dbus/\fR
.PP
\fBdbus-binding-tool\fR(1),
\fBdbus-daemon\fR(1),
\fBdbus-launch\fR(1),
\fBdbus-monitor\fR(1),
\fBdbus-send\fR(1),
\fBdbus-uuidgen\fR(1),
\fBlibdbus-glib-1\fR(3),
\fBattributes\fR(5)
.SH "NOTES"
.PP
For authorship information refer to
\fBhttp://www\&.freedesktop\&.org/software/dbus/doc/AUTHORS\fR\&.
Updated by Brian Cameron, Sun Microsystems Inc\&., 2007\&.
.PP
\fBdbus-cleanup-sockets\fR was adapted by Havoc Pennington from 
linc-cleanup-sockets written by Michael Meeks\&.  Documentation updated by Brian
Cameron, Sun Microsystems Inc\&., 2007\&.
.PP
Please send bug reports to the D\-Bus mailing list or bug
tracker, see
\fBhttp://www\&.freedesktop\&.org/software/dbus/\fR
...\" created by instant / solbook-to-man, Thu 20 Mar 2014, 02:30
...\" LSARC 2006/368 D-BUS Message Bus System