Dit is de opdracht refdba die kan worden uitgevoerd in de gratis hostingprovider van OnWorks met behulp van een van onze meerdere gratis online werkstations zoals Ubuntu Online, Fedora Online, Windows online emulator of MAC OS online emulator
PROGRAMMA:
NAAM
refdba - de beheerclient van RefDB
KORTE INHOUD
Interactieve modus:
refdba [-c pager-commando] [-e log-bestemming] [-f stdin] [-h] [-i IP Address]
[-l Log niveau] [-L log-bestand] [-p port] [-q] [-T Time to] [-u naam] [-v] [-V]
[-w wachtwoord] [-x] [-y conf]
Niet-interactief modus:
Batch-modus:
refdba -C commando [-c pager-commando] [-e log-bestemming] [-f stdin] [-i IP Address]
[-l Log niveau] [-L log-bestand] [-p port] [-q] [-T Time to] [-u naam] [-w wachtwoord] [-x]
[-y conf]
PRODUCTBESCHRIJVING
refdba is een opdrachtregelclient die de te beheren opdrachten levert RefDB(7) databanken,
gebruikers en stijlen. refdba kan worden gestart in een interactieve modus, waarbij een commando wordt gegeven
prompt. Type ? or uw om een lijst met beschikbare opdrachten weer te geven. Als alternatief kunt u beginnen
refdba in niet-interactieve modus. refdba voert het gevraagde commando uit en keert terug. In
deze modus refdba accepteert invoer op stdin voor een verscheidenheid aan commando's, waardoor Unix mogelijk is
leidingen.
OPTIES
-c pager-commando
De opdrachtregel van de te gebruiken pager. In plaats van een pager kan dat natuurlijk ook
specificeer een geldig commando dat gegevens op stdin accepteert. Gebruik "stdout" om gegevens op te vragen
uitgang naar stdout. Dit is de standaard, maar u kunt dit specificeren in de opdracht
regel als u tijdelijk een standaard semafooninstelling in uw configuratie moet overschrijven
bestand.
-C commando
De opdracht die moet worden uitgevoerd in niet-interactieve modus. U kunt alle opties leveren en
parameters die de opdracht accepteert op de refdba-opdrachtregel.
-e log-bestemming
log-bestemming kan de waarden 0, 1 of 2 hebben, of de equivalente tekenreeksen stderr,
syslogof filet, respectievelijk. Deze waarde geeft aan waar de logboekinformatie naartoe gaat.
0 (nul) betekent dat de berichten naar stderr worden verzonden. Ze zijn direct beschikbaar op de
scherm, maar ze kunnen de uitvoer van opdrachten verstoren. 1 zal de output naar de . sturen
syslog-faciliteit. Houd er rekening mee dat syslog moet worden geconfigureerd om logberichten te accepteren
van gebruikersprogramma's, zie de syslog(8) man-pagina voor meer informatie. Unix-achtig
systemen slaan deze berichten meestal op in /var/log/user.log. 2 stuurt de berichten naar
een aangepast logbestand dat kan worden opgegeven met de -L optie.
-f stdin
Gegevens lezen van stdin. refdbc weet meestal wanneer het uit stdin moet lezen. Echter, een
weinig commando's gebruiken gegevens die in de commandoregel worden geleverd, maar laten ook toe om uit een bestand te lezen.
Gebruik deze optie om refdbc te dwingen om te lezen van stdin in toevoeging naar waarden geleverd op
de opdrachtregel.
-h
Geeft het help- en gebruiksscherm weer en sluit vervolgens af.
-i IP Address
Stel het IP-adres in van de box waarop de applicatieserver draait refbd(1).
In plaats van het IP-adres kunt u ook de hostnaam specificeren, zolang deze maar kan
goed opgelost door uw systeem.
-l Log niveau
Specificeer de prioriteit tot welke gebeurtenissen worden gelogd. Dit is ofwel een getal tussen 0
en 7 of een van de snaren emerg, te waarschuwen, crit, dwalen, waarschuwing, kennisgeving, info, debug,
respectievelijk (zie ook Definities op logniveau). -1 schakelt logboekregistratie volledig uit. Een lage
log-niveau zoals 0 betekent dat alleen de meest kritieke berichten worden gelogd. Een hoger logboek
niveau betekent dat ook minder kritieke gebeurtenissen worden gelogd. 7 bevat foutopsporing
berichten. Dit laatste kan uitgebreid en overvloedig zijn, dus u wilt dit logniveau vermijden
tenzij u problemen moet opsporen.
-L log-bestand
Geef het volledige pad op naar een logbestand dat de logberichten zal ontvangen. Meestal dit
zou zijn /var/log/refdba.
-p port
Stel de poort in van de box waarop de applicatieserver draait.
-q
Begin zonder de configuratiebestanden te lezen. De client gebruikt de compile-time
standaardwaarden voor alle waarden die u niet instelt met opdrachtregelopties. Handig voor
configuratiebestanden debuggen.
-T Time to
Stel de time-out voor de client/toepassingsserver-dialoog in seconden in. Een connectie met
mislukte lees- of schrijfpogingen worden als dood beschouwd en daarna verwijderd
deze tijd is verstreken.
-u naam
Stel de gebruikersnaam voor de databasetoegang in. Opmerking: deze gebruikersnaam hoeft niet identiek te zijn aan:
de inlognaam van de gebruiker. Dit is de gebruikersnaam die nodig is om toegang te krijgen tot de database
server.
-v
Drukt versie- en copyrightinformatie af en sluit vervolgens af.
-V
Schakelt over naar uitgebreide modus.
-w wachtwoord
Stel het wachtwoord in voor toegang tot de database. Opmerking: dit wachtwoord hoeft niet identiek te zijn aan:
het inlogwachtwoord van de gebruiker. Dit is het wachtwoord dat nodig is om toegang te krijgen tot de database
server.
-x
Verstuur wachtwoorden onversleuteld.
-y conf
Geef de map op waar de globale configuratiebestanden zich bevinden. Opmerking: Standaard zijn alle
RefDB-toepassingen zoeken naar hun configuratiebestanden in een opgegeven map
tijdens de configuratiestap bij het bouwen van het pakket. Dat wil zeggen, je hebt de niet nodig -y
optie tenzij u voorgecompileerde binaire bestanden op ongebruikelijke locaties gebruikt, bijv. door een
rpm pakket.
DIAGNOSE
De exit-code is 0 als alles goed is gegaan. Het zal 1 zijn als de opdracht (wanneer uitgevoerd in batchmodus)
of de laatste opdracht (wanneer uitgevoerd in interactieve modus) gaf een fout terug, of als er een
algemene foutconditie tijdens het opstarten, zoals een gebrek aan beschikbaar geheugen.
CONFIGURATIE
refdba evalueert het refdbarc-configuratiebestand bij het opstarten om zichzelf te initialiseren.
tafel 1. refdbarc
┌───────────┬─────────────────────┬───── ────────── ───────────┐
│Veranderlijk │ Standaard │ Opmerking │
├───────────┼─────────────────────┼───── ────────── ───────────┤
│logfile │ /var/log/refdba.log │ Het volledige pad van een │
│ │ │ aangepast logbestand. Dit is
│ │ │ alleen gebruikt als logdest │ . is
│ │ │ correct ingesteld. Als │
│ │ │ je start refdba vanuit │
│ │ │ de opdrachtregel als een │
│ │ │ regelmatige gebruiker, zou u moeten │
│ │ │ specificeer een bestand dat u │
│ │ │ hebben schrijftoegang tot │
│ │ │ (u mag niet │
│ │ │ om │ te creëren
│ │ │ /var/log/refdb.log of │
│ │ │ schrijf naar dit bestand als een │
│ │ │ regelmatige gebruiker). │
├───────────┼─────────────────────┼───── ────────── ───────────┤
│logdest │ 2 │ De bestemming van de │
│ │ │ logboekinformatie. 0 =
│ │ │ afdrukken naar stderr (dit is │
│ │ │ vooral bedoeld voor │
│ │ │ debuggen, zoals het kan │
│ │ │ visueel interfereren met │
│ │ │ opdrachtuitvoer); 1 = gebruik │
│ │ │ de syslog-faciliteit; 2 =
│ │ │ gebruik een aangepast logbestand. │
│ │ │ De laatste heeft een │ . nodig
│ │ │ juiste instelling van │
│ │ │ logbestand. │
├───────────┼─────────────────────┼───── ────────── ───────────┤
│logniveau │ 6 │ Het logniveau tot │
│ │ │ welke berichten zullen worden │
│ │ │ gelogd. Een lage stand │
│ │ │ (0) staat alleen de meeste │ toe
│ │ │ belangrijke berichten, een │
│ │ │ hoge instelling (7) maakt │ . mogelijk
│ │ │ alle berichten inclusief │
│ │ │ debug berichten. -1 betekent
│ │ │ er wordt niets gelogd. │
├───────────┼─────────────────────┼───── ────────── ───────────┤
│pager │ stdout │ De opdrachtregel van een │
│ │ │ pager die de │ . accepteert
│ │ │ uitvoer van refdb op stdin │
│ │ │ om scrollen toe te staan en │
│ │ andere handige dingen. │
│ │ │ “stdout” verstuurt de gegevens │
│ │ │ naar stdout. │
├───────────┼─────────────────────┼───── ────────── ───────────┤
│passwd │ * │ Het wachtwoord dat │ . is
│ │ │ gebruikt voor authenticatie │
│ │ │ met de database │
│ │ server. Het is
│ │ │ potentieel slecht voor │
│ │ │ onversleuteld opslaan │
│ │ │ wachtwoorden in schijfbestanden. │
│ │ │ Zorg er in ieder geval voor dat │
│ │ │ het configuratiebestand │
│ │ │ is niet leesbaar voor │
│ │ iemand anders. De standaard
│ │ │ instelling veroorzaakt refdba naar │
│ │ │ om uw wachtwoord vragen │
│ │ │ interactief. │
├───────────┼─────────────────────┼───── ────────── ───────────┤
│poort │ 9734 │ De poort waarop refdbd │
│ │ luistert. Verander dit voor
│ │ │ alle klanten en de │
│ │ │ server als deze waarde │
│ │ │ interfereert met een ander │
│ │ │ programma via deze poort. │
├───────────┼─────────────────────┼───── ────────── ───────────┤
│serverip │ 127.0.0.1 │ Het IP-adres of │
│ │ │ hostnaam van de machine │
│ │ │ waar refdbd draait. Gebruik
│ │ │ de standaard (localhost) │
│ │ │ adres als de klanten │
│ │ │ en refdbd draaien op de │
│ │ dezelfde machine. │
├───────────┼─────────────────────┼───── ────────── ───────────┤
│time-out │ 180 │ De time-out in seconden. │
│ │ │ Na deze tijd heeft │
│ │ │ verstreken, een vastgelopen │
│ │ │ verbinding is gemaakt │
│ │ naar beneden. Verhoog deze │
│ │ │ waarde als je │ . tegenkomt
│ │ │ frequente time-outfouten │
│ │ │ vanwege hoog netwerk │
│ │ │ verkeer of refdbd │
│ │ overbelasting. │
├───────────┼─────────────────────┼───── ────────── ───────────┤
│gebruikersnaam │ loginnaam │ De gebruikersnaam die │ . is
│ │ │ gebruikt voor authenticatie │
│ │ │ met de database │
│ │ server. Dit kan zijn
│ │ │ verschilt van de login │
│ │ │ naam van de gebruiker. │
├───────────┼─────────────────────┼───── ────────── ───────────┤
│uitgebreid │ f │ Zet dit op t als je │
│ │ │ liever uitgebreide fouten │
│ │ │ berichten. │
├───────────┼─────────────────────┼───── ────────── ───────────┤
│no_encrypt │ f │ Indien ingesteld op 't', wachtwoorden │
│ │ │ worden verzonden │
│ │ │ niet-versleuteld. De standaard
│ │ │ is om wachtwoorden te versleutelen. │
└───────────┴─────────────────────┴───── ────────── ───────────┘
COMMANDO'S
Alle commando's bestaan uit een enkel woord dat het commando specificeert. Dit kan worden gevolgd door:
argumenten en/of schakelaars. De algemene syntaxisregels van de getopts-bibliotheek zijn van toepassing.
voeg stijl toe
synopsis
voeg stijl toe [-c commando] [-h] [[-o bestandsnaam] | [-O bestandsnaam]] {stijlbestand...}
BESCHRIJVING
Voegt een of meer bibliografiestijlspecificaties toe vanuit het invoerbestand(en).
Opties
-c commando
Specificeert een commando dat de output zal ontvangen in plaats van de standaard pager.
Dit kan een andere semafoon zijn, elk commando dat invoer op stdin neemt, of de
tekenreeks "stdout" om de gegevens naar stdout te sturen zonder een pager te gebruiken.
-h
Toont de online help over de voeg stijl toe opdracht.
-o bestandsnaam
Schrijf de uitvoer naar bestandsnaam in plaats van te stdouten.
-O bestandsnaam
Voeg de uitvoer toe aan bestandsnaam in plaats van het naar stdout te schrijven.
stijlbestand
Alle andere argumenten worden geïnterpreteerd als de namen van bestanden die stijl bevatten
specificaties.
Voorbeeld
refdba:
voeg stijl toe j.biol.chem.xml farmacol.rev.xml
Hiermee worden de stijlspecificaties in de bestanden j.biol.chem.xml en toegevoegd
pharmacol.rev.xml naar de database in bibliografiestijl.
adduser
synopsis
adduser {-d databank} [-h] {-H host-IP} [-R] [-W wachtwoord] {[-f filet] | [gebruikersnaam...]}
BESCHRIJVING
Verleent toegangsrechten tot een refdb-database aan de opgegeven gebruikers. Specificeer de database met
the -d optie.
Note
Als een gebruiker nog niet bekend is bij de databaseserver, maakt refdb een account aan
met de standaard toegangsrechten (=geen). Als u geen wachtwoord opgeeft voor de
nieuwe gebruiker met de -W optie (zie hieronder), heeft de gebruiker toegang tot de database
server met het standaardwachtwoord "refdb". In de meeste gevallen is dit geen goede zaak.
Een nieuwe gebruiker krijgt automatisch toegang tot de interne refdb database refdb.
Sommige database-engines zoals SQLite ondersteunen geen toegangscontrole. De adduser
commando wordt niet ondersteund met deze engines en geeft alleen een verklarende
bericht.
-d databank
Specificeert de referentiedatabase waarvoor de toegangsrechten moeten gelden.
-f filet
Leest een door spaties gescheiden lijst met gebruikersnamen uit het bestand.
-h
Toont de online help over de adduser opdracht.
-H hostname
hostname specificeert de host waarop de refdb-toepassingsserver draait. Als het doorgaat
dezelfde machine als de databaseserver, kunt u "localhost" specificeren als hostnaam.
Gebruik "%" als hostnaam om toegang toe te staan vanaf alle adressen behalve localhost.
Anders kan het argument hostnaam een hostnaam, een IP-adres of een
subnet dat een of meer computers specificeert om toegang vanaf toe te staan. U kunt de
dezelfde gebruiker meerdere keren met verschillende hostnamen.
Note
Deze optie wordt alleen ondersteund door MySQL. Het wordt genegeerd als u PostgreSQL gebruikt als
uw databaseserver. Zie de PostgreSQL-documentatie voor hulp over hoe
om hostgebaseerde toegangscontrole te manipuleren met het bestand pg_hba.conf.
-R
Gebruik deze optie om de gebruiker alleen-lezentoegang te verlenen. Gebruikers zijn dat standaard
lees-/schrijftoegang verleend. Gebruikers met alleen-lezen toegang kunnen in principe alleen ophalen
referenties en notities.
-W wachtwoord
Stel het wachtwoord voor een nieuwe gebruiker in. Het wachtwoord wordt gecodeerd voordat het wordt overgedragen
naar de applicatieserver. Als de gebruiker al bestaat, zal zijn wachtwoord zijn
dienovereenkomstig gewijzigd.
gebruikersnaam
Alle andere argumenten worden geïnterpreteerd als gebruikersnamen. Als geen van beide een gebruikersnaamargument is
noch een invoerbestand is opgegeven, probeert refdba een door witruimte gescheiden bestand te lezen
lijst met namen van stdin. Om refdba te dwingen te lezen van stdin in toevoeging naar
expliciet genoemde gebruikers, gebruik de -f stdin optie.
Voorbeelden
refdba:
adduser -d db1 -N nieuwpasjim
Dit geeft de nieuwe gebruiker jim toegang tot de database db1. refdbd draait op de
dezelfde computer als de databaseserver (als u de -H optie, localhost is
uitgegaan van). "jim" zal "newpass" als wachtwoord moeten opgeven bij het starten van een van de
refdb-clients.
refdba:
adduser -d db1 -H mono.mycomp.com jim Jane
Dit geeft toegang tot de database db1 voor de gebruikers jim en jane. refdbd loopt door
de computer met de naam "mono.mycomp.com". Als "Jim" en "Jane" al bekend zijn
de databaseserver, behouden ze hun bestaande wachtwoorden. Zo niet, dan hebben ze dat wel
om het standaardwachtwoord "refdb" te gebruiken.
Alternatieven on locaties with begrensd databank server toegang
Als u als refdb-beheerder geen GRANT-rechten hebt op uw database
server, de adduser commando is gedoemd te mislukken. Als een veiligheidsbewuste persoon uw
databasebeheerder kan weigeren om refdba uit te voeren, ongeacht hoe vaak u ervoor zorgt
hem bevat het geen kwaadaardige code. Hij zal het op de harde manier willen doen, en dit is het
wat hij moet doen:
· Als u MySQL als uw databaseserver gebruikt, heeft elke nieuwe gebruiker minimaal invoer nodig
de tabellen mysql.user en mysql.db. Uw databasebeheerder heeft dit mogelijk ingesteld
zijn eigen regels, maar over het algemeen zou de mysql.user-tabel geen privileges moeten toekennen
de gebruiker, terwijl de tabel mysql.db INSERT, SELECT, UPDATE, DELETE moet toestaan
machtigingen aan elke gebruiker voor de refdb-database en SELECT, INSERT, UPDATE,
DELETE, CREATE, DROP privileges voor elke referentiedatabase die de gebruiker zou moeten hebben
toegang tot. Zorg ervoor dat u vermeldt dat het Host-veld in mysql.user de
naam of adres van de box die refdbd uitvoert, wat niet noodzakelijkerwijs identiek is
met het werkstation van de gebruiker.
· Als u in plaats daarvan de voorkeur geeft aan PostgreSQL, is het iets eenvoudiger. Wanneer u een
refdb-database, wordt er een nieuwe groep gemaakt om de toegang tot deze database te beheren. Alle
uw databasebeheerder hoeft te doen is de nieuwe gebruiker aan de groepen toe te voegen
refdbuser (toegang verlenen tot de gemeenschappelijke refdb-database) en gebruiker, waar
is de naam van de referentiedatabase waar de gebruiker toegang toe zou moeten hebben
toegang.
addwoord
synopsis
addwoord [-h] {[-f filet] | [woord...]...}
BESCHRIJVING
De meeste bibliografiestijlen gebruiken gestandaardiseerde afkortingen van de tijdschriftnamen. Meest
gegevensbronnen specificeren deze afkortingen zonder punten, zoals in "Mol Cell Biol". Als de
woorden moeten worden afgekort met punten (zoals in "Mol. Cell Biol.") in de bibliografie,
refdb moet weten welke tokens in de afgekorte naam inderdaad zijn afgekort (bijv
"Mol."), en die volledige woorden zijn (bijv. "Cel"). Hiertoe houdt refdb een lijst bij van
gereserveerde woorden waarvan bekend is dat ze geen afkortingen zijn van iets anders. refdb schepen
met een vrij volledige lijst van dergelijke woorden, maar als u fouten of weglatingen ontdekt, de
addwoord commando komt goed van pas.
Opties
-f filet
Lees een door spaties gescheiden lijst met tijdschrifttitelwoorden uit het bestand.
-h
Toont de online help over de addwoord opdracht.
woord
Alle andere argumenten worden geïnterpreteerd als gereserveerde woorden. Als noch een woordenlijst noch
een invoerbestand is opgegeven, probeert refdba een door spaties gescheiden lijst van
woorden van stdin. Om refdba te dwingen te lezen van stdin in toevoeging naar uitdrukkelijk
vermelde woorden, gebruik de -f stdin optie.
Note
refdb zal alle gereserveerde woorden intern naar hoofdletters converteren, dus dat gebeurt niet
ongeacht in welke hoofdletters u deze woorden opgeeft.
Voorbeeld
refdba:
addwoord -f woordenlijst FOO BAR
Hiermee worden alle gereserveerde woorden in de woordenlijst van het bestand toegevoegd, evenals de woorden "FOO" en
"BAR" toe aan de lijst met gereserveerde woorden.
conserv
synopsis
conserv {commando} [waarde]
BESCHRIJVING
Configureert de applicatieserver terwijl deze actief is en doet enkele trucs met het
refdb helper-databases ook. Sommige commando's wijzigen variabelen die kunnen worden ingesteld
als opdrachtregelargumenten of met het init-bestand. Zie De refdbd-daemon uitvoeren voor
meer informatie over deze variabelen.
Note
Deze opdracht zal refdbd slechts tijdelijk opnieuw configureren. Alle wijzigingen gaan verloren wanneer
de applicatieserver wordt opnieuw opgestart. Om permanente wijzigingen aan te brengen in de
configuratie, bewerk het init-bestand of wijzig de opdrachtregelparameters in het
script dat refdbd start. Houd er ook rekening mee dat beheer op afstand moet zijn
ingeschakeld om deze opdracht te laten werken.
De volgende commando's zijn beschikbaar:
stoppen
Stopt de applicatieserver.
Note
Deze opdracht is alleen van invloed op het bovenliggende refdbd-proces. Alle kinderen die dat mogen zijn
klanten die momenteel worden bediend, zullen dit blijven doen totdat ze klaar zijn.
ping
Controleert of de applicatieserver nog springlevend is. Als dit de
geval, zal het de proces-ID's rapporteren van het kind dat uw vraag behandelt en van
de ouder. Als dit niet het geval is, wordt de verbinding verbroken en wordt er niet gereageerd.
server IP waarde
Stelt het IP-adres van de databaseserver in op waarde.
time-out waarde
Stelt de time-out in seconden in op waarde.
logdst waarde
Stelt de bestemming van de logboekuitvoer in waarde. Mogelijke waarden zijn 0 (stderr), 1
(de syslog-faciliteit van het systeem), 2 (een privélogbestand zoals gedefinieerd door logfile).
logfile waarde
Stelt de bestandsnaam van het logbestand in op waarde.
loglevel waarde
Stelt het maximale niveau in van berichten waarop moet worden gelogd waarde. 0 betekent alleen dat
kritieke fouten worden gelogd, 7 betekent dat alle berichten inclusief de extreem
uitgebreide foutopsporingsberichten worden gelogd. -1 schakelt het loggen volledig uit.
Voorbeeld
refdba: confserv logniveau 7
Hiermee wordt het logniveau op 7 gezet. Deze tijdelijke wijziging is pas van kracht tot
refdbd wordt opnieuw gestart.
gemaaktb
synopsis
gemaaktb [-E codering] [-h] {dbnaam...}
BESCHRIJVING
Maakt een nieuwe database aan met de naam dbnaam. In a. kunnen meerdere databases worden gespecificeerd
enkele aanroep van dit commando.
Opties
-E codering
Selecteer een tekencodering voor de nieuwe database. Dit wordt momenteel alleen ondersteund
door MySQL en PostgreSQL. Als u een andere engine gebruikt, wordt deze optie genegeerd.
Raadpleeg de documentatie van uw database-engine-installatie voor beschikbare
coderingen. De waarde doorgegeven met de -E optie zou moeten zijn IANA[1] codering
naam. Als u deze optie niet gebruikt, zal de nieuwe database de standaard gebruiken
codering van de databaseserver, tenzij uw configuratiebestand refdbdrc a
standaard met een vermelding "db_encoding".
-h
Toont de online help over de gemaaktb opdracht.
naam
De naam van de referentiedatabase. De naam mag geen dubbele punt (':') of een
streepje ('-') vanwege de citatieformaten in documenten die RefDB gebruiken. De toegestane
tekens kunnen verder worden beperkt door de database-engine die u gebruikt. De databank
naam moet ook als niet-hoofdlettergevoelig worden beschouwd, dwz probeer geen a
database "mybase" als u er al een heeft met de naam "MYBASE". Vermijd ook het gebruik van namen
dat zijn SQL-gereserveerde woorden, want dit is gedoemd te mislukken. Helaas, dit
bevat de al te handige naam "referenties". Probeer in plaats daarvan "refs" of "biblio".
Tip
Voeg een constante string zoals "rd" toe aan alle refdb-databasenamen. Dit versnelt
refdb-databases ophalen met de lijstdb opdracht als uw database-engine
beheert aanvullende, niet-RefDB-databases. Gebruik een eenvoudige reguliere expressie zoals
"rd%" om uw zoekopdracht te beperken tot RefDB-databases.
Voorbeeld
refdba:
gemaaktb db1 -E UTF-8 db2
Hiermee worden de databases db1 en db2 gemaakt met de tekencodering UTF-8.
gebruik SQL scripts naar en je merk te creëren databanken
refdb bevat twee SQL-scripts in platte tekst (geïnstalleerd in /usr/local/share/refdb/sql) om
maak databasetabellen net als de gemaaktb commando doet. Deze scripts zijn
in deze gevallen te verkiezen boven het commando:
· U heeft geen machtigingen voor databasebeheerders en moet dit aan uw beheerder vragen
maak de databases voor u aan. Uw beheerder geeft er misschien de voorkeur aan het script zo goed mogelijk uit te voeren
gemakkelijk ontdekken wat het gaat doen.
· U wilt refdb integreren met een bestaand of een op maat gemaakt databasesysteem. In dat
indien u naast de refdb-specifieke tabellen in een bestaande database wilt
niet-refdb-tabellen.
De volgende procedures zijn gelijk aan het uitvoeren van de opdracht createdb. Als je wil
om de tabellen toe te voegen aan een bestaande database, gelieve de scripts en/of de
procedures dienovereenkomstig.
· Als je MySQL gebruikt, gebruik dan de volgende commando's (geef extra opties
zoals gebruikersnaam en wachtwoord zoals vereist):
#~
mysql -e "CREËREN DATABASE dbnaam"
#~
mysql dbnaam < lege.mysql.dump
· Als u PostgreSQL gebruikt, zou de volgende reeks moeten werken (opnieuw, geef
extra opties zoals gebruikersnaam en wachtwoord indien nodig):
#~
dorst 's/refdbtest/dbname/g' < lege.pgsql.dump.in > leeg.pgsql.dump
#~
psql sjabloon1 < leeg.pgsql.dump
Het script empty.pgsql.dump.in bevat de opdrachten om een database aan te maken en in te stellen
passende toegangsrechten voor een nieuwe groep databasegebruikers. Daarom is het een goed
idee om de string "refdbtest" te vervangen door de beoogde naam van uw nieuwe database.
De dorst commando in de eerste regel doet precies dit. Je kunt ook nog een paar dingen bewerken,
zoals de codering. Het tweede commando maakt eigenlijk de database, een nieuwe groep,
verleent rechten aan deze groep en maakt alle benodigde tabellen en sequenties.
template1 is een PostgreSQL-systeemdatabase. De psql opdracht vereist de naam van een
bestaande database als argument, maar in dit geval kunt u elke andere bestaande gebruiken
databank net zo goed.
verwijderdb
synopsis
verwijderdb [-h] {dbnaam...}
BESCHRIJVING
Verwijdert de database met de naam dbnaam. In a. kunnen meerdere databases worden gespecificeerd
enkele aanroep van dit commando.
Voorzichtigheid
De databasestructuur en de gegevens zullen weg zijn, echt weg, dus wees voorzichtig met
deze opdracht. Denk twee keer na en maak bij twijfel in ieder geval eerst een back-up om te voorkomen
uitgebreide hairpulling.
Opties
-h
Geeft een kort gebruiksbericht weer en keert terug naar de prompt.
dbnaam
De naam van de database die moet worden verwijderd.
Voorbeeld
refdba:
verwijderdb db1 db2
Hiermee worden de databases db1 en db2 verwijderd.
verwijderstijl
synopsis
verwijderstijl [-h] {unix-regexp}
BESCHRIJVING
Verwijdert de bibliografiestijlen waarvan de namen overeenkomen met de reguliere Unix-expressie
unix-regexp.
Note
Sommige database-engines, zoals SQLite, ondersteunen geen reguliere expressies in Unix-stijl.
Gebruik in plaats daarvan reguliere SQL-expressies.
Opties
-h
Geeft een kort gebruiksbericht weer en keert terug naar de prompt.
unix-regexp
De overige argumenten worden geïnterpreteerd als een reguliere expressie die specificeert
de stijl of stijlen die verwijderd moeten worden.
Voorbeeld
refdba:
verwijderstijl J\..*
Hiermee worden alle bibliografiestijlen verwijderd die beginnen met "J.".
Verwijder gebruiker
synopsis
Verwijder gebruiker {-d databank} [-h] {-H host-IP-R} {[-f filet] | [gebruikersnaam...]}
BESCHRIJVING
Trekt de toegangsrechten tot een refdb-database in van de opgegeven gebruikers.
Note
Sommige database-engines zoals SQLite ondersteunen geen toegangscontrole. De adduser
commando wordt niet ondersteund met deze engines en geeft alleen een verklarende
bericht.
refdb trekt alleen de toegangsrechten tot de opgegeven database in. Het zal intrekken
noch toegangsrechten tot de interne database refdb, noch zal het de database intrekken
server toegang. U kunt de toegang tot de interne database intrekken door op te geven
"refdb" met de -d keuze. Gebruik a.u.b. om de toegang tot de databaseserver in te trekken
de opdrachtregelhulpprogramma's van uw databaseserver.
Opties
-d databank
Geef de naam van de database op.
-f bestandsnaam
Lees de gebruikersnamen van bestandsnaam
-h
Toont de online help over de Verwijder gebruiker opdracht.
-H hostname
Geef de hostnaam of het IP-adres op waarvoor u de toegangsrechten wilt wijzigen. Dit
moet dezelfde naam zijn die u gebruikte voor een eerdere aanroep naar adduser.
Note
Deze optie wordt alleen ondersteund door MySQL. Het wordt genegeerd als u een andere database gebruikt
motoren.
-R
Trekt alleen-lezen toegang in.
gebruikersnaam
Alle andere argumenten worden geïnterpreteerd als gebruikersnamen. Als geen van beide een gebruikersnaamargument is
noch een invoerbestand is opgegeven, probeert refdba een door witruimte gescheiden bestand te lezen
lijst met namen van stdin. Om refdba te dwingen te lezen van stdin in toevoeging naar
expliciet genoemde gebruikers, gebruik de -f stdin optie.
Voorbeelden
refdba:
Verwijder gebruiker -d -H % db1jim
Dit zal de toegang tot de database db1 intrekken voor de gebruiker jim voor iedereen behalve lokaal
verbindingen.
verwijderwoord
synopsis
verwijderwoord [-h] {[-f filet] | [woord...]...}
BESCHRIJVING
Deze opdracht voert de omgekeerde bewerking van addword uit. De opgegeven gereserveerde woorden
zal van de lijst worden verwijderd.
Opties
-f
Lees een door spaties gescheiden lijst met woorden uit het bestand.
-h
Toont de online help over de addwoord opdracht.
woord
Alle andere argumenten worden geïnterpreteerd als gereserveerde woorden. Als noch een woordenlijst noch
een invoerbestand is opgegeven, probeert refdba een door spaties gescheiden lijst van
woorden van stdin. Om refdba te dwingen te lezen van stdin in toevoeging naar uitdrukkelijk
vermelde woorden, gebruik de -f stdin optie.
Note
refdb zal alle gereserveerde woorden intern naar hoofdletters converteren, dus dat gebeurt niet
ongeacht in welk geval u deze woorden verstrekt.
Voorbeeld
refdba:
verwijderwoord -f woordenlijst FOO BAR
Hiermee worden alle gereserveerde woorden in de woordenlijst van het bestand verwijderd, evenals de woorden "FOO"
en "BAR" uit de lijst met gereserveerde woorden.
getstijl
synopsis
getstijl [-c] [-h] [[-o] | [-O]] {stijl...}
BESCHRIJVING
Haalt een of meer bibliografiestijlspecificaties op uit de database en formaten
ze als een XML-bestand.
Opties
-c commando
Specificeer een commando dat de output zal ontvangen in plaats van de standaard pager. Dit
kan een andere semafoon zijn, een commando dat invoer op stdin neemt, of de string
"stdout" om de gegevens naar stdout te sturen zonder een pager te gebruiken.
-h
Toont de online help over de getstijl opdracht.
-o
Schrijf de uitvoer naar een bestand in plaats van naar stdout.
-O
Voeg de uitvoer toe aan een bestand in plaats van het naar stdout te schrijven
waarschuwing
Wees voorzichtig met het toevoegen (-O) keuze. refdb zal de verwerking uitvoeren
instructies, de doctype-regel en één CITESTYLE-element voor elk
individueel gevraagde stijl. Als u de resultaten van meerdere
getstijl calls, zal het resulterende XML-bestand niet goed gevormd zijn zonder verder
verwerken. Gebruik een
single getstijl bel en vermeld alle vereiste stijlen als argumenten. Dit zal
voer de stijlen uit verpakt in een STYLESET-element, resulterend in een geldige XML
bestand.
stijl
Alle andere argumenten worden geïnterpreteerd als de namen van bibliografiestijlen.
Voorbeeld
refdba:
getstijl -o j.biol.chem.xml Chem.
Hiermee wordt de stijlspecificatie geschreven die is opgeslagen onder de stijlnaam "J.Biol.Chem." naar
het bestand j.biol.chem.xml.
uw
synopsis
uw
?
BESCHRIJVING
Toont een korte samenvatting van de beschikbare commando's.
Voorbeeld
refdba:
uw
lijstdb
synopsis
lijstdb [-h] [database-regexp]
BESCHRIJVING
Geeft alle beschikbare databases weer als er geen argument is opgegeven. Indien database-regexp is
opgegeven, worden alleen de databases weergegeven die overeenkomen met deze uitdrukking.
Note
Om refdb-referentiedatabases te onderscheiden van andere onderhouden databases
door uw databaseserver, moet refdbd in elke database gluren die door de
database server. Afhankelijk van het aantal beschikbare databases kan dit enige tijd in beslag nemen
tijd. Daarom kan het een goed idee zijn om een gemeenschappelijk voorvoegsel te gebruiken voor alle refdb
databases zoals uitgelegd in de sectie over de gemaaktb opdracht.
Opties
-h
Geeft een helpbericht weer met uitleg over de lijstdb opdracht.
database-regexp
Een geldige reguliere SQL-expressie die de uitvoer beperkt tot overeenkomende databasenamen.
Voorbeeld
refdba:
lijstdb dB%
Hiermee worden alle databases weergegeven met namen die beginnen met de tekenreeks "db".
lijststijl
synopsis
lijststijl [-h] [stijl-regexp]
BESCHRIJVING
Geeft een lijst van alle beschikbare bibliografiestijlen die overeenkomen stijl-regexp. Als er geen argument is
gegeven, allen beschikbare stijlen worden weergegeven. Dit kan wel of niet zijn wat je wilt.
Opties
-h
Geeft een helpbericht weer met uitleg over de lijstdb opdracht.
stijl-regexp
Een geldige Unix reguliere expressie die de uitvoer beperkt tot overeenkomende stijlnamen.
Note
Sommige database-engines, zoals SQLite, ondersteunen geen Unix-stijl regular
uitdrukkingen. Gebruik in plaats daarvan reguliere SQL-expressies.
Voorbeeld
refdba:
lijststijl ^J.*
Hiermee worden alle bibliografiestijlen weergegeven die beginnen met een hoofdletter "J".
lijstgebruiker
synopsis
lijstgebruiker {-D databank} [-h] [naam-regexp]
BESCHRIJVING
Toont alle beschikbare gebruikers van de opgegeven database die overeenkomen naam-regexp Als Nee
argument wordt gegeven, allen beschikbare gebruikers worden weergegeven. Dit kan wel of niet zijn wat jij bent
willen.
Opties
-d databank
Geef de databasenaam op.
-h
Geeft een helpbericht weer met uitleg over de lijstdb opdracht.
naam-regexp
Een geldige reguliere Unix-expressie die de uitvoer beperkt tot een overeenkomende databasegebruiker
namen.
Note
Sommige database-engines, zoals SQLite, ondersteunen geen Unix-stijl regular
uitdrukkingen. Gebruik in plaats daarvan reguliere SQL-expressies.
Voorbeeld
refdba:
lijstgebruiker -d scheidsrechters ^ma.*
Hiermee worden alle gebruikers van de database "refs" vermeld waarvan de naam begint met "mo".
lijstwoord
synopsis
lijstwoord [-h] {woord-regexp}
BESCHRIJVING
Toont alle beschikbare gereserveerde dagboekwoorden die overeenkomen unix-regexp. Als er geen argument is
gegeven, allen beschikbare woorden worden weergegeven. Dit kan wel of niet zijn wat je wilt.
Note
Houd er rekening mee dat de journaalwoorden intern in hoofdletters staan. Je zou moeten schrijven
jouw unix-regexp gebruik alle hoofdletters dienovereenkomstig.
Opties
-h
Geeft een helpbericht weer met uitleg over de lijstdb opdracht.
woord-regexp
Een geldige Unix-reguliere expressie die de uitvoer beperkt tot overeenkomende tijdschrifttitels
woorden.
Note
Sommige database-engines, zoals SQLite, ondersteunen geen Unix-stijl regular
uitdrukkingen. Gebruik in plaats daarvan reguliere SQL-expressies.
Note
Voor een korte omschrijving van het doel van gereserveerde woorden, zie de addwoord
opdracht.
Voorbeeld
refdba:
lijstwoord ^BIO.*
Hiermee worden alle gereserveerde journaalwoorden weergegeven die beginnen met "BIO".
scannen
synopsis
scannen {-d databank} [-h]
BESCHRIJVING
Deze opdracht plant een volledige trefwoordscan in de database die is opgegeven met de -d
keuze. Het abstracte veld en alle titelvelden van alle referenties die in de
database worden gescand op de aanwezigheid van alle trefwoorden die beschikbaar zijn in de database. Als een
match is gevonden en het trefwoord is nog niet gekoppeld aan die referentie, het trefwoord
wordt aan die verwijzing toegevoegd. Naarmate de tijd die nodig is om deze bewerking uit te voeren toeneemt
met zowel het aantal referenties als het aantal trefwoorden is de trefwoordenscan
uitgevoerd op de achtergrond en de opdracht keert onmiddellijk terug aan de clientzijde.
Zie het serverlogboek voor de resultaten.
Aangezien deze opdracht een groot aantal databasetoegangen veroorzaakt, kunt u dit het beste plannen
automatisch uitgevoerd als een cron-taak op een moment van weinig gebruik, 's nachts of in het weekend.
Let op het verschil tussen de volledige trefwoordscan en het automatische trefwoord
scan die kan worden aangevraagd door de opdrachtregelschakelaar refdbd -K of het overeenkomstige
configuratie variabele trefwoord_scan. De volledige trefwoordscan is "retrospectief", dwz het
voegt trefwoorden toe die later zijn toegevoegd aan eerder bestaande referenties. De
automatische trefwoordscan zal dus alleen bestaande trefwoorden toevoegen aan nieuw toegevoegde referenties
waardoor de databaseprestaties minder worden beïnvloed terwijl gebruikers waarschijnlijk toegang hebben tot de
database.
Opties
-d databank
Geef de databasenaam op.
-h
Geeft een helpbericht weer met uitleg over de lijstdb opdracht.
reeks
synopsis
reeks [-h] [vernaam] [varwaarde]
BESCHRIJVING
De reeks commando toont of wijzigt de waarden van configuratievariabelen.
Als je belt reeks zonder enige argumenten zal het een lijst met alle configuraties weergeven
variabelen met hun huidige waarden.
Als je belt reeks met één argument, zal het de huidige waarde hiervan weergeven
bepaalde variabele.
Als je belt reeks met twee argumenten, zal het de variabele (eerste argument) instellen op de
nieuwe waarde (tweede argument) voor de huidige sessie. Gebruik om een lege waarde op te geven
twee aanhalingstekens zoals deze: "".
Note
Voor duidelijke redenen, reeks zal nooit het huidige wachtwoord weergeven, hoewel u dat wel kunt
verander zeker het wachtwoord met deze opdracht. Om er zeker van te zijn dat niemand anders de ziet
nieuw wachtwoord dat u invoert, voert u de opdracht uit reeks passwd *. U wordt dan gevraagd
om een wachtwoord in te voeren dat niet op het scherm wordt weergegeven.
Deze opdracht is niet beschikbaar in batchmodus, gebruik de opdrachtregelschakelaars
in plaats daarvan. In de interactieve modus zijn de wijzigingen in de configuratievariabelen:
beperkt tot de huidige sessie. Als u de waarden permanent wilt wijzigen, moet u
zou eerder een van de configuratiebestanden moeten bewerken.
Opties
-h
Geeft een helpbericht weer met uitleg over de lijstdb opdracht.
vernaam
De naam van de variabele waarvan de waarde moet worden weergegeven of ingesteld.
varwaarde
De nieuwe waarde van de in te stellen variabele.
Voorbeeld
refdba:
reeks time-out 90
Deze opdracht stelt de time-out in op 90 seconden voor de huidige sessie.
breedsprakig
synopsis
breedsprakig [-h]
BESCHRIJVING
Schakelt de uitgebreide modus in of uit. Als de uitgebreide modus is ingeschakeld, worden de foutmeldingen en
waarschuwingen zijn misschien wat begrijpelijker.
Opties
-h
Geeft een helpbericht weer met uitleg over de lijstdb opdracht.
Voorbeeld
refdba:
breedsprakig
Afhankelijk van de vorige instelling, schakelt dit de uitgebreide modus in of uit.
kijkstat
synopsis
kijkstat [-h]
BESCHRIJVING
Toont de versienummers van het libdbi-stuurprogramma dat wordt gebruikt om verbinding te maken met uw databaseserver
evenals de versie-informatie van die server. Het toont ook de huidige waarden van
de variabelen waarmee kan worden gewijzigd conserv.
Opties
-h
Geeft een helpbericht weer met uitleg over de lijstdb opdracht.
Voorbeeld
refdba:
kijkstat
Hierdoor worden enkele verbindingsstatistieken en informatie op het scherm afgedrukt.
Gebruik refdba online met behulp van onworks.net-services