FLOSS on NonStop User Manual HP Part Number: 647853-001 Published: February 2011 Edition: J06.04 and all subsequent J-Series RVUs and H06.
© Copyright 2011 Hewlett-Packard Development Company, L.P. Confidential computer software. Valid license from HP required for possession, use or copying. Consistent with FAR 12.211 and 12.212, Commercial Computer Software, Computer Software Documentation, and Technical Data for Commercial Items are licensed to the U.S. Government under vendor’s standard commercial license. Warranty The information contained herein is subject to change without notice.
Contents About This Document.....................................................................................4 Supported Release Version Updates (RVUs)..................................................................................4 Intended Audience....................................................................................................................4 Related Manuals......................................................................................................................
About This Document This manual describes how to install, migrate, and uninstall FLOSS (Freeware Look for OSS) on HP NonStop™ systems. This document is intended for software developers and administrators. This manual includes information about: • Features of FLOSS • FLOSS commands and libraries that assist in porting a software package to NonStop system Supported Release Version Updates (RVUs) This publication supports J06.04 and all subsequent J-series RVUs, and H06.
Document Organization This document is organized as follows: Section Contents “Introduction to FLOSS” (page 8) This chapter provides an overview of FLOSS package. “Installing the FLOSS Package” (page 9) This chapter provides the installation procedure for installing FLOSS package on NonStop systems. “Porting a Software Package Using FLOSS” (page 11) This chapter provides a brief information on how to port a package to NonStop systems.
TERM [\system-name.]$terminal-name INT[ERRUPTS] A group of items enclosed in brackets is a list from which you can choose one item or none. The items in the list can be arranged either vertically, with aligned brackets on each side of the list, or horizontally, enclosed in a pair of brackets and separated by vertical lines. For example: FC [ num ] [ -num ] [ text ] K [ X | D ] address { } Braces A group of items enclosed in braces is a list from which you are required to choose one item.
Line Spacing If the syntax of a command is too long to fit on a single line, each continuation line is indented three spaces and is separated from the preceding line by a blank line. This spacing distinguishes items in a continuation line from items in a vertical list of selections.
1 Introduction to FLOSS The FLOSS package is a set of command-line utilities and libraries that aid in porting packages to NonStop systems. The FLOSS package is required only if you are rebuilding any of the open source packages that are posted in the ITUGLIB website or wish to use it to assist in porting your own software package. The FLOSS package is not required if the pre-built software packages are installed and used.
2 Installing the FLOSS Package This chapter describes how to obtain, migrate, install, and uninstall the FLOSS package on a NonStop system. Ensure that the Open System Services (OSS) environment is installed on a NonStop operating system H06.15 or later, or J06.04 or later for FLOSS package to function correctly. Obtaining the FLOSS Package Based on your requirement, you can either download a supported version or an unsupported (ITUGLIB) version of the FLOSS package.
NOTE: If you do not select the Manage OSS Files option in the DSM/SCM planner interface, DSM/SCM places the T1200PAX file in the Guardian subvolume $ISV.ZOSSUTL (where, ISV is the installation volume). Use the COPYOSS command to extract and place the contents of the T1200PAX file into the OSS file system. 3. 4. 5. Copy the extracted product files to a new software revision of the configuration you want to update. Run the Build request and Apply request command on the configuration revision.
3 Porting a Software Package Using FLOSS This section describes at a very high level how to port a software package using FLOSS. The following six major tasks must be performed in order to port a package: 1. Download the package 2. Unzip and untar the package 3. Configure the package 4. Build the package 5. Test the package 6. Install the package For more information on these tasks, see HP NonStop open source software for software developers on the HP Open Source home page.
A FLOSS Commands and APIs Table 3 lists the various commands, and helper utilities that constitute the FLOSS package. Table 3 FLOSS Commands and Description Command/Helper Utility Description as as utility is a wrapper around the cc script. Most of the open source packages check the presence of this utility, which is provided by the c89 for NonStop system. This wrapper is required for the package build to go through seamlessly. c++ c++ is a wrapper that calls cc with the -Wcplusplus flag.
Table 3 FLOSS Commands and Description (continued) Command/Helper Utility Description conf_script_floss_cc Invokes the GNU configure script with options appropriate for the FLOSS development environment. These operations are performed: • Sets these environment variables: ◦ PREFIX=/usr/local ◦ CC=cc ◦ CXX=c++ ◦ CPP=cpp • Invokes the package configure script using: .
Table 3 FLOSS Commands and Description (continued) Command/Helper Utility Description findcall_floss_pth Finds invalid function calls in FLOSS and GNU portable thread based packages.
Table 4 FLOSS APIs API name API prototype Description floss_execv int floss_execv(const char floss_execv is a wrapper around *path, char * const argv[]) floss_execve. floss_execve int floss_execve(const char floss_execve is a wrapper around *path, char * const argv[], tdm_execve, which load balances the char * const envp[]) executed processes by distributing them on different CPUs using pseudo random technique.
For more information on FLOSS commands, see the HP NonStop open source software for software developers on the HP Open Source home page website. Navigate to the Literature section and click HP NonStop open source software for software developers.
Index D Default file locations, 10 F FLOSS Commands, 12 Features, 8 Migration, 9 Porting, 11 FLOSS Install Using COPYOSS command, 10 Using DSM/SCM, 9 FLOSS Version Supported, 9 Unsupported, 9 17
