[Author Prev][Author Next][Thread Prev][Thread Next][Author Index][Thread Index]
[or-cvs] r23797: {arm} Storing uncompressed man page and compressing them as part o (in arm/trunk: . debian)
Author: atagar
Date: 2010-11-15 03:16:54 +0000 (Mon, 15 Nov 2010)
New Revision: 23797
Added:
arm/trunk/arm.1
Removed:
arm/trunk/debian/arm.1.gz
arm/trunk/debian/manpages
Modified:
arm/trunk/debian/MANIFEST
arm/trunk/debian/make-deb
arm/trunk/setup.py
Log:
Storing uncompressed man page and compressing them as part of the install process.
Added: arm/trunk/arm.1
===================================================================
--- arm/trunk/arm.1 (rev 0)
+++ arm/trunk/arm.1 2010-11-15 03:16:54 UTC (rev 23797)
@@ -0,0 +1,69 @@
+.TH arm 1 "27 August 2010"
+.SH NAME
+arm - Terminal Tor status monitor
+
+.SH SYNOPSIS
+arm [\fIOPTION\fR]
+
+.SH DESCRIPTION
+The anonymizing relay monitor (arm) is a terminal status monitor for Tor
+relays, intended for command-line aficionados, ssh connections, and anyone
+stuck with a tty terminal. This works much like top does for system usage,
+providing real time statistics for:
+ * bandwidth, cpu, and memory usage
+ * relay's current configuration
+ * logged events
+ * connection details (ip, hostname, fingerprint, and consensus data)
+ * etc
+
+Defaults and interface properties are configurable via a user provided
+configuration file (for an example see the provided \fBarmrc.sample\fR).
+Releases and information are available at \fIhttp://www.atagar.com/arm\fR.
+
+.SH OPTIONS
+.TP
+\fB\-i\fR, \fB\-\-interface [ADDRESS:]PORT\fR
+tor control port arm should attach to (default is \fB127.0.0.1:9051\fR)
+
+.TP
+\fB\-c\fR, \fB\-\-config CONFIG_PATH\fR
+user provided configuration file (default is \fB~/.armrc\fR)
+
+.TP
+\fB\-b\fR, \fB\-\-blind\fR
+disable connection lookups (netstat, lsof, and ss), dropping the parts of the
+interface that rely on this information
+
+.TP
+\fB\-e\fR, \fB\-\-event EVENT_FLAGS\fR
+flags for tor, arm, and torctl events to be logged (default is \fBN3\fR)
+
+ d DEBUG a ADDRMAP k DESCCHANGED s STREAM
+ i INFO f AUTHDIR_NEWDESCS g GUARD r STREAM_BW
+ n NOTICE h BUILDTIMEOUT_SET l NEWCONSENSUS t STATUS_CLIENT
+ w WARN b BW m NEWDESC u STATUS_GENERAL
+ e ERR c CIRC p NS v STATUS_SERVER
+ j CLIENTS_SEEN q ORCONN
+ DINWE tor runlevel+ A All Events
+ 12345 arm runlevel+ X No Events
+ 67890 torctl runlevel+ U Unknown Events
+
+.TP
+\fB\-v\fR, \fB\-\-verion\fR
+provides version information
+
+.TP
+\fB\-h\fR, \fB\-\-help\fR
+provides usage information
+
+.SH FILES
+.TP
+\fB/usr/arm/armrc.sample\fR
+example configuration file
+
+.SH AUTHOR
+Written by Damian Johnson (atagar1@xxxxxxxxx)
+
+.SH COPYRIGHT
+GNU GPL version 3, \fIhttp://gnu.org/licenses/gpl.html\fR
+
Modified: arm/trunk/debian/MANIFEST
===================================================================
--- arm/trunk/debian/MANIFEST 2010-11-14 12:49:56 UTC (rev 23796)
+++ arm/trunk/debian/MANIFEST 2010-11-15 03:16:54 UTC (rev 23797)
@@ -2,8 +2,8 @@
setup.cfg
setup.py
arm
+arm.1
armrc.sample
-debian/arm.1.gz
src/__init__.py
src/prereq.py
src/starter.py
Deleted: arm/trunk/debian/arm.1.gz
===================================================================
(Binary files differ)
Modified: arm/trunk/debian/make-deb
===================================================================
--- arm/trunk/debian/make-deb 2010-11-14 12:49:56 UTC (rev 23796)
+++ arm/trunk/debian/make-deb 2010-11-15 03:16:54 UTC (rev 23797)
@@ -1,10 +1,9 @@
#!/bin/sh
cp debian/setup.cfg ./
-cp debian/arm.1.gz ./
debuild -I.svn -i.svn -I.pyc -i.pyc
# cleans up after deb build
-files="build debian/tor-arm debian/python-module-stampdir debian/tor-arm.debhelper.log debian/files debian/tor-arm.substvars setup.cfg arm.1.gz"
+files="build debian/tor-arm debian/python-module-stampdir debian/tor-arm.debhelper.log debian/files debian/tor-arm.substvars setup.cfg"
for i in $files
do
Deleted: arm/trunk/debian/manpages
===================================================================
--- arm/trunk/debian/manpages 2010-11-14 12:49:56 UTC (rev 23796)
+++ arm/trunk/debian/manpages 2010-11-15 03:16:54 UTC (rev 23797)
@@ -1 +0,0 @@
-arm.1.gz
Modified: arm/trunk/setup.py
===================================================================
--- arm/trunk/setup.py 2010-11-14 12:49:56 UTC (rev 23796)
+++ arm/trunk/setup.py 2010-11-15 03:16:54 UTC (rev 23797)
@@ -1,9 +1,28 @@
#!/usr/bin/env python
import os
import sys
+import gzip
from src.version import VERSION
from distutils.core import setup
+# Compresses the man page. This is a temporary file that we'll install. If
+# something goes wrong then we'll print the issue and use the uncompressed man
+# page instead. Build resources are cleaned up by the installion script later.
+try:
+ manInputFile = open('arm.1', 'r')
+ manContents = manInputFile.read()
+ manInputFile.close()
+
+ if not os.path.exists('./build'): os.makedirs('./build')
+ manOutputFile = gzip.open('build/arm.1.gz', 'wb')
+ manOutputFile.write(manContents)
+ manOutputFile.close()
+
+ manFilename = "build/arm.1.gz"
+except IOError, exc:
+ print "Unable to compress man page: %s" % exc
+ manFilename = "arm.1"
+
setup(name='arm',
version=VERSION,
description='Terminal tor status monitor',
@@ -14,8 +33,8 @@
packages=['arm', 'arm.interface', 'arm.interface.graphing', 'arm.util', 'arm.TorCtl'],
package_dir={'arm': 'src'},
data_files=[("/usr/bin", ["arm"]),
- ("/usr/lib/arm", ["src/settings.cfg"]),
- ("/usr/share/man/man1", ["debian/arm.1.gz"])],
+ ("/usr/share/man/man1", [manFilename]),
+ ("/usr/lib/arm", ["src/settings.cfg"])],
)
# Removes the egg_info file. Apparently it is not optional during setup