Local Mirror of solaris Userland
You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
 
 
 
 
 
 
Jiri Sasek 4ba548b3c7 32848083 Samba: uprev to 4.13.8 2 months ago
components 32848083 Samba: uprev to 4.13.8 2 months ago
doc 32849750 Update documentation with example how to import single GPG key out of bigger keychain 2 months ago
exception_lists 33002486 update rabbitmq to 3.8.18 2 days ago
licenses 25049273 CGI.pm module depends on HTML::Entities which is not in Solaris 1 year ago
make-rules 32991095 Improve the pkg locale and localedef build infrastructure 1 month ago
tools 32065551 Userland pkglint should run svccfg validate on SMF manifests 1 month ago
transforms PSARC/2021/021 EOF Ruby 2.5 1 month ago
.hgignore.template 30355569 Userland needs .hgignore 7 months ago
.hgtags Added tag st-011 for changeset 108951563a69 3 years ago
Makefile 31900066 want 'gmake pkg_install' to install built package on local system 9 months ago
README.md 32804497 Remove internal hostname from Userlands README 1 month ago

README.md

Getting started with the Userland Consolidation

Getting Started

This README provides a very brief overview of the gate (i.e., source code repository), how to retrieve a copy, and how to build it. Detailed documentation about the Userland gate can be found in the doc directory.

Overview

The Userland consolidation maintains a project at

 https://github.com/oracle/solaris-userland

That repo contains build recipes, patches, IPS (i.e., pkg(7)) manifests, and other files necessary to download, prep, build, test, package and publish open source software. The build infrastructure makes use of hierarchical Makefiles which provide dependency and recipe information for building the components. In order to build the contents of the Userland gate, you need to clone it. Since you are reading this, you may already have.

Getting the Bits

The canonical repository internal to Oracle is stored in Mercurial, and is mirrored to an external Git repository on GitHub. In order to build or develop in the gate, you will need to clone it. For the external Git repository you can do so with the following command:

$ git clone https://github.com/oracle/solaris-userland /scratch/clone

This will create a replica of the various pieces that are checked into the source code management system, but it does not retrieve the community source archives associated with the gate content. To download the community source associated with your cloned workspace, you will need to execute the following:

$ cd /scratch/clone/components
$ gmake download

This will use GNU make and the downloading tool in the gate to walk through all of the component directories downloading and validating the community source archives from the gate machine or their canonical source repository.

There are two variation to this that you may find interesting. First, you can cause gmake(1) to perform its work in parallel by adding -j (jobs) to the command line. Second, if you are only interested in working on a particular component, you can change directories to that component’s directory and use gmake download from that to only get its source archive.

Building the Bits.

You can build individual components or the contents of the entire gate.

Component build

If you are only working on a single component, you can just build it using following:

Setup the workspace for building components

$ cd (your-workspace)/components ; gmake setup

Build the individual component

$ cd (component-dir) ; gmake publish

Complete Top Down build

Complete top down builds are also possible by simply running $ tools/full-build # see --help for options

That is generally wrapper around $ cd (your-workspace) $ # cleanup your workspace to pristine state $ gmake publish $ # examine the log files and provide a summary

Copyright

Copyright (c) 2010, 2021, Oracle and/or its affiliates.