User Commands                                             VSTP(1)



NAME
     vstpg, vstpp - VisioBraille file transferring

SYNOPSIS
     vstpg [-ifbnd] [-s socketport] [-k keyname] [-o  configname]
     file ...

DESCRIPTION
     vstpg (resp. vstpp) gets  (resp.  puts)  files  from  (resp.
     onto) a VisioBraille terminal.

     For communicating with the terminal, you must launch  brltty
     with  the  BrlNet  driver,  and  telling  BrlNet  to use the
     VisioBraille driver.

     Before putting on the terminal, file names are truncated  to
     8 characters without any extension.

     Before getting from  terminal,  leading  path  and  trailing
     extensions are removed, but put back for local filename.


COMAND-LINE OPTIONS
     -i   ask for confirmation of transfer, for each file (on the
          terminal)

     -f   don't ask for such a confirmation (default)

     -b   if they exists, recursively rename the old  files  with
          an added .x suffix, just like logrotate does

     -n   do not keep such backup file (default)

     -s socketport
          use socketport as the port number  instead  of  default
          for connecting to BrlNet

     -k filename
          use filename as key path instead of default for reading
          BrlNet's authentication key

     -d   use current directory rather than the  download  direc-
          tory (see vbsdir below)

     -o filename
          also read filename as config file


CONFIG FILE
     vstpg and vstpp  read  a  configuration  file  $HOME/.vstprc
     which  contains  keywords  or equalities, one per line (what
     follows a # is ignored).



BrlNet              Last change: Jul 15, 2002                   1






User Commands                                             VSTP(1)



     You can ask them to also read any other file thanks  to  the
     -o option.

     Here are keywords:


     backup
          make -b option the default


     nobackup
          make -f option the default


     and equalities:


     keyname = filename
          use this file instead  of  default,  to  find  BrlNet's
          authentication key


     socketport = port
          use this port number, instead of default, to connect to
          BrlNet


     vbsext = .ext
          use .ext as an extension for downloaded files (.vis  by
          default) this is overriden on command line if an exten-
          sion is provided in the file name


     vbsdir = path
          use path  instead  of  current  directory  for  putting
          files,  except  when  using  the  -d  option, or if the
          filename begins with '.'


RETURNED VALUE
     lB lfCW.  1    syntax error on command line  2    connection
     with  BrlNet  error 3    Unix file error 4    Protocol error
     16   interrupted by user


SHEL EXPANSIONS
     Beware of special chars: * and . are often expanded by  your
     shell, hence vstpp * will probably do what you want, putting
     every file existing in the current directory onto the termi-
     nal,  but vstpg * may not do what you want: it will only get
     every file which already exist  in  the  current  directory,
     skipping  those  you just created on your terminal !  If you



BrlNet              Last change: Jul 15, 2002                   2






User Commands                                             VSTP(1)



     want to get every file which  exist  in  the  terminal,  you
     should  use vstpg '*' or something similar (please read your
     shell manual).

     The same warning applies to other special chars, such as  $,
     ~,  &,... which should be protected by surrounding arguments
     by quotes (') or by using single backslashes (\) just before
     them (please read your shell manual).


BUGS
     The one we could find has been corrected :)


AUTHOR
     Samuel Thibault  and Sebastien
     Hinderer 






































BrlNet              Last change: Jul 15, 2002                   3