| .\" |
| .\" dbus-cleanup-sockets manual page. |
| .\" Copyright (C) 2003 Red Hat, Inc. |
| .\" |
| .TH dbus-cleanup-sockets 1 |
| .SH NAME |
| dbus-cleanup-sockets \- clean up leftover sockets in a directory |
| .SH SYNOPSIS |
| .PP |
| .B dbus-cleanup-sockets [DIRECTORY] |
| |
| .SH DESCRIPTION |
| |
| The \fIdbus-cleanup-sockets\fP command cleans up unused D-Bus |
| connection sockets. See http://www.freedesktop.org/software/dbus/ for |
| more information about the big picture. |
| |
| .PP |
| If given no arguments, \fIdbus-cleanup-sockets\fP cleans up sockets |
| in the standard default socket directory for the |
| per-user-login-session message bus; this is usually /tmp. |
| 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 don't have a |
| corresponding file in /tmp. |
| |
| .PP |
| On most other flavors of UNIX, it's 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 |
| dbus-cleanup-sockets in a cron job to mop up any leaked sockets. |
| Or you can just ignore the leaked sockets, they aren't really hurting |
| anything, other than cluttering the output of "ls /tmp" |
| |
| .SH AUTHOR |
| dbus-cleanup-sockets was adapted by Havoc Pennington from |
| linc-cleanup-sockets written by Michael Meeks. |
| |
| .SH BUGS |
| Please send bug reports to the D-Bus mailing list or bug tracker, |
| see http://www.freedesktop.org/software/dbus/ |
