d/freebsd-dev
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity

Add a few examples.

Browse Source
This commit is contained in:
Brian Somers 1997-10-05 14:21:30 +00:00
parent b8a0cb287a
commit ea895c156b
Notes: svn2git 2020-12-20 02:59:44 +00:00 
svn path=/head/; revision=30122
1 changed files with 84 additions and 3 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

87
usr.sbin/pppctl/pppctl.8
View File

@ -1,4 +1,4 @@
.\" $Id: pppctl.8,v 1.2 1997/07/28 22:17:46 brian Exp $
.\" $Id: pppctl.8,v 1.3 1997/09/29 19:11:45 wosch Exp $
.Dd 26 June 1997
.Os FreeBSD
.Dt PPPCTL 8
@ -65,10 +65,91 @@ Specify the password required by the
daemon. If this switch is not used,
.Nm
will prompt for a password once it has successfully connected to
.Nm ppp
(assuming, of course, that one is required).
.Nm ppp .
.El
.Sh EXAMPLES
Assuming you want to run
.Nm ppp
in
.Fl auto
mode,
.Nm
can be used to automate many frequent tasks. Use of the
.Fl p
option is discouraged (even in scripts that aren't readably by others)
as a
.Xr ps 1
listing may reveal your secret.
.Pp
In order to have
.Nm ppp
create a socket for use with
.Nm pppctl ,
you will need to define a password for your local system:
.Bd -literal -offset indent
# touch /etc/ppp/ppp.secret
# chown root.wheel /etc/ppp/ppp.secret
# chmod 400 /etc/ppp/ppp.secret
# echo "`hostname -s` MyPassword" >>/etc/ppp/ppp.secret
.Ed
.Pp
The most secure way to allow easy, secure
.Nm
access, and to make sure you can distinguish between multiple invocations
of
.Nm ppp
is to create a local server socket in
.Pa /etc/ppp/ppp.conf
(in the correct section):
.Bd -literal -offset indent
set server /var/run/internet 0666
.Ed
This will instruct
.Nm ppp
to create a local domain socket rather than the tcp socket that's created
by default. Refer to the
.Xr ppp 8
man page for further details.
.Pp
You can now create some easy-access scripts. To connect to the internet:
.Bd -literal -offset indent
#! /bin/sh
test $# -eq 0 && time=300 || time=$1
exec pppctl -t 60 /var/run/internet set timeout $time\\; dial
.Ed
.Pp
To disconnect:
.Bd -literal -offset indent
#! /bin/sh
exec pppctl /var/run/internet set timeout 300\\; close
.Ed
.Pp
To check if the line is up:
.Bd -literal -offset indent
#! /bin/sh
pppctl -p '' -v /var/run/internet '' | grep ^PPP >/dev/null
if [ $? -eq 0 ]; then
echo Link is up
else
echo Link is down
fi
.Ed
.Pp
You can even make a generic script:
.Bd -literal -offset indent
#! /bin/sh
exec pppctl /var/run/internet "$@"
.Ed
.Sh SEE ALSO
.Xr services 5 ,
.Xr ppp 8