debian/0000755000000000000000000000000011672046532007174 5ustar debian/copyright0000644000000000000000000000177011672046532011134 0ustar Format-Specification: http://svn.debian.org/wsvn/dep/web/deps/dep5.mdwn?op=file&rev=135 Name: bosh Maintainer: Alex Sisson Source: http://bosh.sourceforge.net/ Files: * Copyright: Copyright 2002-2009, Alex Sisson License: GPL-2+ Files: debian/* Copyright: Copyright 2009-2011, Salvatore Bonaccorso License: GPL-2+ License: GPL-2+ This program is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation; either version 2 of the License, or (at your option) any later version. . This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty or MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details. . On Debian systems the full text of the GNU General Public License can be found in the `/usr/share/common-licenses/GPL-2' file. debian/bosh.examples0000644000000000000000000000004611672046532011667 0ustar configs/bof configs/bops configs/boss debian/watch0000644000000000000000000000006011672046532010221 0ustar version=3 http://sf.net/bosh/bosh-(.*)\.tar\.gz debian/control0000644000000000000000000000153111672046532010577 0ustar Source: bosh Section: utils Priority: optional Maintainer: Salvatore Bonaccorso Build-Depends: debhelper (>= 7), autotools-dev, libncurses5-dev Standards-Version: 3.9.2 Homepage: http://bosh.sourceforge.net/ Package: bosh Architecture: any Depends: ${shlibs:Depends}, ${misc:Depends} Description: browse output of processes bosh stands for browsable output shell. This is a bit of a misnomer because it isn't really a shell. What is does is store the output of a specified program in a buffer, and provides a simple curses interface to browse this buffer. Actions can be configured which can make use of the contents of the currently selected line. . Commands and actions are stored in bosh configuration files. These can include shebang line (#!/usr/bin/bosh) so that the configuration can just be run from the command-line. debian/changelog0000644000000000000000000000470611672046532011055 0ustar bosh (0.6-6) unstable; urgency=low * Update my email address * debian/control: Drop the DM-Upload-Allowed control field. * Add fix-spelling-errors-in-manpage.patch patch. Fix some spelling errors in manpage for bosh. Thanks to A. Costa for the bugreport and the patch. (Closes: #652004) * Update debian/copyright file. Update copyright years for debian/* packaging stanza. * Bump Standards-Version to 3.9.2 * Rename debian/docs file to debian/bosh.docs * Add lintian-overrides for the examples files. Examples files emit a example-unusual-interpreter lintian warning. This is a false-positive in this case as bosh should be used as the interpreter in these examples. -- Salvatore Bonaccorso Wed, 14 Dec 2011 08:09:56 +0100 bosh (0.6-5) unstable; urgency=low * debian/control: Fix long description of package refering to bosh configuration files and fix typo in shebang. Thanks to Davide Prina for spotting this (Closes: #594922). * Bump Standards-Version to 3.9.1 (no changes needed). -- Salvatore Bonaccorso Tue, 31 Aug 2010 10:59:07 +0200 bosh (0.6-4) unstable; urgency=low * Convert to '3.0 (quilt)' package source format. Drop quilt usage in debian/rules and drop Build-Depends on quilt in debian/control. * Refresh debian/copyright to the revision 135 of current poposal for machine readable copyright file in DEP5. * Bump Standards-Version to 3.8.4 (no changes). * Refresh patch headers following DEP3 proposal. * Drop not needed debian/dirs file to create usr/bin directory. -- Salvatore Bonaccorso Sat, 13 Mar 2010 17:15:00 +0100 bosh (0.6-3) unstable; urgency=low * Add patch add-status-bar-description.patch to add a description of the bosh status bar at the bottom (Closes: #531216). * debian/control: Add DM-Upload-Allowed field. -- Salvatore Bonaccorso Sun, 31 May 2009 21:09:29 +0200 bosh (0.6-2) unstable; urgency=low * Do not use wrong absolute path to lsof in example "bops". * debian/rules: Do not set DH_VERBOSE. * debian/rules: simplify makefile using dh tiny makefile. -- Salvatore Bonaccorso Sun, 17 May 2009 12:45:16 +0200 bosh (0.6-1) unstable; urgency=low * Initial release (Closes: #519413) -- Salvatore Bonaccorso Fri, 01 May 2009 14:00:00 +0200 debian/bosh.docs0000644000000000000000000000001411672046532010774 0ustar README TODO debian/README.Debian0000644000000000000000000000126411672046532011240 0ustar bosh for Debian --------------- bosh comes with a few example configurations which can be found under /usr/share/doc/bosh/examples. bops ---- bops uses ps as the main command, and has actions configured for killing the selected process, showing its open files (lsof), and showing its memory map (pmap). bof --- bof uses ls as the main command to list files, and has actions to view and edit the files, and to change directories. This demonstrates the use of the uservars option boss ---- boss shows available init-scripts in /etc/init.d and allows also to stop, start, restart these initscripts. -- Salvatore Bonaccorso Fri, 01 May 2009 13:57:18 +0200 debian/rules0000755000000000000000000000006111672046532010251 0ustar #!/usr/bin/make -f # -*- makefile -*- %: dh $@ debian/source/0000755000000000000000000000000011672046532010474 5ustar debian/source/format0000644000000000000000000000001411672046532011702 0ustar 3.0 (quilt) debian/compat0000644000000000000000000000000211672046532010372 0ustar 7 debian/patches/0000755000000000000000000000000011672046532010623 5ustar debian/patches/series0000644000000000000000000000022111672046532012033 0ustar fix-path-in-example-bops.patch fix-lintian-hyphen-used-as-minus-sign.patch add-status-bar-description.patch fix-spelling-errors-in-manpage.patch debian/patches/fix-spelling-errors-in-manpage.patch0000644000000000000000000000546211672046532017600 0ustar Description: Fix spelling errors in manpage Origin: vendor Bug-Debian: http://bugs.debian.org/652004 Forwarded: yes Author: A. Costa Reviewed-by: Salvatore Bonaccorso Last-Update: 2011-12-14 --- a/bosh.1 +++ b/bosh.1 @@ -22,7 +22,7 @@ Bosh now supports passing arguments to the CONFIGURATION. The arguments will be available in the standard way ($1...$9,$*,$@,etc). -Bosh can be invoked as above, or as "intepreter", meaning it can invoked from +Bosh can be invoked as above, or as "interpreter", meaning it can invoked from a shebang (#!) line at the top of a script. This script would just be a bosh configuration file. See .B bops @@ -51,15 +51,15 @@ .TP .B \-\-multilineseperator=\fISTRING\fP When an action is invoked and the cursor is multi-line, the lines selected will be concatenated together. -With this setting a seperating string can be specified to be inserted between the lines. +With this setting a separating string can be specified to be inserted between the lines. .TP .B \-\-preaction=\fICOMMANDS\fP -A command or commands that will be run on the invokation of all actions, before the action is run. +A command or commands that will be run on the invocation of all actions, before the action is run. This allows code that is a common for the actions to be only defined once. Preactions are simply prefixed onto the action -when the action is invoked. This means you will need to include a seperating character (eg ;) at the end of preaction. +when the action is invoked. This means you will need to include a separating character (eg ;) at the end of preaction. .TP .B \-\-refresh=\fI[0,1]\fP -A value of 1 means that bosh will re-run the command after an action is perfromed. +A value of 1 means that bosh will re-run the command after an action is performed. .TP .B \-\-uservars=\fIN\fP Set the number of user variables ( of the form @@ -84,7 +84,7 @@ .B command=for i in *; do echo $i; done .RE -Or it can spread it over multiple lines for readablity with a \\ (must be at the end of line!) \- +Or it can spread it over multiple lines for readability with a \\ (must be at the end of line!) \- .RS .B @@ -277,7 +277,7 @@ .SH BOSH* VARIABLES: -In addtion to +In addition to .B $BOSH , .B $BOSHPARAM @@ -296,7 +296,7 @@ User variables are variables to be set and used by commands and actions. They are of the form .B $BOSHVARx. When the command or action -is run and sets a user variable, bosh will store the contents when that command or action has finised. +is run and sets a user variable, bosh will store the contents when that command or action has finished. This allows the values to be used by subsequent actions. To make use of these, you must first set the .B uservars to the number you need (eg: uservars=1 will give you BOSHVAR1, uservars=10 will give you debian/patches/fix-lintian-hyphen-used-as-minus-sign.patch0000644000000000000000000001103211672046532021002 0ustar Description: Fix hyphen-used-as-minus-sign lintian warnings for bosh.1 manpage. Forwarded: yes Author: Salvatore Bonaccorso --- a/bosh.1 +++ b/bosh.1 @@ -2,8 +2,7 @@ .\"(C) Alex Sisson, 2008-2009 .TH bosh 1 "18-MAR-2008" bosh-0.6 .SH NAME -.B bosh -(Browsable Output SHell) +.B bosh \- Browsable Output SHell .SH SYNOPSIS .B bosh .I [OPTIONS] [CONFIGURATION] [CONFIGURATION OPTIONS] @@ -73,19 +72,19 @@ .SH CONFIGURATION FILES Bosh configs are fairly simple. Firstly you need a line which tells bosh the -actual program to execute to show it it's buffer - +actual program to execute to show it it's buffer \- .RS .B command=ps x .RE -It could also be a chain of commands (bash) - +It could also be a chain of commands (bash) \- .RS .B command=for i in *; do echo $i; done .RE -Or it can spread it over multiple lines for readablity with a \\ (must be at the end of line!) - +Or it can spread it over multiple lines for readablity with a \\ (must be at the end of line!) \- .RS .B @@ -101,7 +100,7 @@ done .RE -Or now even better, bosh supports blocks delimited by {{ and }} - +Or now even better, bosh supports blocks delimited by {{ and }} \- .RS .B command{{ @@ -125,7 +124,7 @@ These can be used with all options and actions. Command line arguments given to bosh after the COMMAND parameter are available -and can be used as follows - +and can be used as follows \- .RS .B command=ps $* @@ -142,7 +141,7 @@ .RS .B -command=if [ -z "$1" ] \\ +command=if [ \-z "$1" ] \\ .HP .B then \\ @@ -168,7 +167,7 @@ After the command option, you can specify any of the options specified above in the .B OPTIONS -section, but without the -- prefix - +section, but without the \-\- prefix \- .RS .B header=4 @@ -178,7 +177,7 @@ .SH ACTIONS -Basic actions are defined as - +Basic actions are defined as \- .RS .B KEY=command @@ -187,19 +186,19 @@ eg: .RS -.B k=kill $(echo $BOSH | cut -f1 -d' ') +.B k=kill $(echo $BOSH | cut \-f1 \-d' ') .P -.B 9=kill -9 $(echo $BOSH | cut -f1 -d' ') +.B 9=kill \-9 $(echo $BOSH | cut \-f1 \-d' ') .RE -Or, using the preaction setting (see above) - +Or, using the preaction setting (see above) \- .RS -.B preaction=PID=$(echo $BOSH | cut -f1 -d' '); +.B preaction=PID=$(echo $BOSH | cut \-f1 \-d' '); .P .B k=kill $PID .P -.B 9=kill -9 $PID +.B 9=kill \-9 $PID .RE The keys available are a-z,0-9 and enter. Bosh keys are not case sensitive, @@ -215,7 +214,7 @@ .SS ACTIONS WITH OUTPUT For basic actions such as kill, which has no output to stdout, the above definition is sufficient. However, bosh can now intercept the output of actions -and place that in the bosh window. These are defined as follows - +and place that in the bosh window. These are defined as follows \- .RS .B KEY=[.]command @@ -225,20 +224,20 @@ eg: .RS -.B l=[.]/usr/sbin/lsof -p $PID +.B l=[.]/usr/sbin/lsof \-p $PID .RE Assuming the preaction is used above, this action will use lsof to show in bosh a list of files that process $PID has open. In this situation, the output of the original command is lost, and replaced with the output of the action. -Alternatively an action can be defined - +Alternatively an action can be defined \- .RS .B KEY=[>]command .RE In this situation, bosh is like a web browser, in that this output (lsof) will not -override the current buffer, but create a new buffer - You can get then move back and forward +override the current buffer, but create a new buffer \- You can get then move back and forward through these buffers with the left and right arrow keys. At this stage, actions are only available in the original buffer. @@ -263,10 +262,10 @@ .B $BOSHPARAM variable. -eg: Using the ps example above, with PID preaction - +eg: Using the ps example above, with PID preaction \- .RS -.B s=[!:signal] kill -s "$BOSHPARAM" $PID +.B s=[!:signal] kill \-s "$BOSHPARAM" $PID .RE When this action is called, @@ -284,7 +283,7 @@ .B $BOSHPARAM and .B $BOSHERR -(all explained above), the following variables available to actions - +(all explained above), the following variables available to actions \- .TP .B $BOSHPID @@ -314,7 +313,7 @@ the above examples are taken from. The original inspiration for bosh was being able to kill processes easily in this manner. -To run bops, type - +To run bops, type \- .RS .B $ ./bops @@ -322,7 +321,7 @@ This invokes bosh through the shebang at the top (assuming the path is set correctly). -Or to run it the traditional way - +Or to run it the traditional way \- .RS .B $ ./bosh ./bops debian/patches/add-status-bar-description.patch0000644000000000000000000000146211672046532017003 0ustar Description: This patch adds a description of some of the items in the status bar of the package. E.g. exit=0 does not mean, that bosh can be exited with exit=0, instead it means that 0 was the last return value given by the command run in bosh. Bug-Debian: http://bugs.debian.org/531216 Forwarded: yes Author: Salvatore Bonaccorso --- a/bosh.1 +++ b/bosh.1 @@ -378,6 +378,11 @@ .B | same as ^P +.SH STATUS BAR +The status bar contains some further information about the current configuration. It shows +with exit=num the last exit value of a command run in bosh. Furthermore a R indicates that +bosh is running with refresh option activated. In the status bar there will be a countdown +shown if the autorefresh option is set. .SH AUTHOR Alex Sisson (alexsisson@gmail.com) debian/patches/fix-path-in-example-bops.patch0000644000000000000000000000064311672046532016365 0ustar Description: Do not use absolute path to /usr/sbin/lsof in example bops (it is under /usr/bin/lsof on Debian). Forwarded: yes Author: Salvatore Bonaccorso --- a/configs/bops +++ b/configs/bops @@ -25,7 +25,7 @@ 9=[!] kill -9 $PID s=[!:signal] kill -s "$BOSHPARAM" $PID -l=[.] /usr/sbin/lsof -p $PID +l=[.] lsof -p $PID r=[.] chrt -p $PID m=[.] pmap $PID t=[.] pstack $PID debian/bosh.lintian-overrides0000644000000000000000000000041111672046532013503 0ustar # The examples have bosh as the interpreter bosh: example-unusual-interpreter usr/share/doc/bosh/examples/bof #!bosh bosh: example-unusual-interpreter usr/share/doc/bosh/examples/bops #!bosh bosh: example-unusual-interpreter usr/share/doc/bosh/examples/boss #!bosh