Software

Hted

Tue, 30 Mar 2010 18:58:07 +0200

Hted is a very simple "HTML editor" written in Java in 1998.

Getting it

Via git

You can get the latest version via git:

git clone git://git.schottelius.org/Hted

There is also the usual gitweb interface available.

ccollect

Tue, 30 Mar 2010 18:58:07 +0200

ccollect - (pseudo) incremental backup with different exclude lists using hardlinks and rsync

ccollect backups data from local and remote hosts to your local harddisk. Although ccollect creates full backups, it requires very less space on the backup medium, because ccollect uses hardlinks to create an initial copy of the last backup. Only the inodes used by the hardlinks and the changed files need additional space.

ccollect uses rsync for synchronisation. Since ccollect-0.2 there is asciidoc based documentation included in the distribution (see below). You should also be able to configure ccollect with the help of the example configuration in conf/.

cconf

Sat, 15 May 2010 00:03:13 +0200

cconf is a small and smart build assistant. cconf aims to be a very lightweight and easy to use build assistant (like auto*, but with fun).

how to get it?

git

git-clone http://unix.schottelius.org/git/cLinux/cconf
gitweb

releases

cconf-0.0.2: cconf-0.0.2.tar.lzma cconf-0.0.2.tar.bz2 cconf-0.0.2.tar.gz
cconf-0.0.1: cconf-0.0.1.tar.lzma cconf-0.0.1.tar.bz2 cconf-0.0.1.tar.gz

support

IRC

You can join #cLinux on irc.freenode.org.

cdist - usable configuration management

Fri, 21 Jan 2011 20:10:41 +0100

cdist is a usable configuration management system. It adheres to the KISS principle and is being used in small up to enterprise grade environments. cdist is an alternative to other configuration management systems like bcfg2, chef, cfengine and puppet.

ceof

Mon, 05 Nov 2012 21:08:49 +0100

Introduction

ceof is the implementation and documentation of EOF (Eris Onion Forwarding), the secure, peer-to-peer (p2p), decentralised anonymous chat network.

You can read the bachelor thesis, which describes the motivation and goals or you can view the poster that was used on the presentation.

Get ceof

You can get ceof via git:

git clone git://git.schottelius.org/ceof

Support

There are two IRC (!) channels, in which development takes places:

!eof - German
#cstar - Multi language (German/English)

You can subscribe to the !eof mailinglist. You can also contact me directly.

cinit

Tue, 30 Mar 2010 18:58:07 +0200

cinit is a fast, small and simple init with support for profiles

Introduction

cinit is a fast init system with dependency features and profile support. It was orientated on the design of Richard Goochs need concept and Felix von Leitners minit. Minit does not support real dependencies (you don't know whether the service you depend on really started) and the need concept is somehow slow (as seen in gentoo). In addition, minit needs libowfat and dietlibc, which may not be found on every Unix system.

Cinit main features

portability: it should run on every Unix
true dependencies (soft and hard!)
parallel execution
highly customisable (see conf/*)
profile support (specify what services to start depending on the profile)

Why should I use cinit?

To significantly speedup the startup process
To use highest level of parallelisation at startup
To benefit from real dependencies (so called needs and wants)
To easily create profiles that can be chosen at startup (even before init is started!)

How does cinit work?

Cinit creates a dependency tree at startup and executes the services. A service can have two type of dependencies:

wants describe soft dependencies (i.e. it's not fatal if the wanted service fails to start)
needs describe hard dependencies (if the needed service fails, the depending won't be started)

Let's have a look at an example:

                A
             (wants)
            /       \
 |------> B \        C
 |       /   \      /  \
 ^  (needs)   (needs)   (wants)
 |    D          E        F
 |                        |
 |------<------(needs)----|

Or in words:

B and C do not have dependencies
They will be started at the beginning
A wants B and C
- A waits until B and C are executed and started afterwards, independently of the success of B and C
- A will also be started, if B and C fail to start.
D needs B
D will only be started, if B is successfully started
E needs B and C
E will only be started, if both B and C are successfully started
F wants C and needs B
F will only be started, if B is successfully started
F waits until C is started and is started afterwards

Getting cinit

Development versions

You can get the latest (development) version via git:

git clone git://git.schottelius.org/cLinux/cinit.git

Additionally, the following other git ressources are available:

Documentation

The documentation is currently spread all over the doc/ directory within the tarball and is being cleaned up. Additionally there are two presentations available:

Pre-Configuring

If you want to fine tune cinit parameters, add different path names, change the DESTDIR, ... have a look at conf/*.

Installing cinit

You can install cinit parallel to any other init-system, it won't kill other init's config nor /sbin/init, if it exists:

# make all install

This will create /sbin/cinit. If /sbin/init does not exist, it will be linked to /sbin/cinit.

Configuring cinit

You'll have to configure cinit in /etc/cinit and add services, before you can use it.

Please read doc/configuring.cinit for details. Please read doc/FAO if there are still questions open.

There are some testing examples below doc/examples/, to be used as a starting point.

There are currently no tools to merge your existing init-system to cinit (like sysvinit-merge, bsd-merge or minit-merge) available, but they are in the making (see various bugs in ditz).

Configuring the OS / Kernel

After configuring cinit you need to tell your kernel to boot cinit instead of your current init system. How to do that depends on your system:

Linux/LILO and Linux/yaboot (ppc):
append="init=/sbin/cinit"
grub1 and grub2:
kernel init=/sbin/cinit

Support

IRC

You can join the development IRC channel #cstar on irc.freenode.org.

Mailing list

Bug reports, questions, patches, etc. should be send to the cinit mailing list.

Related websites

creature

Thu, 02 Sep 2010 22:07:00 +0200

creature - manage virtual machines

What's creature?

Easy virtual machine management with support for machines, pools, storages and supervisors. It is intended to be a frontend for different supervisors, but the focus for the initial release is on qemu/kvm.

Requirements

posix shell
the used supervisor

Download

Via git

Clone it via

git clone git://github.com/telmich/creature.git

Or browse on github

ctt - time tracking for geeks

Fri, 12 Oct 2012 21:09:47 +0200

Introduction

Ever wondered how much you work compared to what you should? Are you in the need to record working time for a customer? Do you want something that is very simple, geek compatible and runs on the command line? Then you may have found the right software.

Installation

Get ctt from git (gitweb):

git clone git://git.schottelius.org/ctt

Example usage

# Track some time
% ctt track test
Comment: Did some cool work

# Track for a given time range
% ctt track --sd 2013-04-29-1000 --ed 2013-05-29-1200 test
Comment: Long working period

# Track (keep running), but specify different start date
% ctt track --sd 2013-04-29-0800  test
Comment: Started early today

# Track without prompting for a comment
% ctt track -n test                                       

# List available projects
% ctt listprojects
[...]

# List all entries of this month for project test
% ctt report test
[...]

# List all entries from January
% ctt report --sd 2013-01-01 --ed 2013-01-31 test 

# List all entries from January matching either rails ruby or cdist
% ctt report --sd 2013-01-29 --ed 2013-04-29 -e "(rails|ruby|cdist)" test

# The same, but case insensitive
% ctt report --sd 2013-01-29 --ed 2013-04-29 -e "(rails|ruby|cdist)" -i test

Mirrors

git://github.com/telmich/ctt.git (github)

Support

IRC

You can join the development IRC channel #cstar on irc.freenode.net.

cuni

Mon, 20 Dec 2010 17:08:03 +0100

About

Cuni installs unix network installers. The aim of cuni is to be able to install any unix from any unix via network:

cuni creates a structure usable for PXE-networkbooting and installing

To make use of what cuni provides, you need to run a tftp server to be able to install clients over the network.

Cuni is a very basic infrastructure tool and helps you to setup and upgrade install servers.

Using cuni

Type cuni and read the usage description.

Getting cuni

git clone git://git.schottelius.org/cuni

Using the unix installers

Most unix installers have different semantics for execution. Some of them are able to do automatic installations, some of them even need a hint on what to boot from where.

It is planned to make this information available directly in cuni, but until then, examples on how to use them are provided here:

Debian/Ubuntu

Can be automated using Preseed

Syslinux sample code:

LABEL debian_lenny_amd64
  MENU LABEL Debian Lenny amd64
  KERNEL syslinux/pxechain.com
  APPEND ::debian/amd64/lenny/pxelinux.0

OpenBSD

Syslinux sample code:

# works, needs "openbsd/bsd.rd"
LABEL openbesdtest
   MENU LABEL OpenBSD
   KERNEL syslinux/pxechain.com
   APPEND ::openbsd/pxeboot

Adding a new OS installer

Assume, you want to add support for the installer of OS "kroet", which requires the arguments "version" and "arch".

* Define arguments needed
kroet_args="version arch"

# Add code here, that is executed in the destination directory
cuni_kroet()
{
  # MUST Define ddir: subdirectory which contains the actual installer
  ddir="${arch}/${version}"

  # MUST Define bootfile: file that should be booted
  bootfile="$ddir/pxelinux.0"

  # create os specific directory structure
  # get os specific installer
}

Testing a new OS installer

You can test the new installation with qemu for example:

qemu-kvm -boot n -net nic -net user,hostname=cunitest,tftp=/home/services/tftp/root,bootfile=/pxelinux.0

fui

Tue, 30 Mar 2010 18:58:08 +0200

fui - fancy user interface

What's fui?

Fui is a decentralised crypted chat program user interface. It is the first user interface for ceofhack.

Requirements

ruby
ncurses-ruby
ceofhack

Download

Via git

Clone it via

git clone git://git.schottelius.org/fui

Or browse gitweb.

Releases

Documentation

Usage

ruby main.rb

Commands

text: print text to message window
/quit: exit fui

gpm - general purpose mouse

Tue, 30 Mar 2010 18:58:08 +0200

How to get gpm?

You can browse the static archives or use git:

git clone git://git.schottelius.org/gpm

The archives are mirrored at ar.linux.it, the git repository is mirrored at github.

Support

There is the irc channel #gpm on irc.freenode.org.

The mailing list devoted to gpm is "gpm@lists.linux.it". In order to subscribe to the mailing list, visit lists.linux.it or send a message with "subscribe" in its body to gpm-request@lists.linux.it. For example:

echo subscribe | mail gpm-request@lists.linux.it

Or you can browse the mailing list archive.

gpm2

Fri, 28 May 2010 10:52:05 +0200

You know, gpm is a hack.

The idea of gpm2 is to be a nicer hack:

Support multiple mice
Do not draw stuff, but write gpm2 client to do so (os/terminal specific stuff)
Usable under different OS
Modular design, easy way to add new mice protocols
Allow hotplugging of mice (i.e. gpm2d can run without any mice at startup)

Trying out gpm2

gpm2 is in its early design stage, but can so far display movement of a ps/2 compatible mouse.

git clone git://git.schottelius.org/gpm2
cd gpm2
./gpm2hack.sh /dev/input/mice
# move the mouse
# press enter key to end demonstration

If you do not see mouse movement deltas, either your mouse in connected to a different device or you probably do not have permissions to communicate with it.

Development

Names

gpm2_*: Stuff that may appear in a library
*: Stuff that will only be used in the gpm2 main process

Mouse protocols

Protocols in gpm2 are not part of the main system. Instead, each protocol is implemented in its own binary, which is called from gpm2d.

This prevents to create just another ugly "static" struct array or the need to dlopen() and friends.

Implementing a protocol

If you want to implement a mouse protocol, there are some things to take care of:

You have a free choice of the programming language
gpm2d will exec() gpm2- from its path,
gpm2d will connect stdin stdout of gpm2- to the device file
gpm2d will connect stderr to gpm2d, so gpm2- can send messages
gpm2d can drop priviliges to a specific, non-root user
gpm2d will send SIGTERM to gpm2- to signal normal termination
gpm2- should close the file and exit
gpm2- reports about events via stderr

Reading options from gpm2d

If at some point gpm2d needs to pass protocol options to the protocol handler, they can be found in GPM2_PROTO_OPTS.

Support

IRC

You can join #gpm on irc.freenode.org.

WARNING

Everything below this line are just random thoughts.

Events

Events are produced by the mice handlers and forwarded to gpm2d.

Format

As gpm2 can be used independently of the programming language, no binary data is exchanged. An event always consists of one line (terminated with \n), which contains up to GPM2_LINE_MAX characters (including \n).

Client channel

Clients for gpm2 do not need to be c programs, but can be of any kind. The communication is a simple ASCII stream.

Client connection to gpm2d

Clients need to open /var/run/gpm2/gpm2d.sock to connect to gpm2d.

Event: mouse_event

mouseid ev-type ... (more to follow)

Event: mouse_added

Event: mouse_removed

Control channel

The control channel can be used to change things in gpm2, whereas the client channel is read-only.

Control connection to gpm2d

If you want to control gpm2d, you need to open /var/run/gpm2/gpm2d-control.sock.

Command: mouse_add

Command: mouse_remove

Machine Booking System (mbs)

Sat, 02 Oct 2010 14:14:11 +0200

The machine booking system allows users of the ETH Zurich to book machines. It could be easily adjusted to support other institutions, with or without LDAP authentication.

Screenshots!

Installation

Get mbs

git clone git://git.schottelius.org/mbs

Mirrors (all should be up-to-date):

git://github.com/telmich/mbs.git
git://git.sans.ethz.ch/mbs

Requirements

To get mbs up and running, you need ruby and rails and the gems specified in the Gemfile. You may use rvm to assist you, like the following commandline:

rvm install ruby-1.8.7
rvm ruby-1.8.7
rvm gemset create mbs
rvm ruby-1.8.7@mbs
gem install bundler
cd mbs/
bundle install

Initialise Database

cd mbs
rake db:setup

You can also use

rake bootstrap

to add some example data.

Setup

After mbs is up and running, you need to setup some basic data, before you can actually use it.

Authentication

The authentication part is defined in app/controllers/application_controller.rb and currently bound to Nethz-LDAP-Authentication, but can easily be adopted to other systems.

The nethz method uses the input username and password and binds to ldaps02.ethz.ch (most reliable). If that succeeds, the username is copied into the database, to create an id.

Machines types

mbs is heavily focussed on machine types. So the first thing is to select admin => machine types => new machine type and create a new machine type with a number of associated machines.

Usage

Now you are ready to use mbs!

Bookings

After you are authenticated, you can create bookings, select new booking.

Admin

The admin area is accessable for everybody, because everybody authenticated is trusted. It is reachable below /admin, but not linked, because it may confuse users.

mini-lpd

Fri, 14 May 2010 02:59:40 +0200

A small non-queuing lpd

Introduction

mini-lpd is a small lpd. It does not care about the control file sent, nor does it honour any lpd specific commands, though it will acknowlegde them. It takes a document and puts it on the printer. The client will have to wait until it is printed, as mini-lpd does not have any queue (well, it has, but only to queue tcp/ip connections ;-). mini-lpd should run and compile on every UNIX (Linux, BSD, SunOS, ...) (as of version 0.4).

download

mini-lpd-0.4.tar.bz2 - using poll instead of sigio makes mini-lpd portable
mini-lpd-0.3.tar.bz2 - less debug, some cleanups
mini-lpd-0.2.tar - first working version
mini-lpd-0.1.tar - initial (broken) release

Sexy - the Swiss Army Knife for inventory management

Thu, 11 Oct 2012 17:30:47 +0200

Introduction

Sexy is the Swiss Army Knife for inventory management. It allows you to manage hosts and network with a simple command line interface.

Sexy stores inventory information in a cconfig database and adapts to your environment by supporting custom backends.

In short, sexy can create and remove hosts and configure networks - depending on your backend this means:

sexy manages Virtual Machines
sexy generates IPv4 address allocation (DHCP)
sexy sets up your domain name system (DNS)

Status

The release process for sexy version 2.0 has started and is planned to happen in November 2012.

Installation

Download sexy from git (gitweb):

% git clone git://git.schottelius.org/sexy

Afterwards ensure that the bin directory is in your PATH and that you have python3 installed:

% which python3
/usr/bin/python3
% cd sexy
% export PATH=$PATH:$(pwd -P)/bin

Now you should be able to display the current sexy version:

% sexy -V
sexy 1.9.11-1-g837532c

Mirrors

git://github.com/telmich/sexy.git (github)

Support

IRC

You can join the development IRC channel #cstar on irc.freenode.net.

smtp logger

Tue, 30 Mar 2010 18:58:09 +0200

Introduction

smtp_logger is a logging smtp proxy. It is designed to aid mail server administrators debugging their smtp connections.

How does it work?

   ------------------
   | SMTP Client(s) |
   ------------------
          |   
          | want to connect to smtp-real.example.org
          |   
   ------------------
   | Router/firewall|
   ------------------
          |   
          | redirects data to loghost
          |   
   ------------------
   | loghost        |   
   ------------------
          |   
          | Saves connection data and forwards them
          |   
   ------------------
   | smtp-real      | processes the mail
   ------------------

Have a look at the README file for further instructions.

How to get smtp_logger

Releases

smtp_logger-0.1: the first public release (tar lzma gz bz2)

Development

The latest development code can be found in git. You can view latest changes in gitweb or clone the latest sources using

git clone git://git.schottelius.org/smtp_logger

To submit changes, simply follow the instructions on how to setup a public git repo.

There are also some CIA bot statistics available.

Support

IRC

#cstar - Multi language (German/English)

Mail

You can also contact me directly.

uc - manage a UNIX company

Sat, 16 Apr 2011 12:35:26 +0200

Introduction

uc is a shell orientated management tool for Unix gurus running geeky Unix companies. It is intented to be run by geeks and requires git and shell.

Documentation

Use uc help me.

OS support

cdist should run on any Posix alike OS.

Getting uc

git clone git://git.schottelius.org/uc
cd uc
export PATH=$PATH:$(pwd -P)/bin

Update

To upgrade in the current branch use

git pull

Software

Hted

Getting it

Via git

Archives

ccollect

ccollect - (pseudo) incremental backup with different exclude lists using hardlinks and rsync

cconf

how to get it?

git

releases

support

IRC

cdist - usable configuration management

ceof

Introduction

Get ceof

Support

cinit

Introduction

Cinit main features

Why should I use cinit?

How does cinit work?

Getting cinit

Development versions

Archives

Documentation

Pre-Configuring

Installing cinit

Configuring cinit

Configuring the OS / Kernel

Support

IRC

Mailing list

Related websites

creature

What's creature?

Requirements

Download

Via git

See also

ctt - time tracking for geeks

Introduction

Installation

Example usage

Mirrors

Support

IRC

cuni

About

Using cuni

Getting cuni

Using the unix installers

Debian/Ubuntu

OpenBSD

Adding a new OS installer

Testing a new OS installer

fui

What's fui?

Requirements

Download

Via git

Releases

Documentation

Usage

Commands

See also

gpm - general purpose mouse

How to get gpm?

Support

gpm2

Trying out gpm2

Development

Names

Mouse protocols

Implementing a protocol

Reading options from gpm2d

Support

IRC

WARNING