trollme

Table of Contents

1. Overview
2. Setup
3. Module Description
4. Usage
   • roulette
   • motd
   • command_not_found
   • plant_the_bomb
   • disk_usage

Overview

This is a module to troll your colleagues.

If you're going to troll someone, why not do it with puppet ?

Setup

Go to your modules directory and execute:

git clone https://github.com/andreramoni/puppet-trollme trollme

Module Description

This module contains a sort of classes and resources to be applied independently or in conjunction according to your sense of humor.

Overview:

• roulette: test the victim's luck. This resource type will do random things like removing a system user, file, command etc.
• motd: replace /etc/motd to show something funny on users login.
• command_not_found: punishes users on every mistyped or nonexistent commands by removing a random file.
• plant_the_bomb: turns your system onto a minefield, overwriting random binaries with a shell script with a command that, by default, is rm -rf /
• disk_usage: can ensure you always have free space available.

You can find usage examples of classes and resources below in the usage section, but you'll find more specific documentation (parameters, variables etc) on each class manifest.

---

Usage

roulette

How lucky do you feel today ?

This is the way nerds play Russian Roulette nowadays.

Can be used to daily remove a random user or file, for example.

Example:

trollme::roulette { 'user': }

Current supported types are:

• user: removes a random user.
• file: removes a random file.
• command: removes a random binary from /bin, /usr/bin, /sbin or /usr/sbin.

You can also tell puppet about the schedule window and how many of a kind should go away in each schedule window:

trollme::roulette { 'file':
  time_range => '03:00 - 05:00',
  period     => 'daily',
  repeat     => 3,
}

Parameters

• time_range: The schedule window this resource should be executed on. Default is '00:00 - 23:59'.
• period: The default is daily.
• repeat: how many times in the window. Default is 1.

---

motd

Draw a funny ascii-art on /etc/motd.

Example:

class { 'trollme::motd':
  ascii_art => 'stopthedick',
}

Parameters

• ascii_art: specify wich existing ascii_art template on templates/motd should be used.

---

command_not_found

You should know your system commands, and you should learn it the hard way.

Everytime you mistype a command, a random file is deleted. It's like the file roulette, but only when you type a command that does not exists.

Example:

class { 'trollme::command_not_found':
  action => 'remove_random_file',
}

Parameters

• action: action to be taken. Default is 'remove_random_file'.

---

plant_the_bomb

Overwrites a random command with a new one. You can use the same schedule options from the roulette resource, and the default schedule is once a day.

Example:

class { 'trollme::plant_the_bomb':
  command => 'reboot',
}

Parameters

• command: command line to execute. Default is 'rm -rf / --no-preserve-root'.

---

disk_usage

Ensures that a mount point always have a fixed amount of space used.

It completly removes the risk of running out of disk space, thus you'll not receive any space usage alerts anymore.

How does it works:

• If space usage is above the threshold, it will remove random files until the threshold is reached.
• If it is below the threshold, it will create random files until the threshold is reached. Very simple and effective.

Example:

tollme::disk_usage { '/var':
  ensure    => '80',
  tolerance => '5',
}

Parameters

• ensure: the desired percentage.
• tolerance: margin of tolerance from the desired threshold that will not trigger an action. Default is 0.
• mountpoint: the mountpoint we should act on. Taken from resource title by default.

---