File: labgrid-exporter.1

package info (click to toggle)
labgrid 0.4.1-6
  • links: PTS, VCS
  • area: main
  • in suites: bookworm
  • size: 2,232 kB
  • sloc: python: 17,045; makefile: 30; sh: 12
file content (142 lines) | stat: -rw-r--r-- 3,908 bytes parent folder | download
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
.\" Man page generated from reStructuredText.
.
.TH LABGRID-EXPORTER 1 "2017-04-15" "0.0.1" "embedded testing"
.SH NAME
labgrid-exporter \- labgrid-exporter interface to control boards
.
.nr rst2man-indent-level 0
.
.de1 rstReportMargin
\\$1 \\n[an-margin]
level \\n[rst2man-indent-level]
level margin: \\n[rst2man-indent\\n[rst2man-indent-level]]
-
\\n[rst2man-indent0]
\\n[rst2man-indent1]
\\n[rst2man-indent2]
..
.de1 INDENT
.\" .rstReportMargin pre:
. RS \\$1
. nr rst2man-indent\\n[rst2man-indent-level] \\n[an-margin]
. nr rst2man-indent-level +1
.\" .rstReportMargin post:
..
.de UNINDENT
. RE
.\" indent \\n[an-margin]
.\" old: \\n[rst2man-indent\\n[rst2man-indent-level]]
.nr rst2man-indent-level -1
.\" new: \\n[rst2man-indent\\n[rst2man-indent-level]]
.in \\n[rst2man-indent\\n[rst2man-indent-level]]u
..
.SH SYNOPSIS
.sp
\fBlabgrid\-exporter\fP \fB\-\-help\fP
.sp
\fBlabgrid\-exporter\fP \fB*.yaml\fP
.SH DESCRIPTION
.sp
Labgrid is a scalable infrastructure and test architecture for embedded (linux) systems.
.sp
This is the man page for the exporter, supporting the export of serial ports,
USB devices and various other controllers.
.SH OPTIONS
.INDENT 0.0
.TP
.B \-h\fP,\fB  \-\-help
display command line help
.TP
.B \-x\fP,\fB  \-\-crossbar\-url
the crossbar url of the coordinator
.TP
.B \-i\fP,\fB  \-\-isolated
enable isolated mode (always request SSH forwards)
.TP
.B \-n\fP,\fB  \-\-name
the public name of the exporter
.TP
.B \-\-hostname
hostname (or IP) published for accessing resources
.TP
.B \-d\fP,\fB  \-\-debug
enable debug mode
.UNINDENT
.SS \-i / \-\-isolated
.sp
This option enables isolated mode, which causes all exported resources being
marked as requiring SSH connection forwarding.
Isolated mode is useful when resources (such as NetworkSerialPorts) are not
directly accessible from the clients.
The client will then use SSH to create a port forward to the resource when
needed.
.SS \-n / \-\-name
.sp
This option is used to configure the exporter name under which resources are
registered with the coordinator, which is useful when running multiple
exporters on the same host.
It defaults to the system hostname.
.SS \-\-hostname
.sp
For resources like USBSerialPort, USBGenericExport or USBSigrokExport, the
exporter needs to provide a host name to set the exported value of the "host"
key.
If the system hostname is not resolvable via DNS, this option can be used to
override this default with another name (or an IP address).
.SH CONFIGURATION
.sp
The exporter uses a YAML configuration file which defines groups of related
resources.
See <\fI\%https://labgrid.readthedocs.io/en/latest/configuration.html#exporter\-configuration\fP>
for more information.
.SH ENVIRONMENT VARIABLES
.sp
The following environment variable can be used to configure labgrid\-exporter.
.SS LG_CROSSBAR
.sp
This variable can be used to set the default crossbar URL (instead of using the
\fB\-x\fP option).
.SS LG_CROSSBAR_REALM
.sp
This variable can be used to set the default crossbar realm to use instead of
\fBrealm1\fP\&.
.SH EXAMPLES
.sp
Start the exporter with the configuration file \fImy\-config.yaml\fP:
.INDENT 0.0
.INDENT 3.5
.sp
.nf
.ft C
$ labgrid\-exporter my\-config.yaml
.ft P
.fi
.UNINDENT
.UNINDENT
.sp
Same as above, but with name \fBmyname\fP:
.INDENT 0.0
.INDENT 3.5
.sp
.nf
.ft C
$ labgrid\-exporter \-n myname my\-config.yaml
.ft P
.fi
.UNINDENT
.UNINDENT
.SH SEE ALSO
.sp
\fBlabgrid\-client\fP(1), \fBlabgrid\-device\-config\fP(5)
.SH AUTHOR
Rouven Czerwinski <r.czerwinski@pengutronix.de>

Organization: Labgrid-Project
.SH COPYRIGHT
Copyright (C) 2016-2017 Pengutronix. This library is free software;
you can redistribute it and/or modify it under the terms of the GNU
Lesser General Public License as published by the Free Software
Foundation; either version 2.1 of the License, or (at your option)
any later version.
.\" Generated by docutils manpage writer.
.