.\" -*- coding: UTF-8 -*- .\" Copyright (c) 1990, 1993 .\" The Regents of the University of California. All rights reserved. .\" .\" %%%LICENSE_START(BSD_4_CLAUSE_UCB) .\" Redistribution and use in source and binary forms, with or without .\" modification, are permitted provided that the following conditions .\" are met: .\" 1. Redistributions of source code must retain the above copyright .\" notice, this list of conditions and the following disclaimer. .\" 2. Redistributions in binary form must reproduce the above copyright .\" notice, this list of conditions and the following disclaimer in the .\" documentation and/or other materials provided with the distribution. .\" 3. All advertising materials mentioning features or use of this software .\" must display the following acknowledgement: .\" This product includes software developed by the University of .\" California, Berkeley and its contributors. .\" 4. Neither the name of the University nor the names of its contributors .\" may be used to endorse or promote products derived from this software .\" without specific prior written permission. .\" .\" THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND .\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE .\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE .\" ARE DISCLAIMED. IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE .\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL .\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS .\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) .\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT .\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF .\" SUCH DAMAGE. .\" %%%LICENSE_END .\" .\" @(#)recno.3 8.5 (Berkeley) 8/18/94 .\" .\"******************************************************************* .\" .\" This file was generated with po4a. Translate the source file. .\" .\"******************************************************************* .TH RECNO 3 "15 Septiembre 2017" "" "Manual del Programador de Linux" .UC 7 .SH NOMBRE recno \- método de acceso a bases de datos con registros numerados .SH SINOPSIS .nf \fB#include #include \fP .fi .SH DESCRIPCIÓN \fINote well\fP: This page documents interfaces provided in glibc up until version 2.1. Since version 2.2, glibc no longer provides these interfaces. Probably, you are looking for the APIs provided by the \fIlibdb\fP library instead. .PP La rutina \fBdbopen\fP(3) es la interfaz de biblioteca para los ficheros de bases de datos. Uno de los formatos de fichero soportados es el de los ficheros con registros numerados (que llamaremos regnum). La descripción general de los métodos de acceso a bases de datos se encuentra en la página de manual de \fBdbopen\fP(3); esta página de manual sólo describe información específica de regnum. .PP La estructura de datos de registros numerados está formada por registros de longitud o fija o variable almacenados en un formato de fichero plano, accedido por el número lógico de registro. La existencia del registro número cinco implica la existencia de los registros del 1 al 5, y la eliminación del registro número 1 hace que el registro número 5 sea renumerado al registro número 4, de la misma manera que el cursor se desplazará un registro hacia abajo si se encuentra posicionado después del registro número 1. .PP La estructura de datos específica del método de acceso regnum proporcionada a \fBdbopen\fP(3) se define en el fichero cabecera \fI\fP como sigue: .PP .in +4n .EX typedef struct { unsigned long flags; unsigned int cachesize; unsigned int psize; int lorder; size_t reclen; unsigned char bval; char *bfname; } RECNOINFO; .EE .in .PP Los elementos de esta estructura se definen de la siguiente manera: .TP \fIflags\fP El valor de las opciones se especifica mediante una operación \fIO\fP\-lógica de cualquiera de los siguientes valores: .RS .TP \fBR_FIXEDLEN\fP Los registros son de longitud fija, no delimitados por bytes. El elemento \fIreclen\fP de la estructura especifica la longitud del registro y el elemento \fIbval\fP de la estructura se usa como carácter de relleno. Todos los registros, insertados en la base de datos, cuya longitud es más pequeña que \fIreclen\fP bytes, se completan automáticamente con el carácter \fIbval\fP. .TP \fBR_NOKEY\fP En la interfaz especificada por \fBdbopen\fP(3), la recuperación secuencial de registros rellena tanto la clave del invocador como las estructuras de datos. Si se especifica la opción \fBR_NOKEY\fP, no se necesitarán las rutinas con \fIcursor\fP para rellenar la estructura de la clave. Esto permite a las aplicaciones recuperar registros al final de los ficheros sin leer todos los registros que intervienen. .TP \fBR_SNAPSHOT\fP Esta opción exige que se tome una instantanea del fichero cuando se llame a \fBdbopen\fP(3), en lugar de permitir que cualquier registro sin modificar sea leído del fichero original. .RE .TP \fIcachesize\fP Tamaño máximo sugerido, en bytes, de la memoria caché. Este valor \fBsólo\fP es consultivo y el método de acceso reservará más memoria antes que fallar. Si \fIcachesize\fP es 0 (no se especifica un tamaño) se usa una caché por defecto. .TP \fIpsize\fP El método de acceso regnum almacena las copias residentes en memoria de sus registros en un árbolB (btree). Este valor es el tamaño (en bytes) de las páginas usadas para nodos del árbol. Si \fIpsize\fP es 0 (no se especifica un tamaño de página) se selecciona un tamaño de página basado en el tamaño de bloque de E/S del sistema de ficheros subyacente. Véase \fBbtree\fP(3) para más información. .TP \fIlorder\fP El orden de los bytes para los enteros de los metadatos almacenados en la base de datos. El número debería representar el orden como un entero; por ejemplo, el orden `el byte de mayor peso el último' (orden ascendente) sería el número 4321. Si \fIlorder\fP es 0 (no se especifica un orden) se utiliza el orden del anfitrión actual. .TP \fIreclen\fP El tamaño de un registro de tamaño fijo. .TP \fIbval\fP El byte delimitador a usar para marcar el final de un registro para los registros de tamaño variable, y el carácter de relleno para los registros de tamaño fijo. Si no se especifica un valor, se utilizan caracteres `nueva línea' ("\en") para marcar el final de los registros de longitud variable y los registros de longitud fija se completan con espacios. .TP \fIbfname\fP El método de acceso regnum almacena las copias residentes en memoria de sus registros en un árbolB. Si \fIbfname\fP no es NULL, especifica el nombre de un fichero árbolB, como si se especificara el nombre de fichero para una llamadada a \fBdbopen\fP(3) de un fichero árbolB. .PP La parte de datos del par clave/datos usado por el método de acceso \fIrecno\fP es la misma que la de los otros métodos de acceso. La clave es diferente. El campo \fIdata\fP de la clave debería ser un puntero a una posición de memoria del tipo \fIrecno_t\fP, tal y como se define en el fichero cabecera \fI\fP. Normalmente, este tipo es el tipo entero sin signo más grande disponible para la implementación. El campo \fIsize\fP de la clave debería ser el tamaño de ese tipo. .PP Ya que puede no haber ningún metadato asociado con los ficheros subyacentes del método de acceso regnum, cualquier cambio realizado a los valores por defecto (por ejemplo, a la longitud de los registros de tamaño fijo o al valor del separador de bytes) se debe especificar explícitamente cada vez que se abra el fichero. .PP En la interfaz especificada por \fBdbopen\fP(3), el uso de la interfaz \fIput\fP para crear un nuevo registro provocará la creación de varios registros vacíos si el número de registro es mayor, en más de uno, que el número del mayor registro actualmente en la base de datos. .SH ERRORES Las rutinas del método de acceso \fIregnum\fP pueden fallar y asignar a \fIerrno\fP cualquiera de los errores especificados para la rutina de biblioteca \fBdbopen\fP(3) o el siguiente: .TP \fBEINVAL\fP Se ha intentado añadir un registro a una base de datos de registros de tamaño fijo que s demasiado grande para caber. .SH ERRORES Sólo se soportan los órdenes de bytes ascedente (el byte de mayor peso el último) y descendente (el byte de menor peso el último). .SH "VÉASE TAMBIÉN" \fBbtree\fP(3), \fBdbopen\fP(3), \fBhash\fP(3), \fBmpool\fP(3) .PP \fIDocument Processing in a Relational Database System\fP, Michael Stonebraker, Heidi Stettner, Joseph Kalash, Antonin Guttman, Nadene Lynn, Memorandum No. UCB/ERL M82/32, May 1982. .SH COLOFÓN Esta página es parte de la versión 5.10 del proyecto Linux \fIman\-pages\fP. Puede encontrar una descripción del proyecto, información sobre cómo informar errores y la última versión de esta página en \%https://www.kernel.org/doc/man\-pages/. .PP .SH TRADUCCIÓN La traducción al español de esta página del manual fue creada por Juan Piernas . .PP Esta traducción es documentación libre; lea la .UR https://www.gnu.org/licenses/gpl-3.0.html GNU General Public License Version 3 .UE o posterior con respecto a las condiciones de copyright. No existe NINGUNA RESPONSABILIDAD. .PP Si encuentra algún error en la traducción de esta página del manual, envíe un correo electrónico a .MT debian-l10n-spanish@lists.debian.org .ME .