Creación de un archivo pkginfo

pkginfo es un archivo ASCII que describe las características de un paquete, así como la información que ayuda a controlar el flujo de la instalación.

Cada entrada del archivo pkginfo es una línea que establece el valor de un parámetro mediante el formato PARAM=value. PARAM puede ser cualquiera de los parámetros estándar que se describen en la página de comando man pkginfo(4) No hay un orden preciso en el que los parámetros se deban especificar.

Cada valor se puede incluir entre comillas simples o dobles (por ejemplo, 'valor' o “ valor”). Si valor contiene caracteres que se consideren especiales para un entorno de shell, debe usar comillas. Los ejemplos y los casos prácticos de este manual no utilizan comillas. Consulte la página de comando man pkginfo(4) para ver algún ejemplo que utilice comillas dobles.

También puede asignar un valor a sus propios parámetros del paquete para crearlos en el archivo pkginfo. Los parámetros deben comenzar por una letra en mayúsculas seguida de letras en mayúsculas o minúsculas. Una letra en mayúsculas indica que el parámetro (variable) se evaluará en el tiempo de la instalación (en contraposición al tiempo de la construcción). Para obtener más información sobre la diferencia entre las variables de instalación y de construcción, consulte Variables de entorno de paquetes.

Los espacios en blanco que haya tras el valor de un parámetro se ignoran.

Debe definir estos cinco parámetros en un archivo pkginfo: PKG, NAME, ARCH, VERSION y CATEGORY. El software inserta automáticamente los parámetros PATH, PKGINST y INSTDATE cuando se construye el paquete. No modifique estos ocho parámetros. Para obtener información sobre los parámetros restantes, consulte la página de comando man pkginfo(4).

Definición de la instancia de un paquete

El mismo paquete puede tener versiones diferentes, ser compatible con arquitecturas diferentes o ambas. Cada variación de un paquete se conoce como instancia de paquete. Una instancia de paquete está determinada por la combinación de las definiciones de los parámetros PKG, ARCH y VERSION en el archivo pkginfo.

El comando pkgadd asigna un identificador de paquete a cada instancia de paquete en el tiempo de la instalación. El identificador es la abreviatura del paquete con un sufijo numérico, por ejemplo SUNWadm.2. Este identificador distingue una instancia de cualquier otro paquete, incluidas las instancias del mismo paquete.

Definición de la abreviatura de un paquete (PKG)

Una abreviatura de paquete es un nombre más corto de un paquete definido por el parámetro PKG en el archivo pkginfo. La abreviatura de un paquete debe tener estas características:

• La abreviatura debe componerse de caracteres alfanuméricos. El primer carácter no puede ser un número.

• La abreviatura no puede superar los 32 caracteres de longitud.

• La abreviatura no puede ser una de las reservadas: install, new o all.

  ---

  Nota –

  Los cuatro primeros caracteres deben ser exclusivos de su empresa. Por ejemplo, los paquetes construidos por Sun Microsystems^TM tendrán todos “SUNW” como los cuatro primeros caracteres de la abreviatura de sus paquetes.

  ---

  Un ejemplo de entrada de abreviatura de paquete en un pkginfo es PKG=SUNWcadap.

Especificación de una arquitectura de paquetes (ARCH)

El parámetro ARCH en el archivo pkginfo identifica qué arquitecturas se asocian al paquete. El nombre de la arquitectura tiene un máximo de 16 caracteres alfanuméricos. Si un paquete se ha asociado a más de una arquitectura, especifíquelas en una lista separadas por comas.

Éste es un ejemplo de una especificación de arquitectura de paquetes en un archivo pkginfo:

ARCH=sparc

Especificación de una arquitectura de conjunto de instrucciones de paquetes (SUNW_ISA)

El parámetro SUNW_ISA del archivo pkginfo identifica qué arquitectura de conjunto de instrucciones está asociada a un paquete de Sun Microsystems. Los valores son los siguientes:

• sparcv9, para un paquete que contiene objetos de 64 bits

• sparc para un paquete que contiene objetos de 32 bits

Por ejemplo, el valor SUNW_ISA de un archivo pkginfo para un paquete que contiene objetos de 64 bits tendría este aspecto:

SUNW_ISA=sparcv9

Si no se ha configurado SUNW_ISA, la arquitectura predeterminada del conjunto de instrucciones se configura con el valor del parámetro ARCH.

Especificación de la versión de un paquete (VERSION)

El parámetro VERSION del archivo pkginfo identifica la versión del paquete. La versión tiene un máximo de 256 caracteres ASCII y no puede comenzar con un paréntesis izquierdo.

Ésta es una versión de ejemplo de una especificación en un archivo pkginfo:

VERSION=release 1.0

Definición del nombre de un paquete (NAME)

Un nombre de paquete es el nombre completo del paquete, definido por el parámetro NAME en el archivo pkginfo.

Debido a que los administradores del sistema usan con frecuencia nombres de paquetes para determinar si un paquete debe instalarse, es importante escribir nombres de paquetes claros, concisos y completos. Los nombres de paquetes deben satisfacer estos criterios:

• Indique cuándo se necesita un paquete (por ejemplo, para proporcionar determinados comandos o funciones, o bien indicar si el paquete es necesario para un hardware específico).

• Indique para qué se usa el paquete (por ejemplo, el desarrollo de controladores de dispositivos).

• Incluya una descripción nemotécnica de la abreviatura del paquete, mediante palabras clave que indiquen que la abreviatura es una forma corta de la descripción. Por ejemplo, el nombre de la abreviatura del paquete SUNWbnuu es “Basic Networking UUCP Utilities, (Usr)” .

• Nombre la partición en la que el paquete está instalado.

• Use los términos de forma coherente con el significado en el sector.

• Benefíciese del límite de 256 caracteres.

A continuación puede ver un nombre de paquete de ejemplo definido en un archivo pkginfo:

NAME=Chip designers need CAD application software to design
abc chips.  Runs only on xyz hardware and is installed in the
usr partition.

Definición de una categoría de paquetes (CATEGORY)

El parámetro CATEGORY del archivo pkginfo especifica a qué categorías pertenece un catálogo. Como mínimo, un paquete debe pertenecer a la categoría system o application. Los nombres de las categorías se componen de caracteres alfanuméricos. Los nombres de categorías tienen una longitud máxima de 16 caracteres y distinguen entre mayúsculas y minúsculas.

Si un paquete pertenece a más de una categoría, especifíquelas en una lista, separadas por comas.

A continuación puede ver una especificación CATEGORY de ejemplo en un archivo pkginfo:

CATEGORY=system

Cómo crear un archivo pkginfo

1. Cree un archivo llamado pkginfo con su editor de texto preferido.

   Puede crear este archivo en cualquier ubicación del sistema.

2. Edite el archivo y defina los cinco parámetros necesarios.

   Los cinco parámetros necesarios son: PKG, NAME, ARCH, VERSION y CATEGORY. Para obtener más información sobre estos parámetros, consulte Creación de un archivo pkginfo.

3. Agregue parámetros optativos al archivo.

   Cree sus propios parámetros o consulte la página de comando man pkginfo(4) para obtener información sobre los parámetros estándar.

4. Guarde los cambios y salga del editor.

Ejemplo 2–1 Creación de un archivo pkginfo

Este ejemplo muestra el contenido de un archivo pkginfo válido, con los cinco parámetros necesarios definidos, así como el parámetro BASEDIR. El parámetro BASEDIR se trata más detalladamente en El campo ruta.

PKG=SUNWcadap
NAME=Chip designers need CAD application software to design abc chips.  
Runs only on xyz hardware and is installed in the usr partition.
ARCH=sparc
VERSION=release 1.0
CATEGORY=system
BASEDIR=/opt

Véase también

Consulte Cómo organizar el contenido de un paquete.