proxy User Guide

Yong-iL Joh

Proxy 소개

proxy는 irc^[1] bot. 즉, automated irc client다.
proxy는 perlbot-1.1.9^[2]에 대한 plugin 확장이다.
proxy는 일반적인 irc bot과 달리 channel이나 사용자의 관리보다 service에 중점을 두고 변형되고 있다.

proxy에 대한 명령은 다음과 같은 형식이다.

-명령 [명령_옵션]
/msg proxy -명령 [명령_옵션]
/msg proxy #제어명령 [명령_옵션]
/msg proxy #help [명령[주제]]

proxy 명령 에는 다음과 같은 것이 있다.

daemonnews
dictionary
edic
freshmeat
hani
kma
linuxkernel
linuxtoday
math
nslookup
slashdot
weather
pwd

proxy 제어명령 에는 다음과 같은 것이 있다.

load
join
readnote
quit
listnotes
note
reload
msg
part
say

제어명령

제어명령은 proxy owner (flags w)만이 실행할 수 있다.
제어명령에 대한 자세한 사용법은 다음 명령으로 알 수 있다.
```
/msg proxy #help Core [주제]
```

확장명령

DaemonNews (BSD News)

BSD 삼총사(FreeBSD, OpenBSD, NetBSD)에 대한 소식을 다루는 Daily Daemon News.

-daemonnews
-dn

<톨킨> -dn
<proxy> Daemon News:
<proxy> [Dec/05/99] Linux Today: Interview with Mike Smith
<proxy> [Dec/04/99] ipfilter: IP Filter 3.3.4 released
<proxy> [Dec/03/99] USENIX: 1999 System Administrator Salary Survey
<proxy> [Dec/03/99] Yahoo! News: GMV Network Provides the First
+Platform-Independent Streaming Solutions

영영사전

Merriam-Webster OnLine에서 제공하는 영영사전.

-dictionary 영어단어
-dict 영어단어

<톨킨> -dict join
<proxy> Main Entry: join
<proxy> Pronunciation: 'join
<proxy> Function: verb
<proxy> Etymology: Middle English, from Old French
<proxy> 1 a : to put or bring together so as to form a unit  b : to connect (as points) by a line c : ADJOIN

한영사전

대부분 linux 배포판에 실려있는 영한사전인 engdic의 irc version.

-edic 영어단어

<톨킨> -edic join
<proxy> join : vt, vi, n, 연결하다, 잇다, 합병하다, 협력하다(시키다),
+한패가되다, 입회(입대)하다, (배에)타다, (부대, 배에)돌아오다, 함께
+되다(합치다), 결합하다, 합하다, 만나다, 인접하다, ~hand with ...와 제휴하다,
+접합점, 솔기

Freshmeat

Freshmeat에 올라온 새로운 software에 대한 정보를 보여준다. line수가 생략되면 5개만.

-freshmeat [line수]
-fm [line수]

<톨킨> -fm
<proxy> Freshmeat Headlines:
<proxy>                      sfront 0.49 / john_lazza / 1999/12/05 19:05
<proxy>                    ScryMUD 2.0.8 /     Greear / 1999/12/05 18:55
<proxy>             LaTeX2HTML 99.2beta6 / Kevin Atki / 1999/12/05 18:50
<proxy>                      Milo 2.2-14 /  Realcosmo / 1999/12/05 18:27
<proxy>            The Crime Project 0.1 / Omachonu O / 1999/12/05 18:23

Freshmeat에서 주제를 keyword로 검색을 한다. line수가 생략되면 3개만.

-freshmeat search 주제1 [주제2...] [:line수]
-fm search 주제1 [주제2...] [:line수]

<톨킨> -fm search  proxy
<proxy> proxy / score: 1.00
<proxy>   http://core.freshmeat.net/appindex/1999/04/21/924706079.html
<proxy> CGIProxy / score: 0.67
<proxy>   http://core.freshmeat.net/appindex/1999/02/10/918698238.html
<proxy> IDproxy / score: 0.67
<proxy>   http://core.freshmeat.net/appindex/1999/09/29/938637402.html

인터넷 한겨레

인터넷 한겨레에서 제공되는 오늘의 주요뉴스. line수가 생략되면 10개만.

-hani [line수]
-한겨레 [line수]

<톨킨> -hani
<proxy> 한겨레 Headlines:
<proxy>   진념 장관 곧 소환
<proxy>   신용불량자 구제론 물위로
<proxy>   `시골` 중산층에 유치원비 혜택
<proxy>   미 GM "대우차 해외법인 함께 인수"
<proxy>   내일 더 춥다…1주일간 계속
<proxy>   서울대 내년부터 타대학출신 학사편입 허용
<proxy>   삼성·LG 등 PC제조 5개사 담합 조사
<proxy>   40대 박씨가 월북을 기도한 이유

인터넷 한겨레에서 주제별로 오늘의 뉴스를 본다. line수가 생략되면 10개만.

-hani 주제 [line수]
-한겨레 주제 [line수]

주제(section)

정치	경제	사회
국제	스포츠	증권 or 부동산
정보통신	문화 or 생활

<톨킨> -hani 정보통신
<proxy> [1999.12.06(월) 12:17 KST]
<proxy> 정보통신·핵심블루칩 강세
<proxy>   아파트 분양 개인정보가 샌다

한국 날씨

국립기상청에서 제공하는 오늘의 날씨.

-날씨 지명

<톨킨> -날씨 서울
<proxy> 서울 / 온도: 0.9 / 바람: 서 3.5 m/s
<proxy> 서울 / 날씨: 맑      음

현재 Linux kernel version 정보

The Linux Kernel Archives에서 제공하는 현재 kernel version 정보

-linuxkernel
-lk

<톨킨> -lk
<proxy>     The latest stable version of the Linux kernel is:     2.2.13
<proxy>     The latest beta version of the Linux kernel is:       2.3.29
<proxy>     The latest prepatch (alpha) version *appears* to be:  2.3.30-6

Linux Today

The LinuxToday에서 제공되는 오늘의 Linux 소식. line수가 생략되면 5개만.

-linuxtoday [line수]
-lt [line수]

<톨킨> -lt
<proxy> Today's Newswire:
<proxy> [1999/12/ 5 19:50] LinuxPR: Linus Torvalds Native Land Gets
+LinuxStart.Com
<proxy> [1999/12/ 5 19:49] LinuxPR: Bynari Announces Release 1-3 of TradeMail
+Client for Exchange
<proxy> [1999/12/ 5 19:47] LinuxPR: SPIRO BETA 3 (RC2) Now Available
<proxy> [1999/12/ 5 19:42] ScienceDaily: Parallel Computing Reveals Cosmic
+Riddles
<proxy> [1999/12/ 5 19:30] Linux.com: Sites you should know for a better
+desktop - Enlightenment

The LinuxToday에서 주제를 keyword로 검색을 한다. line수가 생략되면 3개만.
- -linuxtoday search 주제1 [주제2...] [:line수]
- -lt search 주제1 [주제2...] [:line수]

irc 계산기

Unix에서 사용되고 있는 bc의 irc version.
- -math 수식
```
<톨킨> -math 1+1
<proxy> 2
```

nslookup

Unix에서 사용되고 있는 nslookup의 irc version.
- -nslookup Domain Name
- -ns Domain Name
```
<톨킨> -ns sarang.net
<proxy> Name:    sarang.net
<proxy> Address:  211.41.67.5
```

/. (Slashdot)

Slashdot에서 제공되는 Internet News, 소문들... line수가 생략되면 5개만.

-slashdot [line수]
-sd [line수]

<톨킨> -sd
<proxy> Slashdot headlines:
<proxy>  Internet Service Providers Not  /    Roblimo / 1999/12/05 22:42:24
<proxy>        Driving with Night Vision /      Hemos / 1999/12/05 21:18:21
<proxy>  NSF awards $500,000 grant for B /      Hemos / 1999/12/05 18:01:56
<proxy>  Netscape Receives Strong Crypto /      Hemos / 1999/12/05 16:59:58
<proxy>                 WTO + SDMI = NWO /    michael / 1999/12/05 16:14:00

Slashdot에서 주제를 keyword로 검색을 한다. line수가 생략되면 3개만.
- -slashdot search 주제1 [주제2...] [:line수]
- -sd search 주제1 [주제2...] [:line수]

전세계 날씨

The Weather Channel에서 제공하는 전세계 도시별 날씨.

-weather 도시,주(state)[,국가]

-weather 약어,,ks (한국의 날씨)
(하지만, 국립기상청에서 제공하는 "-날씨"가 더 낫지 않을까요. ^^;;;)

지명	약어	지명	약어	지명	약어	지명	약어
강릉	kangnung	광주	kwangju	군산	kunsan	대구	taegu
대전	taejon	김천	kimch_on	마산	masan	목포	mokp_o
밀양	miryang	벌교	polgyo	부산	pusan	서울	seoul
성남	songnam	속초	sokch_o	수원	suwon	안동	andong
안양	anyang	여수	yosu	오산	osan	왜관	waegwan
울산	ulsan	의성	uisong	이리	iri	인천	inch_on
제주	cheju	진해	chinhae	창원	ch_angwon	천안	ch_onan
청주	ch_ungju	포항	p_ohang	해남	haenam

<톨킨> -weather seoul,,ks
<proxy> Seoul, KS / Sunrise:  / Sunset:
<proxy> Seoul, KS / Temp: 34F (1.11C) / Wind: from the Northwest at 12 mph
+(19.2 kph)
<proxy> Seoul, KS / Humidity: 51% / Barometer: 30.24 inches (76.8096 cm)
<톨킨> -weather palm bay,fl
<proxy> Palm Bay, FL / Sunrise: 6:59 am EST / Sunset: 5:26 pm EST
<proxy> Palm Bay, FL / Temp: 72F (22.22C) / Wind: from the Southeast at 3 mph
+(4.8 kph)
<proxy> Palm Bay, FL / Humidity: 76% / Barometer: 30.15 inches (76.581 cm)

passwd encryption module (msg only)

text를 crypt() function을 이용해서 encryption해준다.
- /msg proxy -pwd text
```
-> *proxy* -pwd test
*proxy* 41.sp4JspYO8o
```

달력

Unix에서 사용되고 있는 cal 명령의 irc version.

-cal [월 [년]]

<톨킨> -cal
<proxy>      11월 1999
<proxy> 일 월 화 수 목 금 토
<proxy>     1  2  3  4  5  6
<proxy>  7  8  9 10 11 12 13
<proxy> 14 15 16 17 18 19 20
<proxy> 21 22 23 24 25 26 27
<proxy> 28 29 30

proxy를 얻는 방법

cvs [3]를 통해서. (passwd: anoncvs)

[tolkien@rivendell src]$ cvs -d :pserver:anoncvs@florida.sarang.net:/home/cvs/repo login
[tolkien@rivendell src]$ cvs -d :pserver:anoncvs@florida.sarang.net:/home/cvs/repo co proxy

proxy 갱신하기.

[tolkien@rivendell src]$ cvs -d :pserver:anoncvs@florida.sarang.net:/home/cvs/repo update

tarball로 받기 (daily snapshot)
http://florida.sarang.net/~tolkien/proxy.tar.gz
cvsweb으로 보기
http://florida.sarang.net/perl-bin/cvsweb/cvsweb/proxy/
mailing list about proxy proxy에 대한 기능추가 및 bug report를 위한 mailing list가 개설되었습니다.
죄송합니다. 아직 setting이 되지 않았습니다.

bug나 추가하고 싶은 기능이 있으면, tolkien@nownuri.net으로 mail을 보내주시기 바랍니다.

proxy 설치하기

proxy는 Net::IRC module을 사용합니다.
따라서, CPAN(Comprehensive Perl Archive Network)에 가셔서 해당 module을 download받으시기 바랍니다.

받으신 다음에 다음과 같은 방법으로 설치하시면 됩니다.

[tolkien@rivendell src]$ tar zxf Net-IRC-0.62.tar.gz
[tolkien@rivendell src]$ cd Net-IRC-0.62
[tolkien@rivendell Net-IRC-0.62]$ perl Makefile.PL
Checking if your kit is complete...
Looks good
Writing Makefile for Net::IRC
[tolkien@rivendell Net-IRC-0.62]$ make
mkdir blib
mkdir blib/lib
mkdir blib/lib/Net
mkdir blib/arch
mkdir blib/arch/auto
mkdir blib/arch/auto/Net
mkdir blib/arch/auto/Net/IRC
mkdir blib/lib/auto
mkdir blib/lib/auto/Net
mkdir blib/lib/auto/Net/IRC
mkdir blib/man3
cp IRC.pm blib/lib/Net/IRC.pm
cp Connection.pm blib/lib/Net/IRC/Connection.pm
cp Event.pm blib/lib/Net/IRC/Event.pm
cp DCC.pm blib/lib/Net/IRC/DCC.pm
Manifying blib/man3/Net::IRC.3
Manifying blib/man3/Net::Connection.3
Manifying blib/man3/Net::DCC.3
Manifying blib/man3/Net::Event.3
[tolkien@rivendell Net-IRC-0.62]$ make test
No tests defined for Net::IRC extension.
[tolkien@rivendell Net-IRC-0.62]$ su		(대개 root로 설치하셔야 될 겁니다.)
Password:
[root@rivendell Net-IRC-0.62]# make install

그런 다음 원하는 directory에 proxy를 설치합니다.

[tolkien@rivendell src]$ tar zxf proxy.tar.gz
[tolkien@rivendell src]$ cd proxy
[tolkien@rivendell proxy]$ ls
CHANGES        CVS/            Note.pm         TODO            help.txt
CHANGES-1.1.x  Chan.pm         Perlbot.pm      TODO.kr         pLog.pm
CHANGES.kr     Documentation/  PerlbotCore.pm  User.pm         perlbot.pl*
COPYING        Network.pm      README          config.example  plugins/

Edic plugin을 사용하시려면 약간의 수정이 필요합니다.
$PROXY_DIR/plugins/Edic에 있는 README를 참조하셔서 적절하게 설정합니다.

[tolkien@rivendell proxy]$ cd plugins/Edic/
[tolkien@rivendell Edic]$ ls
CVS/  Plugin.pm  README  alzza.diff  seminar2.diff  share.diff  share_dict.diff
[tolkien@rivendell Edic]$ cat README
engdic의 위치 및 format이 다양하여,
-edic 명령이 안 되는 경우 다음과 같이 해주시기 바랍니다.

patch -p0 < "patch file"
ex) patch -p0 < alzza.diff

engdic directory        patch file              배포판
/usr/local/share/engdic 패치할 필요없슴         FreeBSD
/usr/share/dict/engdic  share_dict.diff         debian 2.1 slink
/usr/share/engdic       share.diff              엑셀, 세미나

알짜 6.x                alzza.diff
2회 LinuxForSeminar     seminar2.diff

                                tolkien입니다.

config.example를 config로 이름을 바꾸신다음, 적절하게 고칩니다.
그리고, 실행을...
```
[tolkien@rivendell proxy]$ ./perlbot.pl &
[1] 16970
[tolkien@rivendell proxy]$ begin class bot
  nick: proxy
  addchar: _
  logdir: ./logs
  plugindir: ./plugins
...
```
참고 문헌

proxy User Guide

목 차

죄송합니다. 아직 setting이 되지 않았습니다.