.\" -*- coding: UTF-8 -*- .\" Copyright (c) 1990, 1993 .\" The Regents of the University of California. All rights reserved. .\" .\" SPDX-License-Identifier: BSD-4-Clause-UC .\" .\" @(#)hash.3 8.6 (Berkeley) 8/18/94 .\" .\"******************************************************************* .\" .\" This file was generated with po4a. Translate the source file. .\" .\"******************************************************************* .TH hash 3 "4 Diciembre 2022" "Páginas de manual de Linux 6.05.01" .UC 7 .SH NOMBRE hash \- método de acceso a bases de datos dispersas (hash) .SH BIBLIOTECA Biblioteca Estándar C (\fIlibc\fP, \fI\-lc\fP) .SH SINOPSIS .nf \fB#include #include \fP .fi .SH DESCRIPCIÓN \fINote well\fP: This page documents interfaces provided up until glibc 2.1. Since glibc 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 dispersos. La descripción general de los métodos de acceso a las bases de datos se encuentra en \fBdbopen\fP(3); esta página de manual describe sólo información específica sobre la dispersión. .PP La estructura de datos de dispersión es un esquema disperso dinámico y extensible. .PP El estructura de datos específica del método de acceso proporcionada a \fBdbopen\fP() se define en el fichero cabecera \fI\fP como sigue: .PP .in +4n .EX typedef struct { unsigned int bsize; unsigned int ffactor; unsigned int nelem; unsigned int cachesize; uint32_t (*hash)(const void *, size_t); int lorder; } HASHINFO; .EE .in .PP Los elementos de esta estructura son de la siguiente manera: .TP 10 \fIbsize\fP define el tamaño de la cubeta de la tabla dispersa y es, por defecto, de 256 bytes. Puede ser preferible incrementar el tamaño de página para tablas residentes en disco y tabla con grandes elementos de datos. .TP \fIffactor\fP indica la densidad deseada dentro de la tabla dispersa. Es una aproximación del número de claves que se permite acumular en cualquier cubeta, determinando cuándo la tabla dispersa crece o se encoge. El valor por defecto es 8. .TP \fInelem\fP es una estimación del tamaño final de la tabla dispersa. Si no se configura o se le asigna un valor demasiado pequeño, las tablas dispersas se expandirán de forma elegante cuando se introduzcan claves, aunque se puede observar una ligera degradación del rendimiento. El valor por defecto es 1. .TP \fIcachesize\fP is the suggested maximum size, in bytes, of the memory cache. This value is \fIonly advisory\fP, and the access method will allocate more memory rather than fail. .TP \fIhash\fP es una función de dispersión definida por el usuario. Ya que ninguna función de dispersión funciona igualmente bien sobre todos los datos posibles, el usuario puede encontrar que la función de dispersión ya incorporada funciona de manera pobre sobre un conjunto de datos particular. Las funciones de dispersión especificadas por el usuario deben tomar dos argumentos (un puntero a una cadena de bytes y una longitud) y devolver una cantidad de 32\-bit para usar como valor de dispersión. .TP \fIlorder\fP es 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) debería ser el número 4321. Si \fIlorder\fP es cero (no se especifica un orden) se usa el orden del anfitrión actual. Si el fichero ya existe, el valor especificado se ignora y se usa el valor especificado cuando se creó la tabla. .PP Si el fichero ya existe (y no se especifica la opción \fBO_TRUNC\fP), los valores especificados por \fIbsize\fP, \fIffactor\fP, \fIlorder\fP, y \fInelem\fP se ignoran y se usan los valores especificados cuando se creó la tabla. .PP Si se especifica una función de dispersión, \fIhash_open\fP intentará determinar si la función de dispersión especificada es la misma que aquella con la que se creó la base de datos y fracasará si no lo es. .PP Se proporcionan interfaces compatibles con las antiguas rutinas descritas en \fBdbm\fP(3) y \fBndbm\fP(3); sin embargo, estas inferfaces no son compatibles con los anteriores formatos de fichero. .SH ERRORES Las rutinas del método de acceso \fIdisperso\fP pueden fallar y asignar a \fIerrno\fP cualquiera de los errores especificados para la rutina de biblioteca \fBdbopen\fP(3). .SH ERRORES Sólo se soportan los órdenes de bytes ascendente (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), \fBmpool\fP(3), \fBrecno\fP(3) .PP \fIDynamic Hash Tables\fP, Per\-Ake Larson, Communications of the ACM, April 1988. .PP \fIA New Hash Package for UNIX\fP, Margo Seltzer, USENIX Proceedings, Winter 1991. .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 .