add swift-oldies man page

Closes-bug: #1607017
Change-Id: I365edf77c5bf34e2e51d7f10c9ea1012c1bda8ed

doc/manpages/swift-oldies.1

@@ -0,0 +1,69 @@
+.\"
+.\" Author: Paul Dardeau <paul.dardeau@intel.com>
+.\" Copyright (c) 2016 OpenStack Foundation.
+.\"
+.\" Licensed under the Apache License, Version 2.0 (the "License");
+.\" you may not use this file except in compliance with the License.
+.\" You may obtain a copy of the License at
+.\"
+.\"    http://www.apache.org/licenses/LICENSE-2.0
+.\"
+.\" Unless required by applicable law or agreed to in writing, software
+.\" distributed under the License is distributed on an "AS IS" BASIS,
+.\" WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
+.\" implied.
+.\" See the License for the specific language governing permissions and
+.\" limitations under the License.
+.\"
+.TH swift-oldies 1 "8/04/2016" "Linux" "OpenStack Swift"
+
+.SH NAME
+.LP
+.B swift-oldies
+\- OpenStack Swift oldies tool
+
+.SH SYNOPSIS
+.LP
+.B swift-oldies
+[-h|--help] [-a|--age]
+
+
+.SH DESCRIPTION
+.PP
+Lists Swift processes that have been running more than a specific length of
+time (in hours). This is done by scanning the list of currently executing
+processes (via ps command) and examining the execution time of those python
+processes whose program names begin with 'swift-'.
+
+Example (see all Swift processes older than two days):
+swift-oldies \-a 48
+
+The options are as follows:
+
+.RS 4
+.PD 0
+.IP "-a HOURS"
+.IP "--age=HOURS"
+.RS 4
+.IP "Look for processes at least HOURS old; default: 720 (30 days)"
+.RE
+.PD 0
+
+.IP "-h"
+.IP "--help"
+.RS 4
+.IP "Display program help and exit"
+.PD
+.RE
+
+
+.SH DOCUMENTATION
+.LP
+More documentation about OpenStack Swift can be found at
+.BI http://swift.openstack.org/index.html
+
+
+.SH "SEE ALSO"
+
+.BR swift-orphans(1)
+