.\" Man page generated from reStructuredText
.\" by the Docutils 0.22.4 manpage writer.
.
.
.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
..
.TH "kw-remote - Manage set of tracked test machines" "" "" ""
.SH Name
kw-remote - Manage set of tracked test machines \- 
.SH SYNOPSIS
.nf
\fIkw remote\fP [\-v | \-\-verbose]
\fIkw remote\fP [\-\-global] \-\-add <name> <user>@<remote>[:<port>]
\fIkw remote\fP [\-\-global] \-\-remove <name>
\fIkw remote\fP [\-\-global] \-\-rename <old\-name> <new\-name>
\fIkw remote\fP [\-\-global] \-\-list
\fIkw remote\fP [\-\-global] \-s<name> | \-\-set\-default=<name>
.fi
.sp
.SH DESCRIPTION
.sp
Manage the set of test machines (\(dqremotes\(dq) you want kw to have easy
access.  This feature directly interacts with kw configuration for remote
available locally at \fI\&.kw/remote.config\fP or globally at \fI~/.config/kw/remote.config\fP\&.
.SH OPTIONS
.INDENT 0.0
.TP
.B \-\-add <name> <remote\-address>:
Adds a remote named <name> for the test machine at <remote\-address>. Notice
that <remote_address> must follow the pattern \fI<user>@<remote>[:<port>]\fP where
\fIremote\fP can be an IP or a name server and \fI:<port>\fP is optional (default port
is 22).
.TP
.B \-\-remove <name>:
Remove the remote named <name>.
.TP
.B \-\-rename <old\-name> <new\-name>:
Rename the remote named <old\-name> to <new\-name>. If you try a name already
in use, kw will fail with a message.
.TP
.B \-\-list:
List all available remotes.
.TP
.B \-\-global:
Force use global config file instead of the local one.
.TP
.B \-s<name>, \-\-set\-default=<name>:
Set default remote to remote named <name>.
.TP
.B \-v, \-\-verbose:
Be a little more verbose and show remote url after name.
.UNINDENT
.SH EXAMPLES
.sp
In case you want \fBkw\fP to track a new test machine, you can use:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
cd <kernel\-path>
kw remote \-\-add origin root@my\-test\-machine
.EE
.UNINDENT
.UNINDENT
.sp
If you do not use port 22, you can use:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
kw remote \-\-add my\-x86\-test\-system root@my\-test\-machine:5555
.EE
.UNINDENT
.UNINDENT
.sp
If you want to remove some remote:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
kw remote \-\-remove origin
.EE
.UNINDENT
.UNINDENT
.sp
If you want to rename:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
kw remote \-\-rename origina arm\-device
.EE
.UNINDENT
.UNINDENT
.sp
You can also list all your available remotes via:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
kw remote \-\-list
.EE
.UNINDENT
.UNINDENT
.sp
If you want to set the default remote:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
kw remote \-\-set\-default=new\-default\-remote
.EE
.UNINDENT
.UNINDENT
.\" End of generated man page.