CVS - kommandolinjeverktøyet grip CVS er et system for versjonskontroll av dokumenter CVS generelt TortoiseCVS (Windows-klient) Gjøre klart for bruk av CVS CVS kan benyttes på NTNUs login-servere, linuxlogin.stud.ntnu.no. Det første som må gjøres når man vil benytte CVS er å lage en såkalt CVS-rot. Det er under denne at alt vil bli lagret. La oss si man ønsker å opprette en CVS-rot på en katalog ved navn cvs på sitt hjemmeområde. Man begynner med å opprette katalogen: tiger:~$ mkdir cvs Man kan så opprette CVS-roten i denne katalogen med kommandoen tiger:~$ cvs -d ~grip/cvs init Argumentet -d ~grip/cvs indikerer hvor CVS-roten er (bytt ut grip med ditt eget brukernavn). For å slippe å skrive dette i alle kommandoene før man har opprettet prosjektet, kan man skrive tiger:~$ export CVSROOT=~grip/cvs Dette vil opprette en miljøvariabel, CVSROOT, som inneholder banen til CVS-roten. Opprette et prosjekt Alt er klart til å begynne å opprette prosjekter for å lagre i CVS. La oss si at det finnes en katalog java, med et programmeringsprosjekt i, som man vil benytte CVS for. Man kan da gå inn i katalogen og opprette CVS-prosjektet med alle filene og underkatalogene til java-katalogen: tiger:~$ cd java tiger:~/java$ cvs import -m "Et java-prosjekt" javaprosjekt eksempel start N javaprosjekt/en_fil.java N javaprosjekt/testfil.java No conflicts created by this import Man bør få en utskrift som ligner på den ovenfor, som indikerer at filene som er listet opp er lagt til i det såkalte CVS-repository'et for prosjektet, som er en plass under CVS-roten der all dataen lagres. Navnet på repository'et i eksemplet ovenfor er javaprosjekt. Dersom man ønsker det kan man nå slette hele java-katalogen. Alt er nemlig lagret i CVS-repository'et. Jobbe med prosjektet Dette er vel og bra, men det er ønskelig å arbeide med filene, og dessuten kunne opprette nye/slette gamle filer. Det man nå kan gjøre er å gå til en katalog der man ønsker å plassere filene, og skrive tiger:~$ cvs checkout javaprosjekt cvs checkout: Updating javaprosjekt U javaprosjekt/en_fil.java U javaprosjekt/testfil.java Det vil nå bli opprettet en kopi av javaprosjektet i katalogen javaprosjekt. Dette er en lokal kopi som man kan herje med akkurat som man vil. Man kan forandre filene, slette filer, opprette nye filer etc. Det fine er at dette ikke endrer det som ligger i CVS-repository'et i det hele tatt. Når man føler at man har gjort noe nyttig, for eksempel at man har forandret filen testfil.java, kan man oppdatere repository'et med forandringene, ved å skrive tiger:~/javaprosjekt$ cvs commit -m "Laget en ny utskriftsmetode" testfil.java Checking in testfil.java; /home/homej/gr/grip/cvs/javaprosjekt/testfil.java,v -- testfil.java new revision: 1.2; previous revision: 1.1 done Filen blir nå lagt til i repository'et sammen med kommentaren i hermetegn, men får et nytt versjonsnummer. Dermed blir ikke den gamle versjonen overskrevet, men kan hentes ut igjen i tilfelle man forandret noe feil. For å sammenligne en lokal fil med den i repository'et kan man skrive tiger:~/javaprosjekt$ cvs status en_fil.java =================================================================== File: en_fil.java Status: Locally Modified Working revision: 1.1.1.1 Tue Jan 28 19:30:38 2003 Repository revision: 1.1.1.1 /home/homej/gr/grip/cvs/javaprosjekt/en_fil.java,v Sticky Tag: (none) Sticky Date: (none) Sticky Options: (none) Man kan da se om versjonen man jobber med er oppdatert, eller om den er eldre eller forandret i forhold til den i repository'et. I status-feltet ovenfor kan man se at denne filen har blitt endret i forhold til versjonen i repository'et. Dersom man ønsker å oppdatere sin lokale kopi kan man skrive tiger:~/javaprosjekt$ cvs update en_fil.java M en_fil.java For å legge til en ny fil man har opprettet, må man skrive to kommandoer: tiger:~/javaprosjekt$ cvs add enda_en_fil.java cvs add: scheduling file `enda_en_fil.java' for addition cvs add: use 'cvs commit' to add this file permanently tiger:~/javaprosjekt$ cvs commit -m "En ny fil" enda_en_fil.java RCS file: /home/homej/gr/grip/cvs/javaprosjekt/enda_en_fil.java,v done Checking in enda_en_fil.java; /home/homej/gr/grip/cvs/javaprosjekt/enda_en_fil.java,v -- enda_en_fil.java initial revision: 1.1 done Man kan fjerne en fil fra repository'et ved å skrive tiger:~/javaprosjekt$ cvs remove enda_en_fil.java cvs remove: scheduling `enda_en_fil.java' for removal cvs remove: use 'cvs commit' to remove this file permanently tiger:~/javaprosjekt$ cvs commit -m "En ny fil" enda_en_fil.java Removing enda_en_fil.java; /home/homej/gr/grip/cvs/javaprosjekt/enda_en_fil.java,v -- enda_en_fil.java new revision: delete; previous revision: 1.1 done Se på loggen for filene For en mer detaljert oversikt over hva som har skjedd med en fil kan man skrive tiger:~/javaprosjekt$ cvs log testfil.java RCS file: /home/homej/gr/grip/cvs/javaprosjekt/testfil.java,v Working file: testfil.java head: 1.2 branch: locks: strict access list: symbolic names: start: 1.1.1.1 eksempel: 1.1.1 keyword substitution: kv total revisions: 3; selected revisions: 3 description: ---------------------------- revision 1.2 date: 2003/01/28 19:45:54; author: grip; state: Exp; lines: +1 -1 Laget en ny utskriftsmetode ---------------------------- revision 1.1 date: 2003/01/28 19:45:20; author: grip; state: Exp; branches: 1.1.1; Initial revision ---------------------------- revision 1.1.1.1 date: 2003/01/28 19:45:20; author: grip; state: Exp; lines: +0 -0 Et java-prosjekt ============================================================================= CVS i samarbeidsprosjekt Dersom man benytter CVS i et samarbeidprosjekt, jobber alle på hver sin lokale kopi av prosjektet, men opp mot det samme CVS-repository'et. Da må alle de involverte ha riktig tilgang til dette. Dersom man har et felles område som kan benyttes til formålet, vil det være naturlig å opprette CVS-roten her. Hvis man for eksempel har fått tildelt området /home/prosjekt/sif8005/sif8005_204, vil man bytte ut kommandoene under avsnittet Gjøre klart for bruk av CVS med tiger:~$ cd /home/prosjekt/sif8005/sif8005_204 tiger:/home/prosjekt/sif8005/sif8005_204$ mkdir cvs tiger:/home/prosjekt/sif8005/sif8005_204$ export CVSROOT=/home/prosjekt/sif8005/sif8005_204/cvs tiger:/home/prosjekt/sif8005/sif8005_204$ cvs init Merk at ved å sette miljøvariablen først, kan man kutte ut det ekstra argumentet til cvs init. Merk også at alle de involverte må sette denne miljøvariablen før de foretar utsjekkingen av sin lokale kopi (se avsnittet Jobbe med prosjektet). Man må også sørge for å sette rettighetene på CVS-repository'et slik at alle de involverte har tilgang. Dersom det finnes en bestemt gruppe for prosjektet, for eksempel prog204, må man sette rettighetene slik at repository'et for prosjektet eies av denne gruppa, og at gruppa har riktige rettigheter. Når prosjektet er opprettet (vi antar igjen at det har navnet javaprosjekt), vil følgende kommandoer sørge for det: tiger:/home/prosjekt/sif8005/sif8005_204$ cd cvs tiger:/home/prosjekt/sif8005/sif8005_204/cvs$ chgrp -R prog204 javaprosjekt tiger:/home/prosjekt/sif8005/sif8005_204/cvs$ chmod -R g+r javaprosjekt tiger:/home/prosjekt/sif8005/sif8005_204/cvs$ find javaprosjekt -depth -type d -exec chmod g+wx {} \; Det som skjer her er at filene får gruppetilhørighet til prog204. Deretter får gruppen leserettigheter på alle filene og underkatalogene i repository'et, og til slutt får gruppen skriverettigheter på alle katalogene i repository'et. Når det gjelder skriverettighetene er det altså rettighetene på katalogen som er avgjørende, ikke på filene selv. Andre ressurser CVS har mange andre muligheter. For hjelp om bruken av en kommando, skriv cvs -H kommando, der kommando er en den kommandoen du vil ha hjelp om. For en mer detaljert oversikt over mulighetene i CVS kan man for eksempel ta en titt på http://www.nongnu.org/cvs/