db_codegen - Online in de cloud

PROGRAMMA:

NAAM

db5.3_codegen — genereer applicatiecode voor Berkeley DB

KORTE INHOUD

db5.3_codegen [-Vv] [-a api] [-i filet] [-o voorvoegsel]

PRODUCTBESCHRIJVING

De db5.3_codegen hulpprogramma genereert applicatiecode om Berkeley DB te maken en te configureren
databaseomgevingen en databases op basis van een eenvoudige beschrijvingstaal en schrijft deze naar
een of meer uitvoerbestanden. De gegenereerde code moet mogelijk worden aangepast in het geval van
ingewikkelde toepassingen, maar zal doorgaans de benodigde tijd voor het maken ervan aanzienlijk verkorten
Berkeley DB-applicaties.

De opties zijn als volgt:

-a api
Genereer code voor de opgegeven API (momenteel wordt alleen “c” geaccepteerd).

-i filet
Geef een invoer op filet; standaard wordt standaardinvoer gebruikt.

-o voorvoegsel
Geef een uitvoerbestand op voorvoegsel; standaard wordt “applicatie” gebruikt.

-V Schrijf het versienummer van de bibliotheek naar de standaarduitvoer en sluit af.

-v Uitvoeren in uitgebreide modus.

De db5.3_codegen hulpprogramma verlaat 0 bij succes en >0 als er een fout optreedt.

C Taal specifiek Informatie

Standaard, wanneer de db5.3_codegen hulpprogramma C-taalcode genereert, het uitvoerbestand is
genaamd "applicatie.c”. De uitvoerbestandsnaam kan worden opgegeven met de -o optie.

Aan het begin van het uitvoerbestand staat een lijst met de openbare databaseomgeving (DB_ENV)
handvatten en database (DB) handvatten, zoals gespecificeerd door de beschrijvingstaal. De databank
omgevingshandvatvariabelen heten “XXX_dbenv”, waarbij “XXX’ is de naam van de
omgeving in de invoerspecificatie. Voor databases die aan een database zijn gekoppeld
omgeving, de variabelen van de databasehandle heten “XXX_JJJ", waar "XXX’ is de naam van
het milieu, en “JJJ” is de naam van de database. Voor zelfstandige databases is de
databasehandvatvariabelen heten “XXX", waar "XXX” is de naam van de database.

Er zijn twee openbare functies in het uitvoerbestand: bdb_startup() en bdb_shutdown(). De
bdb_startup() moet worden aangeroepen om de databaseomgevingen te maken en te configureren
en databases, en de bdb_shutdown() functie moet worden aangeroepen om de
omgevingen en databases.

Specificaties Taal

De db5.3_codegen gebruikt een eenvoudige beschrijvingstaal:

· Lijnen in de invoer bestaan ​​uit door witruimte gescheiden tokens.
· Tokens zijn hoofdlettergevoelig.
· Lege regels en regels waarbij het eerste niet-spatieteken een hekje (“#”) is, zijn dat wel
buiten beschouwing gelaten. Bovendien kunnen hekjes in regels verschijnen, in welk geval de inhoud van de
regel vanaf het hekje tot het einde van de regel wordt genegeerd.

Er zijn twee objecten op het hoogste niveau: “omgeving” en “database”, die overeenkomen met de database
omgevingen en databases, respectievelijk. Deze objecten op het hoogste niveau kunnen worden geassocieerd met
trefwoorden om hun configuratie en relaties te beschrijven.

De volgende invoer zou bijvoorbeeld twee zelfstandige databases creëren:

database data_one {
typ bboom
}
database data_twee {
typ bboom
}

In dit geval zou er geen sprake zijn DB_ENV handvat, en het publiek DB handvatten zouden zijn:

DB *data_one;
DB *data_twee;

De volgende invoer zou bijvoorbeeld een databaseomgeving creëren die er drie bevat
databanken:

omgeving mijnenv {
database data_one {
typ bboom
}
database data_twee {
typ bboom
}
database gegevens_drie {
typ bboom
}
}

In dit geval het publiek DB_ENV en DB handvatten zouden zijn:

DB_ENV *mijnenv_dbenv;
DB *myenv_data_one;
DB *myenv_data_two;
DB *myenv_data_three;

Voor de databases en de omgevingen kunnen verschillende trefwoorden worden opgegeven. Bijvoorbeeld,
de cachegrootte kan worden opgegeven voor de databaseomgeving, en de paginagrootte kan dat zijn
gespecificeerd voor de database, evenals voor secundaire relaties:

omgeving mijnenv {
cachegrootte 2 0 10
database data_one {
typ bboom
paginaformaat 1024
}
database data_twee {
primaire data_one
secundaire_offset 10 15
typ bboom
paginaformaat 32768
}
database gegevens_drie {
typ bboom
paginaformaat 512
}
}

Milieu Trefwoorden
milieu Start een databaseomgevingsblok.

Er moeten drie tokens op de regel staan: het trefwoord, de naam van de
omgeving en een openingsaccolade (“{”).

home Geef de basismap van de databaseomgeving op.

Er moeten twee tokens op de regel staan: het trefwoord en de thuismap.

cache grootte Geef de cachegrootte van de databaseomgeving op.

Er moeten twee tokens op de regel staan: het trefwoord, de gigabytes aan cache,
de cachebytes en het aantal caches (het aantal onderliggende
fysieke gebieden waarin de cache logisch is verdeeld).

privaat Geef op dat de databaseomgeving privé is.

Er moet één token op de regel staan: het trefwoord zelf.

} Beëindig het databaseomgevingsblok.

Er moet één token op de regel staan: het trefwoord zelf.

Database Trefwoorden
databank Start een databaseblok.

Er moeten drie tokens op de regel staan: het trefwoord, de naam van de
database en een openingsaccolade (“{”).

gewoonte Geef een aangepaste sleutelvergelijkingsroutine op. Dit wordt gebruikt wanneer de Btree
database vereist een specifieke sortering db5.3_codegen kan niet genereren. A
stub-sleutelvergelijkingsroutine wordt gemaakt en geconfigureerd voor de
database die indien nodig moet worden aangepast. Zie de “sleutel type"
trefwoord voor meer informatie.

Er moet één token op de regel staan: het trefwoord zelf.

dubbelganger Configureer de database om gesorteerde duplicaten te ondersteunen.

Er moet één token op de regel staan: het trefwoord zelf.

omvang Configureer de grootte van de uitbreidingsbestanden van de wachtrijdatabase.

Er moeten twee tokens op de regel staan: het trefwoord en het bestand met de omvang
formaat, als een aantal pagina's.

sleutel type Configureer een routine voor het vergelijken van sleutels van het integrale type. Dit wordt gebruikt wanneer de
Btree-databasesleutel is een integraal type (zoals “Ongesigneerd int"Of
"u_int32_t”). Elk integraaltype in de C-taal kan worden gespecificeerd. Zie de
"gewoontetrefwoord voor meer informatie. Een Btree-vergelijkingsroutine gebaseerd
afhankelijk van het type sleutel dat wordt aangemaakt en geconfigureerd.

Er moeten twee tokens op de regel staan: het trefwoord en het type.

pagina grootte Configureer de paginagrootte van de database.

Er moeten twee tokens op de regel staan: het trefwoord en het paginaformaat
bytes.

primair Configureer de database als een secundaire index. Een stub secundaire callback
routine wordt gemaakt en geconfigureerd voor de database, wat zo zou moeten zijn
indien nodig aangepast. Zie de “secundaire_offsettrefwoord voor meer
informatie.

Er moeten twee tokens op de regel staan: het trefwoord en de naam van de
primaire database waarvoor deze database een secundaire database is.

rectum Configureer de Btree-database om toegang tot recordnummers te ondersteunen.

Er moet één token op de regel staan: het trefwoord zelf.

re_len Configureer de recordlengte voor een wachtrijdatabase of een Recno met een vaste lengte
database.

Er moeten twee tokens op de lijn staan: het trefwoord en de lengte van a
opnemen, in bytes.

secundaire_offset Configureer een secundaire callback-routine op basis van een bytereeks gevonden in de
het gegevensitem van de primaire database.

Er moeten drie tokens op de regel staan: het trefwoord, de byte-offset van
het begin van het primaire gegevensitem waar de secundaire sleutel voorkomt, en
de lengte van de secundaire sleutel in bytes.

transactie Configureer de database (en, bij uitbreiding, de databaseomgeving), om
transactioneel zijn.

Er moet één token op de regel staan: het trefwoord zelf.

type dan: Configureer het databasetype.

Er moeten twee tokens op de regel staan: het trefwoord en het type, waarbij de
type is een van "btree", "hash", "queue" of "recno".

} Beëindig het databaseomgevingsblok.

Er moet één token op de regel staan: het trefwoord zelf.

AUTEURS

Thorsten Glaser[e-mail beveiligd]> schreef deze handleidingpagina voor het Debian-project (maar dat kan ook zo zijn
gebruikt door anderen) naar de originele HTML-documentatie Copyright © 1996,2008 Oracle.
Alle rechten voorbehouden.

Gebruik db_codegen online met behulp van onworks.net-services