1VSTP(1)                      BrlAPI User's Manual                      VSTP(1)
2
3
4

NAME

6       vstpg, vstpp - VisioBraille file transferring
7

SYNOPSIS

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

DESCRIPTION

12       vstpg  (resp. vstpp) gets (resp. puts) files from (resp. onto) a Visio‐
13       Braille terminal.
14
15       For communicating with the terminal, you must launch  brltty  with  the
16       BrlNet driver, and telling BrlNet to use the VisioBraille driver.
17
18       Before  putting  on the terminal, file names are truncated to 8 charac‐
19       ters without any extension.
20
21       Before getting from terminal, leading path and trailing extensions  are
22       removed, but put back for local filename.
23
24

COMMAND-LINE OPTIONS

26       -i     ask  for  confirmation of transfer, for each file (on the termi‐
27              nal)
28
29       -f     don't ask for such a confirmation (default)
30
31       -b     if they exists, recursively rename the old files with  an  added
32              .x suffix, just like logrotate does
33
34       -n     do not keep such backup file (default)
35
36       -s socketport
37              use  socketport  as  the port number instead of default for con‐
38              necting to BrlNet
39
40       -k filename
41              use filename as key path instead of default for reading BrlNet's
42              authentication key
43
44       -d     use  current  directory  rather than the download directory (see
45              vbs_dir below)
46
47       -o filename
48              also read filename as config file
49
50

CONFIG FILE

52       vstpg and vstpp read a configuration file $HOME/.vstprc which  contains
53       keywords or equalities, one per line (what follows a # is ignored).
54
55       You can ask them to also read any other file thanks to the -o option.
56
57       Here are keywords:
58
59
60       backup make -b option the default
61
62
63       nobackup
64              make -f option the default
65
66
67       and equalities:
68
69
70       keyname = filename
71              use  this  file instead of default, to find BrlNet's authentica‐
72              tion key
73
74
75       socketport = port
76              use this port number, instead of default, to connect to BrlNet
77
78
79       vbs_ext = .ext
80              use .ext as an extension for downloaded files (.vis by  default)
81              this  is  overridden on command line if an extension is provided
82              in the file name
83
84
85       vbs_dir = path
86              use path instead of current directory for putting files,  except
87              when using the -d option, or if the filename begins with '.'
88
89

RETURNED VALUE

91       1    syntax error on command line
92       2    connection with BrlNet error
93       3    Unix file error
94       4    Protocol error
95       16   interrupted by user
96
97

SHELL EXPANSIONS

99       Beware  of  special  chars:  *  and . are often expanded by your shell,
100       hence vstpp * will probably do what you want, putting every file exist‐
101       ing  in the current directory onto the terminal, but vstpg * may not do
102       what you want: it will only get every file which already exist  in  the
103       current  directory,  skipping those you just created on your terminal !
104       If you want to get every file which exist in the terminal,  you  should
105       use vstpg '*' or something similar (please read your shell manual).
106
107       The  same  warning  applies to other special chars, such as $, ~, &,...
108       which should be protected by surrounding arguments by quotes (') or  by
109       using  single  backslashes (\) just before them (please read your shell
110       manual).
111
112

BUGS

114       The one we could find has been corrected :)
115
116

AUTHOR

118       Samuel Thibault <samuel.thibault@ens-lyon.org> and  Sebastien  Hinderer
119       <sebastien.hinderer@ens-lyon.fr>
120
121
122
123BrlAPI                            2002-07-15                           VSTP(1)
Impressum