Compare commits
42 Commits
Author | SHA1 | Date | |
---|---|---|---|
![]() |
39907c79a4 | ||
![]() |
25c000bf98 | ||
![]() |
5bd50577a9 | ||
![]() |
00698e45ea | ||
![]() |
3fab03ea0b | ||
![]() |
36c77931fd | ||
![]() |
acbc72748d | ||
![]() |
2d0480ce81 | ||
![]() |
71c1e50da0 | ||
![]() |
01537d014b | ||
![]() |
cfb3464c6e | ||
![]() |
d9be11ad05 | ||
![]() |
ecf390259c | ||
![]() |
49e239fbb1 | ||
![]() |
a192aa3113 | ||
![]() |
1411224b16 | ||
![]() |
bf06f14188 | ||
![]() |
dfecb5c0f4 | ||
![]() |
b25423f765 | ||
![]() |
51cb204eb2 | ||
![]() |
e32415744c | ||
![]() |
25ee995ead | ||
![]() |
804cb72666 | ||
![]() |
9288de6126 | ||
![]() |
95963c46eb | ||
![]() |
fd867aebd1 | ||
![]() |
31b2445000 | ||
![]() |
0fedff44e3 | ||
![]() |
bb1e5569d0 | ||
![]() |
704ab925e9 | ||
![]() |
714bd0cb6a | ||
![]() |
f8f3a096bc | ||
![]() |
584290f264 | ||
![]() |
a4434536cd | ||
![]() |
18580a159f | ||
![]() |
f79e2f0953 | ||
![]() |
165638e3c8 | ||
![]() |
1bc3e103c0 | ||
![]() |
29ff454e80 | ||
![]() |
63b5736e6e | ||
![]() |
41ce43bf8c | ||
![]() |
28feb9a40e |
3
.gitignore
vendored
Normal file
3
.gitignore
vendored
Normal file
|
@ -0,0 +1,3 @@
|
||||||
|
ii
|
||||||
|
*.a
|
||||||
|
*.o
|
10
.hgtags
10
.hgtags
|
@ -1,10 +0,0 @@
|
||||||
0391602b2f06e0c7e89b7328719bec5695f57d9c ii-1.2
|
|
||||||
daf8fc17d14014f312721c1d56ffa049392393fc ii-1.2
|
|
||||||
987fc9d57808948b4bcf626b096c9c60226455d3 ii-1.3
|
|
||||||
7c7c000b4f42a48676e8f98a953a981bf6b29029 1.4
|
|
||||||
4c6892284a9ae73de3c84c164e214d31e76427a4 1.5
|
|
||||||
4c6892284a9ae73de3c84c164e214d31e76427a4 1.5
|
|
||||||
6f504f412a5997158b651eac8785f8331408b2e5 1.5
|
|
||||||
6f504f412a5997158b651eac8785f8331408b2e5 1.5
|
|
||||||
550ee110071903b9676d848d8947e96e02a8a662 1.5
|
|
||||||
f09f802a80379d24194535c7991182ceeb9291af 1.6
|
|
42
CHANGES
42
CHANGES
|
@ -1,42 +0,0 @@
|
||||||
1.7 (2013-01-05)
|
|
||||||
- -k now specifies an environment variable that contains the
|
|
||||||
server key. This behaviour has been changed in order to not
|
|
||||||
expose the password in the process list.
|
|
||||||
- Fix parsing of JOIN messages for certain servers.
|
|
||||||
Thanks Ivan Kanakarakis!
|
|
||||||
- Use , rather than _ for slash characters in channel names.
|
|
||||||
As per RFC , is not allowed in a channel name, while _ is.
|
|
||||||
Thanks plomplomplom and Nils Dagsson Moskopp!
|
|
||||||
|
|
||||||
1.6 (2011-01-31):
|
|
||||||
- fix regression introduced for handling unknown commands
|
|
||||||
|
|
||||||
1.5 (2011-01-24):
|
|
||||||
- fix channel name comparison in add_channel(), compare lowercase
|
|
||||||
to prevent leaking file descriptors in the long run => Thanks samurai!
|
|
||||||
- only handle commands ii explicitely understands and treat the rest
|
|
||||||
as raw irc (only worked for raw commands in capital lettersin the past) => Thanks samurai!
|
|
||||||
- create in FIFO on receiving a privmsg directly instead of requiring a new
|
|
||||||
/j command first => Thanks Evan Gates
|
|
||||||
this also implies that in FIFOs aren't deleted on channel leaves any longer because
|
|
||||||
this itself creates a channel event again which in turn would recreate the file
|
|
||||||
- minor changes
|
|
||||||
|
|
||||||
1.4 (2008-08-09):
|
|
||||||
- fix directory traversal on servers that support SAJOIN
|
|
||||||
NOTE: not marking as security relevant as it is only possible to
|
|
||||||
create directories outside (which is of course annoying) of the irc
|
|
||||||
hierarchy but not overwriting arbitrary files with the channel name.
|
|
||||||
- documentation fixes
|
|
||||||
- general cleanup
|
|
||||||
|
|
||||||
1.3 (2007-07-14):
|
|
||||||
- server messages about users (QUIT,JOIN) will no longer
|
|
||||||
go to the user directories but to the server out file to
|
|
||||||
give an easy method to monitor it and to prevent spamming
|
|
||||||
the irc directory.
|
|
||||||
|
|
||||||
1.2 (2007-06-23):
|
|
||||||
- Exit on channel creation failure, thanks Michael Prokop
|
|
||||||
- Implemented joining of password protected channels
|
|
||||||
- Removed -v option from the manpage since it's not implemented
|
|
19
FAQ
19
FAQ
|
@ -6,6 +6,7 @@ Where is IRC command xy (ignore etc.)?
|
||||||
ii is for advanced users, please use standard tools like awk, sed and grep for
|
ii is for advanced users, please use standard tools like awk, sed and grep for
|
||||||
this. This can be done easily and will not bloat the code.
|
this. This can be done easily and will not bloat the code.
|
||||||
|
|
||||||
|
|
||||||
Where is a graphical interface?
|
Where is a graphical interface?
|
||||||
-------------------------------
|
-------------------------------
|
||||||
Basically ii follows the UNIX philosophy so it is only file based. But it
|
Basically ii follows the UNIX philosophy so it is only file based. But it
|
||||||
|
@ -14,12 +15,14 @@ the FIFOs and output files. Feel free to implement or wait until we have done
|
||||||
this. Actually I use ii in combination with vim, multitail and screen and it works
|
this. Actually I use ii in combination with vim, multitail and screen and it works
|
||||||
like a charm.
|
like a charm.
|
||||||
|
|
||||||
|
|
||||||
Which commands are supported?
|
Which commands are supported?
|
||||||
-----------------------------
|
-----------------------------
|
||||||
j (join or msg), t (topic), a (away), n (nick), l (leave). The missing are
|
j (join or msg), t (topic), a (away), n (nick), l (leave). The missing are
|
||||||
obsolete or can be easily used by typing the IRC commands itself (i.e. /WHO
|
obsolete or can be easily used by typing the IRC commands itself (i.e. /WHO
|
||||||
instead of /who).
|
instead of /who).
|
||||||
|
|
||||||
|
|
||||||
How can I recognize queries?
|
How can I recognize queries?
|
||||||
----------------------------
|
----------------------------
|
||||||
ii itself doesn't support this but the queries.sh script is an example
|
ii itself doesn't support this but the queries.sh script is an example
|
||||||
|
@ -28,9 +31,23 @@ To get an instant notice of a new file other mechanisms like inotify/dnotify
|
||||||
could be used as well but I was too lazy to try it out since the script
|
could be used as well but I was too lazy to try it out since the script
|
||||||
is enough for me.
|
is enough for me.
|
||||||
|
|
||||||
|
|
||||||
What other fancy stuff can I do with ii?
|
What other fancy stuff can I do with ii?
|
||||||
----------------------------------------
|
----------------------------------------
|
||||||
It is very easy to write irc bots in ii:
|
It is very easy to write irc bots in ii:
|
||||||
tail -f \#/out | while read foo; do name=echo $foo | awk '{print $2}' | sed 's,<\\(.*\\)>,\\1,'; if 0 -eq expr $RANDOM % 10 then echo "$name: WHAT??" ; fi; done
|
|
||||||
|
#!/bin/sh
|
||||||
|
chan="#yourchannel"
|
||||||
|
tail -f "${chan}/out" | while read -r line; do
|
||||||
|
cmd=$(printf '%s\n' "$line" | cut -d ' ' -f 4-)
|
||||||
|
name=$(printf '%s\n' "$line" | cut -d ' ' -f 3 | tr -d '<>')
|
||||||
|
if [ "$cmd" = "!rand" ]; then
|
||||||
|
r="$RANDOM"
|
||||||
|
if expr "$r" "%" "10"; then
|
||||||
|
echo "$name: $r" >> "${chan}/in"
|
||||||
|
fi
|
||||||
|
fi
|
||||||
|
done
|
||||||
|
|
||||||
This will just spam a channel but think about using nagios2irc or you can
|
This will just spam a channel but think about using nagios2irc or you can
|
||||||
use ii to generate channel stats. Your imagination should be boundless.
|
use ii to generate channel stats. Your imagination should be boundless.
|
||||||
|
|
5
LICENSE
5
LICENSE
|
@ -1,7 +1,8 @@
|
||||||
MIT/X Consortium License
|
MIT/X Consortium License
|
||||||
|
|
||||||
(C)opyright MMV-MMVI Anselm R. Garbe <garbeam@wmii.de>
|
(C)opyright 2014-2022 Hiltjo Posthuma <hiltjo at codemadness dot org>
|
||||||
(C)opyright MMV-MMVIII Nico Golde <nico at ngolde dot de>
|
(C)opyright 2005-2006 Anselm R. Garbe <garbeam@wmii.de>
|
||||||
|
(C)opyright 2005-2011 Nico Golde <nico at ngolde dot de>
|
||||||
|
|
||||||
Permission is hereby granted, free of charge, to any person obtaining a
|
Permission is hereby granted, free of charge, to any person obtaining a
|
||||||
copy of this software and associated documentation files (the "Software"),
|
copy of this software and associated documentation files (the "Software"),
|
||||||
|
|
83
Makefile
83
Makefile
|
@ -1,55 +1,60 @@
|
||||||
# ii - irc it - simple but flexible IRC client
|
.POSIX:
|
||||||
# (C)opyright MMV-MMVI Anselm R. Garbe
|
|
||||||
# (C)opyright MMV-MMVII Anselm R. Garbe, Nico Golde
|
|
||||||
|
|
||||||
include config.mk
|
VERSION = 1.9
|
||||||
|
|
||||||
SRC = ii.c
|
# paths
|
||||||
OBJ = ${SRC:.c=.o}
|
PREFIX = /usr/local
|
||||||
|
MANPREFIX = $(PREFIX)/share/man
|
||||||
|
DOCPREFIX = $(PREFIX)/share/doc
|
||||||
|
|
||||||
all: options ii
|
SRC = ii.c
|
||||||
@echo built ii
|
OBJ = $(SRC:.c=.o)
|
||||||
|
|
||||||
|
# use system flags.
|
||||||
|
II_CFLAGS = $(CFLAGS)
|
||||||
|
II_LDFLAGS = $(LDFLAGS)
|
||||||
|
|
||||||
|
# on systems which provide strlcpy(3),
|
||||||
|
# remove NEED_STRLCPY from CPPFLAGS and
|
||||||
|
# remove strlcpy.o from LIBS
|
||||||
|
II_CPPFLAGS = $(CPPFLAGS) -DVERSION=\"$(VERSION)\" -D_DEFAULT_SOURCE -DNEED_STRLCPY
|
||||||
|
LIBS = strlcpy.o
|
||||||
|
|
||||||
|
all: ii
|
||||||
|
|
||||||
options:
|
options:
|
||||||
@echo ii build options:
|
@echo ii build options:
|
||||||
@echo "LIBS = ${LIBS}"
|
@echo "CFLAGS = $(CFLAGS)"
|
||||||
@echo "INCLUDES = ${INCLUDES}"
|
@echo "LDFLAGS = $(LDFLAGS)"
|
||||||
@echo "CFLAGS = ${CFLAGS}"
|
@echo "CC = $(CC)"
|
||||||
@echo "LDFLAGS = ${LDFLAGS}"
|
|
||||||
@echo "CC = ${CC}"
|
|
||||||
|
|
||||||
.c.o:
|
.c.o:
|
||||||
@echo CC $<
|
$(CC) -c $< $(II_CFLAGS) $(II_CPPFLAGS)
|
||||||
@${CC} -c ${CFLAGS} $<
|
|
||||||
|
|
||||||
dist: clean
|
ii: $(OBJ) $(LIBS)
|
||||||
@mkdir -p ii-${VERSION}
|
$(CC) -o $@ $(OBJ) $(LIBS) $(II_LDFLAGS)
|
||||||
@cp -R query.sh Makefile CHANGES README FAQ LICENSE config.mk ii.c ii.1 ii-${VERSION}
|
|
||||||
@tar -cf ii-${VERSION}.tar ii-${VERSION}
|
|
||||||
@gzip ii-${VERSION}.tar
|
|
||||||
@rm -rf ii-${VERSION}
|
|
||||||
@echo created distribution ii-${VERSION}.tar.gz
|
|
||||||
|
|
||||||
ii: ${OBJ}
|
$(OBJ): arg.h
|
||||||
@echo LD $@
|
|
||||||
@${CC} -o $@ ${OBJ} ${LDFLAGS}
|
|
||||||
|
|
||||||
install: all
|
install: all
|
||||||
@mkdir -p ${DESTDIR}${DOCDIR}
|
mkdir -p $(DESTDIR)$(PREFIX)/bin
|
||||||
@mkdir -p ${DESTDIR}${BINDIR}
|
mkdir -p $(DESTDIR)$(MANPREFIX)/man1
|
||||||
@mkdir -p ${DESTDIR}${MAN1DIR}
|
mkdir -p $(DESTDIR)$(DOCPREFIX)/ii
|
||||||
|
install -m 644 README FAQ LICENSE $(DESTDIR)$(DOCPREFIX)/ii
|
||||||
@install -d ${DESTDIR}${BINDIR} ${DESTDIR}${MAN1DIR}
|
install -m 775 ii $(DESTDIR)$(PREFIX)/bin
|
||||||
@install -m 644 CHANGES README query.sh FAQ LICENSE ${DESTDIR}${DOCDIR}
|
sed "s/VERSION/$(VERSION)/g" < ii.1 > $(DESTDIR)$(MANPREFIX)/man1/ii.1
|
||||||
@install -m 775 ii ${DESTDIR}${BINDIR}
|
chmod 644 $(DESTDIR)$(MANPREFIX)/man1/ii.1
|
||||||
@install -m 444 ii.1 ${DESTDIR}${MAN1DIR}
|
|
||||||
@echo "installed ii"
|
|
||||||
|
|
||||||
uninstall: all
|
uninstall: all
|
||||||
@rm -f ${DESTDIR}${MAN1DIR}/ii.1
|
rm -f $(DESTDIR)$(MANPREFIX)/man1/ii.1 $(DESTDIR)$(PREFIX)/bin/ii
|
||||||
@rm -rf ${DESTDIR}${DOCDIR}
|
rm -rf $(DESTDIR)$(DOCPREFIX)/ii
|
||||||
@rm -f ${DESTDIR}${BINDIR}/ii
|
|
||||||
@echo "uninstalled ii"
|
dist: clean
|
||||||
|
mkdir -p ii-$(VERSION)
|
||||||
|
cp -R Makefile README FAQ LICENSE strlcpy.c arg.h \
|
||||||
|
ii.c ii.1 ii-$(VERSION)
|
||||||
|
tar -cf - ii-$(VERSION) | gzip -c > ii-$(VERSION).tar.gz
|
||||||
|
rm -rf ii-$(VERSION)
|
||||||
|
|
||||||
clean:
|
clean:
|
||||||
rm -f ii *~ *.o *core *.tar.gz
|
rm -f ii *.o
|
||||||
|
|
53
README
53
README
|
@ -1,8 +1,8 @@
|
||||||
Abstract
|
Abstract
|
||||||
--------
|
--------
|
||||||
ii is a minimalistic FIFO and filesystem based IRC client. It creates an irc
|
ii is a minimalistic FIFO and filesystem based IRC client. It creates an irc
|
||||||
directory tree with server, channel and nick name directories. In every
|
directory tree with server, channel and nick name directories. In every
|
||||||
directory a FIFO file (in) and and normal file (out) is placed.
|
directory a FIFO file (in) and normal file (out) is placed.
|
||||||
|
|
||||||
The in file is used to communicate with the servers and the out files include
|
The in file is used to communicate with the servers and the out files include
|
||||||
the server messages. For every channel and every nick name there will be new in
|
the server messages. For every channel and every nick name there will be new in
|
||||||
|
@ -13,6 +13,7 @@ standard command line tools. For example if you want to join a channel just do
|
||||||
echo "/j #channel" > in and ii creates a new channel directory with in and out
|
echo "/j #channel" > in and ii creates a new channel directory with in and out
|
||||||
file.
|
file.
|
||||||
|
|
||||||
|
|
||||||
Installation
|
Installation
|
||||||
------------
|
------------
|
||||||
Edit config.mk to match your local setup. ii is installed into
|
Edit config.mk to match your local setup. ii is installed into
|
||||||
|
@ -23,6 +24,7 @@ necessary as root):
|
||||||
|
|
||||||
$ make clean install
|
$ make clean install
|
||||||
|
|
||||||
|
|
||||||
Running ii
|
Running ii
|
||||||
------------
|
------------
|
||||||
Simply invoke the 'ii' command with required arguments
|
Simply invoke the 'ii' command with required arguments
|
||||||
|
@ -41,19 +43,50 @@ Thanks to Matthias Kopfermann for this hint.
|
||||||
You can find an example of how this nested environment could look like on:
|
You can find an example of how this nested environment could look like on:
|
||||||
http://nion.modprobe.de/blog/archives/440-Using-the-ii-irc-client.html
|
http://nion.modprobe.de/blog/archives/440-Using-the-ii-irc-client.html
|
||||||
|
|
||||||
|
|
||||||
|
SSL/TLS support
|
||||||
|
---------------
|
||||||
|
|
||||||
|
Below is an example using OpenBSD relayd which sets up a TCP TLS relay
|
||||||
|
connection on localhost. A similar setup can be accomplished using
|
||||||
|
stunnel or netcat with TLS support. This also works for other programs
|
||||||
|
that don't support TLS natively.
|
||||||
|
|
||||||
|
/etc/relayd.conf:
|
||||||
|
|
||||||
|
table <freenode> { irc.freenode.net }
|
||||||
|
table <oftc> { irc.oftc.net }
|
||||||
|
|
||||||
|
protocol "irctls" {
|
||||||
|
tcp { nodelay, sack }
|
||||||
|
}
|
||||||
|
|
||||||
|
relay "freenode" {
|
||||||
|
listen on 127.0.0.1 port 6668
|
||||||
|
protocol "irctls"
|
||||||
|
forward with tls to <freenode> port 6697
|
||||||
|
}
|
||||||
|
|
||||||
|
relay "oftc" {
|
||||||
|
listen on 127.0.0.1 port 6669
|
||||||
|
protocol "irctls"
|
||||||
|
forward with tls to <oftc> port 6697
|
||||||
|
}
|
||||||
|
|
||||||
|
|
||||||
|
Then connect:
|
||||||
|
|
||||||
|
./irc -n nick -u name -s 127.0.0.1 -p 6668
|
||||||
|
./irc -n nick -u name -s 127.0.0.1 -p 6669
|
||||||
|
|
||||||
|
|
||||||
Configuration
|
Configuration
|
||||||
-------------
|
-------------
|
||||||
No configuration is needed.
|
No configuration is needed.
|
||||||
|
|
||||||
|
|
||||||
Changelog
|
Changelog
|
||||||
---------
|
---------
|
||||||
Since I missed the chance to add a proper changelog right from the beginning,
|
Since I missed the chance to add a proper changelog right from the beginning,
|
||||||
please have a look at the commit messages on http://code.suckless.org/hg/ii/
|
please have a look at the commit messages on http://git.suckless.org/ii/
|
||||||
they are fairly descriptive on releases prior to 1.2.
|
they are fairly descriptive on releases prior to 1.2.
|
||||||
|
|
||||||
Contact
|
|
||||||
-------
|
|
||||||
If you want to contact the developers just write a mail to
|
|
||||||
ii (at) modprobe (dot) de
|
|
||||||
|
|
||||||
-- Nico Golde, Anselm R. Garbe
|
|
||||||
|
|
50
arg.h
Normal file
50
arg.h
Normal file
|
@ -0,0 +1,50 @@
|
||||||
|
/*
|
||||||
|
* Copy me if you can.
|
||||||
|
* by 20h
|
||||||
|
*/
|
||||||
|
|
||||||
|
#ifndef ARG_H__
|
||||||
|
#define ARG_H__
|
||||||
|
|
||||||
|
extern char *argv0;
|
||||||
|
|
||||||
|
/* use main(int argc, char *argv[]) */
|
||||||
|
#define ARGBEGIN for (argv0 = *argv, argv++, argc--;\
|
||||||
|
argv[0] && argv[0][0] == '-'\
|
||||||
|
&& argv[0][1];\
|
||||||
|
argc--, argv++) {\
|
||||||
|
char argc_;\
|
||||||
|
char **argv_;\
|
||||||
|
int brk_;\
|
||||||
|
if (argv[0][1] == '-' && argv[0][2] == '\0') {\
|
||||||
|
argv++;\
|
||||||
|
argc--;\
|
||||||
|
break;\
|
||||||
|
}\
|
||||||
|
int i_;\
|
||||||
|
for (i_ = 1, brk_ = 0, argv_ = argv;\
|
||||||
|
argv[0][i_] && !brk_;\
|
||||||
|
i_++) {\
|
||||||
|
if (argv_ != argv)\
|
||||||
|
break;\
|
||||||
|
argc_ = argv[0][i_];\
|
||||||
|
switch (argc_)
|
||||||
|
|
||||||
|
#define ARGEND }\
|
||||||
|
}
|
||||||
|
|
||||||
|
#define ARGC() argc_
|
||||||
|
|
||||||
|
#define EARGF(x) ((argv[0][i_+1] == '\0' && argv[1] == NULL)?\
|
||||||
|
((x), abort(), (char *)0) :\
|
||||||
|
(brk_ = 1, (argv[0][i_+1] != '\0')?\
|
||||||
|
(&argv[0][i_+1]) :\
|
||||||
|
(argc--, argv++, argv[0])))
|
||||||
|
|
||||||
|
#define ARGF() ((argv[0][i_+1] == '\0' && argv[1] == NULL)?\
|
||||||
|
(char *)0 :\
|
||||||
|
(brk_ = 1, (argv[0][i_+1] != '\0')?\
|
||||||
|
(&argv[0][i_+1]) :\
|
||||||
|
(argc--, argv++, argv[0])))
|
||||||
|
|
||||||
|
#endif
|
27
config.mk
27
config.mk
|
@ -1,27 +0,0 @@
|
||||||
# Customize to fit your system
|
|
||||||
|
|
||||||
# paths
|
|
||||||
PREFIX = /usr/local
|
|
||||||
BINDIR = ${PREFIX}/bin
|
|
||||||
MANDIR = ${PREFIX}/share/man
|
|
||||||
MAN1DIR = ${MANDIR}/man1
|
|
||||||
DOCDIR = ${PREFIX}/share/doc/ii
|
|
||||||
|
|
||||||
# Set the following to install to a different root
|
|
||||||
DESTDIR =
|
|
||||||
|
|
||||||
INCDIR = ${PREFIX}/include
|
|
||||||
LIBDIR = ${PREFIX}/lib
|
|
||||||
VERSION = 1.7
|
|
||||||
|
|
||||||
# includes and libs
|
|
||||||
INCLUDES = -I. -I${INCDIR} -I/usr/include
|
|
||||||
LIBS = -L${LIBDIR} -L/usr/lib -lc
|
|
||||||
# uncomment and comment other variables for compiling on Solaris
|
|
||||||
#LIBS = -L${LIBDIR} -L/usr/lib -lc -lsocket -lnsl
|
|
||||||
#CFLAGS = -g ${INCLUDES} -DVERSION=\"${VERSION}\"
|
|
||||||
|
|
||||||
# compiler
|
|
||||||
CC = cc
|
|
||||||
CFLAGS = -g -O0 -W -Wall ${INCLUDES} -DVERSION=\"${VERSION}\"
|
|
||||||
LDFLAGS = ${LIBS}
|
|
136
ii.1
136
ii.1
|
@ -1,16 +1,29 @@
|
||||||
.de FN
|
.TH II 1 ii-VERSION
|
||||||
\fI\|\\$1\|\fP\\$2
|
|
||||||
..
|
|
||||||
.TH ii 1
|
|
||||||
.SH NAME
|
.SH NAME
|
||||||
ii \- irc it or irc improved
|
ii - irc it or irc improved
|
||||||
|
.SH SYNOPSIS
|
||||||
|
.B ii
|
||||||
|
.B -s
|
||||||
|
.I host
|
||||||
|
.RB [ -p
|
||||||
|
.I port
|
||||||
|
|
|
||||||
|
.B -u
|
||||||
|
.IR sockname ]
|
||||||
|
.RB [ -i
|
||||||
|
.IR ircdir ]
|
||||||
|
.RB [ -n
|
||||||
|
.IR nickname ]
|
||||||
|
.RB [ -f
|
||||||
|
.IR realname ]
|
||||||
|
.RB [ -k
|
||||||
|
.IR env_pass ]
|
||||||
.SH DESCRIPTION
|
.SH DESCRIPTION
|
||||||
.B ii
|
.B ii
|
||||||
is a minimalistic FIFO and filesystem based IRC client.
|
is a minimalistic FIFO and filesystem based IRC client.
|
||||||
It creates an irc directory tree with server, channel and
|
It creates an irc directory tree with server, channel and
|
||||||
nick name directories.
|
nick name directories.
|
||||||
In every directory a FIFO file (in) and and normal file (out)
|
In every directory a FIFO file (in) and normal file (out)
|
||||||
is placed. This will be for example ~/irc/irc.freenode.net/.
|
is placed. This will be for example ~/irc/irc.freenode.net/.
|
||||||
The in file is used to communicate with the servers and the out
|
The in file is used to communicate with the servers and the out
|
||||||
files includes the server messages. For every channel and every nick
|
files includes the server messages. For every channel and every nick
|
||||||
|
@ -19,79 +32,90 @@ The basic idea of this is to be able to communicate with an IRC
|
||||||
server with basic command line tools.
|
server with basic command line tools.
|
||||||
For example if you will join a channel just do echo "/j #channel" > in
|
For example if you will join a channel just do echo "/j #channel" > in
|
||||||
and ii creates a new channel directory with in and out file.
|
and ii creates a new channel directory with in and out file.
|
||||||
.SH SYNOPSIS
|
|
||||||
.B ii
|
|
||||||
.RB [ \-s
|
|
||||||
.IR servername ]
|
|
||||||
.RB [ \-p
|
|
||||||
.IR port ]
|
|
||||||
.RB [ \-k
|
|
||||||
.IR environment variable ]
|
|
||||||
.RB [ \-i
|
|
||||||
.IR prefix ]
|
|
||||||
.RB [ \-n
|
|
||||||
.IR nickname ]
|
|
||||||
.RB [ \-f
|
|
||||||
.IR realname ]
|
|
||||||
|
|
||||||
.SH OPTIONS
|
.SH OPTIONS
|
||||||
.TP
|
.TP
|
||||||
.BI \-s " servername"
|
.BI -s " host"
|
||||||
lets you override the default servername (irc.freenode.net)
|
server/host to connect to, for example: irc.freenode.net
|
||||||
.TP
|
.TP
|
||||||
.BI \-p " port"
|
.BI -p " port"
|
||||||
lets you override the default port (6667)
|
lets you override the default port (6667)
|
||||||
.TP
|
.TP
|
||||||
.BI \-k " environment variable"
|
.BI -u " sockname"
|
||||||
lets you specify an environment variable that contains your IRC password, e.g. IIPASS="foobar" ii -k FOOBAR.
|
connect to a UNIX domain socket instead of directly to a server.
|
||||||
This is done in order to prevent other users from eavesdropping the server password via the process list.
|
If set, the
|
||||||
|
.B -p
|
||||||
|
option will be ignored.
|
||||||
.TP
|
.TP
|
||||||
.BI \-i " prefix"
|
.BI -i " ircdir"
|
||||||
lets you override the default irc path (~/irc)
|
lets you override the default irc path (~/irc)
|
||||||
.TP
|
.TP
|
||||||
.BI \-n " nickname"
|
.BI -n " nickname"
|
||||||
lets you override the default nick ($USER)
|
lets you override the default nick ($USER)
|
||||||
.TP
|
.TP
|
||||||
.BI \-f " realname"
|
.BI -f " realname"
|
||||||
lets you specify your real name associated with your nick
|
lets you specify your real name associated with your nick
|
||||||
|
.TP
|
||||||
|
.BI -k " env_pass"
|
||||||
|
lets you specify an environment variable that contains your IRC password,
|
||||||
|
e.g. IIPASS="foobar" ii -k IIPASS.
|
||||||
|
This is done in order to prevent other users from eavesdropping the server
|
||||||
|
password via the process list.
|
||||||
.SH DIRECTORIES
|
.SH DIRECTORIES
|
||||||
.TP
|
.TP
|
||||||
.FN ~/irc
|
.B ~/irc
|
||||||
In this directory the irc tree will be created. In this directory you
|
In this directory the irc tree will be created. In this directory you
|
||||||
will find a directory for your server (default: irc.freenode.net) in
|
will find a directory for your server (default: irc.freenode.net) in
|
||||||
which the FIFO and the output file will be stored.
|
which the FIFO and the output file will be stored.
|
||||||
If you join a channel a new directory with the name of the channel
|
If you join a channel a new directory with the name of the channel
|
||||||
will be created in the ~/irc/$servername/ directory.
|
will be created in the
|
||||||
|
.BI ~/irc/ servername /
|
||||||
|
directory.
|
||||||
.SH COMMANDS
|
.SH COMMANDS
|
||||||
.TP
|
.TP
|
||||||
.FN /a " [<message>]"
|
.BI /a " [message]"
|
||||||
mark yourself as away
|
mark yourself as away,
|
||||||
|
with the optional
|
||||||
|
.I message
|
||||||
|
as an away reason.
|
||||||
.TP
|
.TP
|
||||||
.FN /j " #channel/nickname [<message>]"
|
.BI /j " #channel [password]"
|
||||||
join a channel or open private conversation with user
|
join a
|
||||||
|
.IR #channel ,
|
||||||
|
with the optional
|
||||||
|
.IR password .
|
||||||
.TP
|
.TP
|
||||||
.FN /l " #channel/nickname"
|
.BI /j " nickname [message]"
|
||||||
leave a channel or query
|
open private conversation with user
|
||||||
|
.I nickname
|
||||||
|
and directly send the optional
|
||||||
|
.IR message .
|
||||||
.TP
|
.TP
|
||||||
.FN /n " nick"
|
.BI /l " [reason]"
|
||||||
change the nick name
|
leave a channel or query,
|
||||||
|
giving the optional
|
||||||
|
.I reason
|
||||||
|
message.
|
||||||
.TP
|
.TP
|
||||||
.FN /t " topic"
|
.BI /n " nick"
|
||||||
set the topic of a channel
|
change the nick name to
|
||||||
|
.IR nick .
|
||||||
.TP
|
.TP
|
||||||
Everything which is not a command will simply be posted into the channel or to the server.
|
.BI /q " [reason]"
|
||||||
So if you need /who just write /WHO as described in the RFC to the server in FIFO.
|
quit ii,
|
||||||
|
giving the optional
|
||||||
|
.I reason
|
||||||
|
message.
|
||||||
.TP
|
.TP
|
||||||
.FN "out file usage"
|
.BI /t " topic"
|
||||||
Write wrappers, pagers or use your tools of choice to display the out file contents (loco, multitail, etc.).
|
set the topic of a channel with
|
||||||
.SH CONTACT
|
.IR topic.
|
||||||
.TP
|
.SH RAW COMMANDS
|
||||||
Write to ii (at) modprobe (dot) de for suggestions, fixes, 7|-|>< ;) etc.
|
Everything which is not a command will be posted into the channel or to the
|
||||||
.SH AUTHORS
|
server. So if you need /who just write /WHO as described in RFC#1459 to the
|
||||||
Copyright \(co 2005-2006 by Anselm R. Garbe <garbeam (at) gmail (dot) com> and
|
server in FIFO.
|
||||||
Copyright \(co 2005-2008 by Nico Golde <nico (at) ngolde (dot) de>
|
.SH SSL/TLS PROTOCOL SUPPORT
|
||||||
|
For SSL/TLS protocol support you can connect to a local tunnel, for example
|
||||||
|
with stunnel or socat.
|
||||||
.SH SEE ALSO
|
.SH SEE ALSO
|
||||||
.BR echo (1),
|
.BR echo (1),
|
||||||
.BR tail (1),
|
.BR tail (1)
|
||||||
|
|
29
query.sh
29
query.sh
|
@ -1,29 +0,0 @@
|
||||||
#!/bin/sh
|
|
||||||
# ----------------------------------------------------
|
|
||||||
# Nico Golde <nico@ngolde.de>
|
|
||||||
# License: do whatever you want with this code
|
|
||||||
# Purpose: locate new queries for the ii irc client
|
|
||||||
# ----------------------------------------------------
|
|
||||||
|
|
||||||
IRCPATH=$HOME/irc
|
|
||||||
TMPFILE=$IRCPATH/queries.tmp
|
|
||||||
|
|
||||||
if [ ! -f $TMPFILE ]; then
|
|
||||||
touch $TMPFILE
|
|
||||||
fi
|
|
||||||
|
|
||||||
echo "searching new query data"
|
|
||||||
for i in `find $IRCPATH -newer $TMPFILE -name 'out'`
|
|
||||||
do
|
|
||||||
grep -v '\-!\-' $i > /dev/null 2>&1 # if file doesnt just contain server stuff
|
|
||||||
if [ $? -ne 1 ]; then
|
|
||||||
# strip server, nickserv and channel out files
|
|
||||||
echo $i | egrep -v -i "nickserv|#|$IRCPATH/(irc\.freenode\.net|irc\.oftc\.net)/out" > /dev/null 2>&1
|
|
||||||
if [ $? -ne 1 ]; then
|
|
||||||
printf "new data in: %s\n========================================================\n" "$i"
|
|
||||||
tail -5 $i
|
|
||||||
fi
|
|
||||||
fi
|
|
||||||
done
|
|
||||||
|
|
||||||
touch $TMPFILE
|
|
32
strlcpy.c
Normal file
32
strlcpy.c
Normal file
|
@ -0,0 +1,32 @@
|
||||||
|
/* Taken from OpenBSD */
|
||||||
|
#include <sys/types.h>
|
||||||
|
#include <string.h>
|
||||||
|
|
||||||
|
/*
|
||||||
|
* Copy src to string dst of size siz. At most siz-1 characters
|
||||||
|
* will be copied. Always NUL terminates (unless siz == 0).
|
||||||
|
* Returns strlen(src); if retval >= siz, truncation occurred.
|
||||||
|
*/
|
||||||
|
size_t
|
||||||
|
strlcpy(char *dst, const char *src, size_t siz)
|
||||||
|
{
|
||||||
|
char *d = dst;
|
||||||
|
const char *s = src;
|
||||||
|
size_t n = siz;
|
||||||
|
|
||||||
|
/* Copy as many bytes as will fit */
|
||||||
|
if (n != 0) {
|
||||||
|
while (--n != 0) {
|
||||||
|
if ((*d++ = *s++) == '\0')
|
||||||
|
break;
|
||||||
|
}
|
||||||
|
}
|
||||||
|
/* Not enough room in dst, add NUL and traverse rest of src */
|
||||||
|
if (n == 0) {
|
||||||
|
if (siz != 0)
|
||||||
|
*d = '\0'; /* NUL-terminate dst */
|
||||||
|
while (*s++)
|
||||||
|
;
|
||||||
|
}
|
||||||
|
return(s - src - 1); /* count does not include NUL */
|
||||||
|
}
|
Loading…
Reference in New Issue
Block a user