diff --git a/doc/manpages/swift-oldies.1 b/doc/manpages/swift-oldies.1 new file mode 100644 index 0000000000..3e74b5d55f --- /dev/null +++ b/doc/manpages/swift-oldies.1 @@ -0,0 +1,69 @@ +.\" +.\" Author: Paul Dardeau +.\" 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) +