Frequently Asked Questions

Unknown user or wrong password

  • When logging in I get the error “Unknown user or wrong password.”. What is happening?
  • Either the password is wrong or your username is incorrect. It might also be possible that you set up host masks (i.e. limited access to the bouncer to a few known hosts) and your host is not matched by any of those patterns.
  • You will also get that error when you tried to log in with a wrong password for a couple of times because shroudBNC temporarily blocks logins from your IP address (for about 10 minutes).

Certificates

  • What are client certificates and what purpose do the commands savecert, delcert and showcert have?
  • Client certificates are SSL certificates which the client sends to the server for password-less user authentication. For example, in mIRC you can set your client certificate using Ctrl-O → Connect → Options → SSL.
  • Once you are connecting to shroudBNC using a client certificate you can use the savecert command to save the certificate in your private keychain. When you reconnect to your bouncer (without specifying a password) shroudBNC will recognise your certificate and allow you to log in. showcert can be used to view a list of currently trusted client certificates. Use delcert to remove a certificate.

Listeners

  • What are listeners?
  • Listeners are ports which can be used to connect to shroudBNC. When you initially create your shroudBNC configuration file you already created a main listener.
  • Using the addlistener, dellistener and listeners commands you can create and remove additional listeners.

Simul not working

  • simul does not appear to work; what is wrong?
  • You should keep in mind that simul is directly passing the command to the parser like any other IRC command. Therefore you will have to specify a valid IRC command. Examples:
    • simul USER :jump
      This will not work because /jump is not a valid command.
    • simul USER :MSG -sBNC #test
      This will not work either because on most clients /msg is actually an alias for PRIVMSG; MSG is not an IRC command
    • simul USER :SBNC jump
      This will work as expected.
    • simul USER :PRIVMSG -sBNC :help
      This too will work as expected.

Done twice

  • Why do I get “Done.” twice when using simul?
  • The first “Done.” is from the command you executed. The second one is from the simul command.

How simul can't wait for results

  • Why does something like simul USER :whois other-user not work?
  • ShroudBNC does not wait for a reply from the IRC server when executing simul commands. In fact, it could not possibly do that because shroudBNC would have to know what to expect from the IRC server for every IRC command.
  • It can however directly respond to “sbnc” and “privmsg -sbnc” commands.

User-specific TCL

  • How do I load a TCL script for a specific user?
  • If the TCL script is using eggdrop-style binds (bind, unbind) you can use the setctx (set context) command to specify the user which should be used for creating the binds:
    • setctx “USERNAME”
    • source “scripts/your-script.tcl”

eggdrop users

  • My TCL script is using eggdrop users for authentication. How can I create those users on top of a shroudBNC user account?
  • An admin can create, modify and delete “eggdrop” users using the eggtcl commands adduser, deluser, getuser, chattr, addhost and delhost. For example, to create an eggdrop user “test” for the shroudBNC user “bot” with flags +m and the host *!test@example.net you can use the following command:
    • tcl :setctx bot; adduser test *!test@example.net; chattr test m
 
en/1.2/faq.txt · Last modified: 2011/08/27 15:15 (external edit)
 
Recent changes RSS feed Creative Commons License Donate Powered by PHP Valid XHTML 1.0 Valid CSS Driven by DokuWiki