.TH socks5.passwd 5 "02 May 1997".SH NAME.HP 16socks5.passwd \- Contains usernames and passwords to authorize users in the socks5 environment.SH SYNOPSISsocks5 usually reads the password file, socks5.passwd, in the /etc directory. When you configure and build socks5 with the.PP.RS 5--with-srvpwdfile=pathname.RE.PPoption, you can change the directory. Under FreeBSD's UNIX port, the password file resides in /usr/local/etc/socks5.passwd. .PPYou can set the password file location with the option or the SOCKS5_PWDFILE environment variable. See the socks5.conf(5) man page for a complete list of environment variables..SH DESCRIPTIONTo enable Username/Password authentication with the socks5 daemon you must create a password file, and modify the socks5 configuration file, socks5.conf..PPIn the password file, add one line for each user. Each line should contain the username and password for the user, separated by white space. In the socks5 configuration file, add an auth line and a permit line to require authentication and allow the user access. For additional information about the socks5 configuration file, refer to the socks5.conf(5) man page..PPAdding Username/Password authentication to socks5 requires 3 steps:.RS 5.HP 31. Create the password file with one entry per line. To create an entry for the user named joe, whose password is secret, add this line to the socks.passwd file: .RS 8joe secret .RE.HP 32. Edit the auth and permit lines in the configuration file to require Username/Password authentication. The configuration file may contain auth lines such as: .RS 8auth - - -.RE.PP.RS 3To add username and password authentication, change the line to: .RS 5auth - - u.RE.PPTo require access permission, edit the permit line in the configuration file. To require access permission for joe, edit the permit line for joe in the configuration file: .RS 5permit u - - - - - joe.RE.RE.RE.PP3. Restart the server..SH SOCKS5 ClientsThe socks5 client library uses the SOCKS5_USER and SOCKS5_PASSWD environment variables for a user's username and password. Set the username on the client with the SOCKS5_USER environment variable. Set the password on the client with the SOCKS5_PASSWD variable..SH SEE ALSOsocks5(1), socks5.conf(5) libsocks.conf(5).SH AUTHORNWSL SOCKS5 Development Team.brSend comments to socks5-comments@socks.nec.com