Difference between revisions of "Snoopy"

From ArchWiki
Jump to: navigation, search
(Introduction)
m (Use ip route2 commands.)
(17 intermediate revisions by 7 users not shown)
Line 1: Line 1:
[[Category:HOWTOs (English)]]
+
[[Category:Gaming]]
 
+
Snoopy is a program similar to Warcraft III Banlist, aimed at improving the experience of Warcraft III players on Battle.net. Though focused on hosting, snoopy can be useful for any users as it allows for pinging, location checks, friends list following, and more. Snoopy is a native program built to use with [[WarCraft III]] on [[Wine]].
== Introduction ==
+
Snoopy is a program similar to Warcraft III Banlist, aimed at improving the experience of Warcraft III players on Battle.net. Though focused on hosting, snoopy can be useful for any users as it allows for pinging, location checks, friends list following, and more. Snoopy is a native program built to use with Warcraft III on wine.
+
  
 
== Installation ==
 
== Installation ==
Snoopy can be found in the [http://aur.archlinux.org/packages.php?ID=20199 AUR], or installed with yaourt:
+
Snoopy can be found in the [[AUR]] as package {{AUR|snoopy}}.
yaourt -S snoopy
+
  
 
== Getting Started ==
 
== Getting Started ==
 +
 +
===Snoopy Programs===
 +
 
Snoopy installs three programs in the /usr/bin directory, snoopy-sh, snoopy-ping, and snoopy-nox.  
 
Snoopy installs three programs in the /usr/bin directory, snoopy-sh, snoopy-ping, and snoopy-nox.  
  
 +
*{{Ic|snoopy-sh}} is a not so useful on arch script intended to run snoopy-nox for the current user. Ignore this.
 +
*{{Ic|snoopy-ping}} is a frontend to the ping command that snoopy uses to ping. Feel free to ignore this too.
 +
*{{Ic|snoopy-nox}} is the primary program that snoopy runs. This is all we're really going to worry about.
 +
 +
===Executing Snoopy===
 +
 +
Snoopy can be executed in either of the following ways. The alias approach is a single-user solution, as opposed to the script which will work for all users.
 +
 +
====Snoopy Alias====
 +
A simple way to get snoopy working is to use an alias.
 +
 +
*First edit your .bashrc file, add the following line as a new line with your interface (for example "eth0"):
  
<tt>snoopy-sh</tt> is a not so useful on arch script intended to run snoopy-nox for the current user. Ignore this.
+
{{hc|~/.bashrc|2=
 +
alias snoopy-sh-local='sudo snoopy-nox eth0 `id -u` `id -g`'
 +
}}
  
<tt>snoopy-ping</tt> is a frontend to the ping command that snoopy uses to ping. Feel free to ignore this too.
+
*For this time you have to run
  
<tt>snoopy-nox</tt> is the primary program that snoopy runs. This is all we're really going to worry about.
+
  $ . .bashrc
  
 +
This command re-reads your .bashrc and is afterwards not necessary because your .bashrc is read on every login.
  
The quickest way to get snoopy up and running is to make your own script to run snoopy-nox. It takes three parameters: your network device, your uid, and your gid. These are necessary because snoopy must be ran as root. We'll make a new script. Call it whatever you want. I'll call mine snoopy-sh-local.
+
====Snoopy Script====
 +
You can make your own script to run snoopy-nox. It takes three parameters: your network device, your uid, and your gid. These are necessary because snoopy must be ran as root. We'll make a new script. Call it whatever you want. I'll call mine snoopy-sh-local.
  
  nano /usr/bin/snoopy-sh-local
+
  # nano /usr/bin/snoopy-sh-local
  
If you don't know your network interface run
+
If you do not know your network interface run
  
  ifconfig
+
  # ip a
  
 
to determine what it is. My interface (default ethernet) is eth0.
 
to determine what it is. My interface (default ethernet) is eth0.
  
How you make your script is ultimately up to you. In my example I get the user's uid and gid using <tt>id -u</tt> and <tt>id -g</tt> respectively. I set the interface explicitly, eth0. Sudo is used because snoopy must be run as root. My script looks like this:
+
How you make your script is ultimately up to you. In my example I get the user's uid and gid using {{Ic|id -u}} and {{Ic|id -g}} respectively. I set the interface explicitly, eth0. Sudo is used because snoopy must be run as root. My script looks like this:
  
 
  #!/bin/bash
 
  #!/bin/bash
Line 45: Line 61:
 
  # visudo
 
  # visudo
  
Add a line like the following: %wheel can be replaced with specific usernames if desired, otherwise it'll work for any users in the wheel group.
+
Add a line like the following. %wheel can be replaced with specific usernames if desired, otherwise it'll work for any users in the wheel group.
  
 
  %wheel ALL=NOPASSWD:/usr/bin/snoopy-nox
 
  %wheel ALL=NOPASSWD:/usr/bin/snoopy-nox

Revision as of 01:34, 11 March 2013

Snoopy is a program similar to Warcraft III Banlist, aimed at improving the experience of Warcraft III players on Battle.net. Though focused on hosting, snoopy can be useful for any users as it allows for pinging, location checks, friends list following, and more. Snoopy is a native program built to use with WarCraft III on Wine.

Installation

Snoopy can be found in the AUR as package snoopyAUR.

Getting Started

Snoopy Programs

Snoopy installs three programs in the /usr/bin directory, snoopy-sh, snoopy-ping, and snoopy-nox.

  • snoopy-sh is a not so useful on arch script intended to run snoopy-nox for the current user. Ignore this.
  • snoopy-ping is a frontend to the ping command that snoopy uses to ping. Feel free to ignore this too.
  • snoopy-nox is the primary program that snoopy runs. This is all we're really going to worry about.

Executing Snoopy

Snoopy can be executed in either of the following ways. The alias approach is a single-user solution, as opposed to the script which will work for all users.

Snoopy Alias

A simple way to get snoopy working is to use an alias.

  • First edit your .bashrc file, add the following line as a new line with your interface (for example "eth0"):
~/.bashrc
alias snoopy-sh-local='sudo snoopy-nox eth0 `id -u` `id -g`'
  • For this time you have to run
 $ . .bashrc

This command re-reads your .bashrc and is afterwards not necessary because your .bashrc is read on every login.

Snoopy Script

You can make your own script to run snoopy-nox. It takes three parameters: your network device, your uid, and your gid. These are necessary because snoopy must be ran as root. We'll make a new script. Call it whatever you want. I'll call mine snoopy-sh-local.

# nano /usr/bin/snoopy-sh-local

If you do not know your network interface run

# ip a

to determine what it is. My interface (default ethernet) is eth0.

How you make your script is ultimately up to you. In my example I get the user's uid and gid using id -u and id -g respectively. I set the interface explicitly, eth0. Sudo is used because snoopy must be run as root. My script looks like this:

#!/bin/bash
sudo snoopy-nox eth0 `id -u` `id -g`

When you've finished your simple script make sure it is executable:

# chmod 755 /usr/bin/snoopy-sh-local

That's it. Snoopy should now work properly. It is up to you how you want to run it with regards to Warcraft 3. It shouldn't matter whether you start snoopy before or after Warcraft 3. Perhaps you'll want to change your script to run Warcraft 3 as well after snoopy starts.

Allowing sudo for snoopy

You might want to allow nopassword sudo for snoopy. First, edit the sudo config file

# visudo

Add a line like the following. %wheel can be replaced with specific usernames if desired, otherwise it'll work for any users in the wheel group.

%wheel ALL=NOPASSWD:/usr/bin/snoopy-nox

Additional Resources