# wrlinux-x

**Repository Path**: liquidraido/wrlinux-x

## Basic Information

- **Project Name**: wrlinux-x
- **Description**: No description available
- **Primary Language**: C++
- **License**: GPL-2.0
- **Default Branch**: WRLINUX_10_17_BASE
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2020-04-12
- **Last Updated**: 2020-12-19

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

wrlinux setup
=============

With this tool you can either create a new distribution builder platform
project, or create a mirror that other projects can be based on.

In addition, you can use the tool to obtain information about available
project configuration options.

The tool uses a layer index (such as layers.openembedded.org), as specified in
the bin/settings.py file, to determine what layers are required to construct
a distribution builder project.

The tool relies on 'repo' from the Android 'git-repo' project.  It produces
a repo style 'default.xml' file, and then calls repo to download all of
the layer components necessary.

The tool also configures various sample files that are used by 
oe-init-build-env to construct your build directory.


Documentation
-------------

For documentation, see the Wind River Knowledge Library:
https://knowledge.windriver.com

Select "Products > Operating Systems > Linux > Linux LTS" to view all
documentation categories.

It is suggested that you start with:
_The Wind River Linux Platform Development Quick Start_.

When following the quick start and other examples, use:

    branchName: WRLINUX_10_17_BASE
    repoURL: git://<git mirror>/git/wrlinux-x


Workflows
---------

Basic setup/usage workflow:

The setup program is expected to have been cloned inside of a project
directory, such as:

    $ mkdir my-project
    $ cd my-project
    $ git clone --branch <branchName> <repoURL> wrlinux-x

Once cloned, simply run the setup.sh (./wrlinux-x/setup.sh) to get a list
of options.  The setup program will construct a new git repository in the
current working directory.  This repository is used to manage the output of
the setup program.

You may re-run the setup program at any time to update/change the project
settings.  However, your build directory will not be touched.  You will have
to resync it with the updated project.  (Specifically bblayers.conf and
local.conf to the config/*.sample versions.)

To update your project, re-run the setup program with the same arguments.
Note the original arguments are available in the generated README file.


Mirror workflow:

    $ mkdir my-mirror
    $ cd my-mirror
    $ git clone --branch <branchName> <repoURL> wrlinux-x
    $ ./wrlinux-x/setup.sh --all-layers --mirror

The above command will mirror all layers, including download layers into the
current location, for the branch specified.

To update the mirror, re-run the setup.sh command with the same arguments.
To add additional branches to your mirror, change the branch in the wrlinux-x,
and re-run the setup.sh with the same arguments.

A user can reference this mirror by doing:

    $ mkdir my-project
    $ cd my-project
    $ git clone --branch <branchName> <path_to_mirror>/wrlinux-x

and then run the wrlinux-x/setup.sh program as described above.


License
-------

Copyright (C) 2016-2017 Wind River Systems, Inc.

This program is free software; you can redistribute it and/or modify
it under the terms of the GNU General Public License version 2 as
published by the Free Software Foundation.

This program is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.
See the GNU General Public License for more details.

You should have received a copy of the GNU General Public License
along with this program; if not, write to the Free Software
Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA