help.txt 94 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525526527528529530531532533534535536537538539540541542543544545546547548549550551552553554555556557558559560561562563564565566567568569570571572573574575576577578579580581582583584585586587588589590591592593594595596597598599600601602603604605606607608609610611612613614615616617618619620621622623624625626627628629630631632633634635636637638639640641642643644645646647648649650651652653654655656657658659660661662663664665666667668669670671672673674675676677678679680681682683684685686687688689690691692693694695696697698699700701702703704705706707708709710711712713714715716717718719720721722723724725726727728729730731732733734735736737738739740741742743744745746747748749750751752753754755756757758759760761762763764765766767768769770771772773774775776777778779780781782783784785786787788789790791792793794795796797798799800801802803804805806807808809810811812813814815816817818819820821822823824825826827828829830831832833834835836837838839840841842843844845846847848849850851852853854855856857858859860861862863864865866867868869870871872873874875876877878879880881882883884885886887888889890891892893894895896897898899900901902903904905906907908909910911912913914915916917918919920921922923924925926927928929930931932933934935936937938939940941942943944945946947948949950951952953954955956957958959960961962963964965966967968969970971972973974975976977978979980981982983984985986987988989990991992993994995996997998999100010011002100310041005100610071008100910101011101210131014101510161017101810191020102110221023102410251026102710281029103010311032103310341035103610371038103910401041104210431044104510461047104810491050105110521053105410551056105710581059106010611062106310641065106610671068106910701071107210731074107510761077107810791080108110821083108410851086108710881089109010911092109310941095109610971098109911001101110211031104110511061107110811091110111111121113111411151116111711181119112011211122112311241125112611271128112911301131113211331134113511361137113811391140114111421143114411451146114711481149115011511152115311541155115611571158115911601161116211631164116511661167116811691170117111721173117411751176117711781179118011811182118311841185118611871188118911901191119211931194119511961197119811991200120112021203120412051206120712081209121012111212121312141215121612171218121912201221122212231224122512261227122812291230123112321233123412351236123712381239124012411242124312441245124612471248124912501251125212531254125512561257125812591260126112621263126412651266126712681269127012711272127312741275127612771278127912801281128212831284128512861287128812891290129112921293129412951296129712981299130013011302130313041305130613071308130913101311131213131314131513161317131813191320132113221323132413251326132713281329133013311332133313341335133613371338133913401341134213431344134513461347134813491350135113521353135413551356135713581359136013611362136313641365136613671368136913701371137213731374137513761377137813791380138113821383138413851386138713881389139013911392139313941395139613971398139914001401140214031404140514061407140814091410141114121413141414151416141714181419142014211422142314241425142614271428142914301431143214331434143514361437143814391440144114421443144414451446144714481449145014511452145314541455145614571458145914601461146214631464146514661467146814691470147114721473147414751476147714781479148014811482148314841485148614871488148914901491149214931494149514961497149814991500150115021503150415051506150715081509151015111512151315141515151615171518151915201521152215231524152515261527152815291530153115321533153415351536153715381539154015411542154315441545154615471548154915501551155215531554155515561557155815591560156115621563156415651566156715681569157015711572157315741575157615771578157915801581158215831584158515861587158815891590159115921593159415951596159715981599160016011602160316041605160616071608160916101611161216131614161516161617161816191620162116221623162416251626162716281629163016311632163316341635163616371638163916401641164216431644164516461647164816491650165116521653165416551656165716581659166016611662166316641665166616671668166916701671167216731674167516761677167816791680168116821683168416851686168716881689169016911692169316941695169616971698169917001701170217031704170517061707170817091710171117121713171417151716171717181719172017211722172317241725172617271728172917301731173217331734173517361737173817391740174117421743174417451746174717481749175017511752175317541755175617571758175917601761176217631764176517661767176817691770177117721773177417751776177717781779178017811782178317841785178617871788178917901791179217931794179517961797179817991800180118021803180418051806180718081809181018111812181318141815181618171818181918201821182218231824182518261827182818291830183118321833183418351836183718381839184018411842184318441845184618471848184918501851185218531854185518561857185818591860186118621863186418651866186718681869187018711872187318741875187618771878187918801881188218831884188518861887188818891890189118921893189418951896189718981899190019011902190319041905190619071908190919101911191219131914191519161917191819191920192119221923192419251926192719281929193019311932193319341935193619371938193919401941194219431944194519461947194819491950195119521953195419551956195719581959196019611962196319641965196619671968196919701971197219731974197519761977197819791980198119821983198419851986198719881989199019911992199319941995199619971998199920002001200220032004200520062007200820092010201120122013201420152016201720182019202020212022202320242025202620272028202920302031203220332034203520362037203820392040204120422043204420452046204720482049205020512052205320542055205620572058205920602061206220632064206520662067206820692070207120722073207420752076207720782079208020812082208320842085208620872088208920902091209220932094209520962097209820992100210121022103210421052106210721082109211021112112211321142115211621172118211921202121212221232124212521262127212821292130213121322133213421352136213721382139214021412142214321442145214621472148214921502151
  1. ::+ban
  2. ### $b+ban$b <hostmask> [channel] [%%<XdXhXm>] [comment]
  3. Adds a ban to the list of bans stored on the bot, with optional comment and
  4. ban time. This ban is stored with your handle as the creator, and will be
  5. in effect for every channel if no channel is specified. Prefixing a comment
  6. with '*' will set the ban sticky. Prefixing a comment with '@' will make the
  7. comment only visible within the bot, and not used as the ban reason. Ban
  8. time has to be expressed in days, hours, and/or minutes.
  9. See also: bans, -ban, stick, unstick
  10. ::+chan
  11. ### $b+chan$b <channel> [options]
  12. Adds a channel to the bot's channel list. If options are specified, the
  13. channel will be configured with the options.
  14. See also: -chan, chanset, chaninfo
  15. ::+chrec
  16. ### $b+chrec$b <handle> [channel]
  17. Adds an empty channel record for the specified user so that channel lastons
  18. and info lines can be saved. No flags are associated with the channel.
  19. See also: -chrec, chattr%{+n}, +chan, -chan%{-}
  20. ::+exempt
  21. ### $b+exempt$b <hostmask> [channel] [%%<XdXhXm>] [comment]
  22. Adds an exempt to the list of exempts stored on the bot, with optional
  23. comment and exempt time. This exempt is stored with your handle as the
  24. creator, and will be in effect for every channel if no channel is specified.
  25. Exempt time has to be expressed in days, hours, and/or minutes.
  26. See also: exempts, -exempt, stick, unstick
  27. ::+host
  28. ### $b+host$b [handle] <hostmask> [anotherhostmask] ...
  29. Adds a hostmask to a user's user record. Hostmasks are used to identify your
  30. handle on IRC. If a handle is not specified, the hostmask will be added to
  31. YOUR user record. List as many hosts as wanted.
  32. See also: -host, clearhosts
  33. ::+ignore
  34. ### $b+ignore$b <hostmask> [%%<XdXhXm>] [comment]
  35. Adds an ignore to the list of ignores stored on the bot, with optional
  36. comment and ignore time. This ignore is stored with your handle as the
  37. creator. Ignore time has to be expressed in days, hours, and/or minutes.
  38. See also: -ignore, ignores
  39. ::+invite
  40. ### $b+invite$b <hostmask> [channel] [%%<XdXhXm>] [comment]
  41. Adds an invite to the list of invites stored on the bot, with optional
  42. comment and invite time. This invite is stored with your handle as the
  43. creator, and will be in effect for every channel if no channel is specified.
  44. Invite time has to be expressed in days, hours, and/or minutes.
  45. See also: invites, -invite, stick, unstick
  46. ::+user
  47. ### $b+user$b <handle> [hostmask] [anotherhostmask] ...
  48. Creates a new user record for the handle given. The new user record will
  49. have no flags, an optional hostmask, and a random pass/secpass.
  50. List as many hosts as needed.
  51. See also: -user, +host, -host, clearhosts%{+ni}, newleaf%{-}%{+a}, newhub%{-}
  52. ::-ban
  53. ### $b-ban$b <banmask or number> [channel]
  54. Removes the specified ban from the list of bans stored on the bot. You may
  55. also reference the ban by the number shown by the 'bans' command.
  56. See also: bans, +ban, stick, unstick
  57. :hub:-bot
  58. ### $b-bot$b <bot>
  59. This is exactly the same as $b'%d-user'$b (it removes a user record). It is
  60. included for convenience.
  61. See also: +user, -user%{+ni}, newleaf%{-}%{+a}, newhub%{-}
  62. ::-chan
  63. ### $b-chan$b <channel>
  64. This removes ALL information about a channel from the bot.
  65. $f*** IMPORTANT ***$f
  66. This erases ALL information about the channel, including channel settings,
  67. bans, exempts, invites, and channel records for users -- $bEVERYTHING$b.
  68. $bDO NOT$b use it to have the bot temporarily leave a channel. This
  69. command is for abandoning a channel (e.g. the channel will have to be
  70. redefined and all user flags for that channel will have to be redone.
  71. If you want to do this try '%dcycle' or '%ddown'
  72. See also: +chan, chanset, chaninfo, cycle, down
  73. ::-chrec
  74. ### $b-chrec$b <handle> [channel]
  75. Removes a channel record for the specified user, including channel lastons,
  76. info lines, and flags.
  77. See also: +chrec, chattr
  78. ::-exempt
  79. Removes the specified exempt from the list of exempts stored on the bot. You
  80. may also reference the exempt by the number shown by the 'exempts' command.
  81. See also: exempts, +exempt, stick, unstick
  82. ::-host
  83. ### $b-host$b <hostmask>
  84. Removes a host from your handle.
  85. %{+m|m}
  86. ### $b-host$b <handle> <hostmask> [anotherhostmask] ...
  87. Removes a hostmask from a user's user record.
  88. %{-}
  89. See also: +host, clearhosts
  90. ::-ignore
  91. ### $b-ignore$b <hostmask/number>
  92. Removes the specified ignore from the list of ignores stored on the bot. You
  93. may also reference the ignore by the number shown by the 'ignores' command.
  94. See also: +ignore, ignores
  95. ::-invite
  96. ### $b-invite$b <hostmask or number>
  97. Removes the specified invite from the list of invites stored on the bot. You
  98. may also reference the invite by the number shown by the 'invites' command.
  99. See also: invites, +invite, stick, unstick
  100. ::-user
  101. ### $b-user$b <handle> [anotherhandle] ...
  102. Removes the specified handles user records.
  103. See also: +user%{+ai}, -bot%{-}%{+ni}, newleaf%{-}%{+a}, newhub%{-}
  104. ::about:
  105. ### $babout$b
  106. If you feel you are missing from the list feel free to contact bryan.
  107. :leaf:act
  108. ### $bact$b [channel] <text>
  109. Performs an action on the current console channel (or otherwise
  110. specified channel), as if the bot did it. Just like the /me
  111. command in IRC.
  112. See also: console
  113. ::addline
  114. ### $baddline$b <username>
  115. Shows you a simple line for adding a user to another botnet with the
  116. same hostmasks.
  117. See also: whois
  118. ::addlog
  119. ### $baddlog$b <text>
  120. Adds your comment to the bot's logfile. Bot masters can go back later and
  121. review the log, and will see your comment (with your handle attached). This
  122. is useful for explaining confusing activity.
  123. :leaf:adduser
  124. ### $badduser$b [!]<nickname> [handle]
  125. Creates a new user record for a user on the channel, using their
  126. current hostname. It's similar to a user msg'ing the bot 'hello'
  127. except that no information is sent to that user. If the bot
  128. already knows someone by that nickname, and the user on the channel
  129. doesn't have a bot record, then it does the equivalent of an
  130. 'ident' for that user -- except that, again, no information is
  131. sent to the user telling them that anything was done.
  132. If the user is using a different nickname than the bot normally
  133. knows her by, you can specify her "handle" (the nickname that the
  134. bot remembers).
  135. If you want to add a user using a static hostmask, prefix their nick
  136. with a '!'. i.e. '%dadduser !Lamer'
  137. The user being added is sent a NOTICE with their initial password.
  138. See also: +host, -host, clearhosts%{+m}, +user, -user%{-}
  139. :leaf:authed:
  140. ### $bauthed$b
  141. Displays users who are authed on the bot for chan/msg cmds.
  142. ::away
  143. ### $baway$b [reason]
  144. Marks you as "away" on the party line. Your away message will show up in
  145. the $b'%dwho'$b list. Saying something on the party line will automatically
  146. remove your "away" status, or you can type $b'%dback'$b or $b'%daway'$b by
  147. itself.
  148. See also: back
  149. ::back
  150. ### $bback$b
  151. This marks you as no longer away on the party line.
  152. See also: away
  153. :hub:backup
  154. ### $bbackup$b
  155. This makes the bot write a backup of its entire user list to the disk.
  156. This is useful if you feel the need to backup the userfile and channel
  157. settings.
  158. See also: reload, save
  159. ::bans
  160. ### $bbans$b [[channel/all/global]/wildcard]
  161. Shows you a list of the global bans active on the current channel, and the
  162. list of channel-specific bans, as well as any bans that are on the channel
  163. but weren't placed by the bot.
  164. Here's a sample entry;
  165. [ 5] *!*habib@*frys.com (perm)
  166. paulie: revolving check policy
  167. Created 15:10
  168. The number (5) can be used to reference the ban if you wish to remove it
  169. (see $b'-ban'$b). Next is the actual hostmask being banned. The "(perm)"
  170. means that the ban is "permanent": that is, it doesn't automatically expire.
  171. If there is an elapsed time showing instead, the time displayed is how long
  172. the ban has been active. These types of bans expire after two hours. The
  173. second line of the ban entry is the comment ("revolving check policy"), and
  174. who set the ban (paulie). The last line shows when the ban was added, and
  175. possibly the last time the ban was activated on the channel (if it's
  176. different from the creation time).
  177. Sometimes there will be a "!" or "*" right before the number. A "!" means
  178. the ban is in the bot's ban list, but is not currently on the channel. A "*"
  179. marks a ban which is NOT in the bot's ban list but IS on the channel.
  180. If you use 'bans' without an argument, it will show you only the bans which
  181. are currently active on the channel. If you use 'bans all', it will show you
  182. every ban in the global ban list and on the channel. If you use 'bans
  183. <wildcard>', it will list all bans (active or not) that match against your
  184. wildcard. Consider it a 'bans all' list matched against your wildcard.
  185. If you use 'bans global', a full list of bans for EVERY channel will be
  186. displayed, including inactive/active bans on each channel.
  187. The ban list may change according to which channel you're currently viewing
  188. in the console. Different bans may be active on different channels. If you
  189. specify a channel name, that channel will be used instead of your current
  190. console channel.
  191. See also: -ban, +ban, console%{+m|m}, chanset, chaninfo%{-}, stick, unstick
  192. :hub:bc:
  193. ### $bbc$b <bot> <cmd> [params]
  194. See: botcmd
  195. :hub:boot
  196. ### $bboot$b <handle[@bot]> [reason]
  197. Kicks a user off the party line and displays the reason, if you specify
  198. one. You can also specify a bot, and attempt to boot someone from another
  199. bot on the botnet. You cannot boot a bot owner.
  200. :hub:botcmd:
  201. ### $bbotcmd$b <bot|*|?|&> [%%group] <cmd> [params]
  202. The specified cmd and optional parameters are executed on the specified bot,
  203. all results are displayed back on DCC. For example:
  204. [19:29] #bryan# botcmd wtest whom ...
  205. [19:29] (wtest) #bryan# whom
  206. [wtest] Nick
  207. [wtest] ----------
  208. [wtest] ^bryan
  209. [wtest] ^bryan [idle 1h22m]
  210. [wtest] ^bryan [idle 1h22m]
  211. [wtest] Total users: 3
  212. The bot specified can also have wildcards in it. '*' for 1 or more chars, and
  213. '?' for exactly 1 char. Use this cmd carefully, and even think about placing
  214. a cmdpass on it.
  215. Just using '?' for 'bot' will choose a random leaf bot.
  216. Just using '&' for 'bot' will do the cmd on all localhub bots. (first bot in config).
  217. Use '%%group' to match a specific group. (see also: '%dhelp set')
  218. This cmd cannot be chained over the botnet, ie, no: '%dbotcmd [bot] botcmd [bot2] ...'
  219. There are two default aliases added for this cmd:
  220. bc -> botcmd
  221. bl -> botcmd ?
  222. See also: cmdpass
  223. :hub:botjump:
  224. ### $bbotjump$b <bot> [server [port [pass]]]
  225. Makes the bot jump to another server. If you don't specify a
  226. server, it will jump to the next server in its internal list (see
  227. $b'%dhelp set'$b). If you specify a server, it will jump to that
  228. server (default port is 6667), and if that server is not in the
  229. internal list already, it will add it (until the bot relinks).
  230. Jumping servers ALWAYS makes the bot lose ops! be careful!
  231. See also: jump, servers, botserver
  232. :hub:botmsg:
  233. ### $bbotmsg$b <bot> <nickname|#chan> <text>
  234. Sends a private message to someone from the bot, just as if the
  235. bot had typed /msg.
  236. See also: msg%{+n}
  237. :hub:botnick:
  238. ### $bbotnick$b <bot>
  239. The specified bot will display its current nick over DCC.
  240. See also: netnick, nick
  241. :hub:bots
  242. ### $bbots$b [nodename|%group]
  243. Shows the list of bots currently on the botnet.
  244. Example:
  245. Bots: cEvin, ruthie, Killa1
  246. There is no indication of which bots are directly connected to this current
  247. bot. %{+n}Use $b'%dwho'$b or $b'%dbottree'$b for that information.%{-}
  248. Specifying a nodename will display all bots up/down on that nodename.
  249. Bots with a * preceding its name are down.
  250. Specifying a %%group will only show bots in that group.
  251. See also: groups, downbots%{+n}, bottree%{-}
  252. :hub:botserver:
  253. ### $bbotserver$b <bot>
  254. The bot will display its current server and lag over DCC.
  255. See also: netserver, servers%{+n}, set%{-}
  256. :hub:botset:
  257. ### $bbotset$b <bot> [<+/->list] [<var> [data|-]]
  258. Set's a bot specific entry.
  259. NOTE: 'set' and 'botset' have different entries.
  260. If there is a botset entry for 'name' and a set entry for 'name',
  261. the bot will use the 'botset' entry. Otherwise, the 'set' entry
  262. will be used for all options.
  263. The <var> may have wildcards. Wildcards will only be used for listing
  264. variable, not for setting.
  265. See 'set' for a full help listing.
  266. See also: set
  267. :hub:bottree
  268. ### $bbottree$b
  269. Shows a tree-format diagram of the bots currently on the botnet. It's just a
  270. nice way to get a feel for how the bots are physically connected. If 2 bots
  271. are sharing, a + will be indicated, or a ? if nothing is known.
  272. Some bots are colored if you have colors on (see '%dhelp color')
  273. Yellow: hubs (Do not come on IRC)
  274. Red: localhubs (first bot in binary, see '%dhelp conf')
  275. Other: normal leaf bots
  276. See also: bots, downbots, groups
  277. ::botversion:
  278. ### $bbotversion$b <bot>
  279. The bot will display its pack version and uname.
  280. See also: version, netversion, about%{+m|m}, status%{-}
  281. :hub:chaddr
  282. ### $bchaddr$b <bot> <address[:bot port[/user port]]>
  283. Changes the address for a bot. This is the address your bot will try to
  284. connect to when linking. If the bot has a separate port for bots and users,
  285. they should be separated by a slash (/).
  286. %{+a}
  287. It is not recommended that this is used, you should change your source,
  288. and update all bots instead.
  289. %{-}
  290. See also: link%{+a}, newhub%{-}
  291. ::chaninfo
  292. ### $bchaninfo$b <channel>
  293. This lists all the settings for the bot on the given channel.
  294. It shows any of the following:
  295. $bchanmode$b These modes are enforced on the channel.
  296. Both + and - modes can be enforced. Use {} to
  297. add a key. '%dchanset #chan chanmode { +nt key }'
  298. $bgroups$b List of groups that should join the channel.
  299. Use {} to add multiple groups. See also '%dhelp set'
  300. '%dchanset #chan groups { main alt }'
  301. %{+m|m}
  302. $bauto-delay$b Amount of seconds to wait before auto opping,
  303. or auto voicing a client based on flags or
  304. +voice
  305. $blimit$b If this is set, the +l bot will raise the limit
  306. to the users in the channel + this amount. Set to
  307. 0 to disable.
  308. $bclosed-ban$b Set this to 1 to ban users who join +closed
  309. channels. This is probably not needed though, as
  310. +closed maintains +i.
  311. $bclosed-invite$b If a channel is set +closed and this is set
  312. force the channel to always be +i, otherwise don't.
  313. $bclosed-private$b If a channel is set +closed, the bots will
  314. enforce +p as well. The point is to notice the chan
  315. and bots when an /invite is done. This is useful in
  316. seeing when a shell is hijacked ;)
  317. $bcaps-limit$b If this is set, any +f bots will kick a client for using
  318. too many caps. This is a percentage (0-100) of how much of
  319. their message can be caps before being kicked.
  320. $bcolor-limit$b If this is set, any +f bot will kick the client for
  321. excess color codes. The setting is how many color/bold
  322. character codes the message may contain before being kicked.
  323. $bban-time$b Set here how long temporary bans will last (in
  324. minutes). If you set this setting to 0, the bot will
  325. never remove them. (This also requires +dynamicbans)
  326. $bban-type$b This setting defines what type of bans should be
  327. placed. Available types are:
  328. 0 *!user@host
  329. 1 *!*user@host
  330. 2 *!*@host
  331. 3 *!*user@*.host
  332. 4 *!*@*.host
  333. 5 nick!user@host
  334. 6 nick!*user@host
  335. 7 nick!*@host
  336. 8 nick!*user@*.host
  337. 9 nick!*@*.host
  338. You can also specify types from 10 to 19 which correspond
  339. to types 0 to 9, with the exception that numbers in hostnames
  340. are replaced with the '?' wildcard, or 20 to 29, which works
  341. like 10 to 19 but using '*' for numbers, instead of '?'.
  342. $bexempt-time$b Set here how long temporary exempts will last (in
  343. minutes). If you set this setting to 0, the bot will
  344. never remove them. The bot will check the exempts
  345. every X minutes, but will not remove the exempt if a
  346. ban is set on the channel that matches that exempt.
  347. Once the ban is removed, then the exempt will be
  348. removed the next time the bot checks. Please note
  349. that this is an IRCnet feature.
  350. $bknock$b Allow auto-inviting on /KNOCK? +y bots will invite.
  351. None/0 Don't invite on /KNOCK
  352. Op/1 Ops (+o) are invited on /KNOCK
  353. Voice/2 Voices (+v) are invited on /KNOCK
  354. User/3 Users (not +dk) are invited on /KNOCK
  355. $bflood-exempt$b Should clients be exempt from flood checks based
  356. on their channel status? (not deop/kick floods)
  357. Valid values are:
  358. None/0 Stick to regular checking (+x)
  359. Op/1 Ops are exempt from flood checks
  360. Voice/2 Voices are exempt from flood checks
  361. $bclosed-exempt$b Should clients be exempt from +closed kicks based
  362. on their channel status?
  363. Valid values are:
  364. None/0 Stick to regular user checking (+o)
  365. Op/1 Ops are exempt from +closed kicks
  366. Voice/2 Voices are exempt from +closed kicks
  367. $bflood-lock-time$b How long in seconds to keep the channel locked
  368. during drone floods.
  369. $bfish-key$b The key to use for FiSH encryption. Use '{ key }'
  370. to set and '{}' to unset.
  371. $binvite-time$b Set here how long temporary invites will last (in
  372. minutes). If you set this setting to 0, the bot will
  373. never remove them. The bot will check the invites
  374. every X minutes, but will not remove the invite if a
  375. channel is set to +i. Once the channel is -i then the
  376. invite will be removed the next time the bot checks.
  377. Please note that this is an IRCnet feature.
  378. $bprotect-backup$b Set +backup in the event of a takeover if the
  379. channel is +protect.
  380. $bvoice-non-ident$b If channel is +voice, clients without an ident will
  381. be voiced. Set to 0 to not voice clients without ident.
  382. $bvoice-moderate$b If channel is +voice, auto set +m and devoice flooders
  383. instead of kicking them. Set to 0 to disable.
  384. The following options choose how to respond to specific events.
  385. Each can be set as any of the specified options.
  386. ignore/0 Ignore
  387. deop/1 Chattr user +d (deop)
  388. kick/2 Chattr user +k (auto kickban)
  389. delete/remove/3 Remove user
  390. react/4 React and punish the client, but don't add or modify
  391. their user flags.
  392. These events trigger the bot to react with the above option.
  393. $bbad-cookie$b Missing or invalid cookie in bot op line.
  394. $bmanop$b Manual op.
  395. $bmdop$b Mass deop.
  396. $bmop$b Mass op.
  397. $brevenge$b Client kicking/banning/deopping another bot.
  398. The following are only used if '%dset homechan' is configured.
  399. $bhomechan-user$b Set to treat clients who are in the homechan
  400. special in non-homechan channels.
  401. nothing/0 Do nothing special.
  402. voice/1 Voice clients who are in homechan.
  403. op/2 Op clients who are in homechan.
  404. The following can be set + or - (e.g. '%dchanset #channel -enforcebans')
  405. $bautoop$b Bots that are +y will auto-op all users with
  406. op access to the channel.
  407. $bbackup$b Make backup-bots (+B) join when set.
  408. $bbitch$b Only let users with the +o flag have op on the
  409. channel?
  410. $bbotbitch$b Only let $bbots$b with the +o flag have op on the
  411. channel?
  412. $bclosed$b Kick all people who join channel unless they have
  413. op access for the channel.
  414. $bcycle$b Bot will attempt to cycle the channel when opless
  415. or during splits to gain ops.
  416. $benforcebans$b When a ban is set, kick people who are on the channel
  417. and match the ban?
  418. $bfastop$b Setting this will disable cookie-ops. You may
  419. know cookie-ops as an annoying way of bots opping
  420. themselves with +o-b bot *!*@fjdifgjdsgiufufdhgfudghfdgfdg,
  421. but, with -fastop (cookie-ops enabled), opping is much
  422. more secure and the chances of someone hijacking the bot
  423. for ops in your channel are much less. This is
  424. highly recommeneded to always be set.
  425. $bfloodban$b If a channel flood (public, notice or ctcp) is detected, the
  426. flooder will also be banned, in accordance with ban-type.
  427. $binactive$b This prevents the bot from joining the channel (or
  428. makes it leave the channel if it is already there). It
  429. can be useful to make the bot leave a channel without
  430. losing its settings, channel-specific user flags,
  431. channel bans, and without affecting sharing.
  432. $bnodesynch$b Allow non-ops to perform channel modes? This can stop
  433. the bot from fighting with services such as ChanServ, or
  434. from kicking IRCops when setting channel modes without
  435. having ops.
  436. $bprivate$b This by far is probably the single most unique and
  437. important feature of this pack. With this set, users with
  438. global +o will not implicitly have access to the channel.
  439. They will need to have channel |o flag to have access.
  440. Users with global +n override this as they should have
  441. control over the entire botnet and where it goes.
  442. Users who lose access to a channel because of this setting
  443. will see no reference to it over the botnet in any place.
  444. The +o restriction goes for +v as well.
  445. $bprotect$b Set chan +botbitch and mass deop the channel if someone
  446. attempts to takeover. The channel is also set +backup
  447. if protect-backup is set.
  448. $brbl$b Do RBL lookups on clients and ban on matches.
  449. Uses 'rbl-servers'. See also '%dhelp set'. Only the
  450. +r bot will do lookups. On positive match, the bot
  451. will add a ban to the botnet and all bots will enforce
  452. the ban.
  453. $btake$b Once a bot is opped, it will mass op all other bots
  454. in the channel. After that, they will all attempt to
  455. mass deop in hopes 'taking' the channel. :)
  456. $bvoice$b With this set, the +y bot will voice ALL clients
  457. that join the channel, whether they are a user or not.
  458. It will still keep +q|q users devoiced. Any client
  459. devoiced by a user op (+o) will remain devoiced even
  460. if they cycle. See also: 'voice-non-ident' and
  461. 'voice-moderate'
  462. $bvoicebitch$b Enforce voices in a +bitch style. Only +v users
  463. will be allowed to be voiced. This does take +private
  464. into mind as well.
  465. $bdynamicbans$b Only activate bans on the channel when necessary?
  466. This keeps the channel's ban list from getting
  467. excessively long. The bot still remembers every ban,
  468. but it only activates a ban on the channel when it sees
  469. someone join who matches that ban.
  470. $buserbans$b Allow bans to be made by users directly? If turned
  471. off, the bot will require all bans to be made through
  472. the bot's console.
  473. $bdynamicexempts$b Only activate exempts on the channel when
  474. necessary? This keeps the channel's exempt list from
  475. getting excessively long. The bot still remembers every
  476. exempt, but it only activates an exempt on the channel
  477. when it sees a ban set that matches the exempt. The
  478. exempt remains active on the channel for as long as the
  479. ban is still active.
  480. $buserexempts$b Allow exempts to be made by users directly? If
  481. turned off, the bot will require all exempts to be made
  482. through the bot's console.
  483. $bdynamicinvites$b Only activate invites on the channel when necessary?
  484. This keeps the channel's invite list from getting
  485. excessively long. The bot still remembers every invite,
  486. but the invites are only activated when the channel is
  487. set to invite only and a user joins after requesting an
  488. invite. Once set, the invite remains until the channel
  489. goes to -i.
  490. $buserinvites$b Allow invites to be made by users directly? If turned
  491. off, the bot will require all invites to be made through
  492. the bot's console.
  493. The following are flood settings, they are set via '%dchanset <channel>
  494. flood-type number:seconds', where number and second are integers
  495. indicating the number of times in how many seconds the flood will be
  496. triggered. Setting one of these to 0:0, 0:1, or 1:0 will deactivate the
  497. respective flood setting.
  498. $bflood-chan$b Set here how many channel messages in how many seconds
  499. from one host constitutes a flood. Setting this to 0 or 0:0
  500. disables text flood protection for the channel.
  501. $bflood-bytes$b Set here how many bytes in how many seconds from one
  502. host constitutes a flood. Setting this to 0 or 0:0
  503. disables text flood protection for the channel.
  504. $bflood-ctcp$b Set here how many channel ctcps in how many seconds from
  505. one host constitutes a flood. Setting this to 0 or 0:0
  506. disables ctcp flood protection for the channel.
  507. $bflood-join$b Set here how many joins in how many seconds from one
  508. host constitutes a flood. Setting this to 0 or 0:0 disables
  509. join flood protection for the channel.
  510. $bflood-kick$b Set here how many kicks in how many seconds from one
  511. host constitutes a flood. Setting this to 0 or 0:0 disables
  512. kick flood protection for the channel.
  513. $bflood-deop$b Set here how many deops in how many seconds from one
  514. host constitutes a flood. Setting this to 0 or 0:0 disables
  515. deop flood protection for the channel.
  516. $bflood-nick$b Set here how many nick changes in how many seconds from
  517. one host constitutes a flood. Setting this to 0 or 0:0
  518. disables nick flood protection for the channel.
  519. The following settings will trigger a lockdown (chanmode +mi) for 'flood-lock-time'
  520. seconds. Unlike the other flood-* settings, these will trigger on $bmultiple$b clients.
  521. They are for catching mass floods.
  522. $bflood-mjoin$b Set how many joins in how many seconds before triggering
  523. a lockdown for mass join. Setting this to 0 or 0:0 disables mass
  524. join protection for the channel.
  525. $bflood-mchan$b Set here how many channel messages in how many seconds
  526. from any host constitutes a flood. Setting this to 0 or 0:0
  527. disables text flood protection for the channel.
  528. $bflood-mbytes$b Set here how many bytes in how many seconds from any
  529. host constitutes a flood. Setting this to 0 or 0:0
  530. disables text flood protection for the channel.
  531. $bflood-mctcp$b Set here how many channel ctcps in how many seconds from
  532. any host constitutes a flood. Setting this to 0 or 0:0
  533. disables ctcp flood protection for the channel.
  534. These can all be changed simultaneously with $bflood-*$b
  535. See also: %{-}%{+n}+chan, -chan%{-}%{+m|m}, chanset%{-}
  536. :leaf:channel
  537. ### $bchannel$b [channel-name]
  538. Shows you an extensive display of the users on a channel, and
  539. the current channel attributes. By default, it shows you the
  540. channel you are currently viewing on the console, but you can
  541. specify another channel if you wish.
  542. The first line will look like:
  543. Channel #hiya, 8 members, 45 users, mode +tn:
  544. This means that the bot is sitting on channel #hiya, where 8
  545. other irc'ers are. There are 45 people that the bot knows by
  546. hostmask, and the channel mode is +tn. If the bot isn't on
  547. the channel it is supposed to be on, it will say "Desiring
  548. channel #hiya" instead. Next is a list of the users on the
  549. channel, with each entry looking like this:
  550. NICKNAME HANDLE JOIN HOPS IDLE USER@HOST
  551. @kantSF kantSF 14:53 o 2 6m josh@random.edu
  552. The "@kantSF" means that the user's nickname is kantSF and that
  553. he is a chanop. The second "kantSF" is the nickname that the
  554. bot knows him by. Sometimes this will differ from the nickname
  555. a person is using. The time displayed is the time the user
  556. joined the channel. The next field is the attributes:
  557. n - bot owner o - can get ops (+o)
  558. m - bot master or owner b - another bot
  559. d - cannot get ops (+d)
  560. The last field is the user@host he is using irc from.
  561. See also: status, whois
  562. ::channels:
  563. ### $bchannels$b %{+m}[user|%group]%{-}
  564. Displays channels that you have access to, and any important
  565. flags that are set on them.
  566. %{+m}
  567. Masters: You can specify other users to see what channels their
  568. flags grant them access to.%{-}
  569. Special %%group to see what channels a particular group is in.
  570. See also: whois%{+m}, chattr, chaninfo, groups%{-}
  571. ::chanset
  572. ### $bchanset$b [#&!+channel|*|default] <settings>
  573. Allows you to change the channel settings (see $b'chaninfo'$b for the
  574. settings) for one specific channel or all channels. Use '*' to apply the
  575. change to all channels.
  576. Changes are used until the next restart, and are saved
  577. whenever the userfile is saved.
  578. Modifying 'default' will change what new channels get when they are created.
  579. See also: %{+n}+chan, -chan%{-}, chaninfo
  580. ::chat
  581. ### $bchat$b <on/off>
  582. ### $bchat$b <[*]channel number/name>
  583. Changes your current channel on the partyline. When you first connect to
  584. the partyline, it places you on channel 0 (the main party line).
  585. Some channels may have assigned names if the assoc module is loaded. For
  586. these, you can specify the channel by name instead of channel number if
  587. you wish.
  588. $b'%dchat off'$b removes you from all channels, including the main party line.
  589. You can still use bot commands and see the console, but you can't talk to
  590. anyone. $b'%dchat on'$b returns you to the main party
  591. line (channel 0) if you were elsewhere.
  592. If you prefix the channel with a '*', you will join a local channel.
  593. See also: console
  594. ::chattr
  595. ### $bchattr$b <handle> [flags] [channel]
  596. This lets you view and change the flags for a user.
  597. For example, to give Lamer the p and f flags:
  598. '%dchattr Lamer +pf'
  599. To remove Denali from the global op list:
  600. '%dchattr Denali -o'
  601. You may also do any combination of the above:
  602. '%dchattr Fred1 -m+xj-o'
  603. You can also change the flags for Usagi on a specific channel by supplying
  604. the channel after the attributes:
  605. '%dchattr Usagi -m+dk-o #blah'
  606. Changing global and channel specific flags within the same command line is
  607. also possible (global +o #lamer):
  608. '%dchattr Bill f|o #lamer'
  609. Whether or not you change any flags, it will show you the user's attributes
  610. afterwards. To get a list of all possible flags, see $b'%dhelp whois'$b.
  611. $bNOTES:$b Only the owner may add or remove the 'a' (admin) or 'n' (owner) flags.
  612. It is pointless to -a a permanent owner.
  613. You must remove the permanent owner in the binary.
  614. See also: whois
  615. :hub:checkchannels
  616. ### $bcheckchannels$b
  617. This will make all leaf bots display which channels they are currently
  618. not in but *should* be in. This will only shows channels that contain
  619. the groups the bot are in.
  620. See also: botcmd, channels, channel, status
  621. :hub:chhandle
  622. ### $bchhandle$b <oldhandle> <newhandle>
  623. Changes the handle of a user. For example, to change the handle of user
  624. 'gavroche' to 'jamie', you would use 'chhandle gavroche jamie'.
  625. Perm owners may not change their handle without recompiling binaries first.
  626. Bot handles cannot be changed from partyline.
  627. See also: chpass%{+n}, chsecpass%{-}
  628. ::chinfo
  629. ### $bchinfo$b <user> [channel] [info-line/none]
  630. Sets the information line for a user. This line is shown via the /msg
  631. commands $b'who'$b and $b'whois'$b.
  632. If the info line begins with an '@', then it is "locked", and that user
  633. may no longer change it. If the channel name is omitted, the default info
  634. line is changed. If you specify 'none' as the info-line, it will be erased.
  635. See also: info
  636. :hub:chnick
  637. See: chhandle
  638. :hub:chpass
  639. ### $bchpass$b <handle> [newpassword|rand]
  640. Changes a user's password. If you do not specify the new password, the user
  641. effectively no longer has a password set. A password is needed to get ops,
  642. join the party line, etc. If the newpassword is 'rand', a random password
  643. will be used.
  644. This has no effect on bots.
  645. See also: chhandle%{+n}, chsecpass%{-}
  646. :hub:chsecpass:
  647. ### $bchsecpass$b <handle> [newpassword|rand]
  648. Changes a user's secpass. If you do not specify the new password, the user
  649. effectively no longer has a password set. A secpass is needed to auth and
  650. login via DCC chat. If the newpassword is 'rand', a random password
  651. will be used.
  652. See also: chhandle, chpass
  653. ::clearhosts
  654. ### $bclearhosts$b
  655. Removes all hosts from your handle.
  656. %{+m|m}
  657. ### $bclearhosts$b <handle>
  658. Removes all hosts from a user's user record.
  659. %{-}
  660. See also: +host, -host
  661. :leaf:clearqueue
  662. ### $bclearqueue$b <queue>
  663. Removes all msgs from the specified queue (mode/server/help/play/all)
  664. :hub:cmdpass:
  665. ### $bcmdpass$b <command> <pass> [newpassword]
  666. Places the specified pass on the cmd so that the cmd will need to be
  667. followed by the specified pass whenever it is called. For example:
  668. '%dcmdpass whoami BLAH'
  669. [19:32] #bryan# cmdpass whoami ...
  670. Set command password for whoami to 'BLAH'
  671. '%dwhoami'
  672. Invalid command password. Use !command password arguments
  673. [19:33] bryan attempted !whoami with missing or incorrect command password
  674. '%dwhoami BLAH'
  675. You are bryan@hub.
  676. [19:33] #bryan# whoami
  677. To remove a cmdpass for a cmd, specify the old pass and do not specify a new pass
  678. ** Only permanent owners specified in the binary COMPILE config file **
  679. ** can use this cmd. **
  680. ::color:
  681. ### $bcolor$b <on/off>
  682. Enables or disables misc coloring over DCC. mIRC or ANSI method is
  683. chosen automatically.
  684. See also: console, echo, login, page, strip
  685. ::comment
  686. ### $bcomment$b <user> <comment>
  687. Creates or changes the comment field for a user. The comment field can only
  688. be seen via 'whois' or 'match'. Non-masters cannot see the comment field.
  689. Using the comment 'none' will clear a user's comment.
  690. ::conf:
  691. ### $bconf$b <add|del|change|disable|enable|list|set> [options]
  692. This command is used to modify the bot's local shell config. Only
  693. the first bot listed will be able to perform this command. Using the cmd
  694. on a non-'localhub' will result in an error similar to:
  695. [16:42] #bryan# botcmd wtest2 conf list
  696. [wtest2] Please use 'wtest' for this login/shell.
  697. Simply use the command on the bot specified.
  698. 'add' uses the same syntax as the conf file:
  699. add <bot> [<ip|.> <[+]host|.> [ipv6-ip]]
  700. ip/host/ipv6-ip are all optional and/or can be replaced with '.'
  701. Newly added bots will start immediately, don't forget to 'newleaf'.
  702. 'del' syntax is:
  703. del <bot>
  704. Deleted bots that are running will be killed.
  705. 'change' syntax is the same as 'add'
  706. 'disable' syntax is:
  707. disable <bot>
  708. The bot will be killed, but not removed from userlist. It will not start again
  709. until you use 'enable' on it.
  710. 'enable' syntax is:
  711. enable <bot>
  712. The bot is enabled. (Only relevant for disabled bots designated via a prefix of '/')
  713. 'list' shows all the bots currently in the config.
  714. 'set' allows changing some variables in the config.
  715. Using with no parameters will show all changeable options.
  716. Simply specify the option and new setting as follows:
  717. set <what> [option]
  718. WARNING: Options changed MAY OR MAY NOT affect bots already running,
  719. it is a good idea to restart all bots on the shell
  720. if you change any of the following:
  721. $bhomedir$b, $bbinpath$b, $bbinname$b, $bportmin$b, $bportmax$b
  722. See also: newleaf, newhub
  723. ::console:
  724. ### $bconsole$b [channel] [modes]
  725. Changes your console level so that you will see only the types of console
  726. messages that you want to. Your current console channel is the channel (that
  727. the bot is on) from which you can view from the party line, and which
  728. channel-specific commands (like 'say' and 'op') take affect on.
  729. Valid flags are:
  730. $bj$b joins, parts, quits, and netsplits on the channel
  731. $bk$b kicks, bans, and mode changes on the channel
  732. $bm$b private msgs, notices and ctcps to the bot
  733. $bp$b public text on the channel
  734. $bs$b server connects, disconnects, and notices
  735. %{+m}
  736. Masters only:
  737. $bb$b information about bot linking and userfile sharing
  738. $bd$b misc debug information
  739. $bc$b commands
  740. $bo$b misc info, etc (IMPORTANT STUFF)
  741. $bw$b wallops
  742. %{-}
  743. %{+n}
  744. Owners only (these have to be enabled in the config file via "set raw-log"):
  745. $be$b errors
  746. $bg$b (getin) botnet op/invite/key requests
  747. $bh$b raw share traffic
  748. $br$b raw incoming server traffic
  749. $bt$b raw botnet traffic
  750. $bu$b warnings
  751. $bv$b raw outgoing server traffic
  752. %{-}
  753. %{+o|o}
  754. The mode can also be a modifier like '+p' or '-jk' or '+mp-b'. If you omit
  755. the channel and modes, your current console channel and flags will be shown.
  756. %{-}
  757. %{+m|m}
  758. ### $bconsole$b <user> [channel] [modes]
  759. This is used to set the console level of another user. This can even be used
  760. on users who normally would not be able to set their own console mode.%{-}
  761. See also: color, echo, login, page, strip
  762. ::crontab:
  763. ### $bcrontab$b <status|delete|show|new> [interval]
  764. This command is used to manipulate the crontab entries for the user
  765. that the bot is running on.
  766. 'status' will display the status of the crontab entry for the bot,
  767. for example:
  768. [18:59] #bryan# crontab status
  769. Crontabbed
  770. 'show' will display the current crontab entries, for example:
  771. [18:59] #bryan# crontab show
  772. Showing current crontab:
  773. Result:
  774. 3,8,13,18,23,28,33,38,43,48,53,58 * * * * /usr/home/bryan/hub/hub > /dev/null 2>&1
  775. 1,6,11,16,21,26,31,36,41,46,51,56 * * * * /usr/home/bryan/hub/newhub > /dev/null 2>&1
  776. 'delete' will remove the bot's own crontab entry from the crontab list.
  777. 'new' will make the bot add itself to the crontab list, although this is done
  778. automatically on startup.
  779. ::cycle:
  780. ### $bcycle$b <channel> [delay]
  781. If done on the hub, makes all linked bots cycle the specified channel.
  782. Otherwise, only the bot it is done on will cycle.
  783. Delay defaults to 10 seconds, which means bots will part and not rejoin
  784. until that time has passed.
  785. See also: down
  786. ::date
  787. ### $bdate$b
  788. Displays the time/date in local and GMT. Also displays which time zone
  789. is being used by the bot for internal logging.
  790. :hub:dccstat
  791. ### $bdccstat$b
  792. Displays a table-format list of all "dcc" connections in use on the bot.
  793. Dcc stands for "Direct Client-to-client Communication", and Eggdrop expands
  794. this to cover every open socket. Any type of network connection to the bot
  795. is considered a "dcc" connection.
  796. The headings of the table are:
  797. $bSOCK$b the socket number of this connection (always unique)
  798. $bADDR$b the ip address mask of the host the bot is connected to, if
  799. applicable
  800. $bPORT$b the port number being used for this connection
  801. $bNICK$b the handle of the user or bot, if applicable
  802. $bHOST$b the hostname corresponding to the IP address, if available
  803. $bTYPE$b the type of dcc connection (see below)
  804. The types of connections currently possible are as follows (but more are
  805. being added all the time):
  806. $bCHAT$b dcc-chat partyline user
  807. $bPASS$b user entering dcc chat (being asked for password)
  808. $bSEND$b user sending a file
  809. $bGET$b sending a file to a user
  810. $bGETP$b pending get (waiting for the user to acknowledge)
  811. $bLSTN$b telnet listening port (in place of a hostname, it will show the
  812. callback procedure name, or a mask of acceptable handles)
  813. $bT-IN$b incoming telnet user (being asked for handle)
  814. $bFILE$b user in dcc-chat file area
  815. $bBOT$b connected bot (botnet connection)
  816. $bBOT*$b pending bot link (waiting for acknowledgement)
  817. $bRELA$b user in relay connection to another bot
  818. $b>RLY$b bot being relay'd to (one for each "RELA")
  819. $bCONN$b pending telnet connection (chat, relay, bot-link, etc)
  820. $bNEW$b new user via telnet (entering a handle)
  821. $bNEWP$b new user via telnet (entering a password)
  822. In addition, 'CHAT' and 'BOT' have flags listed for each connection. Capital
  823. letters mean that the flag is on, and lowercase letters mean that the flag
  824. is off. The flags for 'CHAT' are:
  825. $bC$b in file area, but allowed to return to party line
  826. $bK$b color is on
  827. $bP$b party line access only
  828. $bT$b telnet connection (instead of dcc chat)
  829. $bE$b echo is on
  830. $bP$b paging is on
  831. $b6$b socket is ipv6
  832. The flags for 'BOT' are:
  833. $bP$b ping sent, waiting for reply
  834. $bU$b user-file sharing is active
  835. $bC$b local bot initiated the connection
  836. $bO$b user-file offered, waiting for reply
  837. $bS$b in the process of sending the user-file
  838. $bG$b in the process of getting the user-file
  839. $bW$b warned this bot to stop hubbing
  840. $bL$b leaf-only bot (not allowed to be a hub)
  841. $bI$b bot is currently in the 'linking' stage
  842. $bA$b bot is being aggressively shared with
  843. For 'CHAT' users, the party-line channel is also listed.
  844. ::debug
  845. ### $bdebug$b
  846. Display a dump of memory allocation information, assuming the bot was
  847. compiled with memory debugging. It's useless to anyone but developers
  848. trying to find memory leaks.
  849. ::decrypt
  850. ### $bdecrypt$b <key> <string>
  851. Decrypts the string using the specified key.
  852. See also: decrypt_fish, encrypt, encrypt_fish, randstring, md5, sha1, sha256, hash
  853. ::decrypt_fish
  854. ### $bdecrypt_fish$b <key> <string>
  855. Decrypts the string using the specified key.
  856. This algorithm is eggdrop's blowfish, same as FiSH.
  857. See also: decrypt, encrypt, encrypt_fish, randstring, md5, sha1, sha256, hash
  858. :leaf:deluser
  859. ### $bdeluser$b <nickname>
  860. Deletes a user record for a user on the channel, using their
  861. current hostname. Channel masters can remove users so long as
  862. the user isn't a bot master.
  863. Channel masters may only delete users which they added.
  864. see also: adduser%{+m}, +user, -user%{-}
  865. :leaf:deop
  866. ### $bdeop$b <nickname> [channel|*]
  867. Will remove chanop from the person you specify, so long as the
  868. bot is opped on that channel, and the person you specify isn't
  869. on the bot's list of authorized chanops. Specify * for all
  870. channels.
  871. See also: op, console
  872. :leaf:devoice
  873. ### $bdevoice$b <nickname> [channel|*]
  874. Will remove the +v voice from the person you specify, so long as
  875. the bot is opped on that channel. Specify * for all channels.
  876. ::die
  877. ### $bdie$b [reason]
  878. This kills the bot. The bot goes offline immediately, logging who issued
  879. the 'die' command. You shouldn't have to use this too often. If you specify
  880. a reason, it is logged, otherwise the reason is "authorized by <handle>".
  881. See also: suicide, conf
  882. ::dns
  883. ### $bdns$b <hostname/ip/flush>
  884. Resolves the given hostname/ip
  885. If "flush" is the specified hostname, the cache will be flushed.
  886. ::down:
  887. ### $bdown$b <channel>
  888. All linked bots will deop themselves in the specified channel. They
  889. will not reop for 10 seconds.
  890. See also: cycle
  891. :hub:downbots
  892. ### $bdownbots$b
  893. Shows the list of bots that are NOT currently linked to the botnet.
  894. Example:
  895. Down bots: cEvin, ruthie, Killa1
  896. See also: bots, groups
  897. :leaf:dump
  898. ### $bdump$b <text>
  899. dumps the text to the server. keep in mind that this bot doesn't
  900. run through ircII, so ircII commands will most likely not work this
  901. way. they need to be raw irc codes. read rfc1459 from ftp.internic.net
  902. for more help.
  903. '$n' is replaced with the bot's irc nickname.
  904. ** Only permanent owners specified in the binary COMPILE config file **
  905. ** can use this cmd. **
  906. ::echo
  907. ### $becho$b <on/off>
  908. Specifies whether you want your messages echoed back to you. If it's on,
  909. then when you say something on the party line, it will be displayed to you
  910. just like everyone else will see it. If it's off, then it won't happen.
  911. See also: color, console, login, page, strip
  912. ::encrypt
  913. ### $bencrypt$b <key> <string>
  914. Encrypts the string using the specified key.
  915. See also: encrypt_fish, decrypt, decrypt_fish, randstring, md5, sha1, sha256, hash
  916. ::encrypt_fish
  917. ### $bencrypt_fish$b <key> <string>
  918. Encrypts the string using the specified key.
  919. This algorithm is eggdrop's blowfish, same as FiSH.
  920. See also: encrypt, decrypt, decrypt_fish, randstring, md5, sha1, sha256, hash
  921. ::exec:
  922. ### $bexec$b <params>
  923. The bot will execute the specified program with each param specified,
  924. and display the results over DCC.
  925. ::exempts
  926. ### $bexempts$b [[channel/all/global]/wildcard]
  927. Shows you a list of the global exempts active on the current channel, and
  928. the list of channel-specific exempts, as well as any exempts that are on the
  929. channel but weren't placed by the bot.
  930. Here's a sample entry;
  931. ! [ 3] *!test@test.com (perm)
  932. bryan: requested
  933. Created 01:15
  934. The number (3) can be used to reference the exempt if you wish to remove it
  935. (see $b'-exempt'$b). Next is the actual hostmask being exempted. The "(perm)"
  936. means that the exempt is "permanent": that is, it doesn't automatically
  937. expire. If there is an elapsed time showing instead, the time displayed is
  938. how long the exempt has been active. These types of exempts expire after one
  939. hour. The second line of the exempt entry is the comment ("requested"), and
  940. who set the exempt (bryan). The last line shows when the exempt was added, and
  941. possibly the last time the exempt was activated on the channel (if it's
  942. different from the creation time).
  943. Sometimes there will be a "!" or "*" right before the number. A "!" means
  944. the exempt is in the bot's exempt list, but is not currently on the channel.
  945. A "*" marks an exempt which is NOT in the bot's exempt list but IS on the
  946. channel.
  947. If you use 'exempts' without an argument, it will show you only the exempts
  948. which are currently active on the channel. If you use 'exempts all', it will
  949. show you every exempt in the global exempt list and on the channel. If you
  950. use 'exempts <wildcard>', it will list all exempts (active or not) that
  951. match against your wildcard. Consider it a 'exempts all' list matched
  952. against your wildcard.
  953. If you use 'exempts global', a full list of exempts for EVERY channel will be
  954. displayed, including inactive/active exempts on each channel.
  955. The exempt list may change according to which channel you're currently
  956. viewing in the console. Different exempts may be active on different
  957. channels. If you specify a channel name, that channel will be used instead
  958. of your current console channel.
  959. See also: -exempt, +exempt, console%{+m|m}, chanset, chaninfo%{-}, stick, unstick
  960. :leaf:find:
  961. ### $bfind$b <nick!ident@host.com>|<user>
  962. The bot will search through all of its channel records and look
  963. for the specified hostmask. Wildcards are accepted; '*' for 1 or more
  964. characters, or '?' for exactly 1 character.
  965. If a username is specified, then the user is searched for in all the channel
  966. lists.
  967. ::fixcodes
  968. ### $bfixcodes$b
  969. This is for use in situations where the bot gets mixed up about the type
  970. of connection you have with it. For example, you /CTCP CHAT the bot and
  971. it thinks you are connecting via telnet, and you see text displayed as
  972. "Local time is now 17:17" for example instead of "Local time is
  973. now 17:17". Use this to turn telnet codes on or off/change the display
  974. mode.
  975. :leaf:getkey:
  976. ### $bgetkey$b [channel]
  977. If there is a key set for channel, it is displayed. If channel is not
  978. specified, your console channel is used.
  979. See also: console, channels%{+m}, status%{-}
  980. :hub:groups
  981. ### $bgroups$b [bot]
  982. Shows the list of groups and which bots are in them.
  983. Specify a bot to only show which groups it is in.
  984. Bots with a * preceding its name are down.
  985. See also: bots, downbots%{+n}, bottree%{-}
  986. ::handle
  987. ### $bhandle$b <new-handle>
  988. Changes your handle on the bot. This is the handle (nickname) that the
  989. bot will know you as from this point forward. It is used to log into the
  990. bot.
  991. Perm owners may not change their handle without recompiling binaries first.
  992. See also: newpass%{+mi}, chhandle, chpass%{-}%{+n}, chsecpass%{-}
  993. ::hash
  994. ### $bhash$b <string>
  995. Returns the MD5, SHA1, and SHA256 hash of the specified string.
  996. See also: randstring, md5, sha1, sha256, encrypt, encrypt_fish, decrypt, decrypt_fish
  997. ::help:
  998. ### $bhelp$b [cmd]
  999. Alone, will show all cmds that match your flags. With a cmd it will show
  1000. the help entry, such as you see here. Specifying a wildcard will display
  1001. a list of cmds (matching your flags) that match that wildcard. Use '*'
  1002. to match 1 or more characters, and '?' to match exactly one character.
  1003. This will only show the commands available on the current type of bot
  1004. you are on. Ie, hubs and leafs have different cmds shown in '%dhelp'
  1005. :hub:hublevel:
  1006. ### $bhublevel$b <hub-bot> <level>
  1007. Sets the hublevel for the specified hub. This command is not recommended
  1008. for use by anyone. Instead you should change your COMPILE config file
  1009. and update your net with new binaries.
  1010. You really shouldn't use this cmd.
  1011. See also: uplink, chaddr
  1012. ::ignores
  1013. ### $bignores$b [wildcard]
  1014. Shows a list of hostmasks from which the bot is currently ignoring msgs,
  1015. notices, etc. There are two types of ignores: permanent and temporary.
  1016. Permanent ignores never automatically expire. You must use $b'%d-ignore'$b
  1017. to remove them.
  1018. Here is a sample permanent ignore:
  1019. [ 1] *!*@217.156.44.184 (perm)
  1020. bryan: go away
  1021. Started 523 days ago
  1022. The number (1) can be used to reference the ignore if you wish to remove it
  1023. (see $b'%dhelp -ignore'$b). Next is the actual hostmask being ignored. The
  1024. "(perm)" means that the ignore is "permanent": that is, it doesn't
  1025. automatically expire. The second line of the ignore entry is the comment
  1026. ("go away"), and who set the ban (bryan). The last line shows when the ignore
  1027. was added.
  1028. Here is a sample temporary ignore:
  1029. [ 10] blah!blah@blah.cc (expires in 1 day)
  1030. bryan: requested
  1031. Started 18:02
  1032. Here, you see the "perm" in the parentheses next to the hostmask is instead
  1033. an expire time. This means that the ignore will expire automatically in one
  1034. day.
  1035. If you use $b'%dignores <wildcard>'$b, it will list all the ignores
  1036. that match against your wildcard.
  1037. See also: +ignore, -ignore
  1038. ::info
  1039. ### $binfo$b [channel] [info-line]
  1040. Sets your info line. This line is shown via the /msg commands $b'who'$b and
  1041. $b'whois'$b. If the info line begins with an '@', then it is "locked", and
  1042. you may no longer change it.
  1043. %{+m|m}See also: chinfo%{-}
  1044. :leaf:invite
  1045. ### $binvite$b <nickname> [channel|*]
  1046. Invites someone from irc into your current console channel (or
  1047. specified other channel). This is most useful when the channel
  1048. is +i. a user with the +o flag can also request an invite from
  1049. the bot with /MSG INVITE. Specify * for all channels.
  1050. See also: console, iop
  1051. ::invites
  1052. ### $binvites$b [[channel/all/global]/wildcard]
  1053. Shows you a list of the global invites active on the current channel, and
  1054. the list of channel-specific invites, as well as any invites that are on the
  1055. channel but weren't placed by the bot.
  1056. Here's a sample entry;
  1057. ! [ 3] *!test@test.com (perm)
  1058. bryan: requested
  1059. Created 01:15
  1060. The number (3) can be used to reference the invite if you wish to remove it
  1061. (see $b'-invite'$b). Next is the actual hostmask being invited. The "(perm)"
  1062. means that the invite is "permanent": that is, it doesn't automatically
  1063. expire. If there is an elapsed time showing instead, the time displayed is
  1064. how long the invite has been active. These types of invites expire after one
  1065. hour. The second line of the invite entry is the comment ("requested"), and
  1066. who set the invite (bryan). The last line shows when the invite was added, and
  1067. possibly the last time the invite was activated on the channel (if it's
  1068. different from the creation time).
  1069. Sometimes there will be a "!" or "*" right before the number. A "!" means
  1070. the invite is in the bot's invite list, but is not currently on the channel.
  1071. A "*" marks an invite which is NOT in the bot's invite list but IS on the
  1072. channel.
  1073. If you use 'invites' without an argument, it will show you only the invites
  1074. which are currently active on the channel. If you use 'invites all', it will
  1075. show you every invite in the global invite list and on the channel. If you
  1076. use 'invites <wildcard>', it will list all invites (active or not) that
  1077. match against your wildcard. Consider it a 'invites all' list matched
  1078. against your wildcard.
  1079. If you use 'invites global', a full list of invites for EVERY channel will be
  1080. displayed, including inactive/active invites on each channel.
  1081. The invite list may change according to which channel you're currently
  1082. viewing in the console. Different invites may be active on different
  1083. channels. If you specify a channel name, that channel will be used instead
  1084. of your current console channel.
  1085. See also: -invite, +invite, console%{+m|m}, chanset, chaninfo%{-}, stick, unstick
  1086. :leaf:iop
  1087. ### $biop$b <nickname> [channel|*]
  1088. Same as normal invite, except auto-ops them when they join.
  1089. See also: console, invite
  1090. :leaf:jump
  1091. ### $bjump$b [server [port [pass]]]
  1092. Makes the bot jump to another server. If you don't specify a
  1093. server, it will jump to the next server in its internal list (see
  1094. $b'%dhelp set'$b). If you specify a server, it will jump to that
  1095. server (default port is 6667), and if that server is not in the
  1096. internal list already, it will add it (until the bot relinks).
  1097. Jumping servers ALWAYS makes the bot lose ops! be careful!
  1098. See also: botjump, servers, botserver
  1099. :leaf:keyx
  1100. ### $bkeyx$b <nick>
  1101. Initiaite DH1080 key-exchange with nick for FiSH protocol.
  1102. %{+m}See also: setkey%{-}
  1103. :leaf:kick
  1104. ### $bkick$b [channel|*] <nickname> [reason]
  1105. Will kick a user off your current console channel (or specified
  1106. other channel) with the comment given. if you omit the reason,
  1107. the default kick comment is "requested". Specify * for all
  1108. channels.
  1109. See also: kickban, console
  1110. :leaf:kickban
  1111. ### $bkickban$b [channel|*] [-|@]<nickname> [comment]
  1112. Kicks a user off the channel and bans her by a reasonable host-
  1113. mask. your nickname will be attached to the ban in the bot's
  1114. internal ban list, and the ban will last for whatever is set in
  1115. ban-time -- only on this channel. use $b'%d+ban'$b for a more
  1116. permanent ban which will be activated on every channel the bot
  1117. monitors. if you use a comment, that will also be attached to
  1118. the ban in the ban list, and used as the kick comment. Specify
  1119. * for all channels.
  1120. appending a prefix of ! or @ to a nickname changes the ban
  1121. mask used:
  1122. e.g. with a host of nick!ident@host.name.domain
  1123. command banmask
  1124. '%dkickban nick *!*dent@*.name.domain'
  1125. '%dkickban -nick *!*dent@host.name.domain'
  1126. '%dkickban @nick *!*@host.name.domain'
  1127. with a host of nick!~ident@host.name.domain (strict-host set to 1)
  1128. command banmask
  1129. '%dkickban nick *!*ident@*.name.domain'
  1130. '%dkickban -nick *!*ident@host.name.domain'
  1131. See also: +ban, bans, stick
  1132. :hub:lagged:
  1133. ### $blagged$b
  1134. Displays the bot's internal ping list of bots linked to it.
  1135. If a pingtime goes over 30 seconds, it is delinked for
  1136. ping timeout.
  1137. See also: netlag
  1138. ::last:
  1139. ### $blast$b
  1140. Displays the 'last' output from the shell the bot is running on,
  1141. for the user it is running as.
  1142. %{+i}See also: netlast%{-}
  1143. :hub:link
  1144. ### $blink$b [via-bot] <bot-to-link>
  1145. Attempts to link to another hub. This command is deprecated and not
  1146. recommended for use.
  1147. See also: unlink%{+ni}, newleaf%{-}%{+a}, newhub, -bot%{-}
  1148. ::login
  1149. ### $blogin$b <banner|bots|channels|whom> [on/off]
  1150. Sets various login options.
  1151. Not specifying on/off will display what the setting is the for the specified
  1152. login entry.
  1153. See also: echo, color, console, page, strip, whois
  1154. ::match
  1155. ### $bmatch$b <attr> [channel] [[start] limit]
  1156. This displays all user records with the attributes requested.
  1157. "attr" is of the form: <+/-><global>[&/|<channel>[&/|<bot>]]
  1158. Specifying "&" as the separator will cause AND style matching.
  1159. For example:
  1160. '%dmatch p&o'
  1161. This will match all users with both the "p" global flag and the "o" channel
  1162. flag on your current console channel.
  1163. Specifying "|" as the separator will cause OR style matching.
  1164. For example:
  1165. '%dmatch p|o'
  1166. This will match all users with either the "p" global flag or the "o" channel
  1167. flag on your current console channel. If you specify a channel, it will be
  1168. used instead of the current console channel.
  1169. For example:
  1170. '%dmatch p|o #eggdrop'
  1171. This will match all users with either the "p" global flag or the "o" channel
  1172. flag on the channel #eggdrop. You can also match bot flags.
  1173. For example:
  1174. '%dmatch o|o|h'
  1175. This will match all bots with either the "o" global flag, the "o" channel
  1176. flag on the current console channel, or the "h" botflag. You can also limit
  1177. the number of total results returned by specifying a limit at the end of the
  1178. command. A starting point can also be specified.
  1179. For example:
  1180. '%dmatch p&o #eggdrop 16 25'
  1181. This would show results 16 through 25 matching any users with the "p" global
  1182. flag or the "o" channel flag on #eggdrop.
  1183. ### $bmatch$b <wildcard-string> [[start] limit]
  1184. This displays all user records where the user's handle or any of the user's
  1185. hostmasks match the specified wildcard string. You can also limit the number
  1186. of total results returned by specifying a limit at the end of the command. A
  1187. starting point can also be specified.
  1188. For example:
  1189. '%dmatch *.edu 16 25'
  1190. This would show results 16 through 25 matching any users with a hostmask
  1191. that ends with ".edu".
  1192. $bThis command will not match on bots. You must use 'matchbot' for that.$b
  1193. See also: matchbot
  1194. ::matchbot
  1195. ### $bmatchbot$b
  1196. Matches bots.
  1197. See also: match
  1198. ::md5
  1199. ### $bmd5$b <string>
  1200. Returns the MD5 hash of the specified string.
  1201. See also: randstring, sha1, sha256, hash, encrypt, encrypt_fish, decrypt, decrypt_fish
  1202. ::me
  1203. ### $bme$b <text>
  1204. Performs an action on the party line. This appears as "* bryan is leaving",
  1205. etc.
  1206. :leaf:mmode:
  1207. ### $bmmode$b <(+|-)MODE> <#channel> <a|o|v|d|r> [bots=n] [alines=n] [slines=n] [overlap=n] [bitch] [botbitch] [simul] [local]
  1208. For those of us who do not wish to be rocket scientists in the mass mode department,
  1209. a simple '%dmmode -o #channel o' will suffice.
  1210. This is a distributed mass mode command.
  1211. The modes will be distributed among the necessary bots to accomplish the task.
  1212. **Remember, unless specified with [local], the bot you mmode on will never participate.**
  1213. options:
  1214. $ba$b = $ball.$b
  1215. $bo$b = $bops.$b
  1216. $bO$b = $buser-op.$b
  1217. $bv$b = $bvoices.$b
  1218. $bd$b = $bnon-ops.$b
  1219. $br$b = $bregulars (-ov).$b
  1220. $bbitch$b - set +bitch after finished with mmode.
  1221. $bbotbitch$b - set +bitch after finished with mmode.
  1222. $bsimul$b - Simulates the mmode. IE: Gives you a practice run, will show who
  1223. does what in the dcc chat window.
  1224. $blocal$b - Modes will not be distributed: Ran on local bot only.
  1225. Use this with caution, and do not expect good results.
  1226. =============================================================================
  1227. don't bother setting the following options unless you REALLY know what you're
  1228. doing, and don't bother messaging me asking me how to use them if you don't.
  1229. =============================================================================
  1230. $bbots$b - Number of bots to use.
  1231. $balines$b - Number of MODE lines to assume each participating bot will get through.
  1232. $bslines$b - Number of MODE lines each participating bot will send.
  1233. $boverlap$b - Number of times to mode on each target nick (using alines for calc).
  1234. bots, alines, slines and overlap are dependant on each other, set them wrong and
  1235. the bot will complain.
  1236. Defaults are alines=1, slines=5, overlap=1. alines will be increased up to 5 if
  1237. there are not enough bots available.
  1238. Examples:
  1239. To mass deop (old style '%dmdop')
  1240. '%dmmode -o #chan o overlap=2'
  1241. To mass voice non-ops
  1242. '%dmmode +v #chan d'
  1243. To mass voice non-ops and non-voices
  1244. '%dmmode +v #chan r'
  1245. See also: mop
  1246. :leaf:mop:
  1247. ### $bmop$b <channel|*>
  1248. Bot will op all users in the specified channel that are valid ops
  1249. for the channel. If '*' is specified, the bot will scan all channels
  1250. and op all users in all channels that are valid ops in each chan.
  1251. See also: whois
  1252. ::motd
  1253. ### $bmotd$b %{+m}<message>%{-}
  1254. This redisplays the partyline Message Of The Day, which was shown when you
  1255. first joined the partyline.
  1256. %{+m}+m: Include a message to set the motd.%{-}
  1257. :leaf:msg
  1258. ### $bmsg$b <nickname> <text>
  1259. Sends a private message to someone from the bot, just as if the
  1260. bot had typed /msg.
  1261. See also: botmsg%{+n}
  1262. :hub:netcrontab:
  1263. ### $bnetcrontab$b <status|delete|show|new> [interval]
  1264. Runs the specified command on all linked bots.
  1265. See: crontab
  1266. :hub:netlag:
  1267. ### $bnetlag$b
  1268. Pings all bots over botnet, and displays results.
  1269. See also: lagged
  1270. :hub:netlast:
  1271. ### $bnetlast$b
  1272. All bots on the botnet will display an output from 'last' on
  1273. the user that they are currently running as.
  1274. See also: last
  1275. :hub:netnick:
  1276. ### $bnetnick$b
  1277. All bots on the botnet will display their nick over DCC.
  1278. See also: botnick, nick
  1279. :hub:netps:
  1280. ### $bnetps$b [ps-param]
  1281. Will run 'ps' on each bot on the botnet and returned the
  1282. results. If a params are specified, each bot will use those
  1283. on 'ps'.
  1284. See also: ps
  1285. :hub:netrelease
  1286. ### $bnetrelease$b <nick>
  1287. Tells all bots to unjupe the specified nickname. They will wait 7 seconds
  1288. before attempting to regain the nickname.
  1289. See also: set, release
  1290. :hub:netrontab:
  1291. ### $bnetcrontab$b <status|delete|show|new> [interval]
  1292. Runs the specified crontab command on all linked bots.
  1293. See: crontab
  1294. :hub:netserver:
  1295. ### $bnetservers$b
  1296. All bots on the botnet will display their current server and lag
  1297. to that server over DCC.
  1298. See also: botserver, servers%{+n}, set%{-}
  1299. :hub:netversion:
  1300. ### $bnetversion$b <bot>
  1301. All bots on the botnet will display their pack version, and uname.
  1302. See also: botversion, version, about%{+m|m}, status%{-}
  1303. :hub:netw:
  1304. ### $bnetw$b
  1305. All bots on the botnet will run 'w' on their shell and display
  1306. the results over DCC.
  1307. See also: w
  1308. :hub:newhub:
  1309. ### $bnewhub$b <handle> <address> <port> [hublevel]
  1310. Add a new hub to the net.
  1311. See also: chaddr, newleaf
  1312. :hub:newleaf:
  1313. ### $bnewleaf$b <handle> [hostmask] [anotherhostmask] ...
  1314. Adds a new leaf to the botnet with the specified handle and hostname.
  1315. Any number of hosts can be specified in the cmd.
  1316. The binary config botline will also be outputted, but should be
  1317. checked for correctness.
  1318. %{+a}See also: newhub%{-}
  1319. ::newpass
  1320. ### $bnewpass$b <password|rand>
  1321. Changes your password on the bot. This is similar to the '/msg <bot> pass'
  1322. command, except you don't need to specify your old password. If the
  1323. newpassword is 'rand', a random password will be used.
  1324. %{+mi}See also: chpass%{-}%{+n}, chsecpass%{-}
  1325. ::nick
  1326. See: handle
  1327. ::nick:
  1328. ### $bnick$b <bot>
  1329. The bot will display its current nick over DCC.
  1330. See also: botnick, netnick
  1331. :hub:nopass
  1332. ### $bnopass$b [anything]
  1333. Displays all users who do not have a password set.
  1334. Specify any argument to give random passes to users.
  1335. %{+mi}See also: chpass%{-}
  1336. :leaf:op
  1337. ### $bop$b <nickname> [channel|*]
  1338. Will grant chanop to the person you specify, so long as the bot
  1339. is opped on that channel, and the person you specify isn't being
  1340. actively deopped by the bot. Specify * for all channels.
  1341. See also: deop, console
  1342. ::page
  1343. ### $bpage$b <number/off>
  1344. This allows you to slow down the number of lines the bot sends you at once
  1345. via the partyline. When enabled, any commands that send greater than the
  1346. specified number of lines will stop when that number is reached and wait for
  1347. you to type another command (or press enter) to continue. If you have too
  1348. many pending lines, you may be booted off the bot.
  1349. See also: color, console, echo, login, strip
  1350. :leaf:play
  1351. ### $bplay$b [channel] <file>
  1352. Plays the specified file to the specified channel. If no channel is
  1353. given then your console channel is used.
  1354. The 'play' queue is used for this, which is the lowest priority on
  1355. the bot. Any IRC related queue needs will immediately trump
  1356. the 'play' queue and delay the playing of the file.
  1357. Only files in the bots directory path may be played. (Symlinked
  1358. paths are fine). This is to prevent a user from playing /etc/passwd
  1359. since the cmd is +m.
  1360. ::ps:
  1361. ### $bps$b [ps-param]
  1362. Will run 'ps' on the bot's shell and display any results. If
  1363. any params are specified, they will be used.
  1364. %{+i}See also: netps%{-}
  1365. ::quit
  1366. ### $bquit$b [comment]
  1367. This disconnects you from the partyline. If you specify a comment, it will
  1368. be displayed to other partyline users as you leave.
  1369. ::randstring
  1370. ### $brandstring$b <len>
  1371. Displays a random string of length 'len' up to 300 chars.
  1372. See also: md5, sha1, sha256, hash, encrypt, encrypt_fish, decrypt, decrypt_fish
  1373. ::rehash
  1374. ### $brehash$b
  1375. Don't use this cmd, it doesn't do what you think it does, and can result
  1376. in the bot behaving very oddly.
  1377. Reloads config data from binary. (Probably won't be needed as this is
  1378. automatically updated after editing the binary with -C)
  1379. See also: restart
  1380. ::relay
  1381. ### $brelay$b <bot>
  1382. Relays you via telnet to another bot, whether or not it is currently linked.
  1383. The local bot must, however, have a bot record for the bot you wish to
  1384. relay to. Typing '%dquit' or "*bye*" on a line by itself will end the relay.
  1385. See also: bots%{+n}, newleaf%{-}%{+a}, newhub, -bot%{-}
  1386. :leaf:release
  1387. ### $brelease$b
  1388. Releases the bot's nick if it is on the jupenick. It gives an estimated
  1389. 7 seconds before it attempts to regain its jupenick.
  1390. See also: set, netrelease
  1391. ::reload
  1392. ### $breload$b
  1393. Reloads the bot's user file, discarding any changes made since the last
  1394. $b'%dsave'$b command or hourly user file save.
  1395. See also: save
  1396. :leaf:reset
  1397. ### $breset$b [channel]
  1398. Clears out the bot's channel information and makes it gather the
  1399. information from the server all over again, as if it had just
  1400. joined that channel. It's not really useful much, but could be
  1401. if an odd bug causes the channel information to get scrambled.
  1402. unfortunately this command used to get a lot of use. You can omit
  1403. the channel name to make it reset ALL channels.
  1404. See also: resetbans, resetexempts, resetinvites
  1405. :leaf:resetbans
  1406. ### $bresetbans$b [channel]
  1407. Resets the bot's ban list for the channel. any bans on the channel
  1408. that aren't in the ban list (either the global list or the local
  1409. channel ban list) will be removed, and if there are any bans in the
  1410. global ban list or channel ban list that are not currently on the
  1411. channel, they will be added.
  1412. See also: bans, console%{+m|m}, reset%{-}
  1413. :leaf:resetexempts
  1414. ### $bresetexempts$b [channel]
  1415. Resets the bot's exemption list for the channel. this command
  1416. behaves exactly like resetbans, except it is for exempts.
  1417. See also: resetbans, resetinvites
  1418. :leaf:resetinvites
  1419. ### $bresetinvites$b [channel]
  1420. Resets the bot's invitation list for the channel. this command
  1421. behaves exactly like resetbans, except it is for invites.
  1422. See also: resetbans, resetinvites
  1423. ::restart
  1424. ### $brestart$b
  1425. Makes the bot restart, but keeps its connection to IRC active.
  1426. See also: rehash, reload, save
  1427. :leaf:roles
  1428. ### $broles$b [channel]
  1429. Displays which bots are fullfilling which roles for a channel.
  1430. Some roles replace older botflags. See '%dhelp whois' for more
  1431. information.
  1432. $bRole$b $bFlag$b $bDescription$b
  1433. voice y Voice any +v users and handle +voice.
  1434. flood f Handle channel flood controls.
  1435. op y Auto-op +O users and handle autoop.
  1436. deop Deop clients on +bitch or +revenge needs.
  1437. kick Kick clients on +bitch, +revenge or +k needs.
  1438. ban Kick clients on +bitch, +revenge or +k needs.
  1439. topic Set the topic as needed for topic protect.
  1440. limit l Handle automatically raising limit as needed.
  1441. resolv r DNS all clients to look for ban/op matching.
  1442. revenge React to +revenge needs.
  1443. chanmode Set channel protect modes as needed.
  1444. protect Handle +protect needs.
  1445. See also: whois%{+m|m}, chanset, chaninfo%{-}
  1446. :hub:save
  1447. ### $bsave$b
  1448. This makes the bot write its entire userfile to disk. This is useful if you
  1449. think the bot is about to crash or something, since the user file is only
  1450. written to disk about once an hour.
  1451. See also: reload, backup
  1452. :leaf:say
  1453. ### $bsay$b [channel] <text>
  1454. Dumps the text to your current console channel (or other specified
  1455. channel), as if the bot "said" it.
  1456. ::secpass:
  1457. ### $bsecpass$b <password|rand>
  1458. Changes your secpass on the bot. This is used for Authing via /msg
  1459. and for DCC. If the password is 'rand', a random password will be used.
  1460. %{+mi}See also: chpass%{-}%{+n}, chsecpass%{-}
  1461. :leaf:servers
  1462. ### $bservers$b
  1463. Lists the servers that the bot has in its server list. this is
  1464. the list it rotates through when changing servers. it starts
  1465. with a static list which it loads from its config-file when the
  1466. bot is booted up. after that, you can add servers with the
  1467. $b'%djump'$b command. the server list will indicate which server the
  1468. bot is currently on.
  1469. :hub:set:
  1470. ### $bset$b [<+/->list] [<var> [data|-]]
  1471. Sets various options. Type alone to see all set entries. To set
  1472. an entry do '%dset name VALUE'. Use '-' as a value to clear an entry.
  1473. The <var> may have wildcards. Wildcards will only be used for listing
  1474. variable, not for setting.
  1475. The '+' may be used to add 1 element to a comma separated list. (ie, servers)
  1476. The '-' may be used to remove 1 element from a comma separated list. (ie, servers)
  1477. The 'list' may be used to list a comma separated variable as a vertical listing. (like '%dservers')
  1478. Current variables:
  1479. $uB$u: Boolean (0/1/true/on/false/off)
  1480. $uS$u: String
  1481. $uN$u: Number
  1482. $uL$u: List
  1483. $uR$u: Rate. Set as 'number:interval', ie, '1:5'
  1484. $uD$u: Detected vars have the following options: $bignore$b/0, $bwarn$b/1, $breject$b/2,
  1485. $bdie$b/3, $bsuicide$b/4
  1486. [L] $balias$b List of dcc aliases in format '<alias> <cmd> [parms]'. First
  1487. matching alias is used. Normal flag checking is done
  1488. after the alias is expanded.
  1489. $bAliases may not reference other aliases.$b
  1490. [N] $bserver-cycle-wait$b Amount of time in seconds to wait between server reconnections.
  1491. [N] $bserver-port$b Default port to use for server connections.
  1492. [N] $bserver-port-ssl$b Default port to use for SSL server connections.
  1493. [B] $bserver-use-ssl$b Use SSL for IRC server connections?
  1494. [N] $bwait-split$b How long in seconds to track netsplit members.
  1495. [B] $bauth-chan$b If set, auth cmds will work in channels as well as in msg, otherwise
  1496. only in msg.
  1497. [S] $bauth-key$b The authkey used during authing. Give to users if they need to auth.
  1498. (can be bot specific)
  1499. [C] $bauth-prefix$b The prefix character used for msg cmds, ie: $u!$uop or $u.$uop
  1500. [B] $bauth-obscure$b Will not halt on dcc login if pass is wrong. Will display auth hash..
  1501. Will always fail at hash though.
  1502. [N] $bdcc-autoaway$b Time in seconds until a user is set auto-away on dcc.
  1503. (0/- to disable)
  1504. [B] $bmanop-warn$b Warn users via /NOTICE when they msg-op in a channel with manop
  1505. punishments.
  1506. * Msg cmd vars may be left blank to disable usage of cmd.
  1507. [S] $bmsg-op$b Defines the cmd for opping via msging the bot.
  1508. [S] $bmsg-pass$b Defines the cmd for setting a pass via msging the bot.
  1509. [S] $bmsg-invite$b Defines the cmd for requesting invite via msging the bot.
  1510. [S] $bmsg-ident$b Defines the cmd for identing via msging the bot.
  1511. [S] $bmsg-release$b Defines the cmd for releasing a nick.
  1512. [R] $bflood-msg$b Msgs:Secs until a host is ignored. (0:0 to disable)
  1513. [R] $bflood-ctcp$b Ctcps:Secs until a host is ignored. (0:0 to disable)
  1514. [R] $bflood-callerid$b Msgs:Secs until triggering to set CALLERID for
  1515. 60 seconds (0:0 to disable)
  1516. [D] $blogin$b How to handle someone logging in to the shell.
  1517. [D] $btrace$b How to handle someone tracing/debugging the bot.
  1518. [D] $bpromisc$b How to handle when an interface is set to promiscuous mode.
  1519. [D] $bhijack$b How to handle when a commonly used hijack method attempt is detected.
  1520. [L] $bservers$b Comma-separated list of servers the bot will use.
  1521. [L] $bservers-ssl$b Comma-separated list of SSL servers to use if server-use-ssl is true.
  1522. [L] $bservers6$b Comma-separated list of servers the bot will use (FOR IPv6).
  1523. [L] $bservers6-ssl$b Comma-separated list of IPv6 SSL servers to use if server-use-ssl is true.
  1524. [N] $bmsgburst$b How many messages to burst at once to server. (Too high will excess flood)
  1525. [N] $bmsgrate$b How often (msecs) to dequeue msgs to the server. Only used on
  1526. non-ratbox servers. Too small a value can result in Excess Flood.
  1527. [L] $bgroups$b List of groups that the affected bots are a part of.
  1528. [L] $brbl-servers$b Servers to use for RBL checking in channels that are +rbl.
  1529. [S] $brealname$b The bot's "real name" when connecting. (supports '$n' expansion)
  1530. [S] $busermode$b The bot's usermode on IRC. (Set on connect/rehash)
  1531. [B] $bdeaf$b Runs bot in DEAF mode if the IRCD supports it. This will stop
  1532. the IRCD from sending any channel conversations to the bot.
  1533. This will decrease bandwidth/CPU used, as well as prevent
  1534. sniffing of channels.
  1535. [B] $bcallerid$b Run bot in CALLERID mode. This is commonly known as +g on most
  1536. servers. +c bots will automatically accept messages from
  1537. known users. Note that this will break msg-ident.
  1538. [B] $bfish-auto-keyx$b Whether to automatically do a DH1010 FiSH Key exchange when
  1539. accepting users. This is only supported if using callerid.
  1540. [B] $bfish-paranoid$b Whether to automatically re-keyexchange after every message. This
  1541. mitigates replay attacks.
  1542. [S] $baltchars$b Define string of characters to cycle when generating alternative
  1543. nicks when nick is taken. Ie: _-`[].
  1544. [S] $bjupenick$b The bot will attempt to jupe this nick. It will never use a variation
  1545. of the nick though. It will still prefer 'nick' over a variation
  1546. of jupenick.
  1547. [S] $bnick$b The bot's preferred nickname on IRC. It will auto rotate and append
  1548. 'altchars' on the end if taken.
  1549. [N] $bnotify-time$b The number of seconds between server notify checks for nick, if
  1550. the server does not support MONITOR.
  1551. [B] $birc-autoaway$b Should the bot go away auto?
  1552. [B] $bident-botnick$b Send botnick instead of shell username on connect (non-ident)
  1553. [B] $boidentd$b Make bot try and use oidentd spoofing as BOTNICK.
  1554. [B] $blink_cleartext$b Allows bots to link without an encryption scheme. This is needed
  1555. for allowing older bots to link in. Be sure to never leave this on
  1556. unless upgrading or letting an older bot link in to upgrade.
  1557. [B] $bdccauth$b Boolean (0 or 1). Set to use auth checking on dcc/telnet login.
  1558. [N] $bop-bots$b Number of bots to ask every time an oprequest is to be made.
  1559. [N] $bin-bots$b Number of bots to ask every time an inrequest is to be made.
  1560. [R] $bop-requests$b (requests:seconds) limits how often the bot will ask for ops.
  1561. [R] $bclose-threshold$b (H:L) When at least H hubs but L or less leafs are linked, close
  1562. all channels.
  1563. [N] $blag-threshold$b Maximum acceptable server lag for the bot to send/honor requests.
  1564. [N] $bkill-threshold$b When more than this many bots have been killed/klined in the last
  1565. minute, close all channels.
  1566. [N] $bfight-threshold$b When more than this many +obeI/-obeI/kicks have happened on a channel
  1567. in 1 minute, the channel is locked down. Channel must be +protect.
  1568. See also '%dhelp chanset' for +protect.
  1569. [N] $bcloak-script$b Decides which script the bot cloaks as.
  1570. If set to 0, a random script will be used.
  1571. 1=plain bitchx, 2=crackrock, 3=neonapple, 4=tunnelvision,
  1572. 5=argon, 6=evolver, 7=prevail 8=cypress 9=mIRC 10=other
  1573. * $bExamples$b:
  1574. '%dset realname I have no realname, I'm a bot!'
  1575. '%dbotset wraith realname The best pack evar!'
  1576. '%dset +servers irc.efnet.org'
  1577. '%dset -servers irc.efnet.org'
  1578. '%dset list servers'
  1579. '%dset -servers 10'
  1580. '%dbotset wraith nick -'
  1581. See also: botset
  1582. :leaf:setkey
  1583. ### $bsetkey$b <nick> [key|rand]
  1584. Sets the FiSH key for the given target.
  1585. Use no key to clear the currently set key.
  1586. Use 'rand' to generate a random key.
  1587. See also: keyx
  1588. ::sha1
  1589. ### $bsha1$b <string>
  1590. Returns the SHA1 hash of the specified string.
  1591. See also: randstring, md5, sha256, hash, encrypt, encrypt_fish, decrypt, decrypt_fish
  1592. ::sha256
  1593. ### $bsha256$b <string>
  1594. Returns the SHA256 hash of the specified string.
  1595. See also: randstring, md5, sha1, hash, encrypt, encrypt_fish, decrypt, decrypt_fish
  1596. ::simul
  1597. ### $bsimul$b <handle> <text>
  1598. This allows you to simulate the specified handle typing the given text.
  1599. For example:
  1600. '%dsimul dweeb %dquit'
  1601. This would appear just as if "dweeb" typed '%dquit'. This command will not
  1602. work unless eggdrop has simul enabled in the config file.
  1603. See also: su
  1604. ::slowjoin:
  1605. ### $bslowjoin$b <channel> <interval-seconds> [channel-options]
  1606. All bots on the botnet will join the channel at the rate of one bot
  1607. per 'interval-seconds'. If any channel-options are specified, the
  1608. channel will be added with those options.
  1609. See also: slowpart, chanset, chaninfo
  1610. ::slowpart:
  1611. ### $bslowpart$b <channel> <interval-seconds>
  1612. All bots on the botnet will part the specified channel at the rate
  1613. of one bot per 'interval-seconds'
  1614. %{+n}See also: slowjoin%{-}
  1615. ::status
  1616. ### $bstatus$b
  1617. ### $bstatus all$b
  1618. Displays a condensed block of status information about the bot.
  1619. is running. For example:
  1620. [01:15] #bryan# status
  1621. I am wtest, running [wraith] Wraith 1.2.3-cvs: 274 users
  1622. Online for 00:33 (terminal mode) CPU 00:01 cache hit 28.3%
  1623. OS: Linux 2.4.30
  1624. Running from: /home/wheel/bryan/.sshrc
  1625. uid: bryan (1000) pid: 25114 homedir: /home/wheel/bryan
  1626. Tempdir : /home/wheel/bryan/.ssh/.../
  1627. Channels: #|DAWG|Net, #|DAWG|Tcl
  1628. Online as: D|Anakha!wcc@cia.nu (|DAWG|Anakha - |DAWG|Net)
  1629. Server irc.inet.tele.dk:6667 (connected for 11 days)
  1630. #|DAWG|Net: 6 members, enforcing "+istn" (lurking)
  1631. #|DAWG|Tcl: 42 members, enforcing "+tn" (lurking)
  1632. The first line tells you the bot's name, what version of Eggdrop it's
  1633. running, the number of users the bot has records of, and the amount of
  1634. memory being used by the userfile. The second line tells you the uptime of
  1635. the bot, CPU time, and cache hit. The third shows the bot's admin, and the
  1636. forth shows its current config file. The fifth line shows what operating
  1637. system the bot is running on. The next two lines show Tcl information. If
  1638. debug mode is enabled, additional info may be shown. Sharing information
  1639. will also be shown if it's being used.
  1640. Select information from modules will be displayed after the core
  1641. information. If you use $b'%dstatus all'$b instead, you will see all status
  1642. information available from loaded modules.
  1643. See also: channel, channels%{+a}, debug%{-}
  1644. ::stick
  1645. ### $bstick$b [ban/exempt/invite] <hostmask/number> [channel]
  1646. Makes a ban, exempt, or invite "sticky". This means that the bot will always
  1647. try to keep it active on the channel. Obviously, if the channel isn't using
  1648. dynamic bans, this has no effect.
  1649. See also: bans, exempts, invites, unstick, +ban, +exempt, +invite
  1650. ::store
  1651. ### $bstore$b
  1652. Stores your console settings so that they are restored automatically the
  1653. next time you join the party line. ('console' calls this auto)
  1654. See also: console
  1655. ::strip
  1656. ### $bstrip$b [modes]
  1657. Allows you to remove embedded 'attribute' codes from your partyline output. Valid
  1658. options are:
  1659. $bb$b - remove all boldface codes
  1660. $bc$b - remove all color codes
  1661. $br$b - remove all reverse video codes
  1662. $bu$b - remove all underline codes
  1663. $ba$b - remove all ANSI codes
  1664. $bg$b - remove all ctrl-g (bell) codes
  1665. The mode can also be a modifier like '+c' or '-bu' or '+ru-c'. If
  1666. you omit modes, it will show your current setting.
  1667. NOTE: THIS CMD DOES NOT AFFECT ALL COLORS, PLEASE SEE '%dhelp color'
  1668. See also: fixcodes, color, echo, login, page
  1669. %{+m}
  1670. ### $bstrip$b <user> [modes]
  1671. Set the strip level of another user. A master can't set their own strip
  1672. flags without prefixing the modes with a '+' or '-'.%{-}
  1673. ::su
  1674. ### $bsu$b <user>
  1675. Lets you assume the identity of another user. If you are a global owner,
  1676. this does not require a password. Otherwise, you will be asked for the
  1677. user's password. $b%dquit$b returns you to your original handle.
  1678. ::suicide
  1679. ### $bsuicide$b [reason]
  1680. Makes bot remove itself and then dies. If bot is first bot in its binary
  1681. it will kill all bots running for that binary.
  1682. See also: die, conf, botcmd
  1683. :leaf:swhois
  1684. ### $bswhois$b [server/nick] <nick>
  1685. Displays a server /whois for the specified nick. Specifying
  1686. the nick twice will display idle time. Specifying a server will
  1687. display the whois as viewed by that server.
  1688. If the nick is currently not online, a /WHOWAS is done automatically.
  1689. This cmd will hide restricted username/channel info as follows:
  1690. -Username will be hidden for higher level users
  1691. -Users will not see +private chans unless they are in the chan or chan is -sp
  1692. -Users will not see channels that are +s or +p unless they have op access there
  1693. See also: find
  1694. ::tcl
  1695. ### $btcl$b script
  1696. Executes the given string and returns the result.
  1697. :leaf:topic
  1698. ### $btopic$b [channel] [new topic]
  1699. Changes the channel's topic, assuming the bot is a chanop or the
  1700. channel is not +t (uses your current console channel).
  1701. If no chanel is specified, the console channel is used.
  1702. If no new topic is specified, the current topic of the channel will be displayed.
  1703. See also: console
  1704. :hub:trace
  1705. ### $btrace$b <bot>
  1706. Sends out a trace signal to another bot. If/when the trace signal returns,
  1707. (and it should!) you will get an output that looks something like this:
  1708. Trace result -> Valis:Stonewall:NoBoty:SomeBoty
  1709. This is a list of the bots connected between you and the destination bot.
  1710. It should also return the time in seconds taken for the trace to occur.
  1711. See also: bots, bottree
  1712. ::traffic
  1713. ### $btraffic$b
  1714. Shows total and daily net traffic stats since the last $b'%drestart'$b.
  1715. Stats groups are IRC, Botnet, Partyline, Transfer.mod and Misc.
  1716. %{+m}See also: restart%{-}
  1717. :leaf:umode
  1718. ### $bumode$b <+flags>
  1719. Sets the given usermode flags for the bot.
  1720. %{+a}
  1721. See also: dump
  1722. %{-}
  1723. ::unlink
  1724. ### $bunlink$b <bot|*> [reason]
  1725. This disconnects the specified bot from the botnet (assuming it was linked
  1726. in the first place). Some bots (sharebots in particular) might not allow you
  1727. to unlink them. If "*" is specified as the parameter, all bots will be
  1728. unlinked.
  1729. See also: %{+n}link, %{-}bots, downbots%{+n}, newleaf, bottree%{-}%{+a}, newhub%{-}
  1730. ::unstick
  1731. ### $bunstick$b [ban/exempt/invite] <hostmask/number> [channel]
  1732. Makes a "sticky" ban, exempt, or invite normal again.
  1733. See also: bans, exempts, invites, stick, -ban, -exempt, -invite
  1734. ::update:
  1735. ### $bupdate$b <binary>
  1736. The bot will attempt to start the new binary and kill itself.
  1737. The specified binary will need to be in the same directory
  1738. as the bot is running in.
  1739. See also: whois
  1740. :hub:uplink:
  1741. ### $buplink$b <bot> [uplink]
  1742. Changed a bot's preferred botnet uplink. Leave 'uplink' blank
  1743. to clear a bot's uplink, which will make it stay on any hub
  1744. that it can connect to. An uplink must be a hub-bot.
  1745. See also: hublevel, chaddr
  1746. ::uptime
  1747. ### $buptime$b
  1748. Displays the bot's current uptime.
  1749. See also: status
  1750. ::userlist:
  1751. ### $buserlist$b
  1752. A list of all users is displayed. Users with higher flags than you
  1753. will not appear in the list.
  1754. See also: match, whois
  1755. ::version:
  1756. ### $bversion$b
  1757. Displays the pack version and uname.
  1758. See also: botversion, netversion, about%{+m|m}, status%{-}
  1759. :leaf:voice
  1760. ### $bvoice$b <nickname> [channel|*]
  1761. Will give a +v voice to a person you specify, so long as the
  1762. bot is opped on that channel. Specify * for all channels.
  1763. See also: devoice
  1764. ::w:
  1765. ### $bw$b
  1766. The output of 'w' will be displayed over DCC, bot the shell
  1767. the bot is running on.
  1768. %{+i}See also: netw%{-}
  1769. ::who
  1770. ### $bwho$b [bot]
  1771. Displays a list of users on the local bot.
  1772. For example:
  1773. [23:21] #bryan# who
  1774. Party line members: (* = owner, + = master, @ = op)
  1775. *bryan telnet@xxx.atlaga.adelphia.net (idle 17m)
  1776. *bryan telnet@xxx.atlaga.adelphia.net
  1777. Bots connected:
  1778. -> wortel (05 Dec 16:32) eggdrop v1.6.15 <efnet>
  1779. The first section is people on your current channel (the party line, if you
  1780. haven't changed channels) who are on the bot. A '*' will precede the handle
  1781. if they are a bot owner, "+" if they are a master, "%%" if they are a botnet
  1782. master, or "@" if they are an op. The user's nickname, hostname, and
  1783. possibly an idle time and/or away message will be displayed.%{+n} Owners
  1784. will also see the user's dcc idx.%{-}
  1785. The next section is bots directly linked to the current bot. The arrow
  1786. indicates which bot initiated the connection. The right arrow means this bot
  1787. connected to wortel. A left arrow means the remote bot linked to this bot. A
  1788. '+' next to the arrow indicates that the bot is sharing userfiles with us.
  1789. The connection time (05 Dec 16:32) and bot version are also shown, as well
  1790. as what is specified under "network" in the config file.%{+n} Owners will
  1791. also see the bot's dcc idx.%{-}
  1792. The final section (not shown in example above) is a list of users on the
  1793. local bot who are not on your channel. This will be omitted if there are no
  1794. users on other channels. If you specify the name of a remote bot, for
  1795. example $b'%dwho valis'$b, the who request will be sent to that bot instead.
  1796. The remote bot must be linked to the botnet.
  1797. %{+m}
  1798. Masters may also see "(con <flags>)" after a user's entry, which shows the
  1799. user's console flags/modes (see $b'%dhelp console'$b).
  1800. In the final section (users that aren't on the current channel), masters
  1801. will see the actual channels other users are on. Also, people in the
  1802. filesystem will be listed (as being in channel "files") if the filesys
  1803. module is loaded. A '+' next to the nickname here means the user has
  1804. access to return to the party line.%{-}
  1805. See also: whom
  1806. ::whoami
  1807. ### $bwhoami$b
  1808. Shows your current handle and to what bot you are connected.
  1809. See also: whom
  1810. ::whois:
  1811. ### $bwhois$b [nickname]
  1812. Shows you stored information about a user record.
  1813. If no nickname is specified, your own record is shown. Five headings are
  1814. displayed:
  1815. $bHANDLE$b - the handle (nickname) of the user
  1816. $bBOTNICK$b - This user record is a bot.
  1817. $bPASS$b - "yes" if she has a password set; "no" otherwise
  1818. (bots dont use passwords)
  1819. $bFLAGS$b - the list of flags for this user (see below)
  1820. $bLAST$b - the time or date that the user was last on irc or the partyline
  1821. Valid flags:
  1822. $bd$b = deop (user cannot be opped)
  1823. $bk$b = autokick (user is kicked and banned automatically)
  1824. $bo$b = op (user has op access; this is not auto-op)
  1825. $bq$b = quiet (user cannot be voiced)
  1826. $bv$b = voice (user gets +v automatically from +y bots)
  1827. Valid user-only flags:
  1828. $ba$b - admin (user has absolute control over botnet minus a few perm-owner only cmds)
  1829. Be careful who you give this to, only the perm-owner of the net should even have it.
  1830. $bi$b - hub access (user has hub DCC access)
  1831. $bj$b - leaf access (user has leaf DCC access)
  1832. $bm$b = master (user has more access to the botnet cmds than a normal user)
  1833. $bn$b = owner (user has just about full access to bot)
  1834. $bO$b = autoop (user is auto-opped; this does not require any authentication)
  1835. $bp$b - partyline-chat (user can speak on partyline. [$brequires +j or +i$b])
  1836. $bx$b = flood-exempt (user is exempt from flood kicks)
  1837. Valid bot-only flags:
  1838. $bB$b = backup-bot (bot will only join chans marked +backup, see '%dhelp chaninfo')
  1839. $bc$b - chat-bot (bot accepts DCC chat on irc)
  1840. $bf$b = flood-bot (bot reacts to floods based on [cpu intensive] flood settings)
  1841. $bl$b = limit-bot (bot sets limit in all channels, see '%dhelp chaninfo') [$bCPU INTENSIVE$b]
  1842. $br$b = resolve (bot resolves clients in to match against userlist) [$bCPU INTENSIVE+$b]
  1843. $bu$b - update-bot (see doc/UPGRADING)
  1844. $by$b = voice-bot (bot gives out voices/auto-ops in chans) [$bCPU INTENSIVE$b]
  1845. $bFlags followed by a '=' may also be used for a specific channel record.$b
  1846. Hostmasks for the user are displayed on the following lines. If the user is
  1847. a bot, there will be a line below which says "ADDRESS:" and gives the bot's
  1848. telnet address. Some user entries may have "EMAIL:" and "INFO:" entries too.
  1849. There may be additional information displayed depending on the modules
  1850. loaded, such as filesys and console.
  1851. %{+m}
  1852. Masters: if the user has a comment, you will see it under "COMMENT:".%{-}
  1853. See also: match, who, whom%{+m|m}, chattr, chaninfo%{-}
  1854. ::whom
  1855. ### $bwhom$b [channel|*]
  1856. Displays a list of users on the botnet.
  1857. '*' is assumed if no parameters are given.
  1858. For example:
  1859. [23:12] #bryan# whom
  1860. Nick Bot Host
  1861. ---------- --------- --------------------
  1862. *bryan Anakha telnet@xxx.atlaga.adelphia.net [idle 8m]
  1863. *BitchSmack Anakha telnet@xxx.atlaga.adelphia.net
  1864. Total users: 2
  1865. Each user's nickname will be listed in the first column, preceded by a "*"
  1866. if they are a bot owner, "+" if they are a master, "%%" if they are a botnet
  1867. master, or "@" if they are an op. In the next column, the bot the user is
  1868. connected to will be displayed. In the third column, the host is shown. If
  1869. the user is away, the away message will be shown. Likewise, if they are
  1870. idle, their idle time will be displayed.
  1871. To see what users are on a different channel, you may specify a channel
  1872. number/name. If you specify "*" as the channel, all users on all botnet
  1873. channels will be shown.
  1874. See also: who, chat%{+m}, bots%{-}
  1875. ::end