123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525526527528529530531532533534535536537538539540541542543544545546547548549550551552553554555556557558559560561562563564565566567568569570571572573574575576577578579580581582583584585586587588589590591592593594595596597598599600601602603604605606607608609610611612613614615616617618619620621622623624625626627628629630631632633634635636637638639640641642643644645646647648649650651652653654655656657658659660661662663664665666667668669670671672673674675676677678679680681682683684685686687688689690691692693694695696697698699700701702703704705706707708709710711712713714715716717718719720721722723724725726727728729730731732733734735736737738739740741742743744745746747748749750751752753754755756757758759760761762763764765766767768769770771772773774775776777778779780781782783784785786787788789790791792793794795796797798799800801802803804805806807808809810811812813814815816817818819820821822823824825826827828829830831832833834835836837838839840841842843844845846847848849850851852853854855856857858859860861862863864865866867868869870871872873874875876877878879880881882883884885886887888889890891892893894895896897898899900901902903904905906907908909910911912913914915916917918919920921922923924925926927928929930931932933934935936937938939940941942943944945946947948949950951952953954955956957958959960961962963964965966967968969970971972973974975976977978979980981982983984985986987988989990991992993994995996997998999100010011002100310041005100610071008100910101011101210131014101510161017101810191020102110221023102410251026102710281029103010311032103310341035103610371038103910401041104210431044104510461047104810491050105110521053105410551056105710581059106010611062106310641065106610671068106910701071107210731074107510761077107810791080108110821083108410851086108710881089109010911092109310941095109610971098109911001101110211031104110511061107110811091110111111121113111411151116111711181119112011211122112311241125112611271128112911301131113211331134113511361137113811391140114111421143114411451146114711481149115011511152115311541155115611571158115911601161116211631164116511661167116811691170117111721173117411751176117711781179118011811182118311841185118611871188118911901191119211931194119511961197119811991200120112021203120412051206120712081209121012111212121312141215121612171218121912201221122212231224122512261227122812291230123112321233123412351236123712381239124012411242124312441245124612471248124912501251125212531254125512561257125812591260126112621263126412651266126712681269127012711272127312741275127612771278127912801281128212831284128512861287128812891290129112921293129412951296129712981299130013011302130313041305130613071308130913101311131213131314131513161317131813191320132113221323132413251326132713281329133013311332133313341335133613371338133913401341134213431344134513461347134813491350135113521353135413551356135713581359136013611362136313641365136613671368136913701371137213731374137513761377137813791380138113821383138413851386138713881389139013911392139313941395139613971398139914001401140214031404140514061407140814091410141114121413141414151416141714181419142014211422142314241425142614271428142914301431143214331434143514361437143814391440144114421443144414451446144714481449145014511452145314541455145614571458145914601461146214631464146514661467146814691470147114721473147414751476147714781479148014811482148314841485148614871488148914901491149214931494149514961497149814991500150115021503150415051506150715081509151015111512151315141515151615171518151915201521152215231524152515261527152815291530153115321533153415351536153715381539154015411542154315441545154615471548154915501551155215531554155515561557155815591560156115621563156415651566156715681569157015711572157315741575157615771578157915801581158215831584158515861587158815891590159115921593159415951596159715981599160016011602160316041605160616071608160916101611161216131614161516161617161816191620162116221623162416251626162716281629163016311632163316341635163616371638163916401641164216431644164516461647164816491650165116521653165416551656165716581659166016611662166316641665166616671668166916701671167216731674167516761677167816791680168116821683168416851686168716881689169016911692169316941695169616971698169917001701170217031704170517061707170817091710171117121713171417151716171717181719172017211722172317241725172617271728172917301731173217331734173517361737173817391740174117421743174417451746174717481749175017511752175317541755175617571758175917601761176217631764176517661767176817691770177117721773177417751776177717781779178017811782178317841785178617871788178917901791179217931794179517961797179817991800180118021803180418051806180718081809181018111812181318141815181618171818181918201821182218231824182518261827182818291830183118321833183418351836183718381839184018411842184318441845184618471848184918501851185218531854185518561857185818591860186118621863186418651866186718681869187018711872187318741875187618771878187918801881188218831884188518861887188818891890189118921893189418951896189718981899190019011902190319041905190619071908190919101911191219131914191519161917191819191920192119221923192419251926192719281929193019311932193319341935193619371938193919401941194219431944194519461947194819491950195119521953195419551956195719581959196019611962196319641965196619671968196919701971197219731974197519761977197819791980198119821983198419851986198719881989199019911992199319941995199619971998199920002001200220032004200520062007200820092010201120122013201420152016201720182019202020212022202320242025202620272028202920302031203220332034203520362037203820392040204120422043204420452046204720482049205020512052205320542055205620572058205920602061206220632064206520662067206820692070207120722073207420752076207720782079208020812082208320842085208620872088208920902091209220932094209520962097209820992100210121022103210421052106210721082109211021112112211321142115211621172118211921202121212221232124212521262127212821292130213121322133213421352136213721382139214021412142214321442145214621472148214921502151215221532154215521562157215821592160216121622163216421652166216721682169217021712172217321742175217621772178217921802181218221832184218521862187218821892190219121922193219421952196219721982199220022012202220322042205220622072208220922102211221222132214221522162217221822192220222122222223222422252226222722282229223022312232223322342235223622372238223922402241224222432244224522462247224822492250225122522253225422552256225722582259226022612262226322642265226622672268226922702271227222732274227522762277227822792280228122822283228422852286228722882289229022912292229322942295229622972298229923002301230223032304230523062307230823092310231123122313231423152316231723182319232023212322232323242325232623272328232923302331233223332334233523362337233823392340234123422343234423452346234723482349235023512352235323542355235623572358235923602361236223632364236523662367236823692370237123722373237423752376237723782379238023812382238323842385238623872388238923902391239223932394239523962397239823992400240124022403240424052406240724082409241024112412241324142415241624172418241924202421242224232424242524262427242824292430243124322433243424352436243724382439244024412442244324442445244624472448244924502451245224532454245524562457245824592460246124622463246424652466246724682469247024712472247324742475247624772478247924802481248224832484248524862487248824892490249124922493249424952496249724982499250025012502250325042505250625072508250925102511251225132514251525162517251825192520252125222523252425252526252725282529253025312532253325342535253625372538253925402541254225432544254525462547254825492550255125522553255425552556255725582559256025612562256325642565256625672568256925702571257225732574257525762577257825792580258125822583258425852586258725882589259025912592259325942595259625972598259926002601260226032604260526062607260826092610261126122613261426152616261726182619262026212622262326242625262626272628262926302631263226332634263526362637263826392640264126422643264426452646264726482649265026512652265326542655265626572658265926602661266226632664266526662667266826692670267126722673267426752676267726782679268026812682268326842685268626872688268926902691269226932694269526962697269826992700270127022703270427052706270727082709271027112712271327142715271627172718271927202721272227232724272527262727272827292730273127322733273427352736273727382739274027412742274327442745274627472748274927502751275227532754275527562757275827592760276127622763276427652766276727682769277027712772277327742775277627772778277927802781278227832784278527862787278827892790279127922793279427952796279727982799280028012802280328042805280628072808280928102811281228132814281528162817281828192820282128222823282428252826282728282829283028312832283328342835283628372838283928402841284228432844284528462847284828492850285128522853285428552856285728582859286028612862286328642865286628672868286928702871287228732874287528762877287828792880288128822883288428852886288728882889289028912892289328942895289628972898289929002901290229032904290529062907290829092910291129122913291429152916291729182919292029212922292329242925292629272928292929302931293229332934293529362937293829392940294129422943294429452946294729482949295029512952295329542955295629572958295929602961296229632964296529662967296829692970297129722973297429752976297729782979298029812982298329842985298629872988298929902991299229932994299529962997299829993000300130023003300430053006300730083009301030113012301330143015301630173018301930203021302230233024302530263027302830293030303130323033303430353036303730383039304030413042304330443045304630473048304930503051305230533054305530563057305830593060306130623063306430653066306730683069307030713072307330743075307630773078307930803081308230833084308530863087308830893090309130923093309430953096309730983099310031013102310331043105310631073108310931103111311231133114311531163117311831193120312131223123312431253126312731283129313031313132313331343135313631373138313931403141314231433144314531463147314831493150315131523153315431553156315731583159316031613162316331643165316631673168316931703171317231733174317531763177317831793180318131823183318431853186318731883189319031913192319331943195319631973198319932003201320232033204320532063207320832093210321132123213321432153216321732183219322032213222322332243225322632273228322932303231323232333234323532363237323832393240324132423243324432453246324732483249325032513252325332543255325632573258325932603261326232633264326532663267326832693270327132723273327432753276327732783279328032813282328332843285328632873288328932903291329232933294329532963297329832993300330133023303330433053306330733083309331033113312331333143315331633173318331933203321332233233324332533263327332833293330333133323333333433353336333733383339334033413342334333443345334633473348334933503351335233533354335533563357335833593360336133623363336433653366336733683369337033713372337333743375337633773378337933803381338233833384338533863387338833893390339133923393339433953396339733983399340034013402340334043405340634073408340934103411341234133414341534163417341834193420342134223423342434253426342734283429343034313432343334343435343634373438343934403441344234433444344534463447344834493450345134523453345434553456345734583459346034613462346334643465346634673468346934703471347234733474347534763477347834793480348134823483348434853486348734883489349034913492349334943495349634973498349935003501350235033504350535063507350835093510351135123513351435153516351735183519352035213522352335243525352635273528352935303531353235333534353535363537353835393540354135423543354435453546354735483549355035513552355335543555355635573558355935603561356235633564356535663567356835693570357135723573357435753576357735783579358035813582358335843585358635873588358935903591359235933594359535963597359835993600360136023603360436053606360736083609361036113612361336143615361636173618361936203621362236233624362536263627362836293630363136323633363436353636363736383639364036413642364336443645364636473648364936503651365236533654365536563657365836593660366136623663366436653666366736683669367036713672367336743675367636773678367936803681368236833684368536863687368836893690369136923693369436953696369736983699370037013702370337043705370637073708370937103711371237133714371537163717371837193720372137223723372437253726372737283729373037313732373337343735373637373738373937403741374237433744374537463747374837493750375137523753375437553756375737583759376037613762376337643765376637673768376937703771377237733774377537763777377837793780378137823783378437853786378737883789379037913792379337943795379637973798379938003801380238033804380538063807380838093810381138123813381438153816381738183819382038213822382338243825382638273828382938303831383238333834383538363837383838393840384138423843384438453846384738483849385038513852385338543855385638573858385938603861386238633864386538663867386838693870387138723873387438753876387738783879388038813882388338843885388638873888388938903891389238933894389538963897389838993900390139023903390439053906390739083909391039113912391339143915391639173918391939203921392239233924392539263927392839293930393139323933393439353936393739383939394039413942394339443945394639473948394939503951395239533954395539563957395839593960396139623963396439653966396739683969397039713972397339743975397639773978397939803981398239833984398539863987398839893990399139923993399439953996399739983999400040014002400340044005400640074008400940104011401240134014401540164017401840194020402140224023402440254026402740284029403040314032403340344035403640374038403940404041404240434044404540464047404840494050405140524053405440554056405740584059406040614062406340644065406640674068406940704071407240734074407540764077407840794080408140824083408440854086408740884089409040914092409340944095409640974098409941004101410241034104410541064107410841094110411141124113411441154116411741184119412041214122412341244125412641274128412941304131413241334134413541364137413841394140414141424143414441454146414741484149415041514152415341544155415641574158415941604161416241634164416541664167416841694170417141724173417441754176417741784179418041814182418341844185418641874188418941904191419241934194419541964197419841994200420142024203420442054206420742084209421042114212421342144215421642174218421942204221422242234224422542264227422842294230423142324233423442354236423742384239424042414242424342444245424642474248424942504251425242534254425542564257425842594260426142624263426442654266426742684269427042714272427342744275427642774278427942804281428242834284428542864287428842894290429142924293429442954296429742984299430043014302430343044305430643074308430943104311431243134314431543164317431843194320432143224323432443254326432743284329433043314332433343344335433643374338433943404341434243434344434543464347434843494350435143524353435443554356435743584359436043614362436343644365436643674368436943704371437243734374437543764377437843794380438143824383438443854386438743884389439043914392439343944395439643974398439944004401440244034404440544064407440844094410441144124413441444154416441744184419442044214422442344244425442644274428442944304431443244334434443544364437443844394440444144424443444444454446444744484449445044514452445344544455445644574458445944604461446244634464446544664467446844694470447144724473447444754476447744784479448044814482448344844485448644874488448944904491449244934494449544964497449844994500450145024503450445054506450745084509451045114512451345144515451645174518451945204521452245234524452545264527452845294530453145324533453445354536453745384539454045414542454345444545454645474548454945504551455245534554455545564557455845594560456145624563456445654566456745684569457045714572457345744575457645774578457945804581458245834584458545864587458845894590459145924593459445954596459745984599460046014602460346044605460646074608460946104611461246134614461546164617461846194620462146224623462446254626462746284629463046314632463346344635463646374638463946404641464246434644464546464647464846494650465146524653465446554656465746584659466046614662466346644665466646674668466946704671467246734674467546764677467846794680468146824683468446854686468746884689469046914692469346944695469646974698469947004701470247034704470547064707470847094710471147124713471447154716471747184719472047214722472347244725472647274728472947304731473247334734473547364737473847394740474147424743474447454746474747484749475047514752475347544755475647574758475947604761476247634764476547664767476847694770477147724773477447754776477747784779478047814782478347844785478647874788478947904791479247934794479547964797479847994800480148024803480448054806480748084809481048114812481348144815481648174818481948204821482248234824482548264827482848294830483148324833483448354836483748384839484048414842484348444845484648474848484948504851485248534854485548564857485848594860486148624863486448654866486748684869487048714872487348744875487648774878487948804881488248834884488548864887488848894890489148924893489448954896489748984899490049014902490349044905490649074908490949104911491249134914491549164917491849194920492149224923492449254926492749284929493049314932493349344935493649374938493949404941494249434944494549464947494849494950495149524953495449554956495749584959496049614962496349644965496649674968496949704971497249734974497549764977497849794980498149824983498449854986498749884989499049914992499349944995499649974998499950005001500250035004500550065007500850095010501150125013501450155016501750185019502050215022502350245025502650275028502950305031503250335034503550365037503850395040504150425043504450455046504750485049505050515052505350545055505650575058505950605061506250635064506550665067506850695070507150725073507450755076507750785079508050815082508350845085508650875088508950905091509250935094509550965097509850995100510151025103510451055106510751085109511051115112511351145115511651175118511951205121512251235124512551265127512851295130513151325133513451355136513751385139514051415142514351445145514651475148514951505151515251535154515551565157515851595160516151625163516451655166516751685169517051715172517351745175517651775178517951805181518251835184518551865187518851895190519151925193519451955196519751985199520052015202520352045205520652075208520952105211521252135214521552165217521852195220522152225223522452255226522752285229523052315232523352345235523652375238523952405241524252435244524552465247524852495250525152525253525452555256525752585259526052615262526352645265526652675268526952705271527252735274527552765277527852795280528152825283528452855286528752885289529052915292529352945295529652975298529953005301530253035304530553065307530853095310531153125313531453155316531753185319532053215322532353245325532653275328532953305331533253335334533553365337533853395340534153425343534453455346534753485349535053515352535353545355535653575358535953605361536253635364536553665367536853695370537153725373537453755376537753785379538053815382538353845385538653875388538953905391539253935394539553965397539853995400540154025403540454055406540754085409541054115412541354145415541654175418541954205421542254235424542554265427542854295430543154325433543454355436543754385439544054415442544354445445544654475448544954505451545254535454545554565457545854595460546154625463546454655466546754685469547054715472547354745475547654775478547954805481548254835484548554865487548854895490549154925493549454955496549754985499550055015502550355045505550655075508550955105511551255135514551555165517551855195520552155225523552455255526552755285529553055315532553355345535553655375538553955405541554255435544554555465547554855495550555155525553555455555556555755585559556055615562556355645565556655675568556955705571557255735574557555765577557855795580558155825583558455855586558755885589559055915592559355945595559655975598559956005601560256035604560556065607560856095610561156125613561456155616561756185619562056215622562356245625562656275628562956305631563256335634563556365637563856395640564156425643564456455646564756485649565056515652565356545655565656575658565956605661566256635664566556665667566856695670567156725673567456755676567756785679568056815682568356845685568656875688568956905691569256935694569556965697569856995700570157025703570457055706570757085709571057115712571357145715571657175718571957205721572257235724572557265727572857295730573157325733573457355736573757385739574057415742574357445745574657475748574957505751575257535754575557565757575857595760576157625763576457655766576757685769577057715772577357745775577657775778577957805781578257835784578557865787578857895790579157925793579457955796579757985799580058015802580358045805580658075808580958105811581258135814581558165817581858195820582158225823582458255826582758285829583058315832583358345835583658375838583958405841584258435844584558465847584858495850585158525853585458555856585758585859586058615862586358645865586658675868586958705871587258735874587558765877587858795880588158825883588458855886588758885889589058915892589358945895589658975898589959005901590259035904590559065907590859095910591159125913591459155916591759185919592059215922592359245925592659275928592959305931593259335934593559365937593859395940594159425943594459455946594759485949595059515952595359545955595659575958595959605961596259635964596559665967596859695970597159725973597459755976597759785979598059815982598359845985598659875988598959905991599259935994599559965997599859996000600160026003600460056006600760086009601060116012601360146015601660176018601960206021602260236024602560266027602860296030603160326033603460356036603760386039604060416042604360446045604660476048604960506051605260536054605560566057605860596060606160626063606460656066606760686069607060716072607360746075607660776078607960806081608260836084608560866087608860896090609160926093609460956096609760986099610061016102610361046105610661076108610961106111611261136114611561166117611861196120612161226123612461256126612761286129613061316132613361346135613661376138613961406141614261436144614561466147614861496150615161526153615461556156615761586159616061616162616361646165616661676168616961706171617261736174617561766177617861796180618161826183618461856186618761886189619061916192619361946195619661976198619962006201620262036204620562066207620862096210621162126213621462156216621762186219622062216222622362246225622662276228622962306231623262336234623562366237623862396240624162426243624462456246624762486249625062516252625362546255625662576258625962606261626262636264626562666267626862696270627162726273627462756276627762786279628062816282628362846285628662876288628962906291629262936294629562966297629862996300630163026303630463056306630763086309631063116312631363146315631663176318631963206321632263236324632563266327632863296330633163326333633463356336633763386339634063416342634363446345634663476348634963506351635263536354635563566357635863596360636163626363636463656366636763686369637063716372637363746375637663776378637963806381638263836384638563866387638863896390639163926393639463956396639763986399640064016402640364046405640664076408640964106411641264136414641564166417641864196420642164226423642464256426642764286429643064316432643364346435643664376438643964406441644264436444644564466447644864496450645164526453645464556456645764586459646064616462646364646465646664676468646964706471647264736474647564766477647864796480648164826483648464856486648764886489649064916492649364946495649664976498649965006501650265036504650565066507650865096510651165126513651465156516651765186519652065216522652365246525652665276528652965306531653265336534653565366537653865396540654165426543654465456546654765486549655065516552655365546555655665576558655965606561656265636564656565666567656865696570657165726573657465756576657765786579658065816582658365846585658665876588658965906591659265936594659565966597659865996600660166026603660466056606660766086609661066116612661366146615661666176618661966206621662266236624662566266627662866296630663166326633663466356636663766386639664066416642664366446645664666476648664966506651665266536654665566566657665866596660666166626663666466656666666766686669667066716672667366746675667666776678667966806681668266836684668566866687668866896690669166926693669466956696669766986699670067016702670367046705670667076708670967106711671267136714671567166717671867196720672167226723672467256726672767286729673067316732673367346735673667376738673967406741674267436744674567466747674867496750675167526753675467556756675767586759676067616762676367646765676667676768676967706771677267736774677567766777677867796780678167826783678467856786678767886789679067916792679367946795679667976798679968006801680268036804680568066807680868096810681168126813681468156816681768186819682068216822682368246825682668276828682968306831683268336834683568366837683868396840684168426843684468456846684768486849685068516852685368546855685668576858685968606861686268636864686568666867686868696870687168726873687468756876687768786879688068816882688368846885688668876888688968906891689268936894689568966897689868996900690169026903690469056906690769086909691069116912691369146915691669176918691969206921692269236924692569266927692869296930693169326933693469356936693769386939694069416942694369446945694669476948694969506951695269536954695569566957695869596960696169626963696469656966696769686969697069716972697369746975697669776978697969806981698269836984698569866987698869896990699169926993699469956996699769986999700070017002700370047005700670077008700970107011701270137014701570167017701870197020702170227023702470257026702770287029703070317032703370347035703670377038703970407041704270437044704570467047704870497050705170527053705470557056705770587059706070617062706370647065706670677068706970707071707270737074707570767077707870797080708170827083708470857086708770887089709070917092709370947095709670977098709971007101710271037104710571067107710871097110711171127113711471157116711771187119712071217122712371247125712671277128712971307131713271337134713571367137713871397140714171427143714471457146714771487149715071517152715371547155715671577158715971607161716271637164716571667167716871697170717171727173717471757176717771787179718071817182718371847185718671877188718971907191719271937194719571967197719871997200720172027203720472057206720772087209721072117212721372147215721672177218721972207221722272237224722572267227722872297230723172327233723472357236723772387239724072417242724372447245724672477248724972507251725272537254725572567257725872597260726172627263726472657266726772687269727072717272727372747275727672777278727972807281728272837284728572867287728872897290729172927293729472957296729772987299730073017302730373047305730673077308730973107311731273137314731573167317731873197320732173227323732473257326732773287329733073317332733373347335733673377338733973407341734273437344734573467347734873497350735173527353735473557356735773587359736073617362736373647365736673677368736973707371737273737374737573767377737873797380738173827383738473857386738773887389739073917392739373947395739673977398739974007401740274037404740574067407740874097410741174127413741474157416741774187419742074217422742374247425742674277428742974307431743274337434743574367437743874397440744174427443744474457446744774487449745074517452745374547455745674577458745974607461746274637464746574667467746874697470747174727473747474757476747774787479748074817482748374847485748674877488748974907491749274937494749574967497749874997500750175027503750475057506750775087509751075117512751375147515751675177518751975207521752275237524752575267527752875297530753175327533753475357536753775387539754075417542754375447545754675477548754975507551755275537554755575567557755875597560756175627563756475657566756775687569757075717572757375747575757675777578757975807581758275837584758575867587758875897590759175927593759475957596759775987599760076017602760376047605760676077608760976107611761276137614761576167617761876197620762176227623762476257626762776287629763076317632763376347635763676377638763976407641764276437644764576467647764876497650765176527653765476557656765776587659766076617662766376647665766676677668766976707671767276737674767576767677 |
- == CMD_DESCRIPTION_ACL ==
- Establece permisos para un usuario, en un objeto dado.
- == CMD_USAGE_ACL ==
- Sintaxis:
- cm acl --user=usr_name | --group=group_name <action=<+|-permission>+>+ spec_objeto
- --user Nombre de usuario.
- --group Nombre de grupo.
- action Acción a aplicar: permitir, denegar o sobrescribir.
- -allowed para habilitar permisos
- -denied para denegar
- -overrideallowed
- -overridedenied
- permission Permiso a aplicar.
- Usa comas para separar permisos.
- (Usa 'cm showpermissions' para mostrar todos los
- permisos disponibles.)
- spec_objeto Especificación del objeto sobre el que se van a fijar
- los permisos.
- Objetos válidos para este comando son:
- repserver, repositorio, rama, changeset, etiqueta, item
- y atributo.
- (Usa 'cm help objectspec' para obtener más información
- sobre especificaciones.)
- La especificación puede ser también una ruta segura.
- Consulta las Notas para obtener más información sobre
- las rutas seguras.
- Uso especial para rutas seguras:
- cm acl [regular options] [--delete] [--branches=comma separated list] spec
- (Opcionalmente, cada rama especificada en --branches se puede preceder con
- los signos + o - para especificar si una rama se añadirá o se eliminará de
- la lista cuando se edite.)
- == CMD_HELP_ACL ==
- La configuración de permisos requiere comprender cómo se gestiona la seguridad
- en Plastic SCM. Lee la Guía de Seguridad para aprender cómo funcionan estos
- permisos de seguridad:
- https://www.plasticscm.com/documentation/security/plastic-scm-version-control-security-guide.shtml
- Notas:
- Este comando fija permisos de usuario o grupo a los objetos, repositorios,
- ramas, etiquetas y/o rutas de servidor especificados.
- Object specs:
- Usa 'cm help objectspec' para aprender cómo especificar objetos.
- El comando acl usa un tipo especial de especificación: rutas seguras.
- - Especificación de rutas seguras (secured paths):
- path:server_path[#tag]
- Ejemplos: path:/src/foo.c
- path:/doc/pdf
- path:/doc/pdf#documents
- Acciones de permisos:
- Usa -allowed y -denied para especificar qué permisos aplicar.
- Usa los argumentos -overrideallowed y -overridedenied para especificar
- qué permisos se sobrescriben.
- Cada acción requiere una lista de permisos separados por comas.
- Nombres de permisos:
- Cada nombre de permiso debe ir precedido del símbolo + o -.
- El símbolo + aplica el permiso y el símbolo - lo elimina.
- Para ver los permisos de un objeto, usa el comando 'cm showacl'.
- Permisos sobrescritos:
- Sobrescribir un permiso usando --overrideallowed y --overridedenied te
- permite evitar la herencia de permisos.
- Esto es útil para evitar los permisos aplicados a nivel de repositorio o
- de servidor.
- Por ejemplo:
- cm acl --user=vio -allowed=+ci -overrideallowed=+ci br:qa@test
- (Permite a la usuaria 'vio' hacer checkin en la rama 'qa' del
- repositorio 'test' incluso si ella tiene los permisos denegados a
- nivel de repositorio.)
- Permisos de rutas de servidor (rutas seguras):
- - Es posible especificar permisos para una ruta de servidor dada.
- - Estos permisos se comprueban durante la operación de check-in.
- - Estos permisos también pueden ser comprobados durante la operación de
- update y usados para prevenir ciertos directorios y ficheros sean
- descargados al espacio de trabajo.
- - Por cada ítem que se proteja (checkin), el servidor intenta concordar
- la ruta del ítem con una ruta segura. Si se encuentra, entonces la
- operación de checkin comprueba si el ítem tiene permisos para ser
- protegido (checked in).
- Los permisos que se pueden definir para una ruta segura son:
- ci, change, add, move, rm, read
- Si la comprobación de permisos no es satisfactoria para ninguno de los
- ítems involucrados, entonces la operación de checkin se cancelará.
- Para aplicar permisos de rutas seguras a un grupo de ramas, usa la
- opción --branches.
- Por ejemplo:
- cm acl --user=jo -denied=+ci path:/src#rule0 --branches=main,main/rel0
- Para editar el ACL asociado a una ruta segura, usa el símbolo "#".
- Por ejemplo:
- cm acl --user=jo -denied=+rm path:/src#rule0
- (Sin "#", la lista de ramas tendría que ser especificada de nuevo).
- Es posible también editar la lista de ramas de una ruta segura.
- Por ejemplo:
- cm acl path:/src#rule0 --branches=-main,+main/rel1
- (Elimina main de la lista y añade main/rel1.)
- Para eliminar una ruta segura, usa el argumento --delete.
- Por ejemplo:
- cm acl --user=jo --delete path:/src#rule0
- Herencia:
- Herencia es una opción que proviene de los inicios de Plastic SCM 3.0.
- Es una opción avanzada, pero también está obsoleta.
- Permite a un objeto heredar los permisos de otro objeto, sobrescribiendo
- las relaciones de herencia por defecto.
- Usa la opción -cut para cortar la cadena de herencia.
- Usa la opción -cutncpy para cortar y copiar los permisos heredados.
- (Estas características vienen inspiradas por los permisos de sistema de
- Windows donde puedes cortar herencia pero mantener los permisos
- actuales.)
- La opción -inherit permiter heredar de una especificación de objeto.
- Por ejemplo: '-inherit=object_spec'
- Ejemplos:
- cm acl --user=danipen -denied=+ci rep:core
- (Deniega el permiso de checkin al usuario danipen en el repositorio 'core'.)
- cm acl --group=developers -allowed=+view,-read -denied=+chgperm br:main
- (Otorga el permiso 'view', elimina el permiso 'read' y deniega el permiso
- 'chgperm' al grupo 'developers' en la rama 'main'.)
- Ejemplos con rutas de servidor:
- cm acl --group=devs -denied=+ci path:/server#rel --branches=main,main/2.0
- (Deniega el permiso de checkin al grupo 'devs' para cualquier ruta que
- concuerde con '/server' en las ramas 'main' y 'main/2.0'. La etiqueta #rel
- se crea para poder referirse a ella más adelante.)
- cm acl path:/server#rel --branches=-/main,+/main/Rel2.1
- (Actualiza la ruta segura '/server', cuya etiqueta es 'rel', borrando la
- rama 'main' y añadiendo la rama 'main/Rel2.1' al grupo de ramas al que la
- ruta segura aplica. Teniendo en cuenta el ejemplo anterior, ahora la lista
- de ramas contendrá main/Rel2.1 y main/2.0)
- cm acl --user=vsanchezm -allowed=-read -overrideallowed=+read path:/doc
- (Eliminar el permiso de lectura a vsanchezm, sobrescribiéndolo, en la ruta
- /doc.)
- == CMD_DESCRIPTION_ACTIVATEUSER ==
- Activa un usuario de licencia desactivado previamente.
- == CMD_USAGE_ACTIVATEUSER ==
- Sintaxis:
- cm activateuser nombre1 nombre2 ... [opciones]
- nombre: Nombre del usuario que se desea activar.
- Opciones:
- --server: activa el usuario en el servidor especificado.
- Usa 'cm help objectspec' para saber más sobre especificaciones.
- == CMD_HELP_ACTIVATEUSER ==
- Notas:
- Este comando activa un usuario para que pueda utilizar Plastic SCM.
- Para activar un usuario, éste ha de estar desactivado previamente.
- Para activar un usuario por primera vez, basta con utilizar Plastic SCM
- con las credenciales del usuario a activar, siempre que no se sobrepase
- el número máximo de usuarios autorizados.
- Ejemplos:
- cm activate user juan
- == CMD_DESCRIPTION_ADD ==
- Añade un ítem al repositorio.
- == CMD_USAGE_ADD ==
- Sintaxis:
- cm add [options]* <ruta>+
- ruta Rutas de los ítems a añadir, separados por espacios.
- Usa comillas (") para especificar rutas que contengan
- espacios.
- Usa * para añadir todo el contenido del directorio
- actual.
- Opciones:
- -R|-r|--recursive Añade los ítems recursivamente.
- --silent No muestra ninguna salida.
- --ignorefailed Si un ítem no se puede añadir, la operación de add
- continuará sin él. Importante: si un directorio no se
- puede añadir, su contenido tampoco se añadirá.
- --skipcontentcheck Cuando la extensión no es suficiente para determinar si
- el fichero es de texto o binario, se asumirá que es
- binario en lugar de usar el contenido para detectar el
- tipo. Este funcionamiento se asume para aumentar el
- rendimiento en grandes operaciones de checkin.
- == CMD_HELP_ADD ==
- Notas:
- Requisitos para añadir items:
- - El directorio padre del ítem a añadir debe existir en el repositorio.
- Ejemplos:
- cm add file1.txt file2.txt
- (Añade los ítems file1.txt y file2.txt.)
- cm add c:\workspace\file.txt
- (Añade el ítem file.txt en la ruta c:\workspace.)
- cm add -R c:\workspace\src
- (Añade recursivamente el contenido de la ruta src.)
- cm add -R *
- (Añade recursivamente todo el contenido del directorio actual.)
- == CMD_USAGE_ADDIGNOREPATTERN ==
- Uso:
- cm addignorepattern pattern1 pattern2 ... patternN [--workspace=wkpath | --allworkspaces][--remove]
- == CMD_DESCRIPTION_ADMIN ==
- Ejecuta comandos de administración en el servidor.
- == CMD_USAGE_ADMIN ==
- Sintaxis:
- cm admin comando [opciones]
- Comandos:
- readonly
- Para obtener más información de cada uno de los comandos ejecute:
- cm changeset command --usage
- cm changeset command --help
- == CMD_HELP_ADMIN ==
- Notas:
- Sólo el administrador del servidor puede ejecutar el comando admin.
- Ejemplos:
- cm admin readonly enter
- cm admin readonly status
- == CMD_DESCRIPTION_ADMIN_READONLY ==
- Permite habilitar/deshabilitar el modo solo-lectura en el servidor.
- == CMD_USAGE_ADMIN_READONLY ==
- Sintaxis:
- cm admin readonly acción [servidor]
- Acciones:
- enter: habilita el modo de solo-lectura en el servidor.
- leave: deshabilita el modo de solo-lectura en el servidor.
- status: muestra el estado del modo de solo-lectura del servidor.
- Opciones:
- servidor: El comando se ejecuta en el servidor especificado
- (servidor:puerto; usa 'cm help objectspec' para más información.)
- Si no se especifica un servidor, el comando se ejecuta
- en servidor del espacio de trabajo actual.
- Si la ruta actual no está en un espacio de trabajo,
- se ejecuta en el servidor por defecto configurado en
- client.conf.
- == CMD_HELP_ADMIN_READONLY ==
- Notas:
- Sólo el administrador del servidor puede ejecutar el comando readonly.
- Ejemplos:
- cm admin readonly enter diana:8086
- cm admin readonly leave
- == CMD_DESCRIPTION_ANNOTATE ==
- Lista el contenido de un fichero o directorio, indicando para cada línea el propietario y la revisión en la cual fue introducida.
- == CMD_USAGE_ANNOTATE ==
- Sintaxis:
- cm annotate spec [opciones]
- spec Especificación del fichero que se va a anotar.
- Usa 'cm help objectspec' para obtener más información
- sobre especificaciones.
- Opciones:
- --format=cadena: Cadena con el formato de salida.
- --dateformat=cadena: Cadena con el formato en que se escribirán las fechas.
- --ignore=método_de_comparación: Cambia la forma de calcular las diferencias.
- --repository=repspec: Especificación del repositorio para calcular las
- anotaciones. Por defecto, este comando utiliza el
- repositorio del workspace cuya revisión está cargada.
- Usa 'cm help objectspec' para más información sobre las
- especificaciones de repositorio.
- método_de_comparación:
- none (por defecto)
- eol (ignora diferencias en retornos de carro)
- whitespaces (ignora diferencias en espacios en blanco)
- eol&whitespaces (las dos anteriores)
- == CMD_HELP_ANNOTATE ==
- Notas:
- Los items de tipo binario no están soportados por este commando.
- Este comando admite una cadena de formato para mostrar la salida.
- Los parametros de salida de este comando son los siguientes:
- {owner}: El propietario de la línea.
- {rev}: La especificación de la revision donde apareció la línea.
- {content}: El contenido de la línea.
- {date}: La fecha de la revisión donde fue introducida la línea.
- {comment}: El comentario de la revisión donde apareció la línea.
- {changeset}: El changeset de la revisión donde apareció la línea.
- {line}: El número de línea dentro del fichero.
- {branch}: La rama de la revisión donde apareció la línea.
- {ismergerev}: La revisión donde apareció la línea fue creada en una
- operación de merge.
- Puede usar la opción --dateformat para especificar el formato en el que se
- escribirán las fechas en pantalla.
- El commando annotate puede recuperar los datos de un repositorio remoto
- usando la opción --repository. Esto es útil cuando se trabaja con
- repositorios replicados.
- Ejemplos:
- cm ann c:\workspace\src
- cm ann c:\workspace\file.txt
- cm ann c:\workspace\file.txt --format"{owner} {date} {content}"
- cm ann c:\workspace\file.txt --format"{owner, -7} {content} [{date}]" \
- --dateformat=yyyyMMdd
- cm ann c:\workspace\file.txt --repository=centralRep@myserver:8084
- cm blame serverpath:/src/client/checkin/Checkin.cs#cs:73666
- (Anota el fichero empezando en el changeset 73666 y usando un server path.)
- == CMD_DESCRIPTION_APPLY_LOCAL ==
- Aplica los cambios locales (movidos, borrados y modificados localmente).
- == CMD_USAGE_APPLY_LOCAL ==
- Sintaxis:
- cm applylocal [opciones] [rutas]
- rutas: rutas de los cambios locales a aplicar. Por defecto son los de todo
- el workspace.
- Opciones:
- --dependencies: Incluir las dependencias de los cambios locales entre los
- ítems a proteger.
- == CMD_HELP_APPLY_LOCAL ==
- Notas:
- - Si no se especifican [opciones] ni [rutas], la operación involucrará a
- todos los cambios locales en el espacio de trabajo.
- - La operación se aplica siempre recursivamente desde la ruta indicada.
- Ejemplos:
- cm applylocal fichero1.txt fichero2.txt
- cm applylocal . (Aplica los cambios locales para el directorio actual y
- todo su contenido)
- cm applylocal (Aplica los cambios locales para todo el workspace)
- == CMD_DESCRIPTION_ARCHIVE ==
- Almacena o restaura datos en almacenamiento externo de un conjunto dado de revisiones especificadas.
- == CMD_USAGE_ARCHIVE ==
- Sintaxis:
- cm archive [revspec]+ [-c=comentario] [-f=path y nombre de fichero base]
- cm archive [revspec]+ --restore
- [revspec]+ una o más especificaciones de revisión. Se pueden leer desde la
- entrada estándar (STDIN) con el modificador de comando "-". Usa
- 'cm help objectspec' para más información sobre especificaciones.
- [-c | --comment] especifica el comentario que se agregará a los datos
- archivados que se generen.
- [-f | --file] especifica el nombre y (opcionalmente) el path de los ficheros
- que se crearán para almacenar los datos por archivar.
- [--restore] restaura los datos previamente archivados utilizando los
- ficheros de almacenamiento generados.
- == CMD_HELP_ARCHIVE ==
- Notas:
- El comando permite extraer datos desde la base de datos de un repositorio
- y volcarlos en almacenamiento externo, ahorrando espacio en la base de
- datos.
- Usa 'cm help objectspec' para saber más sobre cómo especificar una revisión.
- El comando también puede usarse para restaurar las revisiones 'archivadas',
- volviéndolas a introducir en la base de datos (opción --restore).
- El usuario que ejecute este comando debe ser administrador del servidor
- de Plastic SCM (propietario del servidor de repositorios) para que se le
- permita completar la operación.
- Cada segmento de datos de las revisiones especificadas se almacenará en
- un fichero diferente, prefijado por el contenido del argumento --file.
- Este argumento puede contener tanto un 'path' completo con un prefijo de
- nombre de archivo como únicamente dicho prefijo.
- Una vez archivados los datos de las revisiones, se podrá acceder a ellos
- de dos maneras:
- 1) Desde el cliente: el cliente de Plastic SCM detectará que los datos
- fueron archivados y pedirá al usuario que indique la ubicación en la que
- se encuentran. El usuario puede configurar las ubicaciones de los datos
- externos creando un fichero 'externaldata.conf' (en las ubicaciones
- estándar para ficheros de configuración, siguiendo las mismas reglas que se
- aplican para el fichero client.conf) que contendrá los paths en los que
- se encuentren los datos archivados.
- 2) Desde el servidor: de esta forma los usuarios estarán totalmente
- aislados del hecho de que los datos han sido archivados, ya que las
- peticiones se resolverán de forma transparente por el servidor. Para
- ello, el administrador creará un fichero 'externaldata.conf' en el
- directorio del servidor con los paths de los datos externos.
- Para restaurar (unarchive) los datos de una revisión (o conjunto de
- revisiones) los datos archivados deberán estar accesibles desde el cliente.
- Por tanto, no es posible restaurar datos que estén siendo resueltos por el
- servidor -método 2)- porque el cliente no será capaz de identificarlos como
- archivados, al resolverse de forma transparente por el servidor. Si se están
- resolviendo los datos externos en servidor, para poder restaurar será
- necesario que el administrador elimine los volúmenes por restaurar de las
- ubicaciones accesibles por el servidor o que configure 'externaldata.conf'
- apropiadamente.
- Si existe una variable de entorno llamada PLASTICEDITOR apuntando al
- ejecutable de un editor de texto, y no se especifica un comentario al
- archivar, el editor se abrirá automáticamente para que especifique
- un comentario.
- Especificaciones de revisión:
- rev:path[#(brSpec|csetSpec|lbSpec)], ej: rev:fichero.cs#cs:5
- rev:fichero.cs#br:/main/task1
- Ejemplos:
- Archivar bigfile.zip:
- $ cm archive bigfile.zip#br:/main#13
- Archivar todos los ficheros mayores de 25Mb
- $ cm find "revs where size > 26214400" --format="{item}#{branch}" --nototal | cm archive --comment="volume00" -f="volume00" -
- Restaurar todos los ficheros archivados mayores de 25 Mb
- $ cm find "revs where size > 26214400 and archived='true'" --format="{item}#{branch}" --nototal | cm archive --restore
- == CMD_DESCRIPTION_ATTRIBUTE ==
- Use este comando para administrar atributos.
- == CMD_USAGE_ATTRIBUTE ==
- Sintaxis:
- cm attribute | att command [options]
- Comandos:
- create | mk
- delete | rm
- set
- unset
- rename
- edit
- Para obtener más información sobre cada comando:
- cm attribute comando --usage
- cm attribute comando --help
- == CMD_HELP_ATTRIBUTE ==
- Ejemplos:
- cm attribute create estado
- cm attribute set att:estado br:/main/SCM105 abierto
- cm attribute unset att:estado br:/main/SCM105
- cm attribute delete att:estado
- cm attribute rename att:estado estadoBuild
- cm attribute edit att:estado "Estado de la tarea en CI"
- == CMD_DESCRIPTION_CHANGELIST ==
- Permite organizar los cambios pendientes del espacio de trabajo en diferentes changelists.
- == CMD_USAGE_CHANGELIST ==
- Sintaxis:
- a) Manejo de los objetos 'changelist':
- cm changelist [list]
- Muestra los changelists en el espacio de trabajo actual.
- cm changelist add changelistName [descpription_text] [--persistent | --notpersistent]
- Crea un nuevo changelist con nombre = "changelistName":
- "descpription_text": descripción para el nuevo changelist.
- "--persistent | --notpersistent": Especifica si el changelist ha de eliminarse o no si el
- contenido del changelist se queda vacío (los cambios que contiene se protegen o se
- deshacen).
- (valor por defecto: "--notpersistent").
- cm changelist rm changelistName
- Borra un changelist con nombre = "changelistName".
- cm changelist edit changelistName [editParameterAction newValue] [--persistent | --notpersistent]
- Modifica un changelist con nombre = "changelistName:
- "editParameterAction": Posibles valores: "rename" | "description"
- "--persistent | --notpersistent": Especifica si el changelist ha de eliminarse o no si el
- contenido del changelist se queda vacío (los cambios que contiene se deshacen o se les
- ejecuta una operación de check-in.
- (valor por defecto: "--notpersistent").
- b) Manejo del contenido de un 'changelist' concreto:
- cm changelist changelistName (add | rm) ruta(s)
- Añade / elimina del changelist con nombre = "changelistName" el cambio que
- coincide con la(s) ruta(s) especificada(s).
- Opciones:
- clist_name El nombre un changelist.
- clist_desc La descripción un changelist.
- action_name Utiliza '^rename' o '^description' para modificar un
- changelist.
- action_value Realiza la operación de renombrado o cambio de la descripción
- cuando editas un changelist.
- --persistent El changelist permacenerá en el workspace incluso si se ha ejecutado
- una operación de check-in o de revert.
- --notpersistent (Default) El changelist no permanecerá en el workspace.
- --symlink Realizar la operacion de checkin sobre el fichero de link y no
- al que apunta..
- == CMD_HELP_CHANGELIST ==
- Notas:
- El comando 'changelist' permite administrar los changelists existentes en un
- espacio de trabajo, así como los cambios que contiene cada uno de ellos.
- Ejemplos del manejo de los changelists existentes en el espacio de trabajo:
- $ cm changelist
- (lista los changelists en el espacio de trabajo actual).
- $ cm changelist add config_changes "dotConf files" --persistent
- (crea un changelist con nombre "config_changes", descripción "dotConf files",
- que además quedará persistente en el espacio de trabajo una vez que se
- haga check-in o revert de dicho changelist).
- $ cm changelist edit config_changes rename "config_files" --notpersistent
- (edita el changelist con nombre "config_changes" y lo renombra a
- "config_files". Además convierte el changelist en no persistente).
-
- $ cm changelist edit config_changes --notpersistent
- (edita el changelist con nombre "config_changes" y lo convierte en no persistente).
- $ cm changelist rm "config_files"
- (elimina el changelist "congig_files" del espacio de trabajo actual).
- Ejemplos del manejo del contenido de un changelist:
- (Nota, los ficheros que se manejan en los siguientes comandos han de
- encontrarse en estado "Added" or "Checked-out".
- $ cm changelist "config_files" add "foo.conf"
- (añade el fichero "foo.conf" al changelist "config_files")
- $ cm changelist "config_files" rm "foo.conf"
- (elimina el fichero "foo.conf" del changelist "config_files" y
- lo mueve al changelist por defecto del sistema).
- == CMD_DESCRIPTION_CHANGESET ==
- Ejecuta operaciones avanzadas sobre changesets.
- == CMD_USAGE_CHANGESET ==
- Sintaxis:
- cm changeset comando [opciones]
- Comandos:
- move | mv
- delete | rm
- editcomment | edit
- Para obtener más información de cada uno de los comandos ejecute:
- cm changeset command --usage
- cm changeset command --help
- == CMD_HELP_CHANGESET ==
- Ejemplos:
- cm changeset move cs:15@myrepo br:/main/scm005@myrepo
- cm changeset delete cs:2b55f8aa-0b29-410f-b99c-60e573a309ca@devData
- == CMD_DESCRIPTION_CHANGESET_EDIT_COMMENT ==
- Modifica el comentario de un changeset.
- == CMD_USAGE_CHANGESET_EDIT_COMMENT ==
- Sintaxis:
- cm changeset editcomment | edit <cset_spec> <nuevo_comentario>
- Opciones:
- spec_cset El changeset objetivo para editar su comentario.
- Usa 'cm help objectspec' para más información.
- nuevo_comentario El nuevo comentario que será asignado al changeset
- seleccionado.
- == CMD_HELP_CHANGESET_EDIT_COMMENT ==
- Notas:
- - La especificación del changeset objetivo debe ser válida.
- Ejemplos:
- cm changeset editcomment cs:15@myrepo "Olvidé añadir detalles importantes."
- cm changeset edit cs:cb11ecdb-1aa9-4f11-8698-dcab14e5885a \
- "Este texto de comentario sustituirá al anterior."
- == CMD_DESCRIPTION_CHANGESET_MOVE ==
- Mueve un changeset y todos sus descendientes en la misma rama a otra rama distinta.
- == CMD_USAGE_CHANGESET_MOVE ==
- Sintaxis:
- cm changeset move | mv <spec_cset> <spec_branch>
- Opciones:
- spec_cset El primer changeset que debe moverse a una rama
- diferente. Todos los changeset descendientes en la
- misma rama se moverán también.
- spec_branch La rama destino a la que mover los changesets
- seleccionados. Debe estar vacía o no existir. En caso
- de no existir, el comando la creará.
- Usa 'cm help objectspec' para obtener más información sobre cómo indicar
- especificaciones de changeset y rama.
- == CMD_HELP_CHANGESET_MOVE ==
- Notas:
- - La especificación del changeset objetivo debe ser válida.
- - La rama de destino debe estar vacía o no existir.
- - Si la rama de destino no existe, el comando la creará.
- - Los enlaces de merge no se verán afectados dado que las ramas no están
- involucradas en ellos.
- Ejemplos:
- cm changeset move cs:15@myrepo br:/main/scm005@myrepo
- cm changeset move cs:cb11ecdb-1aa9-4f11-8698-dcab14e5885a \
- br:/hotfix/TL-352
- == CMD_DESCRIPTION_CHANGESET_DELETE ==
- Elimina un changeset del repositorio.
- == CMD_USAGE_CHANGESET_DELETE ==
- Sintaxis:
- cm changeset delete | rm <spec_cset>
- Opciones:
- spec_cset El changeset seleccionado para eliminar. Debe cumplir
- una serie de condiciones; ver ayuda completa para
- más información. Usa 'cm help objectspec' para aprender
- cómo construir las especificaciones.
- == CMD_HELP_CHANGESET_DELETE ==
- Notas:
- - El changeset objetivo debe ser el último en su rama.
- - No debe haber ningún otro changeset que tenga al objetivo como padre.
- - El changeset objetivo no debe ser origen de merge ni estar envuelto en
- el intervalo origen de un merge de intervalo.
- - No debe haber etiquetas aplicadas al changeset objetivo.
- - El changeset objetivo no puede ser el changeset raíz (cs:0)
- Ejemplos:
- cm changeset rm cs:4525@myrepo@myserver
- cm changeset delete cs:cb11ecdb-1aa9-4f11-8698-dcab14e5885a
- == CMD_DESCRIPTION_CHANGEUSERPASSWORD ==
- Cambia la contraseña del usuario actual cuando la configuración de seguridad es usuario/contraseña.
- == CMD_USAGE_CHANGEUSERPASSWORD ==
- Sintaxis:
- cm changeuserpassword
- == CMD_HELP_CHANGEUSERPASSWORD ==
- Notas:
- Este comando solamente está disponible cuando el sistema de seguridad y
- usuarios está configurado en modo de funcionamiento de usuario/contraseña.
- Ejemplo:
- cm changeuserpassword
- == CMD_DESCRIPTION_CHECKCONNECTION ==
- Comprueba la conexión del cliente de Plastic SCM contra el servidor.
- == CMD_USAGE_CHECKCONNECTION ==
- Sintaxis:
- cm checkconnection
- == CMD_HELP_CHECKCONNECTION ==
- Notas:
- Este comando retorna un mensaje indicando si hay una conexión valida contra
- el servidor de Plastic SCM o no.
- El comando comprueba si el usuario configurado es válido.
- También comprueba si la versión del cliente es compatible con la del
- servidor.
- == CMD_DESCRIPTION_CHECKDB ==
- Comprueba la integridad de las bases de datos.
- == CMD_USAGE_CHECKDB ==
- Sintaxis:
- cm checkdatabase [spec]
- spec: Especificación del servidor o de un repositorio.
- Usa 'cm help objectspec' para aprender cómo indicar especificaciones
- de servidor y repositorio.
- == CMD_HELP_CHECKDB ==
- Notas:
- - Si no se especifica [spec], el comando utilizará el valor del servidor
- del fichero client.conf.
- Ejemplos:
- cm checkdatabase repserver:localhost:8084
- cm checkdatabase rep:default@localhost:8084
- == CMD_DESCRIPTION_CHECKIN ==
- Crea una nueva revisión de un ítem.
- == CMD_USAGE_CHECKIN ==
- Se pueden proteger tanto ficheros como directorios.
- Sintaxis:
- cm checkin [opciones] [rutas]
- rutas: rutas de los items a proteger.
- Opciones:
- --nchk: (No check) No chequea el contenido del fichero al proteger.
- Ver notas para mas información.
- --symlink: Realizar la operacion de checkin sobre el fichero de link y no
- al que apunta.
- -c: Añade un comentario al changeset creado en la operación de protección.
- --commentsfile=comment.txt: Carga el comentario del fichero especificado.
- --all (-a): Los ítems cambiados, movidos y borrados localmente, en las
- rutas dadas, también serán protegidos.
- --dependencies: Incluir las dependencias de los cambios locales entre los
- ítems a proteger.
- --private: Los ítems privados también serán protegidos.
- == CMD_HELP_CHECKIN ==
- Notas:
- - Si no se especifican [opciones] ni [rutas], la operación involucrará a
- todos los cambios pendientes en el espacio de trabajo.
- - La operación de protección se aplica siempre recursivamente desde la
- ruta indicada.
- - Requisitos para proteger un ítem:
- * El ítem debe estar controlado por Plastic SCM.
- * El ítem ha de estar desprotegido.
- * La revisión ha de tener cambios. Es decir, no se pueden proteger los
- mismos datos. Para eliminar la desprotección descartando los cambios,
- se utiliza el comando uncheckout.
- * Con la opción --nchk, se fuerza la protección del ítem, sin comprobar
- los datos.
- Ejemplos:
- cm checkin fichero1.txt fichero2.txt
- cm checkin . (Protege el directorio actual)
- (Proteger recursivamente el contenido de 'src')
- cm checkin link --symlink
- (Proteger el fichero de link y no al que apunta, opción disponible en UNIX)
- Comentarios:
- Para especificar comentarios use el switch "-c" o "-m" del siguiente modo:
- cm ci file1.txt -c="my comment"
- cm ci file1.txt -m "my comment"
- Proteger 'changelist'. Ejemplo:
- cm status --short --compact --changelist=pending_to_review | cm checkin -
- (El comando listará los paths en el changelist llamado 'pending_to_review'
- y dicha lista será redirigida a la entrada del comando 'checkin').
- Si existe una variable de entorno llamada PLASTICEDITOR apuntando al
- ejecutable de un editor de texto, y no se especifica un comentario al
- hacer checkin, el editor se abrirá automáticamente para que especifique
- un comentario.
- == CMD_DESCRIPTION_CHECKOUT ==
- Desprotege un ítem dado.
- == CMD_USAGE_CHECKOUT ==
- Sintaxis:
- cm co [Opciones] paths
- paths: Rutas de los elementos que se desean desproteger.
- Opciones:
- -R: Descender recursivamente dentro del ítem.
- --symlink: Efectúar la desprotección sobre el fichero de link y no al que
- apunta.
- --ignorefailed: Si un ítem no se puede bloquear (no se le puede hacer un
- checkout exclusivo), la operación de checkout continuará sin él.
- == CMD_HELP_CHECKOUT ==
- Notas:
- Cuando un ítem del workspace se desea modificar, se debe desproteger.
- La forma de desproteger un ítem es utilizando el comando co.
- Se pueden desproteger tanto ficheros como directorios.
- Requisitos: Para poder desproteger elementos:
- El ítem debe estar controlado por Plastic.
- El ítem debe estar protegido previamente.
- Ejemplos:
- cm co . (Desproteger el directorio actual)
- cm co c:\workspace\fichero.txt
- cm co fichero1.cs fichero2.cs
- cm co –R c:\workspace\src (desprotege recursivamente todo el contenido de ‘src’)
- cm co –R * (desprotege recursivamente todos los elementos del directorio actual)
- cm co link --symlink
- (desprotege el fichero de link y no el fichero al que apunta, disponible en UNIX)
- == CMD_DESCRIPTION_CHECKSELECTORSYNTAX ==
- Comprueba la sintaxis de un selector.
- == CMD_USAGE_CHECKSELECTORSYNTAX ==
- Uso:
- cm checkselectorsyntax [--file=file]
- Opciones:
- --file=file: El fichero del cual leer el selector; si no se especifica se
- supone la entrada estándar.
- == CMD_HELP_CHECKSELECTORSYNTAX ==
- Notas:
- Este comando lee el selector desde un fichero o desde la entrada estándar
- y comprueba si su sintaxis es válida. Si falla la comprobación se muestra
- en la salida estándar.
- == CMD_DESCRIPTION_CHGREVTYPE ==
- Cambia el tipo de todas las revisiones de un ítem.
- == CMD_USAGE_CHGREVTYPE ==
- Sintaxis:
- cm changerevisiontype | chgrevtype | crt rutas --type=tipo
- rutas: Rutas de los items para alterar el tipo de sus revisiones.
- tipo: Tipo al que se fijarán las revisiones.
- == CMD_HELP_CHGREVTYPE ==
- Notas:
- Este comando sólo puede aplicarse a ficheros, no a directorios.
- El tipo especificado, ha de ser alguno soportado por el sistema:
- bin
- txt
- ...
- Ejemplos:
- cm changerevisiontype c:\workspace\file.txt --type=txt
- (Cambia el tipo de revisión de 'file.txt' a 'txt'.)
- cm chgrevtype comp.zip "image file.jpg" --type=bin
- (Cambia el tipo de revisión de 'comp.zip' e "image file.jpg" a 'bin'.)
- cm crt *.* --type=txt
- (Cambia el tipo de revisión de todos los archivos a 'txt'.)
- == CMD_DESCRIPTION_TRIGGER_EDIT ==
- Cambia la información asociada a un trigger existente.
- == CMD_USAGE_TRIGGER_EDIT ==
- Sintaxis:
- cm trigger edit subtipo-tipo posición [opciones]
- subtipo-tipo: Tipo y subtipo de trigger.
- Teclee 'cm showtriggertypes' para ver una lista completa de los tipos de
- trigger disponibles. Algunos ejemplos son:
- before-mkbranch
- after-mkwokspace
- after-setselector
- posición: posición que ocupa el trigger que deseamos modificar.
- Opciones:
- --position=posición: nueva posición para el trigger especificado.
- --name=nombre: nuevo nombre para el trigger especificado.
- --script=ruta: nueva ruta de ejecución para el script del trigger
- especificado. Si esta ruta comienza por "webtrigger ", se
- considerará como web trigger. Consulte la ayuda del comando para obtener
- detalles adicionales.
- --filter=filtro: Comprueba sólo aquellos elementos que coincidan con el
- filtro de busqueda indicado.
- --server=servidor: modifica el trigger en el servidor especificado.
- Si no se especifica ninguno lo busca en el que se configuró en el cliente.
- Usa 'cm help objectspec' para más información.
- == CMD_HELP_TRIGGER_EDIT ==
- Notas:
- Web triggers: Para crear web triggers, escriba "webtrigger <target-uri>"
- como comando de trigger. En este caso, el trigger ejecutará una consulta
- POST contra el URI especificado, en la que el cuerpo de la petición
- contiene un diccionario JSON con las variables de entorno del trigger.
- También estará presente una clave INPUT apuntando a un vector de cadenas de
- texto para aquellos triggers que escriban en la entrada estándar de sus
- comandos asociados.
- Ejemplos:
- cm trigger edit after-setselector 6 --name="Gestiona backup2" --script="/nuevo/path/al/script"
- cm tr edit before-mklabel 7 --position=4 --server=myserver:8084
- cm tr edit after-add 2 --script="webtrigger http://myserver.org/api"
- == CMD_DESCRIPTION_CODEREVIEW ==
- Crea, edita o elimina revisiones de código.
- == CMD_USAGE_CODEREVIEW ==
- Sintaxis:
- cm codereview <spec> <título> [--status=nombre_estado]
- [--assignee=nombre_usuario] [--format=cad_formato]
- [--repository=rep_spec]
- spec Puede tratarse tanto de una especificación de
- changeset como de una especificación de rama.
- Determina el objetivo de la nueva revisión de código.
- título Una cadena de texto para utilizarla como título de la
- nueva revisión de código.
- cm codereview -e <id> [--status=nombre_estado]
- [--assignee=nombre_usuario] [--repository=rep_spec]
- cm codereview -d <id> [id...] [--repository=rep_spec]
- id Número identificador de la revisión de código. Puede
- utilizarse también su GUID.
- Opciones:
- -e Edita los parámetros de una revisión de código
- existente.
- -d Elimina una revisión de código existente.
- --status Modifica el estado de una revisión de código. Consulte
- las notas para más información.
- --assignee Modifica el usuario asignado a la revisión de código.
- --repository Indica el repositorio que se utilizará por defecto.
- --format Devuelve el mensaje de respuesta con el formato
- especificado. Consulte la ayuda para más información.
- == CMD_HELP_CODEREVIEW ==
- Notas:
- Este comando permite manipular revisiones de código: crear, editar
- y eliminar revisiones de código de changesets o ramas.
- Para crear una nueva revisión de código se requiere una especificación de
- changeset o rama, junto con un título. Además, puede indicarse tanto
- el usuario asignado (revisor de los cambios) como el estado inicial.
- Como resultado se devolverá un ID (o GUID, si así se solicitó).
- Para editar o eliminar una revisión de código existente se requiere el ID
- (o GUID) de la misma. No se mostrarán mensajes si no se detectan errores.
- El parámetro 'status' sólo puede tener como valor uno de los siguientes:
- 'Under review' (valor por defecto), 'Reviewed' o 'Rework required'.
- El parámetro 'repository' se encuentra disponible para actuar sobre las
- revisiones de código de un repositorio diferente al asociado al espacio
- de trabajo actual (o para situaciones en las que no exista espacio de
- trabajo).
- Personalización del formato de salida:
- Este comando acepta una cadena de formato para mostrar su salida.
- Los parámetros de salida del comando son los siguientes:
- {0} id
- {1} guid
- Por favor, tenga en cuenta que el parámetro --format sólo tiene efecto
- al crear una nueva revisión de código.
- Ejemplos:
- cm codereview cs:1856@myrepo@myserver:8084 "Mi nueva revisión" --assignee=dummy
- cm codereview br:/main/task001@myrepo@myserver:8084 "Mi nueva revisión" --status="Rework required" --assignee=newbie --format="{id} -> {guid}"
- cm codereview 1367 -e --assignee=new_assignee
- cm codereview -e 27658884-5dcc-49b7-b0ef-a5760ae740a3 --status=Reviewed
- cm codereview -d 1367 --repository=myremoterepo@myremoteserver:18084
- cm codereview 27658884-5dcc-49b7-b0ef-a5760ae740a3 -d
- == CMD_DESCRIPTION_CRYPT ==
- Encripta una contraseña.
- == CMD_USAGE_CRYPT ==
- Sintaxis:
- cm crypt mypassword
- mypassword Contraseña que se va a encriptar.
- == CMD_HELP_CRYPT ==
- Notas:
- Este comando encripta una contraseña cualquiera pasada como argumento.
- Está diseñado para encriptar las contraseñas de los ficheros de
- configuración y aumentar así su seguridad.
- Ejemplos:
- cm crypt dbconfpassword -> ENCRYPTED: encrypteddbconfpassword
- (Encripta la contraseña en el fichero de la base de datos de configuración:
- db.conf)
- == CMD_DESCRIPTION_DEACTIVATEUSER ==
- Desactiva un usuario activado previamente.
- == CMD_USAGE_DEACTIVATEUSER ==
- Sintaxis:
- cm deactivateuser nombre1 nombre2 ... [opciones]
- nombre: Nombre del usuario que se desea desactivar.
- Opciones:
- --nosolveuser: Intenta desactivar el usuario especificado sin resolver
- el nombre dado en el sistema de autenticación subyacente.
- --server: desactiva el usuario en el servidor especificado.
- == CMD_HELP_DEACTIVATEUSER ==
- Notas:
- Este comando deshabilita a un usuario para el uso de Plastic SCM.
- Por favor, consulte la guía de usuario, o el comando "activateuser" para
- obtener más información acerca de la habilitación de usuarios de Plastic SCM.
- Para activar un usuario por primera vez, basta con utilizar Plastic SCM con
- las credenciales del usuario a activar, siempre que no se sobrepase el
- número máximo de usuarios autorizados.
- El comando comprueba que el usuario a deshabilitar existe en el sistema de
- autenticación subyacente (p.ej: ActiveDirectory, LDAP, Usuario/Contraseña ...).
- Si se desea desactivar un usuario que ya no existe en el sistema de autenticación,
- utilice la opción --nosolveuser
- Ejemplos:
- cm deactivateuser juan
- cm deactivateuser juan --server=miservidor:8084
- cm deactivateuser S-1-5-21-3631250224-3045023395-1892523819-1107 --nosolveuser
- == CMD_DESCRIPTION_DIFF ==
- Muestra las diferencias existentes entre dos revisiones o dos changesets
- == CMD_USAGE_DIFF ==
- Sintaxis:
- cm differences [opciones] version1 [version2] [ruta]
- version1: especificación de rama, primera revisión, changeset, etiqueta o
- shelve a comparar.
- version2: segunda especificación de revisión, changeset, etiqueta o shelve
- a comparar.
- ruta: muestra las diferencias en el fichero especificado
- Usa 'cm help objectspec' para obtener más información sobre especificaciones.
- Opciones:
- --added: imprime sólo las diferencias consistentes en items añadidos
- --changed: imprime sólo las diferencias consistentes en items cambiados
- --moved: imprime sólo las diferencias consistentes en items movidos
- o renombrados
- --deleted: imprime sólo las diferencias consistentes en items borrados
- --all: imprime todas las diferencias
- La primera letra de cada línea que se imprime denota el tipo de cambio:
- A significa que el ítem fue añadido
- C signnifica que el ítem fue cambiado
- D significa que el ítem fue borrado
- M significa que el ítem fue movido o renombrado. El ítem a la izquierda
- es el nombre original, el ítem a la derecha es el nombre en destino
- --clean: limpia las diferencias de la rama (omite las diferencias que vienen
- de los merges
- --download: almacena el contenido de las diferencias en la ruta especificada.
- --fullpaths, --fp: Fuerza al comando a imprimir rutas de workspace absolutas
- siempre que sea posible.
- --repositorypaths: imprime rutas de repositorio en lugar de rutas
- de workspace. (Ésta opción prevalece sobre la opción "--fullpaths").
- == CMD_HELP_DIFF ==
- Notas:
- Este comando muestra las diferencias en una rama si el segundo comando no se
- especifica o entre dos revisiones, changesets o etiquetas si se especifica
- el segundo parámetro.
- Comparar ramas:
- cm diff br:/main/task001
- cm diff br:/main/task001 \doc\readme.txt
- Comparar changesets:
- cm diff 19
- cm diff 19 25
- cm diff cs:19 cs:25
- cm diff cs:19 cs:23 --changed
- cm diff cs:19 cs:23 --repositorypaths
- cm diff cs:19 cs:23 \doc\readme.txt
- Comparar etiquetas:
- cm diff lb:EtiquetaPrimeraRelease lb:EtiquetaSegundaRelease
- cm diff lb:tag_193.2 cs:34214
- cm diff cs:31492 lb:tag_193.2
- Comaprar shelves:
- cm diff sh:2
- cm diff sh:2 sh:4
- Comparar revisiones:
- cm diff rev:readme.txt#cs:19 rev:readme.txt#cs:20
- cm diff serverpath:/doc/readme.txt#cs:19@myrepo \
- serverpath:/doc/readme.txt#br:/main@myrepo@localhost:8084
- == CMD_DESCRIPTION_DIFFMETRICS ==
- Muestra métricas sobre las diferencias de dos revisiones (líneas añadidas, cambiadas y borradas).
- == CMD_USAGE_DIFFMETRICS ==
- (líneas cambiadas, añadidas y borradas)
- Sintaxis:
- cm diffmetrics [opciones] spec_revision1 spec_revision2
- spec_revision1: Especificación de revisión.
- spec_revision2: La otra especificación de revisión.
- Usa 'cm help objectspec' para más información sobre especificaciones.
- Opciones:
- --format=str: Cadena de formato de salida. Ver notas para más información.
- --encoding=tipo_codificación: Cambia la codificación.
- --ignore=método_de_comparación: Cambia la forma de calcular las diferencias.
- tipo_codificación : ascii
- unicode
- bigendian
- utf7
- utf8
- método_de_comparación:
- none (por defecto)
- eol (ignora diferencias en retornos de carra)
- whitespaces (ignora diferencias en espacios en blanco)
- eol&whitespaces (las dos anteriores)
- == CMD_HELP_DIFFMETRICS ==
- Notas:
- Este comando acepta una cadena de formato para mostrar la salida.
- Cada parámetro de salida se identifica con un número, y el usuario se
- puede referir a él escribiéndolo entre los símbolos '{' y '}'.
- Los parámetros de salida de este comando son los siguientes:
- 0: Número de líneas cambiadas
- 1: Número de líneas añadidas
- 2: Número de líneas borradas
- Éstas son cadenas de formato válidas:
- --format={0}{1}{2}
- --format="Hay {0} líneas cambiadas, {1} líneas añadidas y {2} líneas borradas"
- Ejemplos:
- cm diffmetrics fichero.txt#br:/main#2 fichero.txt#br:/main/scm0211#4
- cm diffmetrics fichero.txt#br:/main#2 fichero.txt#br:/main#3 --encoding=utf8 --ignore=whitespaces
- == CMD_DESCRIPTION_FASTEXPORT ==
- Exporta los datos de un repositorio de Plastic SCM a un formato fast-export.
- == CMD_USAGE_FASTEXPORT ==
- Sintaxis:
- cm ^fast-export | ^fe <repspec> <fast-export-file>
- [--^import-marks=<marks_file>]
- [--^export-marks=<marks_file>]
- [--^branchseparator=<chr_separator>]
- [--^nodata] [--^from=<changesetid>] [--^to=<changesetid>]
- Opciones:
- repspec Repositorio cuyos datos serán exportados.
- (Usa 'cm help objectspec' para aprender cómo especificar
- un repositorio.)
- fast-export-file Fichero con los datos del repositorio en formato
- fast-export de Git.
- --import-marks Fichero de marcas usado para la importación incremental.
- Este fichero habrá sido previamente exportado con el
- comando --export-marks. Los changesets descritos en este
- fichero no serán importados porque ya lo fueron en una
- importación previa.
- --export-marks Fichero donde se guardan los changesets importados.
- Este fichero podrá ser usado en una operación fast-import
- para indicar los changesets que han sido importados.
- --branchseparator Plastic SCM usa "/" como separador por defecto en la
- jerarquía de ramas. Esta opción permite usar un carácter
- como separador de jerarquía. Por ejemplo, la rama
- main-task-sub será mapeada en Plastic como /main/task/sub.
- --nodata Realiza la exportaciónExporta pero sin incluir datos.
- Esta opción es útil si se desea comprobar que la
- exportación se ejecutará sin problemas.
- --from Exporta desde el changeset especificado.
- --to Exporta hasta el changeset especificado.
- == CMD_HELP_FASTEXPORT ==
- Notas:
- - Para importar un repositorio de Plastic a Git, usa el siguiente comando:
- cat repo.fe.00 | git fast-import --export-marks=marks.git --import-marks=marks.git
- - La exportación incremental es soportado usando un fichero de marcas que
- contenga los changesets previamente importados (ficheros --import-marks y
- --export-marks).
- Esto significa que solamente los nuevos changesets que no fueron
- exportados en una operación previa de fast-export serán exportados.
- Ejemplos:
- cm fast-export repo@localhost:8087 repo.fe.00 --import-marks=marks.cm --export-marks=marks.cm
- (Exporta el repositorio "repo" en el servidor local al fichero "repo.fe.00"
- en formato fast-export de Git y crea el fichero de marcas para poder
- realizar una futura exportación incremental.)
- cm ^fast-export repo@localhost:8087 repo.fe.00 --^from=20
- (Exporta el repositorio "repo" en el servidor local al fichero "repo.fe.00"
- en formato Git fast-export desde el changeset '20'.)
- == CMD_DESCRIPTION_FASTIMPORT ==
- Importa datos de fast-export de Git en el repositorio.
- == CMD_USAGE_FASTIMPORT ==
- Sintaxis:
- cm ^fast-import | ^fi <repspec> <fast-export-file>
- [--^import-marks=<marks_file>]
- [--^export-marks=<marks_file>]
- [--^stats] [--^branchseparator=<chr_separator>]
- [--^nodata] [--^ignoremissingchangesets] [--^mastertomain]
- Opciones:
- repspec Repositorio en el cual se importarán los datos.
- Si no existe en el momento de la operación, se
- crea automáticamente. (Usa 'cm help objectspec'
- para aprender cómo especificar un repositorio.)
- fast-export-file Fichero con los datos en formato Git
- fast-export.
- --import-marks El fichero de etiquetas (marks) utilizado para
- importaciones incrementales. Dicho fichero se
- ha exportado previamente con --export-marks.
- Los changesets descritos en este fichero no se
- importarán porque ya existían de una importación
- previa.
- --export-marks El fichero en el cual se guardarán los changesets
- importados. Dicho fichero se utiliza en una
- operación posterior de fast-import para señalar
- los changesets que ya han sido importados.
- --stats Muestra estadísticas del proceso de importación.
- --branchseparator Plastic SCM usa "/" como separador por defecto
- en la jerarquía de ramas. Esta opción permite
- usar un carácter como separador en esa
- jerarquía. Por ejemplo, la rama main-task-sub
- será mapeada en Plastic SCM como /main/task/sub.
- --nodata Realiza la importación pero sin incluir datos.
- Esta opción es útil si se desea comprobar que la
- importación se ejecutará sin problemas.
- --ignoremissingchangesets Los changesets que no pueden ser importados se
- descartan y la operación de fast-import continúa
- sin ellos.
- --mastertomain Realiza la importación usando "main" en lugar
- de "master".
- == CMD_HELP_FASTIMPORT ==
- Notas:
- * Para exportar un repositorio de Git, utilice un comando como el
- siguiente:
- git fast-export --all -M --signed-tags=strip
- --tag-of-filtered-object=drop> ..\git-fast-export.dat
- La opción -M es importante para detectar ítems movidos.
- * El repositorio especificado se crea en caso de que no exista.
- * Se soporta una importación incremental utilizando ficheros de marcas que
- contienen los changesets ya importados (--import-marks and --export-marks).
- Esto significa que solamente se importarán los changesets que no fueron
- importados previamente.
- Ejemplos:
- cm fast-import mynewrepo@atenea:8084 repo.fast-export
- Importa el contenido exportado en el fichero repo.fast-export en el
- repositorio "mynewrepo" del servidor atenea:8084.
- cm fast-import repo@server:8084 repo.fast-export --export-marks=rep.marks
- Importa el contenido del fichero de exportaciones repo.fast-export en el
- repositorio "mynewrepo" del servidor atenea:8084 y crea un archivo de
- marcas para importaciones incrementales posteriores.
- cm fast-import repo@server:8084 repo.fast-export --importmarks=repo.marks
- --export-marks=repo.marks
- Importa el contenido del fichero repo.fast-export. Solamente se importarán
- los changesets que no están en el fichero de marcas. Se utiliza el mismo
- fichero de marcas para guardar los changesets que se importarán esta vez,
- de nuevo con el fin de otra importación incremental posterior.
- == CMD_DESCRIPTION_FILEINFO ==
- Obtiene información detallada sobre elementos en el espacio de trabajo.
- == CMD_USAGE_FILEINFO ==
- Sintaxis:
- cm fileinfo <item_path> [--fields=field_list] [--xml[=output_file]]
- [--format=str_format] [--encoding=name]
- item_path Elementos para mostrar, separados por espacios. Pueden
- utilizarse comillas (") para aquellas rutas que
- contengan espacios.
- Opciones:
- --fields Una cadena de valores separados por coma. Indica
- qué campos se mostrarán por cada elemento.
- Puede encontrar información adicional mediante el
- comando 'cm help fileinfo'.
- --xml Vuelca la salida en formato XML a la salida estándar.
- Es posible especificar un fichero de salida. Esta opción
- no puede combinarse con --format.
- --format Obtiene el mensaje de salida en un formato específico.
- Consulte las notas para más información. No puede
- combinarse con --xml.
- --symlink Aplica la operación fileinfo al enlace simbólico y no
- a su destino.
- --encoding Especifica la codificación de salida. P. ej.: UTF-8.
- Consulte la documentación MSDN para obtener la lista de
- codificaciones soportadas y su formato, al final de la
- página. La columna "Name":
- http://msdn.microsoft.com/en-us/library/system.text.encoding.aspx
- == CMD_HELP_FILEINFO ==
- Notas:
- Este comando muestra una lista detallada de atributos para cada elemento
- seleccionado. Cada atributo se muestra en una nueva línea por defecto.
- Se puede modificar la lista de atributos para mostrar únicamente los
- atributos que el usuario necesite. A tal efecto se puede utilizar el
- argumento --fields=lista, que acepta una cadena de nombres de atributo
- separados por comas. De este modo, solo se mostrarán aquellos argumentos
- cuyo nombre esté presente en la lista.
- Revision Head Changeset:
- Esta opción está desactivada por defecto. Tenga en cuenta que la
- recuperación de este atributo es notablemete más lenta que el resto, por
- lo que recomendamos al usuario agrupar tantos ficheros por ejecución como
- sea posible. Esto mejora los tiempos de ejecución, al evitar numerosas
- ejecuciones 'cm fileinfo' separadas.
- Adicionalmente, esta característica no se encuentra disponible actualmente
- para directorios controlados por PlasticSCM.
- A continuación se encuentra la lista completa de nombres de atributo. Los
- nombres marcados con asterisco ('*') no se muestran por defecto:
- ClientPath Ruta local del elemento en disco.
- RelativePath Ruta del elemento relativa al workspace.
- ServerPath Ruta del elemento en el repositorio.
- (Nota: las rutas afectadas por workspace
- transformables no están soportadas actualmente)
- Size Tamaño del elemento.
- Hash Suma 'hash' del elemento
- Owner Nombre del usuario propietario del elemento.
- RevisionHeadChangeset* Changeset de la revisión cargada en el último
- changeset de la rama (ver párrafo anterior).
- RevisionChangeset Changeset de la revisión cargada en el workspace
- RepSpec Especificación del repositorio al que pertenece
- el elemento (repositorio@servidor).
- Status Estado actual del elemento en el espacio de
- trabajo (añadido, eliminado, checkout, etc.).
- Type Tipo de la revisión (texto, binario, directorio,
- enlace simbólico o desconocido).
- Changelist Lista de cambios a la que pertenece el elemento
- (si la hubiere).
- IsLocked* Muestra si el elemento está bloqueado o no.
- LockedBy* Usuario que bloqueó el elemento mediante
- checkout exclusivo.
- LockedWhere* Localización del elemento bloqueado mediante
- checkout exclusivo.
- IsUnderXlink Muestra si el elemento se encuentra bajo un
- Xlink o no.
- UnderXlinkTarget Repositorio destino del Xlink en que se
- encuentra el elemento, si lo hubiere.
- UnderXlinkPath Ruta en el repositorio apuntado por el Xlink
- en que se encuentra el elemento, si lo hubiere.
- UnderXlinkWritable Muestra si el Xlink bajo el que se encuentra el
- elemento es de escritura o no.
- UnderXlinkRelative Muestra si el Xlink bajo el que se encuentra el
- elemento es relativo o no.
- IsXlink Muestra si el elemento es un Xlink o no.
- XlinkTarget Repositorio objetivo del Xlink, si el elemento
- lo es.
- XlinkName Nombre del Xlink, si el elemento lo es.
- XlinkWritable Muestra si el elemento es un Xlink de escritura
- o no.
- XlinkRelative Muestra si el elemento es un Xlink relativo o no
- Personalización del formato de salida:
- Este comando acepta una cadena de formato para mostrar su salida.
- Los parámetros de salida de este comando son los siguientes:
- ClientPath
- RelativePath
- ServerPath
- Size
- Hash
- Owner
- RevisionHeadChangeset
- RevisionChangeset
- Status
- Type
- Changelist
- IsLocked
- LockedBy
- LockedWhere
- IsUnderXlink
- UnderXlinkTarget
- UnderXlinkPath
- UnderXlinkWritable
- UnderXlinkRelative
- IsXlink
- XlinkTarget
- XlinkName
- XlinkWritable
- XlinkRelative
- RepSpec
- Tenga en cuenta que las opciones --format y --xml son mutuamente
- exclusivas, por lo que no se pueden utilizar simultáneamente.
- Ejemplos:
- cm fileinfo file1.txt file2.txt dir/
- cm fileinfo "New Project.csproj" --xml
- cm fileinfo assets.art --fields=ServerPath,Size,IsLocked,LockedBy
- cm fileinfo proj_specs.docx --fields=ServerPath,RevisionChangeset --xml
- cm fileinfo samples.ogg --format="{ServerPath}[{Owner}] -> {Size}"
- == CMD_DESCRIPTION_FIND_QUERY ==
- Obtiene una serie de objetos en base a unos criterios de búsqueda.
- == CMD_USAGE_FIND_QUERY ==
- Sintaxis:
- cm find objeto [where str_condiciones]
- [on repository 'repspec' | on repositories <'repspec'>+]
- [--format=str_format] [--dateformat=date_format]
- [--nototal] [--file=dump_file] [--xml] [--encoding=name]
- cm find objeto [where condiciones] [on repositorios] [opciones]
- objeto Objeto a buscar.
- Lee la guía sobre'cm find' para ver los objetos que
- puedes buscar:
- https://www.plasticscm.com/documentation/cmfind/plastic-scm-version-control-query-system-guide.shtml
- Opciones:
- condiciones Condiciones de búsqueda sobre los atributos del objeto.
- repspec Nombre o especificación del repositorio donde buscar.
- En el caso de "repositories", debes separar las
- especificaciones (repspec) por comas.
- Usa 'cm help objectspec' para obtener más información
- sobre las especificaciones de repositorios.
- --format Devuelve el mensaje de salida en un formato determinado.
- Lee la guía sobre 'cm find' para ver todos los atributos
- de los objetos que puedes usar para formatear la salida:
- https://www.plasticscm.com/documentation/cmfind/plastic-scm-version-control-query-system-guide.shtml
- --dateformat Formato de las fechas. Por defecto "dd/MM/yyy HH:mm:ss".
- --nototal No muestra el número total de registros.
- --file Fichero en el que se vuelcan los resultados.
- --xml Formatea salida como XML.
- --encoding Especifica la codificación con la que se quiere mostrar
- la salida del comando o escribir el fichero de
- resultado, por ejemplo, utf-8.
- Consulte la documentación de MSDN para obtener
- la tabla completa de codificaciones soportadas y su
- formato (al final de la página, en la columna "Name"):
- http://msdn.microsoft.com/en-us/library/system.text.encoding.aspx
- == CMD_HELP_FIND_QUERY ==
- Notas:
- Si no se especifica ningún repositorio, la búsqueda se realiza sobre el
- repositorio actual.
- Cuando se ejecutan búsquedas desde la línea de comandos usando operadores de
- comparación (>, <, >=, <=), el intérprete de comandos (o shell) considera a
- estos operadores como redirecciones de E/S. Por lo que es necesario escribir
- la búsqueda entre dobles comillas.
- El comando cm find acepta una cadena de formato para mostrar la salida.
- Cada parámetro de salida se identifica con un nombre, y el usuario se
- puede referir a él escribiéndolo entre los símbolos '{' y '}'.
- Los parámetros de salida se corresponden en la mayoría de los casos con
- los atributos del objeto.
- Estas son cadenas de formato válidas:
- --format={id}{date}{name}
- --format="{item}#{branch} con fecha {date}"
- Consideraciones sobre XML y codificación (encoding):
- Cuando se especifica la opción --xml, se muestra por consola el resultado
- como un texto XML. Por defecto se utiliza la codificación estándar del
- sistema operativo. Es posible que si hay caracteres extraños (tildes o
- eñes), no se visualicen correctamente en la consola. Pero si se redirige la
- salida a un fichero, el contenido se visualizará correctamente.
- Cuando se especifican simultáneamente las opciones --xml y --file, se
- utiliza por defecto la codificación UTF-8.
- Ejemplos:
- cm find revision
- cm find revision "where changeset = 23 and owner = 'user'"
- cm find branch "on repository 'rep1'"
- cm find label "on repositories 'rep1', 'rep:default@localhost:8084'"
- cm find branch "where parent = 'br:/main' on repository 'rep1'"
- cm find revision "where item = 'item:.'" --format="{item}#{branch}"
- cm find revision "where item = 'item:.'" --xml --file=c:\queryresults\revs.xml
- == CMD_DESCRIPTION_FINDCHANGED ==
- Obtiene una lista de los ficheros que se han modificado fuera del control de
- Plastic SCM. Este comando se considera obsoleto y se mantiene únicamente por
- retrocompatibilidad. Reemplazado por cm status.
- == CMD_USAGE_FINDCHANGED ==
- fuera del control de Plastic
- Sintaxis:
- cm findchanged [opciones][ruta]
- ruta: Ruta inicial de búsqueda.
- Opciones:
- -R|-r|--recursive Descender recursivamente dentro de directorios.
- --checkcontent Comparar los ficheros por el contenido.
- --onlychanged Con esta opción los elementos desprotegidos no serán
- devueltos entre los cambiados.
- == CMD_HELP_FINDCHANGED ==
- Notas:
- El comando findchanged se utiliza para identificar los items que se han
- modificado en el espacio de trabajo. Si no se utiliza opción
- –checkcontent solamente se comparan los timestamp para obtener los ficheros
- cambiados. Si se utiliza la opción –checkcontent, se compara el contenido del
- fichero.
- Cuando por alguna razón no podemos obtener conexión con el servidor y se
- trabaja desconectado, y se modifica una serie de ficheros, se puede utilizar
- este comando para identificar los elementos cambiados.
- Ejemplos:
- cm findchanged .
- cm findchanged -R . | cm checkout - (desprotege los elementos cambiados)
- == CMD_DESCRIPTION_FINDCHECKEDOUT ==
- Obtiene un listado de desprotecciones pendientes. Este comando está deprecado y
- se mantiene únicamente por retrocompatibilidad. Reemplazado por cm status.
- == CMD_USAGE_FINDCHECKEDOUT ==
- Sintaxis:
- cm findcheckouts [opciones]
- Opciones:
- --all: Muestra desprotecciones de todos los usuarios.
- --format=cadena: Cadena de formato de salida.
- Ver notas para más información.
- == CMD_HELP_FINDCHECKEDOUT ==
- Notas:
- Este comando se utiliza para encontrar las protecciones pendientes en un
- espacio de trabajo. Se puede combinar con el comando 'checkin' para
- proteger todos los elementos desprotegidos, utilizando la redirección de
- la salida estándar. Vea los ejemplos para más información.
- Este comando acepta una cadena de formato para mostrar la salida.
- Cada parámetro de salida se identifica con un número, y el usuario se puede
- referir a él escribiéndolo entre los símbolos '{' y '}'.
- Los parámetros de salida de este comando son los siguientes:
- 0: Fecha de modificación.
- 1: Propietario.
- 2: Información del espacio de trabajo.
- 3: Máquina.
- 4: Ruta del ítem.
- 5: Información de repositorio y rama.
- Éstas son cadenas de formato válidas:
- --format={0}{1}{2}{3}{4}{5}
- --format="El fichero {4} está desprotegido por el usuario {1}"
- Ejemplos:
- cm findcheckouts
- cm findcheckouts --all
- cm findcheckouts --format={4} | cm checkin -
- (Protege todos los items desprotegidos)
- cm findcheckouts --format={4} | cm uncheckout -
- (Deshace las desprotecciones de todos los items desprotegidos)
- == CMD_DESCRIPTION_FINDPRIVATE ==
- Obtiene un listado de items privados en el espacio de trabajo. Este comando
- está deprecado y se mantiene únicamente por retrocompatibilidad. Reemplazado
- por cm status.
- == CMD_USAGE_FINDPRIVATE ==
- Sintaxis:
- cm findprivate [opciones][ruta]
- rutas: Ruta inicial de búsqueda.
- Opciones:
- -R|-r|--recursive Descender recursivamente dentro de directorios.
- --exclusions Ignora los elementos excluidos.
- == CMD_HELP_FINDPRIVATE ==
- Notas:
- Si no se proporciona una ruta, se tomará el directorio actual.
- Este comando es útil para añadir solamente los elementos privados de una
- ruta al repositorio, utilizando la redirección de la salida estándar.
- Ver ejemplos.
- Ejemplos:
- cm findprivate .
- cm findprivate -R | cm add - --coparent
- (busca recursivamente items privados, y los añade al
- repositorio desprotegiendo los padres si es necesario)
- == CMD_DESCRIPTION_GETCONFIG ==
- Obtiene la información de configuración solicitada.
- == CMD_USAGE_GETCONFIG ==
- Sintaxis:
- cm getconfig setting
- setting: Parámetro de configuración que se quiere consultar.
- Los parámetros disponibles son:
- setfileasreadonly : indica si los ficheros protegidos se dejan en sólo lectura.
- location: devuelve la ruta del fichero de configuración del cliente.
- extensionworkingmode: devuelve el modo de trabajo de la extensión.
- extensionprefix: devuelve el prefijo de la extensión configurada.
- defaultrepserver: devuelve el servidor de repositorios configurado por defecto.
- Devuelve el valor de la clave solicitada.
- == CMD_HELP_GETCONFIG ==
- Ejemplos:
- cm getconfig setfileasreadonly
- == CMD_DESCRIPTION_GETFILE ==
- Obtiene una revisión especificada.
- == CMD_USAGE_GETFILE ==
- Sintaxis:
- cm cat spec [opciones]
- spec: Especificación de la revisión. Usa 'cm help objectspec' para obtener
- más información sobre especificaciones.
- Opciones:
- --file=fichero: Fichero de salida, opcional. Si no se especifica
- el resultado, se escribe en la salida estándar.
- --debug: Cuando se especifica la revisión de un directorio, el
- comando muestra su id de revisión y sus permisos.
- == CMD_HELP_GETFILE ==
- Notas:
- Una especificación de revisión se define como:
- [rev:]RUTA[#(brSpec|csetSpec|lbSpec)][@repSpec]
- [rev:]revid:rev_id[@repSpec]
- [rev:]serverpath:ruta_de_servidor#(brSpec|csetSpec|lbSpec)[@repSpec]
- brSpec: br:NOMBRE_RAMA[#LAST]
- csetSpec: cs:NUMERO_CSET
- lbSpec: lb:NOMBRE_ETIQUETA
- repSpec: [rep:]NOMBRE_REPOSITORIO[@[repserver:]NOMBRE_SERVIDOR:PUERTO_SERVIDOR]
- Ejemplos:
- Obtener la última revisión de la rama main del ítem fichero.txt:
- cm cat fichero.txt#br:/main
- Obtener la revisión del changeset 3 del ítem fichero.txt y escribirlo en el
- fichero tmp.txt:
- cm cat fichero.txt#cs:3 --file=tmp.txt
- Obtener la revisión id 1230:
- cm cat revid:1230@rep:myrepos@repserver:london:8084
- Obtener el fichero /src/foo.c en el último changeset de la rama
- br:/main/task003 del repositorio 'myrepo':
- cm cat serverpath:/src/foo.c#br:/main/task003@myrepo
- == CMD_DESCRIPTION_GETREVISION ==
- Trae una revisión especifica al espacio de trabajo actual
- == CMD_USAGE_GETREVISION ==
- Sintaxis:
- cm getrevision revision_spec
- revision_spec: Especificación de la revisión que se desea obtener. Usa
- 'cm help objectspec' para obtener más información sobre especificaciones.
- == CMD_HELP_GETREVISION ==
- Notas:
- Una especificación de revisión se define como:
- [rev:]RUTA[#(brSpec|csetSpec|lbSpec)][@repSpec]
- [rev:]revid:[#(brSpec|csetSpec|lbSpec)][@repSpec]
- brSpec: br:NOMBRE_RAMA[#LAST]
- csetSpec: cs:NUMERO_CSET
- lbSpec: lb:NOMBRE_ETIQUETA
- repSpec: [rep:]NOMBRE_REPOSITORIO[@[repserver:]NOMBRE_SERVIDOR:PUERTO_SERVIDOR]
- Ejemplos:
- cm getrevision fichero.txt#cs:3 (Establece la revisión del changeset 3 del
- fichero.txt)
- == CMD_DESCRIPTION_GETSTATUS ==
- Obtiene el estado de un ítem.
- == CMD_USAGE_GETSTATUS ==
- Sintaxis:
- cm getstatus [opciones] rutas
- rutas: Rutas de los items sobre los que se desea consultar su estado.
- Opciones:
- -R|-r|--recursive Descender recursivamente dentro de directorios.
- == CMD_HELP_GETSTATUS ==
- Notas:
- Los estados posibles de un ítem son los siguientes:
- privado: El ítem no está controlado por Plastic SCM.
- desprotegido: El ítem está desprotegido, y por tanto controlado por Plastic SCM.
- protegido: El ítem está protegido, y por tanto controlado por Plastic SCM.
- Ejemplos:
- cm getstatus fichero1.txt fichero2.txt
- == CMD_DESCRIPTION_GETTASKBRANCHES ==
- Obtiene las ramas asociadas con la tarea especificada.
- == CMD_USAGE_GETTASKBRANCHES ==
- Sintaxis:
- cm gettaskbranches tarea [opciones]
- tarea: el identificador de la tarea.
- Opciones:
- --format=cadena: Cadena de formato de salida.
- --dateformat: Formato de las fechas.
- == CMD_HELP_GETTASKBRANCHES ==
- Notas:
- Este comando admite una cadena de formato para mostrar la salida.
- Los parametros de salida de este comando son los siguientes:
- tab: Introduce un tabulador.
- newline: Introduce una nueva línea.
- name: El nombre de la rama.
- owner: El propietario de la rama.
- date: La fecha en la que fue creada la rama.
- type: El tipo de la rama ('T' si es smart o 'F' si no lo es).
- parent: La rama padre.
- comment: El comentario de la rama.
- repname: El repositorio donde se encuentra la rama.
- repserver: El nombre del servidor.
- Ejemplos:
- cm gtb 4311
- cm gtb 4311 --format="br:{name}"
- cm gtb 4311 --format="br:{name} {date}" --dateformat="yyyy/MM/dd HH:mm:ss"
- == CMD_DESCRIPTION_GETWWI ==
- Muestra información acerca del selecetor del espacio de trabajo.
- == CMD_USAGE_GETWWI ==
- Uso:
- cm wi [ruta_workspace]
- ruta_workspace: Ruta en disco del workspace a consultar.
- == CMD_HELP_GETWWI ==
- Notas:
- Este comando muestra información acerca de la configuración del selector
- del espacio de trabajo (en qué repositorio, rama y etiqueta se está
- trabajando).
- Ejemplos:
- cm wi c:\mywk
- == CMD_DESCRIPTION_GWP ==
- Obtiene información acerca del workspace a partir de un path.
- == CMD_USAGE_GWP ==
- Uso:
- cm getworkspacefrompath | gwp <ruta> [--format=str_format]
- ruta Fichero o directorio en disco.
- Opciones:
- --format Devuelve el mensaje de salida con un formato determinado.
- Más información en las notas.
- == CMD_HELP_GWP ==
- Notas:
- Este comando muestra por pantalla información del workspace al que
- pertenece una ruta determinada.
- Este comando acepta una cadena especificando el formato con el que se
- debe mostrar la salida. Los parámetros de salida son los siguientes:
- {0} | {wkname} Nombre del workspace.
- {1} | {wkpath} Ruta del workspace.
- {2} | {machine} Nombre de la máquina del workspace.
- {3} | {owner} Propietario del workspace.
- {4} | {guid} GUID del workspace.
- {tab} Inserta un tabulador.
- {newline} Inserta un salto de línea.
- Ejemplos:
- cm gwp c:\myworkspace\code\file1.cpp --format="Nombre del wkspace: {wkname}"
- == CMD_DESCRIPTION_HELP ==
- Muestra ayuda acerca de un comando.
- == CMD_USAGE_HELP ==
- Sintaxis:
- cm help nombre_comando
- == CMD_HELP_HELP ==
- == CMD_DESCRIPTION_IOSTATS ==
- Muestra estadísticas de rendimiento relativas al hardware
- == CMD_USAGE_IOSTATS ==
- Sintaxis:
- cm iostats [server_spec] list_of_tests [options]
- server_spec: Servidor válido de PlasticSCM para ejecutar las pruebas de red,
- tales como "serverUploadTest" y/o "serverDownloadTest".
- Si no se especifica ningún parámetro, se intentará usar el servidor
- configureado por defecto.
- Usa 'cm help objectspec' para aprender cómo indicar la especificación
- del servidor.
- list_of_tests: Test disponibles:
- --serverUploadTest: mide la velocidad de subida de datos a través de la
- red desde el cliente de Plastic SCM al servidor.
- --serverDownloadTest: mide la velocidad de bajada de datos a través de
- la red desde el servidor de Plastic SCM al cliente.
- --diskTest: mide la velocidad de escritura y lectura a disco.
- --systemNetworkUsage: muestra el uso actual de los recursos de red del
- sistema. (Se usan contadores de rendimiento del sistema operativo).
- (Sólo disponible en plataformas Windows).
- --systemDiskUsage: muestra el uso actual de los discos físico del
- sistema. (Se usan contadores de rendimiento del sistema operativo).
- (Sólo disponible en plataformas Windows).
- Opciones (options):
- --netTotalMB: cantidad de datos de usuario (en MegaBytes) que se
- transmitirán en un test de red, tales como"serverDownloadTest"
- o "serverUploadTest".
- Debe ser un valor comprendido entre "4" y "512" (por defecto: 16).
- --networkIterations: indica el número de iteraciones para los tests de red:
- "serverUploadTest" o "serverDownloadTest".
- Debe ser un valor comprendido entre "1" y "100". (por defecto: 1).
- --diskDataSize: cantidad de datos (en MegaBytes) que se escribirán y leerán
- en el test de disco ("diskTest").
- Debe ser un valor comprendido entre "100" y "4096". (por defecto: 512).
- --diskTestPath: Ruta donde el test de disco escribe los datos para la
- realización de la prueba. Si no se especifica ningún parámetro, se
- intentará usar un directorio dentro del directorio temporal del sistema.
- --systemDisplayTime: Espacio de tiempo (en segundos) en el que se muestra el uso
- de los recursos del sistema. Éste parámetro es tenido en cuenta para los tests:
- "systemNetworkUsage" y "systemDiskUsage".
- Debe ser un valor comprendido entre "1" y "3600". (por defecto: 5 segundos).
- --systemDisplayTimeInterval: Periodo de tiempo (en segundos) entre las muestras
- que se toman sobre el uso de los recursos del sistema. Este parámetro
- es tenido en cuenta para los tests: "systemNetworkUsage" y "systemDiskUsage".
- Debe ser un valor comprendido entre "1" y "60". (por defecto: 1 segundo).
- Ejemplo:
- cm iostats MYSERVER:8087 --serverUploadTest --serverDownloadTest --netTotalMB=32
- == CMD_HELP_IOSTATS ==
- Notas:
- Éste comando necesita un servidor de Plastic SCM que se usará para las
- pruebas de velocidad de la red ("serverUploadTest" y/o
- "serverDownloadTest").
- El parámetro "--diskTestPath" debe apuntar a una ruta que pertenezca a la
- unidad física de disco que se pretende probar.
- Si no se especifica ninguna ruta, el comando intentará utilizar la ruta
- de almacenamiento temporal del sistema.
- La unidad de disco del directorio de pruebas de disco debe contener suficiente
- espacio libre para ejecutar la prueba.
- Durante la ejecución del comando se puede experimentar una caída de rendimiento
- de la máquina debido a las pruebas realizadas.
- == CMD_DESCRIPTION_ISSUETRACKER ==
- Obtiene, actualiza o busca el estado de una tarea del sistema de incidencias especificado.
- == CMD_USAGE_ISSUETRACKER ==
- Sintaxis:
- cm issuetracker <name> status get <task_id> <parameter>+
- cm issuetracker <name> status update <task_id> <status> <parameter>+
- cm issuetracker <name> status find <status> <parameter>+
- cm issuetracker <name> connection check <parameter>+
- name: Nombre del sistema de seguimiento de incidencias contra
- el que se va a conectar.
- Sólo Jira está soportado por el momento.
- task_id: Número de la tarea que se quiere consultar o actualizar.
- status: Un estado de tarea válido en el sistema especificado.
- Parámetros de Jira (son todos obligatorios):
- --user=user El usuario a autenticar.
- --password=pwd La contraseña a autenticar.
- --host=url La url del sistema de seguimiento de incidencias.
- --projectkey=clave La clave del proyecto en Jira.
-
- == CMD_HELP_ISSUETRACKER ==
- Ejemplos:
- cm issuetracker jira status get 11 --user=user@mail.es --password=pwd --host=https://user.atlassian.net --projectkey=PRJ
- (Obtiene el estado de la tarea 11 para el proyecto PRJ)
-
- cm issuetracker jira status update 11 "Done" --user=user@mail.es --password=pwd --host=https://user.atlassian.net --projectkey=PRJ
- (Actualiza el estado a "Done" de la tarea 11 para el proyecto PRJ)
-
- cm issuetracker jira status find "Done" --user=user@mail.es --password=pwd --host=https://user.atlassian.net --projectkey=PRJ
- (Obtiene los ids de tarea cuyo estado es "Done" para el proyecto PRJ)
-
- cm issuetracker jira connection check --user=user@mail.es --password=pwd --host=https://user.atlassian.net
- (Comprueba si los parámetros de configuración son válidos o no)
- == CMD_DESCRIPTION_LICENSEINFO ==
- Muestra información de la licencia y de su uso.
- == CMD_USAGE_LICENSEINFO ==
- Sintaxis:
- cm licenseinfo | li [--server=repserverspec] [--inactive] [--active] [--sort={name|status}]
- Opciones:
- --server: Obtiene la información de la licencia para el servidor
- especificado. Si no se especifica ningún servidor, el
- comando se ejecutará contra el servidor configurado en
- el cliente.
- Usa 'cm help objectspec' para obtener más información
- sobre especificaciones.
- --inactive Muestra únicamente usuarios inactivos en la sección de
- "uso de licencia".
- --active Muestra únicamente usuarios activos en la sección de
- "uso de licencia".
- --sort Ordena usuarios usando el campo especificado:
- 'name' o 'status'.
- == CMD_HELP_LICENSEINFO ==
- Notas:
- Se muestra información acerca de la fecha de expiración, los usuarios
- activos y no activos, etc.
- Ejemplos:
- cm licenseinfo
- cm licenseinfo --server=myserver:8084
- == CMD_DESCRIPTION_LINKTASK ==
- Enlaza un changeset a tareas pertenecientes a un control de tareas.
- == CMD_USAGE_LINKTASK ==
- Sintaxis:
- cm linktask changesetSpec extensionPrefix taskKey
- changesetSpec: Especificación completa del changeset para ser enlazado a una
- tarea en el sistema de control de tareas. Usa 'cm help objectspec' para
- obtener más información sobre especificaciones.
- extensionPrefix: Prefijo del sistema de control de tareas configurado.
- taskKey: Identificador de la tarea para asociar al changeset especificado.
- == CMD_HELP_LINKTASK ==
- Ejemplos:
- cm lt cs:8@rep:default@repserver:localhost:8084 jira PRJ-1
- == CMD_DESCRIPTION_LOCK_LIST ==
- Muestra los elementos bloqueados (checkouts exclusivos) en el servidor especificado.
- == CMD_USAGE_LOCK_LIST ==
- Sintaxis:
- cm lock list [revspec [revspec ...]] [flags]
- revspec: especificación de revisión. Usa 'cm help objectspec' para aprender
- cómo indicar las especificaciones de las revisiones.
- Opciones:
- flags:
- --server=<server>: muestra los elementos bloqueados en el
- servidor, sobreescribiendo el valor por defecto (tomado del espacio
- de trabajo actual o del fichero client.conf).
- Usa 'cm help objectspec' para más información sobre especificaciones.
- --onlycurrentuser: Filtra los resultados mostrando únicamente los
- bloqueos efectuados por el usuario actual de Plastic SCM.
- --onlycurrentworkspace: Filtra los resultados mostrando únicamente los
- bloqueos efectuados en el espacio de trabajo actual. (Se cotejan
- los resultados por nombre de espacio de trabajo).
- --ignorecase: Ignora mayúsculas y minúsculas cuando una servepath spec
- es usada. Con esta opción el comando funcionará para "/src/foo.c"
- incluso si el usuario indica"/sRc/fOO.c".
- == CMD_HELP_LOCK_LIST ==
- Ejemplos:
- cm lock list
- cm lock ls --server=DIGITALIS:8084
- cm lock ls serverpath:/src/foo.c#cs:99@default@localhost:8084
- cm lock ls revid:3521@default itemid:2381@secondary --onlycurrentuser
- cm lock ls --onlycurrentuser
- cm lock ls --onlycurrentuser --onlycurrentworkspace
- Notas:
- El comando muestra una lista de los elementos actualmente bloqueados en el
- servidor por defecto. También acepta una lista de especificaciones de
- revisión; en ese caso, solo se mostrarán los elementos bloqueados que
- estén asociados a al menos una de las revisiones especificadas como
- argumentos del comando. Adicionalmente, se puede utilizar el parámetro
- opcional --server=<server> para modificar el servidor que se
- consultará por defecto.
- El comando muestra una línea por cada bloqueo almacenado en el servidor,
- con la siguiente información:
- GUID del elemento bloqueado.
- Nombre de usuario que realizó el bloqueo.
- Ruta del elemento bloqueado (formato de ruta de servidor).
- Nombre del espacio de trabajo donde se realizó el bloqueo.
- == CMD_DESCRIPTION_LISTUSERS ==
- Lista los usuarios y grupos conocidos por el servidor.
- == CMD_USAGE_LISTUSERS ==
- Sintaxis:
- cm listusers server [opciones]
- server: especificación del servidor de repositorios.
- Usa 'cm help objectspec' para más información sobre especificaciones.
- Opciones:
- --onlyusers (-u): Lista sólo los usuarios.
- --onlygroups (-g): Lista sólo los grupos.
- --filter : Lista sólo aquellos usuarios y/o grupos que coincidan con el
- filtro de busqueda indicado.
- == CMD_HELP_LISTUSERS ==
- Ejemplos:
- cm listusers localhost:8084
- cm listusers localhost:8084 -u
- == CMD_DESCRIPTION_LOCATION ==
- Muestra la ruta completa donde se ubica el ejecutable del cliente.
- == CMD_USAGE_LOCATION ==
- Sintaxis:
- cm location
- == CMD_HELP_LOCATION ==
- == CMD_DESCRIPTION_LOCK ==
- Use este comando para administrar workspaces.
- == CMD_USAGE_LOCK ==
- Sintaxis:
- cm lock command [options]
- Comandos:
- list | ls
- unolck
- Para obtener más información sobre cada comando:
- cm lock comando --usage
- cm lock comando --help
- == CMD_HELP_LOCK ==
- Ejemplos:
- cm lock list
- cm lock
- (list es opcional si no hay argumentos)
- cm lock ls serverpath:/src/foo.c#cs:99@default@localhost:8084
- cm lock unlock 91961b14-3dfe-4062-8c4c-f33a81d201f5
- == CMD_DESCRIPTION_LOG ==
- Devuelve información sobre las revisiones creadas en la rama del changeset
- especificado, o de un intervalo de changesets.
- == CMD_USAGE_LOG ==
- Sintaxis:
- cm log [repSpec|csSpec] [--from|-f=csSpecFrom] [--allbranches|-a]
- [--csFormat=format] [--itemFormat=format] [--xml[=outputfile]]
- [--encoding] [--repositorypaths | --fullpaths]
- repSpec: Especificación del repositorio del cual se obtendrá información de
- las revisiones en sus changesets. Usa 'cm help objectspec' para más información.
- csSpec: Especificación del changeset del cual se obtendrá la información de
- sus revisiones. Usa 'cm help objectspec' para más información.
- Opciones:
- --from, -f=csSpecFrom: Especificación del changeset a partir del cual se
- mostrará información de revisiones. Dicho changeset no se incluye en la
- salida. Ignorado si se indica una especificación de un repositorio.
- --allbranches, -a: Muestra información de los changesets creados en un
- intervalo especificado para cualquier rama.
- --ancestors: muestra la información acerca de los changesets alcanzables
- siguiendo los enlaces de parentesco y de merge para el changeset dado
- ([csSpec]). Si el changeset from ([csSpecFrom]) también es proporcionado,
- este será usado como límite inferior para todos los paths.
- Notas: los cambios de los changeset no se mostrarán con esta opción.
- --csFormat=format: Especificación del formato en el cual se desea obtener
- la información de los changesets.
- --itemFormat=format: Especificación del formato en el cual se desea obtener
- la información de los items involucrados en cada changeset.
- --xml: Permite volcar la salida del comando en formato xml a la salida
- estándar. También se permite especificar un fichero de salida
- (--xml=output.xml).
- --fullpaths, --fp: Fuerza al comando a imprimir rutas de workspace
- absolutas siempre que sea posible.
- --repositorypaths: imprime rutas de repositorio en lugar de rutas
- de workspace. (Ésta opción prevalece sobre la opción "--fullpaths").
- --encoding: si se utiliza con la opción --xml, permite especificar el
- encoding con el que se guardará la salida del comando. Consulte la
- documentación de la MSDN para obtener la tabla completa de codificaciones
- soportadas y su formato; al final de la página en la columna "Name":
- http://msdn.microsoft.com/en-us/library/system.text.encoding.aspx
- == CMD_HELP_LOG ==
- Notas:
- Si no se especifica ni changeset ni opción, mostrará información de todos
- los changeset creados en el último mes en cualquier rama.
- Si solamente se incluye la opción -f=[csSpecFrom], se mostrará la
- información de todos los changesets desde el especificado hasta el momento
- actual en la rama en la cual se creó dicho changeset.
- Si se especifica la opción -a sin un intervalo, a todos los efectos el
- comando funcionará exactamente igual que si solamente se especificara
- [csSpec].
- Si se utiliza la opción -f=[csSpecFrom], la salida muestra información
- desde el changeset [csSpecFrom]+1 en adelante.
- El repositorio que se utiliza para mostrar la información de los changesets
- es el repositorio cargado en el path desde el cual se lanza el comando.
- Este comando acepta una cadena de formato para mostrar la salida.
- Se puede especificar un formato para la información de los changeset y
- otro para la información de los ítems.
- Cada parámetro de salida se identifica con un descriptor, y el usuario se
- puede referir a él escribiéndolo entre los símbolos '{' y '}'.
- Los parámetros de salida de este comando son los siguientes:
- csFormat=
- tab: Introduce un tabulador.
- newline: Introduce una nueva línea.
- changesetid: Número de changeset.
- branch: Información de rama.
- date: Fecha de creación del changeset.
- owner: Propietario del changeset.
- comment: Comentarios del changeset.
- items: Items afectados en el changeset.
- repository: Nombre del repositorio donde se encuentra el changeset.
- repserver: Nombre del servidor.
- itemFormat=
- tab: Introduce un tabulador.
- newline: Introduce una nueva línea.
- path: Ruta del ítem en disco.
- branch: Información de rama.
- owner: Propietario del changeset.
- date: Fecha de creación del changeset.
- shortstatus: Formato corto. Ver más abajo.
- fullstatus: Formato largo. Ver más abajo.
- Formato corto y su correspondiente formato largo:
- A = Added.
- C = Changed.
- M = Moved.
- D = Deleted.
- Éstas son cadenas de formato válidas:
- --csFormat="{newline}Changeset {changesetid} generado el día {date};{tab} ítems cambiados: {items}."
- --itemFormat="{newline}El ítem {path} se ha cambiado en la rama {branch} en el changeset {changesetid}."
- Ejemplos:
- cm log
- (Muestra información de todos los changesets creados en el último mes en
- cualquier rama).
- cm log cs:16
- (Muestra la información de los cambios realizados en el changeset 16 en la
- rama en que se creó dicho changeset).
- cm log cs:16 --csFormat="{newline}Changeset {changesetid} generado el día {date};{tab} ítems cambiados: {items}."
- (Muestra la información el el formato especificado).
- cm log --from=cs:20 cs:50
- (Muestra información de todos los cambios de cada changeset comprendido
- entre el 21 y el 50 en la rama br:/main).
- cm log --from=cs:20 cs:50 -a
- (Muestra información de todos los cambios de cada changeset comprendido
- entre el 21 y el 50 en todas las ramas del repositorio).
- cm log rep:myrep@localhost:8084
- (Muestra la información de todos los changeset de otro repositorio diferente
- al configurado en el selector del workspace. Puede ejecutarse fuera de
- un workspace).
- == CMD_DESCRIPTION_LS ==
- Lista el contenido de un workspace o de un árbol de changeset, rama o selector.
- == CMD_USAGE_LS ==
- Sintaxis:
- cm ls [opciones][rutas]
- rutas: Rutas de los items para obtener el listado.
- Opciones:
- --format=cadena: cadena de formato
- --symlink: aplica la operación al propio symlink y no a su destino
- --selector: obtiene el contenido del selector del workspace actual
- --selector="selector": obtiene el contenido del selector especificado
- --tree=spec: lista el árbol de un changeset (a partir de su número o guid)
- o de una rama (a partir de su nombre completo). Usa 'cm help objectspec'
- para aprender cómo indicar una especificación.
- -R|-r|--recursive: recorre los directorios recursivamente
- --xml: Permite volcar la salida del comando en formato xml a la salida
- estándar. También se permite especificar un fichero de salida
- (--xml=output.xml).
- --encoding: si se utiliza con la opción --xml, permite especificar el
- encoding con el que se guardará la salida del comando. Consulte la
- documentación de la MSDN para obtener la tabla completa de codificaciones
- soportadas y su formato; al final de la página en la columna "Name":
- http://msdn.microsoft.com/en-us/library/system.text.encoding.aspx
- == CMD_HELP_LS ==
- Notas:
- Las rutas se pueden escribir con metacaracteres (*, ?, ...)
- La salida del comando 'ls' se puede formatear usando una 'cadena de formato'
- en la cual cada parámetro se identifica mediante un nombre (o un número para
- mantener compatibilidad con las versiones anteriores).
- La cadena de formato por defecto es:
- "{<size>,10} {<date>:dd/MM/yyyy} {<date>:HH:mm} \
- {<type>,-6} {<location>,-12} {<co>,-5} \
- {name} {symlinktarget}"
- También se pueden especificar los nombres como {nombre} para cadenas de
- formato más sencillas:
- "{size} {date} {name}"
- Los nombres de los parámetros válidos para la cadena de formato son:
- size 0
- date 1
- type 2
- location 3 imprime br:branch#cset
- checkout 4
- co 4
- name 5
- changeset 6
- cset 6
- fullpath 7
- path 7
- repspec 8
- owner 9
- formattedsize 10
- revid 11
- parentrevid 12
- itemid 13
- brid 14
- repid 15
- server 16
- symlinktarget 17
- hash 18
- chmod 19
- wkpath 20 imprime un path relativo a la raíz del workspace
- branch 21
- newlocation 22 imprime cset@branch
- guid 23 imprime el guid de cada elemento (tarda más tiempo)
- itemguid 24
- transformed 25 muestra las reglas aplicadas en cada elemento que
- haya sufrido transformación.
- Se puede personalizar la salida del comando ls sin necesidad de especificar
- --format cada vez, definiendo la variable de entorno PLASTIC_LS_FORMAT.
- Ejemplos:
- cm ls
- cm ls c:\workspace\src
- cm ls --format={name} (muestra nombres de ficheros y directorios)
- cm ls --symlink (muestra información de los symlinks y no del fichero o
- directorio al que apunta. Disponible en entornos Linux/Mac/Unix)
- cm ls code --selector (muestra el contenido del subdirectorio 'code' cargado
- del selector asociado al workspace actual)
- cm ls /code --selector="rep 'arevalo' path '/' branch '/main'" (muestra el
- contenido del subdirectorio '/code' cargado del selector especificado.
- Es importante destacar que el path se especifica en "formato servidor")
- cm ls /code --tree=44@arevalo@cyl:7070 (lista el contenido del
- subdirectorio /code en el changeset 44 del repositorio 'arevalo' en el
- servidor 'cyl:7070')
- cm ls /code --tree=br:/main/scm13596@arevalo@cyl:7070 (lista el contenido del
- subdirectorio /code en el último changeset de la rama /main/scm13596
- del repositorio 'arevalo' en el servidor 'cyl:7070')
- cm ls /code --tree=ae1390ed-7ce9-4ec3-a155-e5a61de0dc77@arevalo@cyl:7070
- (lista el subdirectorio /code en el changeset con guid
- ae1390ed-7ce9-4ec3-a155-e5a61de0dc77
- en el repositorio 'arevalo' del servidor 'cyl:7070')
- == CMD_DESCRIPTION_TRIGGER_LIST ==
- Muestra la información relativa a los triggers de un determinado tipo.
- == CMD_USAGE_TRIGGER_LIST ==
- Sintaxis:
- cm trigger list [subtipo-tipo] [opciones]
- subtipo-tipo: momento de ejecución del trigger y operacion del trigger.
- Teclee 'cm showtriggertypes' para ver una lista completa de los tipos de
- trigger disponibles. Algunos ejemplos son:
- before-mkbranch
- after-mkwokspace
- after-setselector
- Opciones:
- --server=servidor: Lista los triggers del servidor especificado.
- --format: formato de salida.
- == CMD_HELP_TRIGGER_LIST ==
- Notas:
- Si no se especifica tipo, muestra todos los triggers del servidor
- configurado en el cliente.
- Formato de salida:
- {0}: Posición.
- {1}: Nombre del trigger.
- {2}: Ruta del ejecutable.
- {3}: Propietario.
- {4}: Tipo.
- {5}: Filtro del trigger.
- Ejemplos:
- cm trigger list after-mklabel
- cm tr ls before-mkbranch --server=myserver:8084
- == CMD_DESCRIPTION_MANIPULATESELECTOR ==
- Permite cambiar el selector para reflejar cambios en los comandos.
- == CMD_USAGE_MANIPULATESELECTOR ==
- Uso:
- cm manipulateselector [wkpath | wkspec] [options]
- path: Ruta del espacio de trabajo.
- wkspec: Especificación del espacio de trabajo. Usa 'cm help objectspec'
- para más información sobre especificaciones.
- Opciones:
- --atdate=date: Devuelve un selector que recreará el espacio de trabajo con
- los contenidos que se cargarían en la fecha especificada.
- == CMD_HELP_MANIPULATESELECTOR ==
- Notas:
- Si no se indica alguna de las rutas o especificaciones de espacio de
- trabajo el comando supondrá el directorio actual como ruta al espacio de
- trabajo.
- Ejemplos:
- cm manipulateselector c:\workspace --atdate=yyyy-MM-ddTHH:mm:ss
- cm manipulateselector --atdate=yyyy-MM-ddTHH:mm:ss
- cm manipulateselector > mySelector.txt --atdate=yyyy-MM-ddTHH:mm:ss
- cm manipulateselector wk:build_wk@BUILDER --atdate=yyyy-MM-ddTHH:mm:ss
- == CMD_DESCRIPTION_MERGE ==
- Mezcla el contenido de una rama con otra.
- == CMD_USAGE_MERGE ==
- Sintaxis:
- cm merge spec_origen [--merge] [--cherrypicking] [--forced]
- [--mergetype=merge_type]
- [--interval-origin=csetspec | --ancestor=csetspec]
- [--keepsource | --ks] [--keepdestination | --kd]
- [--automaticresolution=<conflict-types>+]
- [--subtractive] [--mount] [--printcontributors]
- [--noprintoperations] [--silent]
- [(--to=brspec | --destination=brspec) [--shelve]]
- [-c=str_comment | --commentsfile=<comments_file>]
- [--resolveconflict --conflict=index
- --resolutionoption=src|dst|<rename --resolutioninfo=strname>
- --mergeresultfile=path --solvedconflictsfile=path]
- [--nointeractiveresolution]
- [--machinereadable [--startlineseparator=sep]
- [--endlineseparator=sep] [--fieldseparator=sep]]
- spec_origen Especificación del origen del merge. Este puede ser:
- - una rama: [br:]/nombre_rama
- - una etiqueta: lb:nombre_etiqueta
- - un changeset: cs:numero_changeset
- - un shelve: sh:numero_shelve
- Usa 'cm help objectspec' para más información sobre
- especificaciones.
- Opciones:
- --merge Realiza el merge. Si no se especifica esta opción,
- se muestran los conflictos encontrados.
- --cherrypicking Realiza el merge de los cambios incluidos en los
- changesets origen. Esta opción no se considera si
- el origen del merge es una etiqueta.
- --forced No comprueba si el origen y el destino ya están
- conectados.
- Esta opción solo es válida para el merge de intervalo
- y para el cherrypicking.
- --mergetype Especifica el tipo de merge. Puede ser uno de los
- siguientes: onlyone, onlysrc, onlydst, try, forced.
- --interval-origin Especificación del changeset que queremos que actúe
- como origen del intervalo, de manera que el merge
- introducirá los cambios realizados desde el
- changeset común hasta el changeset especificado
- como origen del merge.
- --ancestor Alias para --interval-origin.
- --keepsource Acepta todos los cambios del contribuidor origen
- para elementos con conflictos.
- --keepdestination Preserva los cambios del contribuidor destino
- para elementos con conflictos.
- --automaticresolution Opción para resolver conflictos de directorio. Esta
- opción permite elegir si el contribuidor origen
- (source) o el contribuidor destino (destination)
- debe ser seleccionado automáticamente para
- resolver el conflicto.
- Debes especificar los tipos de conflictos separados
- por punto y coma ";".
- Más información en las notas.
- --subtractive Se utiliza para quitar cambios ya introducidos en
- el sistema, ya sea por un checkin o por un merge.
- El parámetro que se pasa al comando (spec_origen)
- es el origen desde donde se quieren eliminar los
- cambios. Puede ser la especificación de un
- changeset o de un intervalo de ellos. En el caso
- de un intervalo de changesets, se utiliza la opción
- --interval-origin para definir el origen del
- intervalo.
- --mount El punto de montaje del respositorio especificado.
- --printcontributors Imprime los contribuidores (base, origen y destino).
- --noprintoperations Resuelve las mezclas de manera silenciosa sin
- mostrar información sobre la resolución.
- --silent No muestra ninguna salida.
- --to | --destination Realiza una operación de merge-to a la rama de
- destino especificada, con resolución de conflictos
- completa. Una mezcla "merge-to" (o mezcla sin
- workspace) es una mezcla hecha en el lado del
- servidor. Mientras que en mezclas normales el
- destino es el workspace, en una operación de
- "merge-to" se debe especificar el destino (por
- eso se llama "to", 'hacia' en inglés).
- En la siguiente página se puede encontrar más
- información sobre esta funcionalidad:
- https://www.plasticscm.com/download/help/mergeto
- --shelve Crea un shelve con los cambios del resultado del
- merge (incluida la trazabilidad) en lugar de crear
- un changeset. Esta opción no es válida cuando el
- origen del merge es un shelve. Esta opción sólo
- está disponible para el merge en el lado del
- servidor (merge-to). Por ello, se requieren las
- opciones "--to" y "--merge".
- --no-dst-changes Asegura que el contribuidor destino no tiene cambios
- (que el changeset destino es también el antecesor
- común). Cuando hay cambios en el destino, no se
- permite hacer el merge.
- -c Añade un comentario al changeset creado en la
- operación de mezcla.
- --commentsfile Carga el comentario del fichero especificado y lo
- añade al changeset creado en la operación de
- mezcla.
- --resolveconflict (Usado principalmente por plugins. Más información
- en las notas.)
- Usado para resolver un conflicto de directorio.
- --conflict Usado con '--resolveconflict', especifica el
- índice del conflicto a resolver empezando por 1.
- --resolutionoption Usado con '--resolveconflict', indica el tipo de
- resolución de conflicto. Puede ser una de las
- siguientes opciones: src, dst, rename.
- Más información en las notas.
- --resolutioninfo Usado con '--resolveconflict', proporciona el
- nombre que se usará cuando la opción
- '--resolutionoption' es "rename".
- --mergeresultfile Usado con '--resolveconflict', guarda en un fichero
- la información del resultado de la mezcla entre
- diferentes llamadas. El fichero especificado se
- crea durante la primera llamada y se actualiza en
- cada siguiente llamada.
- --solvedconflictsfile Usado con '--resolveconflict', guarda en un fichero
- la información de los conflictos solucionados
- entre diferentes llamadas. El fichero especificado
- se crea durante la primera llamada y se actualiza
- en cada siguiente llamada.
- --nointeractiveresolution (Usado principalmente por plugins. Más información
- en las notas.)
- Evita preguntar al usuario cuando hay un conflicto
- manual. Así, por ejemplo, un conflicto de directorio
- no podrá ser resuelto.
- --machinereadable (Usado principalmente por plugins. Más información
- en las notas.)
- Muestra la salida en un formato fácil de tratar.
- --startlineseparator Usado con '--machinereadable', especifica cómo
- deben comenzar las líneas. Por defecto, una cadena
- de texto vacía.
- --endlineseparator Usado con '--machinereadable', especifica cómo
- deben terminar las líneas. Por defecto, una cadena
- de texto vacía.
- --fieldseparator Usado con '--machinereadable', especifica cómo
- deben separarse los campos. Por defecto, un
- espacio en blanco.
- == CMD_HELP_MERGE ==
- Notas:
- Este comando se utiliza para meclar cambios entre dos ramas, o entre una
- etiqueta y una rama. El destino del merge siempre debe ser una rama.
- El origen del merge se especifica como argumento.
- El destino de la rama es (salvo en el merge-to) el contenido actual del
- workspace.
- Por ejemplo, para mostrar los elementos que serán mezclados desde la rama
- task001 a la rama principal, el selector debe apuntar a la rama principal,
- el espacio de trabajo debe estar actualizado, y entonces ejecutar:
- cm merge br:/task001
- Para que el merge se realice, se añade el modificador "--merge":
- cm merge br:/task001 --merge
- El origen del merge es la especificación de un objeto (rama, etiqueta,
- changeset o shelve).
- Usa 'cm help objectspec' para más información sobre especificaciones.
- Para resolver automáticamente conflictos de directorio debes usar la opción
- "--automaticresolution" y especificar el tipo de conflicto seguido por el
- contribuidor (origen o destino) que se seleccionará durante el merge.
- (Recuerda separar cada par "tipo de conflicto"-"contribuidor" con punto y
- coma (;).)
- Por ejemplo:
- cm merge cs:2634 --merge --automaticresolution=eviltwin-src;changedelete-src
- (La operación de merge desde el changeset 2634 resuelve los conflictos
- "eviltwin" y "changedelete" manteniendo al contribuidor origen ("-src")
- en ambos conflictos.)
- - El sufijo "-src" añadido después del tipo de conflicto indica al comando
- merge que debe mantener los cambios del contribuidor origen (source).
- - El sufijo "-dst" indicará que se mantendrán los cambios del contribuidor
- destino (destination).
- Esta es la lista de tipos de conflictos que soporta el comando merge:
- "movedeviltwin", "eviltwin", "changedelete", "deletechange", "movedelete",
- "deletemove", "loadedtwice", "addmove", "moveadd", "divergentmove",
- "cyclemove", "all".
- El valor "all" sobrescribe al resto de opciones. En el siguiente ejemplo,
- el conflicto "eviltwin-dst" será ignorado:
- cm merge br:/main/task062 --merge --automaticresolution=all-src;eviltwin-dst
- Consulta el siguiente enlace para aprender más sobre conflictos de merge:
- https://www.plasticscm.com/download/help/directorymerges
- Estas son las opciones para el argumento --mergetype:
- onlyone Merge automático si solo uno de los contribuidores modificó
- el elemento.
- onlysrc Merge automático si solo el contribuidor origen modificó
- el elemento.
- onlydst Merge automático si solo el contribuidor destino modificó
- el elemento.
- try Merge automático si solo un contribuidor ha modificado la
- parte del fichero en conflicto (para cada conflicto).
- forced Intentar resolver siempre los conflictos no automáticos.
- Estas son las opciones que se usan principalmente por plugins e integraciones:
- - "--resolveconflict" para resolver un conflicto de directorio. Se
- deben usar las siguientes opciones:
- - "--conflict" es el índice del conflicto que se quiere resolver
- (empezando por 1).
- - "--resolutionoption" indica el tipo de resolución de conflicto.
- Puede ser:
- - "src" para mantener el cambio del origen y descartar el
- cambio del destino
- - "dst" para mantener el cambio del destino y descartar el
- cambio del origen
- - "rename" (solo si el tipo de conflicto soporta esta
- resolución), para renombar el destino al nombre
- proporcionado en la opción "--resolutioninfo".
- - "--resolutioninfo" para proporcionar el nombre a usar
- con el tipo de resolución "rename"
- - "--mergeresultfile" y "--solvedconflictsfile", ambos se usan
- para guardar informacación de la mezcla entre las diferentes
- llamadas.
- - "nointeractiveresolution" indica a la mezcla que no pregunte al usuario
- en caso de necesitarse una resolución manual de un conflicto.
- - "--machinereadable" y "--startlineseparator", "--endlineseparator",
- "fieldseparator" se usan para imprimir la salida a un formato fácil
- de leer, tratar o parsear.
- Por ejemplo:
- cm merge --machinereadable --startlineseparator=start@_@line
- --endlineseparator=new@_@line --fieldseparator=def#_#sep
- --mergeresultfile=C:\Users\Borja\AppData\Local\Temp\2tmp4D6C.tmp
- --solvedconflictsfile=C:\Users\Borja\AppData\Local\Temp\2tmp4D6D.tmp
- --resolveconflict --conflict=1 --resolutionoption=rename --resolutioninfo=bin_dst
- br:/main/task --merge
- Ejemplos:
- cm merge br:/task001
- (No realiza la mezcla, simplemente escribe los elementos que van a ser
- mezclados.)
- cm merge br:/task001 --merge
- (Realiza el merge desde la rama task001.)
- cm merge cs:5 --merge --cherrypicking --interval-origin=cs:2
- (Cherrypick del intervalo de changesets (2,5].)
- cm merge cs:8 --merge --subtractive --keepdestination
- (Merge sustractivo del changeset 8, preservando los cambios del destino
- para aquellos elementos con conflictos.)
- cm merge br:/main/task001 --to=br:/main --merge -c="Integrated new UI"
- (Realiza el merge en el lado del servidor -a.k.a. "merge-to"-, desde la
- rama task001 hasta la rama main, con un comentario.)
- cm merge br:/main/task001 --to=br:/main --merge --shelve
- (Realiza el merge en el lado del servidor desde la rama task001 a la rama
- main y deja el resultado en un shelve.)
- cm merge sh:2 --to=br:/main --merge --no-dst-changes
- (Aplica el shelve 2 en la rama main solo si fue creado desde la cabeza
- actual de main.)
- == CMD_DESCRIPTION_ATTRIBUTE_CREATE ==
- Crea un atributo nuevo.
- == CMD_USAGE_ATTRIBUTE_CREATE ==
- Sintaxis:
- cm attribute create nombre
- nombre: Nombre del atributo.
- Opciones:
- -c: Añade un comentario al atributo creado.
- --commentsfile=comment.txt: Carga el comentario del fichero especificado.
- == CMD_HELP_ATTRIBUTE_CREATE ==
- Ejemplos:
- cm attribute create Estado
- == CMD_DESCRIPTION_BRANCH ==
- Use este comando para administrar ramas.
- == CMD_USAGE_BRANCH ==
- Sintaxis:
- cm branch command [options]
- Comandos:
- [(create)|delete|rename|history|showmain|showmerges]
- Para obtener más información sobre cada comando:
- cm branch command --usage
- cm branch command --help
- == CMD_HELP_BRANCH ==
- Ejemplos:
- cm branch /main/scm21345
- cm branch create /main/scm21345
- cm branch delete /main/scm21345
- cm branch rename /main/scm21345 scm21346
- cm branch history /main/scm21345
- cm branch showmain
- cm branch showmerges file.txt
- == CMD_DESCRIPTION_BRANCH_CREATE ==
- Crea una rama en el repositorio actual.
- == CMD_USAGE_BRANCH_CREATE ==
- Sintaxis:
- cm branch | br [create | mk] brspec [--changeset=csetspec | --label=lbspec]
- [-c=str_comment | -commentsfile=<comments_file>]
- brspec Nombre o especificación de la nueva rama.
- Usa 'cm help objectspec' para más información sobre
- especificaciones.
- Opciones:
- --changeset Changeset usado como punto de inicio de la nueva rama.
- Especificación del changeset: [cs:]cs_number.
- --label Etiqueta usada como punto de inicio de la nueva rama.
- Usa 'cm help objectspec' para más información sobre
- especificaciones.
- -c Rellena el comentario de la nueva rama con el texto
- especificado.
- --commentsfile Rellena el comentario de la nueva rama con el contenido
- del fichero de texto especificado.
- == CMD_HELP_BRANCH_CREATE ==
- Notas:
- Para crear una rama de primer nivel, especifique el nombre sin jerarquía.
- Por ejemplo:
- cm br /dev
- Si no se especifica el parámetro 'changeset', se utilizará el último
- changeset de la rama madre. En caso de que la rama sea de primer nivel, se
- utilizará como base el changeset 0.
- Para especificar comentarios use el switch "-c" o "-m" del siguiente modo:
- cm branch main/task001 -c="Este es el comentario"
- cm branch main/task001 -m "Este es el comentario"
- Se puede escoger qué editor se lanzará para escribir el comentario
- mediante la variable de entorno PLASTICEDITOR. Si dicha variable de entorno
- tiene un valor, y no se especifica un comentario, el editor escogido se
- abrirá automáticamente para que se espefique el comentario.
- Ejemplos:
- cm branch task001
- cm branch create task001
- cm branch mk task001
- cm br mk task001
- (Crea la rama de primer nivel 'task001' en el repositorio al que apunta
- el workspace actual.)
- cm branch br:/task001/task002
- (Crea la rama 'task002' como hija de 'task001'.)
- cm br /main/task001@myrep@myserver:8084 -c="my comment"
- (Crea la rama 'task001' como hija de 'main' en el repositorio
- 'myrepo@myserver:8084' con el comentario 'my comment'.)
- cm br mk br:/main/task001 --changeset=2837 -commentsfile=commenttask001.txt
- (Crea la rama 'task001' tomando como base el changeset '2837' de la rama
- 'main' con el comentario contenido en el fichero 'commenttask001.txt'.)
- == CMD_DESCRIPTION_BRANCH_DELETE ==
- Borra una o más ramas.
- == CMD_USAGE_BRANCH_DELETE ==
- Sintaxis:
- cm branch | br delete | rm <spec_rama>+
- spec_rama: Ramas a borrar, separadas por espacios.
- Usa 'cm help objectspec' para obtener más información
- sobre la especificación de ramas.
- == CMD_HELP_BRANCH_DELETE ==
- Notas:
- Este comando borra una o más ramas.
- Ejemplos:
- cm branch delete /main/task001
- (Borra la rama con nombre 'task001' que sea hija de 'main' en el
- repositorio al que apunta el workspace actual.)
- cm br rm main/task002 /main/task012@reptest@myserver:8084
- (Borra la rama '/main/task002' del repositorio al que apunta el workspace
- actual, y la rama '/main/task012' del repositorio 'reptest@myserver:8084'.)
- == CMD_DESCRIPTION_BRANCH_RENAME ==
- Renombra una rama.
- == CMD_USAGE_BRANCH_RENAME ==
- Sintaxis:
- cm branch | br rename spec_rama nuevo_nombre
- spec_rama: Especificación de la rama que se va a renombrar.
- Usa 'cm help objectspec' para obtener más información sobre
- la especificación de ramas.
- nuevo_nombre Nuevo nombre para la rama.
- == CMD_HELP_BRANCH_RENAME ==
- Notas:
- Este comando renombra una rama.
- Ejemplos:
- cm branch rename /main/task0 task1
- (Renombra la rama '/main/task0' a '/main/task1'.)
- cm br rename br:/main@reptest@server2:8084 secondary
- (Renombra la rama principal del repositorio 'reptest' a 'secondary'.)
- == CMD_DESCRIPTION_BRANCH_HISTORY ==
- Muestra la historia de una rama (merges y punto de partida).
- == CMD_USAGE_BRANCH_HISTORY ==
- Sintaxis:
- cm branch | br history spec_rama
- [--dateformat=date_format] [--machinereadable]
- spec_rama Especificación de la rama para obtener la historia.
- Usa 'cm help objectspec' para obtener más información.
- Opciones:
- --dateformat Formato utilizado para mostrar fechas.
- --machinereadable Devuelve el resultado en un formato sencillo de
- parsear.
- == CMD_HELP_BRANCH_HISTORY ==
- Ejemplos:
- cm branch history br:/main/scm001@myrepository@myserver:8084
- (Muestra la historia de '/main/scm001' en el repositorio 'myrepository'.)
- cm br history main --dateformat="yyyy, dd MMMM" --machinereadable
- (Muestra la historia de 'main' con un formato de fecha determinado y con
- un formato sencillo de parsear.)
- == CMD_DESCRIPTION_BRANCH_SHOWMAIN ==
- Muestra la rama principal del repositorio.
- Este es un comando de automatización, diseñado para automatizar el comando cm.
- Muy probablemente la rama principal de sus repositorios sea /main.
- == CMD_USAGE_BRANCH_SHOWMAIN ==
- Sintaxis:
- cm branch | br showmain [repspec] [--encoding=name]
- [--format=format_str] [--dateformat=date_format]
- repspec Especificación del repositorio donde buscar la rama principal.
- Si no se especifica, se utilizará el repositorio al que apunte
- el workspace actual.
- Opciones:
- --encoding Permite especificar la codificación con el que se
- guardará la salida del comando. Consulte la
- documentación de la MSDN para obtener la tabla completa
- de codificaciones soportadas y su formato; al final de
- la página en la columna "Name":
- http://msdn.microsoft.com/en-us/library/system.text.encoding.aspx
- --format Devuelve el mensaje de salida con un formato determinado.
- Más información en las notas.
- --dateformat Formato utilizado para mostrar fechas.
- == CMD_HELP_BRANCH_SHOWMAIN ==
- Notas:
- Este comando muestra la rama principal de un repositorio.
- Este comando acepta una cadena especificando el formato con el que se
- debe mostrar la salida. Los parámetros de salida son los siguientes:
- {id} Id de la rama.
- {comment} Comentario.
- {date} Fecha.
- {owner} Propietario.
- {name} Nombre.
- {parent} Nombre de la rama madre.
- {repository} Repositorio.
- {repname} Nombre del repositorio.
- {repserver} Servidor.
- {changeset} Id del último changeset de la rama.
- Ejemplos:
- cm branch showmain
- (Muestra la rama principal del repositorio del workspace actual.)
- cm branch showmain repo@repserver:8084
- (Muestra la rama principal del repositorio 'repo' en el servidor
- 'repserver:8084'.)
- cm br showmain --dateformat="yyyy, dd MMMM" --encoding=utf-8
- (Muestra la rama principal del repositorio, con las fechas en un determinado
- formato, y la salida está codificada en utf-8.)
- cm br showmain --format="{id} - {name}"
- (Muestra la rama principal del repositorio, devolviendo únicamente su id y
- nombre.)
- == CMD_DESCRIPTION_BRANCH_SHOWMERGES ==
- Muestra información sobre elementos pendientes en ramas a mezclar.
- == CMD_USAGE_BRANCH_SHOWMERGES ==
- Este es un comando de automatización, diseñado para automatizar el comando cm.
- Sintaxis:
- cm branch | br showmerges <item_path>+
- [--format=format_str] [--dateformat=date_format]
- Opciones:
- --format Devuelve el mensaje de salida con un formato determinado.
- Más información en las notas.
- --dateformat Formato utilizado para mostrar fechas.
- == CMD_HELP_BRANCH_SHOWMERGES ==
- Notas:
- Este comando acepta una cadena especificando el formato con el que se
- debe mostrar la salida. Los parámetros de salida son los siguientes:
- {id} Id de la rama.
- {comment} Comentario.
- {date} Fecha.
- {name} Nombre.
- {owner} Propietario.
- {parent} Nombre de la rama madre.
- {parentid} Id de la rama madre.
- {repid} Id del repositorio.
- {repository} Repositorio.
- {repname} Nombre del repositorio.
- {repserver} Servidor.
- Ejemplos:
- cm branch showmerges file.txt
- (Muestra las ramas involucradas en el merge pendiente del fichero file.txt.)
- cm branch showmerges file.txt --format="{date} {name}" --dateformat="ddMMyy"
- (Muestra las ramas involucradas en el merge, mostrando solo la fecha y el
- nombre, con las fechas en un determinado formato.)
- == CMD_DESCRIPTION_REPOSITORY ==
- Administra repositorios.
- == CMD_USAGE_REPOSITORY ==
- Sintaxis:
- cm repository | repo commmand [options]
- Comandos:
- create | mk
- delete | rm
- list | ls
- rename
- add
- Para obtener más información sobre cada comando:
- cm repository command --usage
- cm repository command --help
- == CMD_HELP_REPOSITORY ==
- Ejemplos:
- cm repository
- cm repository list
- cm repository newrepo
- cm repository create newrepo
- cm repository rename oldname newname
- cm repository add C:\repo\
- == CMD_DESCRIPTION_REPOSITORY_CREATE ==
- Crea un repositorio en un servidor.
- == CMD_USAGE_REPOSITORY_CREATE ==
- Sintaxis:
- cm repository rep_name
- cm repository servidor <nombre_repositorio>+
- cm repository [create | mk] rep_name
- servidor Especificación del servidor.
- Usa 'cm help objectspec' para más información sobre
- especificaciones.
- nombre_repositorio Nombre del nuevo repositorio.
- == CMD_HELP_REPOSITORY_CREATE ==
- Ejemplos:
- cm repository MyRep
- cm repo 192.168.1.140:8087 Rep01 Rep01/ModuleA Rep01/ModuleB
- cm repo create Rep01
- cm repo mk list
- == CMD_DESCRIPTION_REPOSITORY_DELETE ==
- Borra un repositorio del servidor.
- == CMD_USAGE_REPOSITORY_DELETE ==
- Sintaxis:
- cm repository delete | rm repositoryspec
- repositoryspec Especificación del repositorio a borrar.
- Usa 'cm help objectspec' para obtener más información
- sobre la especificación de repositorios.
- == CMD_HELP_REPOSITORY_DELETE ==
- Nota:
- Elimina un repositorio del servidor de repositorios.
- No borra los datos del sistema gestor de bases de datos,
- simplemente desconecta el repositorio del sistema de modo
- que ya no sea accesible (los datos pueden ser añadidos de
- nuevo, véase 'cm repository add').
- Ejemplos:
- cm repository delete myrepository@repserver:myserver:8084
- cm repository rm myrepository@myserver:8084
- cm repo rm myrepository
- == CMD_DESCRIPTION_REPOSITORY_LIST ==
- Lista los repositorios de un servidor.
- == CMD_USAGE_REPOSITORY_LIST ==
- Sintaxis:
- cm repository
- cm repository list [servidor] [--format=str_format]
- servidor Especificación del servidor.
- Usa 'cm help objectspec' para más información sobre
- especificaciones.
- --format Devuelve la salida en el formato especificado.
- == CMD_HELP_REPOSITORY_LIST ==
- Notas:
- Este comando acepta una cadena de texto formateada para mostrar la
- salida.
- Los parámetros de salida del comando son los siguientes:
- {repid} | {0} Identificador del repositorio.
- {repname} | {1} Nombre del repositorio.
- {repserver} | {2} Nombre del servidor del repositorio.
- {repowner} | {3} Propietario del repositorio.
- {repguid} | {4} Identificador único del repositorio.
- {tab} Inserta un tabulador.
- {newline} Inserta una nueva línea.
- Si el valor del formato es "TABLE", la salida se imprimirá en formato
- tabla con los siguientes campos: {repid}, {repname} y {repserver}.
- Ejemplos:
- cm repository
- (Lista todos los repositorios.)
- cm repository list localhost:8084 --format="{1, -20} {3}"
- (Escribe el campo "nombre del repositorio" utilizando 20 espacios,
- alineado a la izquierda, un espacio, y a continuación el propietario.)
- cm repository ls localhost:8084 --format="{repname, -20} {repowner}"
- (Escribe lo mismo que el ejemplo anterior.)
- cm repo ls localhost:8084 --format=TABLE
- (Escribe la lista de repositorios en formato tabla con los siguientes
- campos: el id del repositorio, el nombre del repositorio, y el nombre
- del servidor de repositorios.)
- == CMD_DESCRIPTION_REPOSITORY_RENAME ==
- Renombra un repositorio.
- == CMD_USAGE_REPOSITORY_RENAME ==
- Sintaxis:
- cm repository rename [spec_repositorio] nuevo_nombre
- spec_repositorio Especificación del repositorio a renombrar.
- Usa 'cm help objectspec' para obtener más
- información sobre la especificación de repositorios.
- nuevo_nombre Nuevo nombre para el repositorio.
- == CMD_HELP_REPOSITORY_RENAME ==
- Notas:
- Este comando renombre un repositorio.
- Si no se proporciona ninguna especificación de repositorio, se tomará el
- repositorio actual como spec_repositorio.
- Ejemplos:
- cm repository rename desarrollo
- (El repositorio actual se renombra a 'desarrollo'.)
- cm repo rename rep:default@SERVER:8084 desarrollo
- (El repositorio 'default' del servidor 'SERVER' se renombra a 'desarrollo'.)
- == CMD_DESCRIPTION_REPOSITORY_ADD ==
- Añade una base de datos de repositorio al sistema.
- == CMD_USAGE_REPOSITORY_ADD ==
- Uso:
- cm repository add databasename nombre repserverspec
- databasename El nombre de la base de datos a reconectar.
- nombre Nombre del repositorio.
- repserverspec Especificación del servidor de repositorios.
- Usa 'cm help objectspec' para obtener más
- información sobre la especificación de servidores.
- == CMD_HELP_REPOSITORY_ADD ==
- Nota:
- Reconecta una base de datos de repositorio al servidor. Puede
- usarse para mover un repositorio de un servidor a otro o para
- restaurar datos.
- Ejemplos:
- cm repository add rep_27 myrepository myserver:8084
- == CMD_DESCRIPTION_TRIGGER_CREATE ==
- Crea un nuevo trigger en un determinado servidor.
- == CMD_USAGE_TRIGGER_CREATE ==
- Sintaxis:
- cm trigger create subtipo-tipo nombre script [opciones]
- subtipo-tipo: momento de ejecución del trigger y operacion del trigger.
- Teclee 'cm showtriggertypes' para ver una lista completa de los tipos de
- trigger disponibles. Algunos ejemplos son:
- before-mkbranch
- after-mkwokspace
- after-setselector
- nombre: nombre que queremos dar al trigger.
- script: ruta del servidor en la que se encuentra el script
- que deseamos ejecutar. Si esta ruta comienza por "webtrigger ", se
- considerará como web trigger. Consulte la ayuda del comando para obtener
- detalles adicionales.
- Opciones:
- --position=posicion: Intenta crear el trigger en la posición especificada
- si esta no esta cogida por otro del mismo tipo.
- --filter=filtro: Comprueba sólo aquellos elementos que coincidan con el
- filtro de busqueda indicado. Se pueden especificar varios filtros
- separados por comas, si es así el el trigger se ejecutará si el elemento
- coincide con cualquiera de los filtros. Si uno de los filtros comienza
- con "rep:", el trigger se ejecutara sólo para las operaciones realizadas
- sobre el repositorio con el nombre especificado (ver ejemplo).
- --server=servidor: Crea el trigger en el servidor especificado. Si no se
- especifica ninguno se crea en el servidor configurado en el cliente.
- == CMD_HELP_TRIGGER_CREATE ==
- Notas:
- Web triggers: Para crear web triggers, escriba "webtrigger <target-uri>"
- como comando de trigger. En este caso, el trigger ejecutará una consulta
- POST contra el URI especificado, en la que el cuerpo de la petición
- contiene un diccionario JSON con las variables de entorno del trigger.
- También estará presente una clave INPUT apuntando a un vector de cadenas de
- texto para aquellos triggers que escriban en la entrada estándar de sus
- comandos asociados.
- Ejemplos:
- cm trigger create after-setselector "backup" "/path/al/script" --position=4
- cm tr mk before-mklabel new "/path/al/script" --server=myserver:8084
- cm tr mk after-mklabel Log "/path/al/script" --filter="rep:myRep,LB*"
- Este trigger se ejecutará sólo si el nombre de la etiqueta creada
- comienza por 'LB' y si está siendo creada en el repositorio 'myrep'.
- cm tr mk after-checkin Notify "webtrigger http://myserver.org/endpoint"
- == CMD_DESCRIPTION_MOVE ==
- Mueve o renombra un ítem.
- == CMD_USAGE_MOVE ==
- Sintaxis:
- cm move ruta_origen ruta_destino
- ruta_origen: Ruta origen del ítem.
- ruta_destino: Ruta destino del ítem.
- == CMD_HELP_MOVE ==
- Notas:
- Este comando mueve o renombra un ítem en el repositorio.
- Los cambios también se realizan en el sistema de ficheros local.
- Si la ruta de origen es un fichero, el destino puede ser un fichero o un
- directorio. En el primer caso, el fichero se renombra, si no, el ítem se
- mueve al directorio destino.
- Si la ruta de origen es un directorio, la ruta destino ha de serlo también.
- Requisitos para mover o renombrar un ítem:
- El ítem ha de estar controlado por Plastic SCM.
- El directorio padre del ítem origen y del ítem destino han de estar desprotegidos.
- Ejemplos:
- cm move fichero.txt fichero.old (renombra el ítem)
- cm move .\fichero.old .\antiguos (mueve fichero.old al directorio antiguos)
- cm move .\src .\src2 (renombra el directorio)
- == CMD_DESCRIPTION_LABEL ==
- Este comando permite al usuario efectuar operaciones con etiquetas.
- == CMD_USAGE_LABEL ==
- Sintaxis:
- cm label | lb command [options]
- Comandos:
- create | mk
- delete | rm
- rename
- Para obtener más información sobre cada uno de los comandos ejecute:
- cm label command --usage
- cm label command --help
- == CMD_HELP_LABEL ==
- Ejemplos
- cm label myNewLabel cs:42
- (el comando 'create' es opcional)
- cm label rename myNewLabel newLabelName
- cm label delete newLabelName
- == CMD_DESCRIPTION_LABEL_CREATE ==
- Crea una etiqueta nueva o etiqueta una changeset dado.
- == CMD_USAGE_LABEL_CREATE ==
- Sintaxis:
- cm label [create] spec_etiqueta [spec_changeset | ruta]
- [--allxlinkedrepositories]
- [-c=str_comment | -commentsfile=<comments_file>]
- spec_etiqueta: Especificación de la etiqueta. Usa 'cm help objectspec' para
- obtener más información sobre especificaciones.
- spec_changeset: Nombre o especificación del changeset a etiquetar. Usa
- 'cm help objectspec' para obtener más información sobre especificaciones.
- ruta: Ruta del workspace a etiquetar
- Si no se especifica spec_changeset ni ruta se asumirá el directorio actual
- como workspace a etiquetar.
- Opciones:
- --allxlinkedrepositories (-s): Crea la etiqueta en todos los repositorios
- enlazados.
- -c: Añade un comentario a la etiqueta creada.
- --commentsfile=comment.txt: Carga el comentario del fichero especificado.
- == CMD_HELP_LABEL_CREATE ==
- Notas:
- Si existe una variable de entorno llamada PLASTICEDITOR apuntando al
- ejecutable de un editor de texto el editor se abrirá automáticamente
- para que especifique un comentario.
- Ejemplos:
- cm label create lb:BL001 cs:1203 -commentsfile=commentlb001.txt
- cm label BL002 cs:=1203 -c="first release"
- == CMD_DESCRIPTION_LABEL_DELETE ==
- Borra una o más etiquetas.
- == CMD_USAGE_LABEL_DELETE ==
- Sintaxis:
- cm label delete spec_etiqueta1 spec_etiqueta2 ...
- spec_etiqueta: Etiquetas a borrar, separadas por espacios.
- Usa 'cm help objectspec' para obtener más información
- sobre la especificación de etiquetas.
- == CMD_HELP_LABEL_DELETE ==
- Notas:
- Este comando borra una o más etiquetas creadas previamente.
- Ejemplos:
- cm label delete lb:BL001 (Se borra la etiqueta 'BL001')
- cm label delete lb:BL001 lb:BL002
- == CMD_DESCRIPTION_LABEL_RENAME ==
- Renombra una etiqueta.
- == CMD_USAGE_LABEL_RENAME ==
- Sintaxis:
- cm label rename spec_etiqueta nuevo_nombre
- sepec_etiqueta: Especificación de la etiqueta que se va a renombrar.
- Usa 'cm help objectspec' para obtener más información sobre
- la especificación de etiquetas.
- nuevo_nombre: Nuevo nombre para la etiqueta.
- == CMD_HELP_LABEL_RENAME ==
- Notas:
- Este comando renombra una etiqueta.
- Ejemplos:
- cm label rename lb:BL001 BL002
- (La etiqueta 'BL001' se renombra a 'BL002')
- == CMD_DESCRIPTION_OBLITERATE ==
- DEPRECATED
- == CMD_USAGE_OBLITERATE ==
- == CMD_HELP_OBLITERATE ==
- == CMD_DESCRIPTION_OBJECTSPEC ==
- Explica cómo escribir object specs (especificaciones de objetos).
- == CMD_USAGE_OBJECTSPEC ==
- Sintaxis:
- cm objectspec
- Para obtener toda la información sobre cómo construir specs de objetos.
- == CMD_HELP_OBJECTSPEC ==
- Muchos comandos de Plastic SCM esperan 'object specs' como entrada para
- referirse a un objeto concreto (normalmente una rama, un changeset, un
- repositorio, etc.).
- Esta documentación describe los diferentes tipos de "specs" disponibles y
- cómo construirlas.
- Cada tipo de especificación comienza con un tag único, por ejemplo "rep:" o "cs:".
- El tag se debe indicar para comandos que reciban especificaciones generales
- de objetos, como por ejemplo "cm setowner object_spec", pero a menudo se pueden
- omitir en comandos que solo acepten un tipo de especificación, como por ejemplo
- "cm getfile revision_spec".
- == Repository server spec (repserverspec) ==
- repserver:name:port
- Ejemplos:
- cm lrep repserver:skull:8084
- cm lrep skull:8084
- Nota:
- Lo llamamos "rep" server spec (con el 'rep' delante) en lugar de
- simplemente 'server spec' por motivos históricos. Hace mucho tiempo
- Plastic tenía servidores de workspaces y repositorios separados, y
- el nombre ha sobrevivido.
- == Repository spec (repspec) ==
- rep:rep_name@[repserverspec]
- Ejemplos:
- cm showowner rep:codice@localhost:6060
- (Aquí la "rep:" es necesaria porque el comando showowner admite
- todo tipo de objetos).
- == Branch spec (brspec) ==
- br:[/]br_name[@repspec]
- Ejemplos:
- cm switch br:/main@rep:plastic@repserver:skull:9095
- (En este caso "br:", "rep:" y "repserver:" no son necesarios así
- que el comando se puede escribir de forma mucho más compacta:
- "cm switch main@plastic@skull:9095" .)
- cm find revisions "where branch='br:/main/task001'"
- Nota:
- La barra inicial '/' en las ramas no es obligatoria. Solíamos escribir
- todas las ramas como /main, /main/task001, etc. Pero ahora preferimos
- user formatos más cortos tipo main, main/task001.
- == Changeset spec (csetspec) ==
- cs:cs_number|cs_guid[@repspec]
- Se puede especificar el número o el GUID del changeset.
- Ejemplos:
- cm ls /code --tree=ae1390ed-7ce9-4ec3-a155-e5a61de0dc77@code@skull:7070
- == Label spec (labelspec) ==
- lb:lb_name[@repspec]
- Ejemplos:
- cm switch lb:RELEASE2.0
- cm switch lb:RELEASE1.4@myrep@MYSERVER:8084
- == Revision spec ==
- Hay distintos tipos de specs de revisiones:
- rev:item_path[#(brspec|csetspec|labelspec)]
- rev:serverpath:item_path#(brspec|cset_spec|lb_spec)
- rev:revid:rev_id[@rep_spec]
- rev:itemid:item_id#(br_spec|cset_spec|lb_spec)
- Ejemplos:
- cm diff rev:readme.txt#cs:19 rev:readme.txt#cs:20
- cm diff serverpath:/doc/readme.txt#cs:19@myrepo \
- serverpath:/doc/readme.txt#br:/main@myrepo@localhost:8084
- cm cat revid:1230@rep:myrep@repserver:myserver:8084
- == Item spec ==
- Se usa muy raras veces.
- item:path
- Ejemplo:
- cm find revision "where item='item:.'"
- == Attribute spec ==
- att:att_name[@repspec]
- Ejemplo:
- cm rmattributereal att:merged@code@doe:8084 cs:25@code@doe:8084
- == Workspace specs ==
- wk:name@clientmachine
- Se usa muy poco porque solamente aplica a los comandos relacionados con los
- workspaces. Es útil para indicar el nombre del workspace en lugar del path.
- Ejemplo:
- cm showselector wk:codebase@modok
- Nota:
- Estas specs vienen de los viejos tiempos de Plastic SCM 2.x en los que
- los 'workspace servers' eran una forma de almacenar metadatos de forma
- centralizada. Se eliminaron por cuestiones de rendimiento.
- == CMD_DESCRIPTION_PARTIAL ==
- Ejecuta comandos en un espacio de trabajo parcial.
- == CMD_USAGE_PARTIAL ==
- Sintaxis:
- cm partial comando [opciones]
- Comandos:
- configure
- add
- undo
- co | checkout
- unco | undocheckout
- ci | checkin
- mv | move
- rm | remove
- stb | switch
- upd | update
- Para obtener más información de cada uno de los comandos ejecute:
- cm partial comando --usage
- cm partial comando --help
- == CMD_HELP_PARTIAL ==
- Ejemplos:
- cm partial configure +/fondo-azul.png
- cm partial update paisaje-1024.png
- cm partial checkin ojos-verde.png ojos-negro.png
- == CMD_DESCRIPTION_PARTIAL_ADD ==
- Añade un ítem al repositorio.
- == CMD_USAGE_PARTIAL_ADD ==
- Sintaxis:
- cm partial add [-R | -r | --recursive] [--silent] [--parents] [--ignorefailed]
- [--skipcontentcheck] <rutas>+
- rutas Rutas de los ítems a añadir separados por espacios.
- Usa comillas (") para especificar rutas con espacios.
- Usa * para añadir todo el contenido del directorio
- actual.
- Opciones:
- -R Añade los ítems recursivamente.
- --silent No muestra ninguna salida.
- --parents Incluye los directorios padre de los ítems indicados en
- la operación.
- --ignorefailed Si un ítem no se puede añadir, la operación de add
- continuará sin él. Importante: si un directorio no se
- puede añadir, su contenido tampoco se añadirá.
- --skipcontentcheck Cuando la extensión no es suficiente para determinar si
- el fichero es de tipo texto o binario, se asumirá que es
- binario en lugar de usar el contenido para detectar el
- tipo.
- == CMD_HELP_PARTIAL_ADD ==
- Notas:
- Requisitos para añadir ítems:
- - El directorio padre del ítem a añadir debe existir en el repositorio.
- Ejemplos:
- cm partial add pic1.png pic2.png
- (Añade los ítems pic1.png y pic2.png.)
- cm partial add c:\workspace\imagen.png
- (Añade el ítem imagen.png en el directorio c:\workspace.)
- cm partial add -R c:\workspace\src
- (Añade recursivamente todos los ítems del directorio especificado.)
-
- cm partial add --parents ejemplos\diseño01.png
- (Añade el ítem diseño01.png y su directorio padre ejemplos.)
-
- cm partial add -R *
- (Recursively adds all the contents of the current directory.)
- == CMD_DESCRIPTION_PARTIAL_CHECKIN ==
- Crea una nueva revisión de un ítem.
- == CMD_USAGE_PARTIAL_CHECKIN ==
- Sintaxis:
- cm partial checkin | ci [opciones] [<ruta>+]
- ruta Rutas de los ítems a proteger, separados por espacios.
- Usa comillas (") para especificar rutas con espacios.
- Usa . para aplicar la operación de checkin al directorio
- actual.
- Opciones:
- -c Añade un comentario al changeset creado en la operación
- de protección.
- -commentsfile Añade el comentario existente en el fichero especificado
- añ changeset creado en la operación de protección.
- --all | -a Los ítems cambiados, movidos y borrados localmente en
- las rutas especificadas también son protegidos.
- --applychanged Protege los ítems cambiados localmente junto con los
- ítems desprotegidos.
- --keeplock Mantiene el bloqueo de aquellos elementos que estaban
- bloqueados después de la operación de protección.
- --symlink Realizar la operación de checkin sobre el fichero de
- link y no al que apunta.
- --ignorefailed Los cambios locales que no se pueden aplicar (porque el
- bloqueo (checkout exclusivo) no se puede obtener o
- porque están en conflicto con los cambios del servidor)
- son descartados y el checkin continúa sin ellos.
- == CMD_HELP_PARTIAL_CHECKIN ==
- Notas:
- - Si no se especifican [opciones] ni [rutas], la operación involucrará a
- todos los cambios pendientes en el espacio de trabajo.
- - La operación de protección se aplica siempre recursivamente desde la
- ruta indicada.
- - Requisitos para proteger un ítem:
- - El ítem debe estar controlado por Plastic SCM.
- - El ítem ha de estar desprotegido.
- - Si un ítem ha sido cambiado pero no desprotegido, no es necesario
- especificar la opción --applychanged, salvo que en las rutas a ser
- protegidas se incluyan directorios o rutas con wildcards ('*').
- La revisión ha de tener cambios. Es decir, no se pueden proteger los
- mismos datos.
- Si existe una variable de entorno llamada PLASTICEDITOR apuntando al
- ejecutable de un editor de texto, y no se especifica un comentario al
- hacer checkin, el editor se abrirá automáticamente para que especifique
- un comentario.
- Ejemplos:
- cm partial checkin figura.png paisaje.png
- (Protege los ítems figura.png and paisaje.png.)
- cm partial checkin . -commentsfile=micomentario.txt
- (Protege los ítems de la ruta actual y aplica el comentario existente en el
- fichero micomentario.txt.)
- cm partial ci fondo.png -c="Nuevo fondo añadido" --keeplock
- (Protege el ítem fondo.png, incluye el comentario especificado y mantiene el
- bloqueo.)
- cm partial checkin --applychanged
- (Protege todos los cambios pendientes en el espacio de trabajo.)
-
- cm partial checkin link --symlink
- (Proteger el fichero de link y no al que apunta, opción disponible en UNIX)
- == CMD_DESCRIPTION_PARTIAL_CHECKOUT ==
- Desprotege los ítems dejándolos preparados para ser modificados.
- == CMD_USAGE_PARTIAL_CHECKOUT ==
- Síntaxis:
- cm partial checkout | co [<ruta>+] [--resultformat=str_format]
- [--silent] [--ignorefailed]
- Opciones:
- ruta Rutas de los ítems a desproteger, separados por
- espacios.
- Usa comillas (") para especificar rutas con espacios.
- Usa . para aplicar la operación de checkout al
- directorio actual.
- --resultformat Devuelve la salida en el formato especificado.
- --silent No muestra ninguna salida.
- --ignorefailed Si un ítem no se puede desproteger/bloquear (no se puede
- hacer un checkout exclusivo), la operación de checkout
- continuará sin él.
- == CMD_HELP_PARTIAL_CHECKOUT ==
- Notas:
- Para desproteger un ítem:
- - El ítem debe estar controlado por Plastic.
- - El ítem debe estar protegido.
-
- Si se han configurado bloqueos en el servidor (existe el fichero lock.conf),
- entonces cada vez que se produzca una desprotección, Plastic comprobará si
- se aplica alguna de las reglas. Si es así, la ruta permanecerá en checkout
- exclusivo (bloqueada), con lo que nadie podrá desprotegerlo simultáneamente.
- Puedes obtener todos los bloqueos del servidor usando 'cm listlocks'.
- Lee la documentación Administrator Guide para más información.
- Examples:
- cm partial checkout imagen1.png imagen2.png
- (Desprotege los ítems imagen1.png and imagen2.png.)
-
- cm partial co *.png
- (Desprotege todos los ítems png.)
- cm partial checkout .
- (Desprotege el directorio actual.)
-
- cm partial checkout -R c:\workspace\paisaje
- (Desprotege recursivamente el directorio paisaje.)
- cm partial co diseño01.png --exclusive
- (Desprotege el ítem exclusivamente.)
- == CMD_DESCRIPTION_PARTIAL_CONFIGURE ==
- Permite configurar tu espacio de trabajo, cargando o descargando elementos.
- == CMD_USAGE_PARTIAL_CONFIGURE ==
- Sintaxis:
- cm partial configure <+|-ruta>+ [--silent] [--ignorefailed] [--ignorecase]
- [--restorefulldirs]
- ruta Rutas a cargar o descargar, separadas por espacios.
- Usa comillas (") para especificar rutas con espacios.
- Todas las rutas deben comenzar con "/".
- Opciones:
- --silent No muestra ninguna salida.
- --ignorefailed Ignora cualquier error durante la operación.
- --ignorecase Ignora mayúsculas y minúsculas. Con esta opción el
- comando funcionará para "/Data/Textures" incluso si el
- usuario indica "/data/teXtures".
- --restorefulldirs Resetea una configuración de directorio incorrecta
- (ocurre cuando una operación no parcial es ejecutada en
- un espacio de trabajo parcial).
- Los directorios de esta lista se configuran por
- completo (full check), lo que significa que bajarán
- automáticamente el nuevo contenido durante el update.
- Esta operación no descarga ningún fichero, simplemente
- restaura la configuración de directorio en un espacio
- de trabajo parcial.
- == CMD_HELP_PARTIAL_CONFIGURE ==
- Notas:
- El comando siempre asume recursividad.
- Ejemplos:
- cm partial configure +/paisaje-gris.png
- (Carga paisaje-gris.png.)
- cm partial configure -/paisaje-negro.png
- (Descarga paisaje-negro.)
- cm partial configure +/textura -/textura/textura01.png
- (Carga todo el contenido del directorio textura excepto textura01.png.)
- cm partial configure -/
- (Descarga todo el directorio de trabajo.)
- cm partial configure -/ +/
- (Carga todo el directorio de trabajo.)
- cm partial configure +/figura-64.png --ignorefailed
- (Carga figura-64.png, estuviera o no ya cargado previamente.)
- cm partial configure +/ --restorefulldirs
- (Fija todos los directorios para que descarguen el nuevo contenido automáticamente.)
- cm partial configure +/src/lib --restorefulldirs
- (Fija sólo /src/lib y sus subdirectorios para que descarguen el nuevo contenido automáticamente.)
- == CMD_DESCRIPTION_PARTIAL_MOVE ==
- Mueve o renombra un archivo o directorio.
- == CMD_USAGE_PARTIAL_MOVE ==
- Sintaxis:
- cm partial move | mv src_path dst_path [--format=str_format]
- src_path Ruta origen del ítem.
- dst_path Ruta destino del ítem.
- Options:
- --format Devuelve la salida en el formato especificado.
- == CMD_HELP_PARTIAL_MOVE ==
- Notas:
- Este comando mueve o renombra un ítem en el repositorio.
- Los cambios también se aplican localmente.
-
- Si la ruta de origen es un fichero, el destino puede ser un fichero o un
- directorio. En el primer caso, el fichero se renombra. En el segundo, el
- fichero se renombra.
- Si la ruta de origen en un directorio, el destino ha de serlo también.
- El ítem a mover o renombrar debe existir.
- Formato:
- {0} Ruta de origen.
- {1} Ruta de destino.
- Examples:
- cm partial move fichero.png fichero-azul.png
- (Renombra el ítem.)
- cm partial mv .\fichero-azul.png .\azulFicheros
- (Mueve fichero-azul.png a azulFicheros.)
- cm partial move .\diseño .\marketing
- (Renombra un directorio.)
- == CMD_DESCRIPTION_PARTIAL_RM ==
- Borra un ítem del control de versiones.
- == CMD_USAGE_PARTIAL_RM ==
- Sintaxis:
- cm partial remove | rm <ruta>+ [--nodisk]
- ruta Ítems a borrar, separados por espacios.
- Usa comillas (") para especificar rutas con espacios.
- Opciones:
- --nodisk Borra del control de versiones, pero mantiene el ítem en
- disco.
- == CMD_HELP_PARTIAL_RM ==
- Notas:
- Los ítems se borran de disco. Los ítems borrados son borrados del directorio
- padre en el control de versiones.
- Requisitos:
- - El ítem debe estar controlado.
- Ejemplos:
- cm partial remove src
- (Borra src. Si src es un directorio, equivale a ejecutar:
- cm partial remove -R src.)
- cm partial remove c:\workspace\pic01.png --nodisk
- (Borra pic01.png del control de versiones, pero lo mantiene en el disco.)
- == CMD_DESCRIPTION_PARTIAL_SWITCH ==
- Establece la rama especificada como rama de trabajo.
- == CMD_USAGE_PARTIAL_SWITCH ==
- Sintaxis:
- cm switch branch_spec [--report | --silent] [--workspace=path]
- (Establece la rama de trabajo y actualiza el workspace.)
-
- cm switch branch_spec --configure <+|-ruta>+ [--silent]
- [--ignorefailed] [--ignorecase] [--workspace=path]
- (Establece la rama de trabajo y configura el workspace como haría el
- comando 'cm partial configure'.)
- branch_spec Especificación de rama.
- ruta Rutas a cargar o descargar, separadas por espacios.
- Usa comillas (") para especificar rutas con espacios.
- Todas las rutas deben comenzar con "/".
-
- Opciones:
-
- --silent No muestra salida.
- --report Imprime una lista de los cambios efectuados una vez
- termina la operación. Pierde efecto si se utiliza
- la opción --silent conjuntamente.
- --configure Configura (carga / descarga rutas) el espacio de
- trabajo después de haber actualizado la rama de trabajo.
- Usa 'cm partial configure --help' para aprender más
- sobre como especificar las rutas a configurar.
- --ignorefailed Ignora cualquier error durante la operación
- de configuración.
- --ignorecase Ignora mayúsculas y minúsculas en las rutas a
- configurar. Con esta opción el comando funcionará
- para "/Data/Textures" incluso si el usuario indica
- "/data/teXtures".
- --workspace=path Ruta del espacio de trabajo a cambiar.
- --forcedetailedprogress Fuerza mostrar progreso detallado incluso cuando se
- redirige la salida estándar.
- Usa 'cm help objectspec' para aprender más sobre cómo indicar especificaciones
- de ramas.
- == CMD_HELP_PARTIAL_SWITCH ==
- Notas:
- Este comando permite a los usuarios especificar una rama, como rama de
- trabajo. Después de actualizar la rama, actualiza el espacio de trabajo
- a la nueva rama como haría un 'cm partial update'. Sin embargo, si se
- especifica la opción --configure, permite configurar el espacio de trabajo
- teniendo en cuenta los elementos cargados en la nueva rama como haría un
- 'cm partial configure'.
- Ejemplos:
- cm switch br:/main/task
- (Establece /main/task como rama de trabajo y actualiza el espacio de
- trabajo.)
- cm switch br:/main/task --configure +/art/images
- (Establece /main/task como rama de trabajo y configura el directorio
- /art/images.)
- == CMD_DESCRIPTION_PARTIAL_UNCO ==
- Deshace la desprotección de un ítem.
- == CMD_USAGE_PARTIAL_UNCO ==
- Sintaxis:
- cm partial undocheckout | unco <ruta>+ [--silent]
- ruta Ítems sobre los que aplicar la operación, separados por
- espacios.
- Usa comillas (") para especificar rutas con espacios.
- Usa . para aplicar la operación al directorio actual.
- Opciones:
- --silent No muestra ninguna salida.
- == CMD_HELP_PARTIAL_UNCO ==
- Notas:
- Si un ítem está desprotegido y no quieres protegerlo, puede deshacer la
- desprotección usando este comando.
- Se puede deshacer la desprotección tanto a ficheros como a carpetas.
- El ítem se actualizará al estado anterior previo a ser desprotegido.
- Requisitos:
- - El ítem debe estar controlado.
- - El ítem debe estar desprotegido.
- Ejemplos:
- cm partial undocheckout .
- (Deshace las desprotecciones del directorio actual.)
- cm partial undocheckout pic1.png pic2.png
- cm unco c:\workspace\diseño01.png
- (Deshace las desprotecciones de los ítems especificados.)
- == CMD_DESCRIPTION_PARTIAL_UNDO ==
- Deshace cambios en un workspace.
- == CMD_USAGE_PARTIAL_UNDO ==
- Syntaxis:
- cm partial undo [path]+ [--symlink] [-r | --recursive] [Filtros]+
- [Opciones de salida]
- path Rutas de los ficheros o carpetas a los que aplicar
- la operación, separados por espacios. Se pueden
- utilizar comillas (") para especificar rutas con
- espacios. Si no se especifica ninguna ruta, por
- defecto la operación se ejecutará sobre los ficheros
- en el directorio actual.
- Opciones:
- --symlink Aplica la operación de undo al enlace simbólico y
- no a su destino.
- -r Ejecuta el undo de manera recursiva.
- Filtros:
- Si ninguna de estas opciones está presente, por defecto se deshacen todos
- los tipos de cambio, pero los ficheros pueden filtrarse utilizando estas
- opciones.
- Si un fichero o directorio tiene uno o más de los tipos de cambio
- especificados, todos los cambios en ese fichero o directorio serán
- deshechos.
- Por ejemplo, si se especifica tanto --checkedout como --moved, si un fichero
- está tanto movido como checkedout, ambos cambios se desharán.
- --checkedout Selecciona ficheros y directorios marcados para
- cambios.
- --unchanged Selecciona ficheros sin modificaciones en su
- contenido.
- --changed Selecciona ficheros y directorios cambiados o
- marcados para cambios.
- --deleted Selecciona ficheros y directorios eliminados.
- --moved Selecciona ficheros y directorios movidos.
- --added Selecciona ficheros y directorios añadidos.
- Opciones de salida:
- --silent | --machinereadable [--startlineseparator=sep]
- [--endlineseparator=sep] [--fieldseparator=sep]
- --silent No muestra ninguna salida.
- --machinereadable Muestra la salida en un formato fácil de tratar.
- --startlineseparator Usado en conjunto con la opción '--machinereadable',
- especifica cómo deberían comenzar las líneas.
- --endlineseparator Usado en conjunto con la opción '--machinereadable',
- especifica cómo deberían terminar las líneas.
- --fieldseparator Usado en conjunto con la opción '--machinereadable',
- especifica cómo deberían separarse las líneas.
- == CMD_HELP_PARTIAL_UNDO ==
- Notas:
- El comand undo es peligroso - deshace trabajo de una manera irreversible.
- Una vez que el undo termina, no hay manera posible de recuperar el estado
- anterior de los ficheros y directorios afectados. Si no se especifica
- ninguna ruta en los argumentos, por defecto se desharán los cambios en todos
- los elementos del directorio actual, pero NO de manera recursiva.
- Estos comandos son equivalentes ejecutados desde el directorio /src:
- /src
- |- file.txt
- |- code.cs
- \- /test
- |- test_a.py
- \- test_b.py
- $ cm partial undo
- $ cm partial undo *
- $ cm partial undo file.txt code.cs /test
- $ cm partial undo .
- $ cm partial undo /src file.txt code.cs
- Si se quiere que la operación sea recursiva, se necesita especificar la
- opción -r.
- Para deshacer todos los cambios debajo de un directorio (incluyendo los
- cambios sobre el propio directorio):
- $ cm partial undo dirpath -r
- Si dirpath es la ruta de un workspace, todos los cambios dentro del
- workspace serán deshechos.
- Examples:
- $ cm partial undo . -r
- (Deshace todos los cambios en el directorio actual de manera recursiva. Si
- se ejecuta desde la raíz del workspace, deshace todos los cambios en el
- workspace completo.)
- $ cm partial co file.txt
- $ cm partial undo file.txt
- (Deshace el checkout en file.txt.)
- $ echo content >> file.txt
- $ cm partial undo file.txt
- (Deshace el cambio local en file.txt.)
- $ cm partial undo src
- (Deshace los cambios en el directorio src y en todos los ficheros
- controlados que contenga)
- $ cm partial undo src/*
- (Deshace los cambios en todos los elementos contenidos en src, sin afectar
- al propio directorio. Por la expansión del wildcard, es equivalente a
- 'cm partial undo src/file1.txt src/file2.txt').
- $ cm partial undo *.cs
- (Deshace cambios en cada elemento que encaje con el patrón *.cs en el
- directorio actual.)
- $ cm partial undo *.cs -r
- (Deshace cambios en cada elemento que encaje con el patrón *.cs en el
- directorio actual, y en cada directorio por debajo de una manera recursiva.)
- $ cm partial co file1.txt file2.txt
- $ echo content >> file1.txt
- $ cm partial undo --unchanged
- (Deshace el checkout en file2.txt por no estar modificado, ignorando
- file1.txt ya que tiene cambios locales.)
- $ echo content >> file1.txt
- $ echo content >> file2.txt
- $ cm partial co file1.txt
- $ cm partial undo --checkedout
- (Deshace el cambio en el fichero en checkout file1.txt, ignorando file2.txt
- ya que no está en checkout.)
- $ cm partial add file.txt
- $ cm partial undo file.txt
- (Deshace el añadido de file.txt, dejándolo de nuevo como privado.)
- $ rm file1.txt
- $ echo content >> file2.txt
- $ cm partial add file3.txt
- $ cm partial undo --deleted --added *
- (Deshace el borrado de file1.txt y el añadido de file3.txt, ignorando
- el cambio en file2.txt.)
- == CMD_DESCRIPTION_PARTIAL_UPDATE ==
- Actualiza el espacio de trabajo parcial.
- == CMD_USAGE_PARTIAL_UPDATE ==
- Sintaxis:
- cm partial update [<ruta>+]
- [--changeset=número]
- [--silent | --report]
- ruta Rutas a actualizar, separadas por espacios. Las dobles
- comillas (") deben usarse para especificar rutas que
- contienen espacios.
- Si se usa . entonces se actualiza el directorio actual.
- Si no se especifica ninguna ruta, entonces se actualiza todo
- el espacio de trabajo parcial.
- Opciones:
- --changeset Actualiza el espacio de trabajo parcial al changeset
- especificado.
- --silent No muestra salida.
- --report Imprime una lista de los cambios efectuados una vez que
- termina la operación. Esta opción no tiene efecto si se
- utiliza la opción --silent.
- --dontmerge No procesa los conflictos de fichero. El resto de cambios
- se procesan con normalidad. Esta opción puede ser útil en
- automatización para evitar interacción con el usuario.
- == CMD_HELP_PARTIAL_UPDATE ==
- Notas:
- El comando update actualiza los ficheros desactualizados.
- El comando update siempre asume recursividad.
- Si todas las rutas especificadas son ficheros dentro del mismo xlink y
- se usa la opción --changeset, entonces las versiones a actualizar se buscan
- dentro del changeset del repositorio del xlink.
- Ejemplos:
- cm partial update
- (Actualiza todo el espacio de trabajo parcial.)
- cm partial update .
- (Actualiza todos los hijos del directorio actual.)
- cm partial update fichero1.txt
- (Actualiza el fichero fichero1.txt.)
- cm partial update fichero1.txt fichero2.txt
- (Actualiza los ficheros fichero1.txt y fichero2.txt.)
- cm partial update src --report
- (Actualiza todos los hijos del directorio src, mostrando una lista de los
- cambios aplicados al finalizar.)
- cm partial update src --changeset=4
- (Actualiza todos los hijos del directorio src, al contenido
- que cargaban en el changeset 4.)
-
- cm partial update xlink/first.png --changeset=4
- (Actualiza el fichero xlink/first.png al contenido que cargaba en el
- changeset 4 del repositorio del xlink.)
- == CMD_DESCRIPTION_PATCH ==
- Genera un parche a partir de una spec o aplica un parche generado en el workspace actual.
- == CMD_USAGE_PATCH ==
- Sintaxis:
- cm patch [source_spec] source_spec
- [--output=output_file] [--tool=/path/to/diff]
- cm patch --apply patch_file [--tool=/path/to/patch]
- source_spec Especificación de rama o changeset
- output_file Fichero que contendrá la salida del comando. Se
- mostrará en pantalla si no se especifica.
- Opciones:
- --output Indica el fichero de destino para almacenar los
- contenidos del parche.
- --tool Especifica la ruta hacia la herramienta necesaria para
- ejecutar la operación (diff o patch).
- == CMD_HELP_PATCH ==
- Notas:
- Este comando genera un fichero patch que contiene las diferencias de una
- rama o un changeset, así como las diferencias entre changesets. Encuentra
- diferencias para ficheros tanto de texto como binarios.
- El parámetro --apply permite aplicar los contenidos de un fichero patch
- en el workspace actual.
- Limitaciones:
- Si el fichero de salida de patch ya existe, el comando no lo
- sobreescribirá.
- Si el fichero con modificaciones en el patch no existe, el comando no
- creará uno nuevo para aplicar los cambios.
- Importante:
- Este comando requiere las utilidades Diff y Patch, disponibles
- en http://gnuwin32.sourceforge.net/packages/patch.htm y
- http://gnuwin32.sourceforge.net/packages/diffutils.htm
-
- Tras su instalación se recomienda agregar su ubicación a la variable
- de entorno PATH.
- Ejemplos:
- cm patch cs:4@default@localhost:8084
- (Muestra en pantalla las diferencias del changeset 4 en formato patch.)
- cm patch br:/main --output=file.patch
- (Obtiene un fichero file.patch con las diferencias de la rama "main".)
- cm patch br:/main --output=file.patch --tool=C:\gnu\diff.exe
- (Misma operación con un ejecutable indicado explícitamente.)
-
- cm patch cs:2@default cs:4@default
- (Muestra en pantalla las diferencias entre los changeset 2 y 4.)
- cm patch --apply file.patch --tool=C:\gnu\patch.exe
- (Aplica el parche contenido en file.patch al workspace actual con un
- ejecutable indicado explícitamente.)
- == CMD_DESCRIPTION_QUERY ==
- Ejecuta una consulta SQL contra la base de datos del servidor.
- == CMD_USAGE_QUERY ==
- Uso:
- cm query comandosql [--outputfile=ruta]
- [--solveuser=nombre_columna1,nombre_columna2,...]
- [--solvepath=nombre_columna1,nombre_columna2,...]
- [--columnwidth=valor]
- --outputfile: Escribe en un fichero el resultado de la consulta.
- --solveuser: Indica al intérprete de consultas que la(s) columna(s)
- especificada(s) contiene(n) usuarios. Se tratarán de resolver
- identificadores de usuario a nombres de usuario.
- --solvepath: Indica al intérprete de consultas que la(s) columna(s)
- especificadas(s) contiene(n) identificadores de ítem. Se tratarán de
- resolver los identificadores a rutas de disco.
- --columnwidth: Especifica la anchura de cada columna del resultado de la
- consulta.
- == CMD_HELP_QUERY ==
- Notas:
- Este comando permite a los usuarios ejecutar consultas SQL directamente
- contra la base de datos del servidor.
- A continuación se detalla el esquema (tablas y campos de cada tabla)
- disponibles para realizar consultas.
- ITEMS
- OBJECTID (integer)
- CREATIONDATE (datetime)
- OWNER (string)
- REVISIONS
- OBJECTID (integer)
- SIZEBYTES (integer)
- ITEMID (integer)
- BRANCHID (integer)
- CHANGESET (integer)
- COMMENT (string)
- CREATIONDATE (datetime)
- OWNER (string)
- CHECKOUTS
- REVISIONID (integer)
- WORKSPACESERVER (string)
- CLIENTMACHINE (string)
- EXCLUSIVE (char)
- CREATIONDATE (datetime)
- OWNER (string)
- BRANCHES
- OBJECTID (integer)
- NAME (string)
- PARENTBRANCHID (integer)
- CREATIONDATE (datetime)
- OWNER (string)
- LABELS
- OBJECTID (integer)
- NAME (string)
- CREATIONDATE (datetime)
- OWNER (string)
- LABELEDREVISIONS
- LABELID (integer)
- REVISIONID (integer)
- CREATIONDATE (datetime)
- OWNER (string)
- LINKS
- OBJECTID (integer)
- NAME (string)
- CREATIONDATE (datetime)
- OWNER (string)
- LINKEDOBJECTS
- LINKID (integer)
- SOURCEOBJECTID (integer)
- DESTINATIONOBJECTID (integer)
- CREATIONDATE (datetime)
- OWNER (string)
- ATTRIBUTES
- OBJECTID (integer)
- NAME (string)
- CREATIONDATE (datetime)
- OWNER (string)
- OBJECTSWITHATTRIBUTES
- ATTRIBUTEID (integer)
- SOURCEOBJECTID (integer)
- ATTRIBUTEVALUE (string)
- CREATIONDATE (datetime)
- OWNER (string)
- CHANGESETS
- CHANGESETNUMBER (integer)
- CREATIONDATE (datetime)
- OWNER (string)
- Además, a la hora de escribir consultas, existen dos functiones predefinidas
- para trabajar con usuarios y rutas de disco.
- Estas funciones son las siguientes:
- * SolveUser(nombre_usuario), resuelve el nombre de usuario dado al formato que
- maneja Plastic SCM.
- * SolvePath(path), resuelve rutas de disco a identificadores de ítem itemid.
- Para mostrar el resultado de las consultas de forma legible al usuario, se
- puede indicar al intérprete de consultas que convierta identificadores de
- usuario a nombres de usuario, e identificadores de ítem a rutas de disco.
- Para ello se utilizan las opciones:
- --solveuser=nombre_columna
- --solvepath=nombre_columna
- Se pueden especificar varios nombres de columnas separados por comas.
- Ejemplos:
- cm query "SELECT * FROM revision"
- cm query "SELECT b.sname as br_name, o.dtimestamp as date from branch b, object o, seid s
- where b.iobjid=o.iobjid and o.fidowner=s.iseidid and s.scode='SolveUser(juan)'"
- cm query "SELECT * FROM REVISION WHERE itemid=SolvePath(c:\mi_workspace)"
- cm query "SELECT r.iobjid, r.fiditem as ruta, s.scode as nombre_usuario FROM revision r, object o, seid s
- WHERE r.iobjid=o.iobjid and o.fidowner=s.iseidid" --solveuser=nombre_usuario --solvepath=ruta
- == CMD_DESCRIPTION_ATTRIBUTE_DELETE ==
- Borra uno o más atributos.
- == CMD_USAGE_ATTRIBUTE_DELETE ==
- Sintaxis:
- cm attribute delete spec_atributo1 spec_atributo2 ...
- spec_atributo Atributos a borrar, separados por espacios.
- Usa 'cm help objectspec' para obtener más información
- sobre la especificación de atributos.
- == CMD_HELP_ATTRIBUTE_DELETE ==
- Notas:
- Este comando borra uno o más atributos creados previamente.
- Los parámetros son especificaciones de atributos, dados en el formato
- att:nombre.
- Ejemplos:
- cm attribute delete att:Status
- (Borra el atributo 'Status'.)
- cm att rm status att:integrated@reptest@server2:8084
- (Borrar los atributos 'status' e 'integrated'.)
- == CMD_DESCRIPTION_ATTRIBUTE_UNSET ==
- Borra un atributo que ha sido fijado previamente en un objeto.
- == CMD_USAGE_ATTRIBUTE_UNSET ==
- Sintaxis:
- cm attribute unset spec_atributo spec_objeto
- spec_atributo Especificación del atributo.
- spec_objeto Especificación del objeto sobre el que fijar
- el atributo.
- Se pueden fijar atributos sobre ramas, changesets,
- shelvesets, etiquetas, items y revisiones.
- Usa 'cm help objectspec' para obtener más información sobre especificación
- de objetos.
- == CMD_HELP_ATTRIBUTE_UNSET ==
- Notas:
- Un atributo que ha sido fijado previamente a un objeto puede ser borrado
- con este comando. Se borra la realización del atributo en el objeto pero
- no el atributo.
- Usa 'cm help objectspec' para aprender cómo indicar especificaciones de
- objetos.
- Ejemplo:
- cm attribute unset att:Status br:/main/SCM105
- == CMD_DESCRIPTION_ATTRIBUTE_RENAME ==
- Renombra un atributo.
- == CMD_USAGE_ATTRIBUTE_RENAME ==
- Sintaxis:
- cm attribute rename spec_atributo nuevo_nombre
- spec_atributo: Especificación del atributo que se va a renombrar.
- Usa 'cm help objectspec' para obtener más información sobre
- la especificación de atributos.
- nuevo_nombre: Nuevo nombre para el atributo.
- == CMD_HELP_ATTRIBUTE_RENAME ==
- Notas:
- Este comando renombra un atributo.
- Ejemplos:
- cm attribute rename att:Status state
- (El atributo 'Status' se renombra a 'state')
- == CMD_DESCRIPTION_ATTRIBUTE_EDIT ==
- Editar el comentario de un atributo.
- == CMD_USAGE_ATTRIBUTE_EDIT ==
- Sintaxis:
- cm attribute edit spec_atributo nuevo_comentario
- spec_atributo: Especificación del atributo objetivo del cambio.
- Usa 'cm help objectspec' para obtener más información sobre
- la especificación de atributos.
- nuevo_comentario: Nuevo comentario para el atributo. También puedes
- especificar una lista de valores por defecto para el
- atributo.
- == CMD_HELP_ATTRIBUTE_EDIT ==
- Notas:
- Este comando cambia el comentario de un atributo.
- Para especificar la lista de valores por defecto para un atributo, solo
- tienes que incluir un texto como este en el comentario del atributo:
- 'default: valor_uno, "valor dos", valor3, "Valor final"'.
- Ejemplos:
- cm attribute edit att:status "The status of a branch in the CI pipeline."
- (Edita el comentario del atributo "status".)
- cm attribute edit att:status "Status of a branch. default: open, resolved, reviewed"
- (Edita el comentario del atributo "status". Y también especifica una lista
- de valores. De este modo, cuando apliques el atribute "status" a un objeto,
- podrás seleccionar uno de los siguientes valores: "open", "resolved" o
- "reviewed".)
- == CMD_DESCRIPTION_REPLICATE ==
- ATENCIÓN: Este comando se ha declarado obsoleto.
- Ha sido reemplazado por 'pull' (equivalente a 'replicate') y por 'push'
- (equivalente a 'replicate --push').
- Replica datos desde un repositorio remoto.
- == CMD_USAGE_REPLICATE ==
- Uso:
- cm replicate br_spec dst_rep_spec [--nodata] [translateOptions] [authOptions]
- cm replicate hydrate br_spec [src_rep_spec] [authOptions]
- cm replicate hydrate cs_spec [src_rep_spec] [authOptions]
- cm replicate br_spec --package=packagename [--changeset=número]
- cm replicate dst_rep_spec --import=packagename
- br_spec: la rama para ser replicada/hidratada. Es una especificación
- completa de rama con el siguiente formato:
- br:/NOMBRE_RAMA[@rep:NOMBRE_REP[@repserver:NOMBRE_SERVIDOR:puerto]]
- cs_spec: changeset para ser hidratado. Es una espec. de changeset:
- cs:NUMERO_CHANGESET[@rep:NOMBRE_REP[@repserver:NOMBRE_SERVIDOR:puerto]]
- src_rep_sec: repositorio origen de los datos. Es una especificación
- completa de repositorio:
- rep:NOMBRE_REPOSITORIO@repserver:NOMBRE_SERVIDOR:puerto
- dst_rep_sec: repositorio destino de la replica. Es una especificación
- completa de repositorio:
- rep:NOMBRE_REPOSITORIO@repserver:NOMBRE_SERVIDOR:puerto
- Opciones:
- --package para crear un paquete de replicación.
- --import para importar un paquete concreto.
- --nodata para replicar los cambios de una rama sin replicar sus datos. Esta
- opción no se puede usar para la réplica con paquetes ni con la opción
- --push.
- Opciones de traducción:
- --trmode=[copy | name | table] para especificar cómo tratar los
- nombres de usuario cuando se importen los datos en el
- repositorio de destino:
- * copy -> es el utilizado por defecto. Copia los SEIDs en el
- repositorio de destino.
- * name -> realiza una traducción por nombre entre el modo
- de autentificación de origen y el de destino.
- * table -> se usará una tabla de traducción en la que se
- especifican los nombres de origen y cómo han de quedar
- en el destino.
- --trtable=[translationTable]
- una tabla de traducción es un fichero que contiene entradas
- en la forma nombre antiguo;nombre nuevo.
- Opciones de autentificación:
- Hay dos formas de especificar los datos de autentificación:
- 1) Especificando un fichero de autentificación.
- --authfile=fichero, un fichero que contiene dos líneas: el modo de
- autentificación en la primera línea y los datos de autentificación
- (ver --authdata) o una cadena vacía en la segunda.
- 2) Especificando la autentificación mediante parámetros.
- Para ello hay que especificar el modo de autentificación mediante el
- modificador:
- --authmode=[NameWorkingMode | NameIDWorkingMode |
- LDAPWorkingMode | ADWorkingMode | UPWorkingMode]
- Si está trabajando en UPWorkingMode o LDAPWorkingMode, puede
- especificar los datos de autentificación de dos formas:
- 2.1) Para UPWorkingMode o LDAPWorkingMode:
- --authdata=datos_de_autentificación
- Ejemplos:
- --authdata=ActiveDirectory:192.168.1.3:389:john.doe@factory.com:fPBea2rPsQaagEW3pKNveA==:dc=factory,dc=com (LDAPWorkingMode)
- --authdata=john:fPBea2rPsQaagEW3pKNveA== (UPWorkingMode)
- 2.2) Solamente para UPWorkingMode:
- --user=usuario
- --password=contraseña
- == CMD_HELP_REPLICATE ==
- Notas:
- El comando 'replicate' replica datos desde una rama hacia un
- repositorio de destino. Todos los datos de la rama de origen, incluyendo
- revisiones, ítems, changesets, etiquetas, revisiones de código, links
- y seguridad serán replicados.
- Su cliente Plastic SCM debe estar configurado para trabajar con el
- repositorio de destino.
- La replicación también gestiona la 'reconciliación' de ramas que han
- sido modificadas tanto en origen como en destino, mediante la creación
- de 'ramas de entrega' (fetch branches) que podrán ser integradas
- posteriormente para resolver los conflictos.
- La replicación puede funcionar en tres modos diferentes:
- 1- Comunicación directa entre servidores: lo que significa que el servidor
- de destino se comunicará con el de origen para sincronizar la rama
- especificada.
- 2- Generación de paquete de exportación: el cliente se conectará
- únicamente con el destino para generar un paquete de replicación con los
- datos y los metadatos de la rama especificada. Se usará el modificador
- --package. El usuario podrá especificar, opcionalmente, un changeset
- inicial desde el cual generar la replicación.
- 3- Importar un paquete generado previamente, usando la opción --import.
- En los modos 1 y 2 será necesaria la autentificación contra el servidor
- de origen. El comando 'replicate' acepta parámetros para especificar los
- diferentes modos de autentificación.
- Ejemplos:
- cm replicate br:/main@rep:default@repserver:LONDRES:8084 rep:myrep@repserver:MADRID:9090
- cm replicate br:/main@rep:default@repserver:LONDRES:8084 rep:myrep@repserver:MADRID:9090 --trmode=name
- cm replicate br:/main@rep:default@repserver:LONDRES:8084 rep:myrep@repserver:MADRID:9090 --trmode=table --trtable=tabla.txt
- cm replicate br:/main@rep:default@repserver:LONDRES:8084 rep:myrep@repserver:MADRID:9090 --authmode=NameWorkingMode --user=john.doe
- Significa que se autentificará contra el servidor 'MADRID' usando NameWorkingMode como usuario 'john.doe'
- cm replicate br:/main/releaseBL060@rep:blackbird@repserver:barcelona:9090 --package=replicationpackage.data
- Creará un paquete de replicación
- cm replicate rep:mine@repserver:casa:9094 --import=replicationpackage.data
- Importará el paquete creado con anterioridad
- cm replicate br:/main/releaseBL060@rep:blackbird@repserver:barcelona:9090 --package=replicationpackage.data --changeset=1230
- Generará un paquete de replicación de la rama br:/main/releaseBL060 desde el changeset 1230
- cm replicate /main@project1@LONDRES:8084 projectx@localhost:8084 --nodata
- Replicará la rama /main del servidor LONDRES a mi servidor sin replica los datos.
- cm replicate hydrate /main@projectx@localhost:8084 project1@LONDRES:8084
- Hidratará los datos de la rama /main de mi servidor, usando los datos del servidor LONDRES.
- Nota adicional:
- La tabla de traducción tiene entradas (una por línea) con el siguiente
- formato:
- nombre antiguo;nombre nuevo
- == CMD_DESCRIPTION_PULL ==
- Replica datos desde un repositorio remoto.
- == CMD_USAGE_PULL ==
- Uso:
- cm pull src_br_spec dst_rep_spec
- [--preview] [--nodata] [translateOptions]
- [--user=usr_name [--password=pwd] | AuthOptions]
- (Replicación directa entre servidores. Hace pull de una rama desde un
- repositorio.)
- cm pull dst_rep_spec --package=pack_file [AuthOptions]
- (Replicación basada en paquetes. Importa el paquete en el servidor de
- destino.)
- cm pull hydrate dst_br_spec [src_rep_spec]
- [--user=usr_name [--password=pwd] | AuthOptions]
- (Introduce los datos restantes para todos los changesets de una rama
- replicada previamente con la opción --nodata. Si no se especifica un
- repositorio del que obtener los datos, Plastic intentará usar el origen
- de replicación original de la rama.)
- cm pull hydrate dst_cs_spec [src_rep_spec]
- [--user=usr_name [--password=pwd] | AuthOptions]
- (Introduce los datos restantes para un changeset replicado previamente
- con la opción --nodata. Si no se especifica un repositorio del que obtener
- los datos, Plastic intentará usar el origen de replicación original de
- la rama.)
- src_br_spec La rama a ser replicada desde un repositorio remoto.
- dst_br_spec La rama a ser hidratada.
- Especificación de ramas:
- [br:][/]nombre_rama[@[rep:]nombre_rep[@[repserver:]nombre_servidor:puerto]]
- dst_cs_spec El changeset a ser hidratado.
- Especificación de changesets:
- cs:numero_cset[@[rep:]nombre_rep[@[repserver:]nombre_servidor:puerto]]
- dst_rep_spec El repositorio de destino.
- Especificación de repositorio:
- [rep:]nombre_rep[@[repserver:]nombre_servidor:puerto]
- --package El fichero de donde se importa un paquete de replicación
- creado anteriormente.
- Es útil para mover datos entre servidores sin una
- conexión de red directa.
- Consule 'cm push' para crear paquetes de replicación.
- Opciones:
- --preview Proporciona información sobre qué cambios serán traídos
- durante el pull, pero no se ejecuta ninguna acción más.
- Esta opción es útil para comprobar qué datos serán
- replicados antes de ejecutar el pull.
- --user, --password Credenciales para utilizar en caso de que el modo de
- autenticación de los servidores origen y destino
- difieran, y no exista un profile para autenticarse
- contra el remoto.
- --nodata Replica los metadatos de una rama sin replicar los
- datos. Esta opción no se puede utilizar al importar un
- paquete de replicación.
- Opciones de traducción (translateOptions):
- --trmode={copy|name|table}
- El servidor de origen y de destino pueden utilizar modos distintos de
- autenticación. Este argumento especifica cómo se han de traducir los
- nombres de usuario del origen al destino.
- - copy El modo por defecto, indica que los nombres de usuario serán
- simplemente copiados.
- - name Los nombres de usuario serán emparejados entre origen y
- destino por coincidencia.
- - table Se utilizará una tabla de traducción (más información a
- continuación).
- --trtable={translation_table_file}
- Si el modo de traducción es 'table', entonces una tabla de traducción
- es un fichero que contiene líneas de la forma nombreantiguo;nombrenuevo.
- Cuando la rama se escribe en el repositorio de destino, los objetos
- creados por un usuario identificado por "nombreantiguo" en el
- repositorio de origen serán asignados al usuario identificado por
- "nombrenuevo" en el repositorio de destino.
- Opciones de autentificación (AuthOptions):
- Hay dos formas de especificar los datos de autentificación:
- 1) Especificando la autentificación mediante parámetros:
- --authmode={NameWorkingMode|LDAPWorkingMode|ADWorkingMode|UPWorkingMode}
- (LDAPWorkingMode) --authdata=::0:dave:fPBea2rPsQaagEW3pKNveA
- (UPWorkingMode) --authdata=dave:fPBea2rPsQaagEW3pKNveA==
- El parámetro '--authdata' es el contenido del campo <SecurityConfig>
- en los ficheros client.conf o profiles.conf. El fichero profiles.conf
- puede ser generado desde la GUI de Plastic SCM (Windows).
- Si se utiliza UPWorkingMode, se puede especificar simplemente:
- --authmode=UPWorkingMode --user=user --password=pwd
- 2.1) Para UPWorkingMode o LDAPWorkingMode:
- --authdata=datos_de_autentificación
- Ejemplos:
- --authdata=ActiveDirectory:192.168.1.3:389:john.doe@factory.com:fPBea2rPsQaagEW3pKNveA==:dc=factory,dc=com (LDAPWorkingMode)
- --authdata=john:fPBea2rPsQaagEW3pKNveA== (UPWorkingMode)
- 2.2) Solamente para UPWorkingMode:
- --user=usuario
- --password=contraseña
- 1) Especificando un fichero de autentificación. Se pueden tener varios
- ficheros de autenticación, uno por servidor al que se conecte,
- conteniendo las credenciales específicas para dicho servidor.
- --authfile=fichero
- Contiene 2 líneas:
- Línea 1) modo de autenticación, igual que para --authmode.
- Línea 2) datos de autenticación, igual que para --authdata.
- == CMD_HELP_PULL ==
- Notas:
- El comando pull replica ramas (junto a sus changesets) entre un repositorio
- origen y otro destino. Los repositorios pueden encontrarse en diferentes
- servidores.
- Hay dos operaciones de replicación: push y pull.
- Una operación de 'pull' significa que la operación de replicación hará que
- el servidor destino obtenga datos desde el origen. El cliente se conectará
- con el servidor destino, y, desde ese host, establecerá una conexión con el
- repositorio origen para recuperar los datos pedidos. Durante el pull, será
- el servidor destino el que se conecte al origen.
- Aunque en un escenario distribuido típico el desarrollador haga pùsh de los
- cambios en su servidor local al servidor central, también puede ser
- necesario hacer pull de los últimos cambios en el servidor central al
- servidor local.
- La replicación puede resolver situaciones en las que se hagan cambios
- concurrentes en la misma rama en dos repositorios replicados:
- - Push: si se intenta hacer push de datos locales a un repositorio que tenga
- datos más nuevos que los que se están enviando, el sistema pedirá hacer
- pull de los últimos cambios, resolver el merge resultante y, finalmente,
- tratar de repetir el push.
- - Pull: cuando se hace pull de changesets de una rama remota, estos estarán
- correctamente enlazados a sus changesets padre. Si el changeset que se ha
- traído no es un hijo del último changeset de la rama, entonces aparecerá
- un escenario de múltiples cabezas. La rama tendrá más de una 'cabeza', o
- dicho de otro modo, más de un changeset final de rama. Será necesario
- hacer merge de ambas cabezas antes de que se pueda hacer push de nuevo.
- El pull puede funcionar de dos modos:
- 1) Comunicación directa entre servidores: lo que significa que el servidor
- de destino se comunicará con el de origen para sincronizar la rama
- especificada.
- 2) Importación de un paquete de replicación generado con push, con la opción
- --package.
- El modo 1) requere que el usuario que ejecute el comando esté autenticado
- contra el servidor remoto, bien o usando la autenticación por defecto en
- el fichero client.conf, mediante un profile creado previamente, o
- especificando los argumentos --authmode y --authdata (o --user y --password
- en caso de que el modo de autenticación sea UPWorkingMode).
- El modo 2) require usar un paquete de replicación generado previamente con
- el comando push.
- Recuerde que la replicación pull funciona de una manera indirecta. Cuando
- se ejecuta, el comando pide al repositorio destino que se conecte con el
- origen para obtener la rama especificada.
- Sin embargo, esto se puede hacer de manera directa utilizando el comando
- push, que hará que sea el repositorio origen quien envíe los datos
- directamente al destino.
- Ejemplos:
- cm pull br:/main@project1@remoteserver:8084 projectx@myserver:8084
- (Hace pull de la rama principal de remoteserver a myserver. En este caso,
- ambos servidores están configurados con el mismo modo de autenticación.)
- cm pull br:/main@project1@remoteserver:8084 projectx@myserver:8084 --authmode=LDAPWorkingMode --authdata=::0:dave:fPBea2rPsQaagEW3pKNveA
- (Hace pull de la misma rama que antes, pero ahora el servidor remoto está
- configurado para autenticar usuarios contra un Active Directory. Por ejemplo,
- se puede conectar de una máquina Linux a un servidor Windows configurado
- para usar Active Directory. Para ello, se especificará el usuario y la
- contraseña cifrada.)
- cm pull br:/main@project1@remoteserver:8084 projectx@myserver:8084 --authmode=UPWorkingMode --user=dave --password=mysecret
- (Hace pull de la misma rama, pero ahora ambos usuarios están autenticados
- en el servidor remoto mediante el sistema de gestión de usuarios integrado
- en Plastic SCM.)
- cm pull br:/main@project1@remoteserver:8084 projectx@myserver:8084 --nodata
- (Hace pull de la rama principal de remoteserver a myserver pero sin datos.)
- cm pull hydrate br:/main@projectx@myserver:8084 projectx@remoteserver:8084
- (Introduce los datos de todos los changesets de la rama principal obteniendo
- dichos datos del repositorio en remoteserver.)
- cm pull hydrate cs:122169@projectx@myserver:8084 projectx@remoteserver:8084
- (Introduce los datos del changeset 122169 en myserver obteniendo dichos
- datos del repositorio en remoteserver.)
- Nota adicional:
- La tabla de traducción tiene entradas (una por línea) de la forma:
- nombre antiguo;nombre nuevo
- == CMD_DESCRIPTION_PUSH ==
- Replica datos hacia un repositorio remoto.
- == CMD_USAGE_PUSH ==
- Uso:
- cm push src_br_spec dst_rep_spec
- [--preview] [translateOptions]
- [--user=usr_name [--password=pwd] | AuthOptions]
- (Replicación directa entre servidores. Hace push de una rama hacia un
- repositorio.)
- cm push src_br_spec --package=pack_file [AuthOptions]
- (Replicación basada en paquetes. Crea un paquete de replicación con la
- rama especificada.)
- src_br_spec La rama a ser replicada desde un repositorio remoto.
- Especificación de ramas:
- [br:][/]nombre_rama[@[rep:]nombre_rep[@[repserver:]nombre_servidor:puerto]]
- dst_cs_spec El changeset a ser hidratado.
- Especificación de changesets:
- cs:numero_cset[@[rep:]nombre_rep[@[repserver:]nombre_servidor:puerto]]
- dst_rep_spec El repositorio de destino.
- Especificación de repositorio:
- [rep:]nombre_rep[@[repserver:]nombre_servidor:puerto]
- --package Exporta un paquete de replicación al fichero especificado.
- Es útil para mover datos entre servidores sin una
- conexión de red directa.
- Opciones:
- --preview Proporciona información sobre qué cambios serán enviados
- durante el push, pero no se ejecuta ninguna acción más.
- Esta opción es útil para comprobar qué datos serán
- replicados antes de ejecutar el push.
- --user, --password Credenciales para utilizar en caso de que el modo de
- autenticación de los servidores origen y destino
- difieran, y no exista un profile para autenticarse
- contra el remoto.
- --nodata Replica los metadatos de una rama sin replicar los
- datos. Esta opción no se puede utilizar al exportar un
- paquete de replicación.
- Opciones de traducción (translateOptions):
- --trmode={copy|name|table}
- El servidor de origen y de destino pueden utilizar modos distintos de
- autenticación. Este argumento especifica cómo se han de traducir los
- nombres de usuario del origen al destino.
- - copy El modo por defecto, indica que los nombres de usuario serán
- simplemente copiados.
- - name Los nombres de usuario serán emparejados entre origen y
- destino por coincidencia.
- - table Se utilizará una tabla de traducción (más información a
- continuación).
- --trtable={translation_table_file}
- Si el modo de traducción es 'table', entonces una tabla de traducción
- es un fichero que contiene líneas de la forma nombreantiguo;nombrenuevo.
- Cuando la rama se escribe en el repositorio de destino, los objetos
- creados por un usuario identificado por "nombreantiguo" en el
- repositorio de origen serán asignados al usuario identificado por
- "nombrenuevo" en el repositorio de destino.
- Opciones de autentificación (AuthOptions):
- Hay dos formas de especificar los datos de autentificación:
- 1) Especificando la autentificación mediante parámetros:
- --authmode={NameWorkingMode|LDAPWorkingMode|ADWorkingMode|UPWorkingMode}
- (LDAPWorkingMode) --authdata=::0:dave:fPBea2rPsQaagEW3pKNveA
- (UPWorkingMode) --authdata=dave:fPBea2rPsQaagEW3pKNveA==
- El parámetro '--authdata' es el contenido del campo <SecurityConfig>
- en los ficheros client.conf o profiles.conf. El fichero profiles.conf
- puede ser generado desde la GUI de Plastic SCM (Windows).
- Si se utiliza UPWorkingMode, se puede especificar simplemente:
- --authmode=UPWorkingMode --user=user --password=pwd
- 2.1) Para UPWorkingMode o LDAPWorkingMode:
- --authdata=datos_de_autentificación
- Ejemplos:
- --authdata=ActiveDirectory:192.168.1.3:389:john.doe@factory.com:fPBea2rPsQaagEW3pKNveA==:dc=factory,dc=com (LDAPWorkingMode)
- --authdata=john:fPBea2rPsQaagEW3pKNveA== (UPWorkingMode)
- 2.2) Solamente para UPWorkingMode:
- --user=usuario
- --password=contraseña
- 1) Especificando un fichero de autentificación. Se pueden tener varios
- ficheros de autenticación, uno por servidor al que se conecte,
- conteniendo las credenciales específicas para dicho servidor.
- --authfile=fichero
- Contiene 2 líneas:
- Línea 1) modo de autenticación, igual que para --authmode.
- Línea 2) datos de autenticación, igual que para --authdata.
- == CMD_HELP_PUSH ==
- Notas:
- El comando pull replica ramas (junto a sus changesets) entre un repositorio
- origen y otro destino. Los repositorios pueden encontrarse en diferentes
- servidores.
- Hay dos operaciones de replicación: push y pull.
- Una operación de 'push' significa que la operación de replicación enviará
- datos desde el repositorio origen al repositorio destino. En este caso, el
- cliente se conectará al repositorio origen, recuperando los datos para ser
- replicados, y entonces los enviará al repositorio destino. Mientras que el
- origen necesita tener conectividad con el destino, el destino no se
- conectará con el origen.
- En un escenario distribuido típico el desarrollador hace push de los
- cambios en su servidor local al servidor central. También puede ser
- necesario hacer pull de los últimos cambios en el servidor central al
- servidor local.
- La replicación puede resolver situaciones en las que se hagan cambios
- concurrentes en la misma rama en dos repositorios replicados:
- - Push: si se intenta hacer push de datos locales a un repositorio que tenga
- datos más nuevos que los que se están enviando, el sistema pedirá hacer
- pull de los últimos cambios, resolver el merge resultante y, finalmente,
- tratar de repetir el push.
- - Pull: cuando se hace pull de changesets de una rama remota, estos estarán
- correctamente enlazados a sus changesets padre. Si el changeset que se ha
- traído no es un hijo del último changeset de la rama, entonces aparecerá
- un escenario de múltiples cabezas. La rama tendrá más de una 'cabeza', o
- dicho de otro modo, más de un changeset final de rama. Será necesario
- hacer merge de ambas cabezas antes de que se pueda hacer push de nuevo.
- El push puede funcionar de dos modos:
- 1) Comunicación directa entre servidores: lo que significa que el servidor
- de origen se comunicará con el de destino para sincronizar la rama
- especificada.
- 2) Exportación de un paquete de replicación: El cliente únicamente se
- conectará con el origen y generará un paquete de replicación que contenga
- tanto los datos como los metadatos para la rama especificada. Para ello
- se utilizará el argumento --package.
- Ambos modos requeren que el usuario ejecutando el comando esté autenticado
- contra el servidor, bien o usando la autenticación por defecto en el fichero
- client.conf, mediante un profile creado previamente, o especificando los
- argumentos --authmode y --authdata (o --user y --password en caso de que
- el modo de autenticación sea UPWorkingMode).
- La replicación push funciona de una manera directa. Cuando se ejecuta, el
- comando replicará la rama seleccionada del origen al destino, en vez de
- pedir al repositorio destino que se conecte al repositorio origen para
- obtener la rama especificada (como hace pull).
- Ejemplos:
- cm push br:/main@project1@myserver:8084 projectx@remoteserver:8084
- (Hace push de la rama main desde myserver a remoteserver. En este caso,
- ambos servidores están configurados con el mismo modo de autenticación.)
- cm push br:/main@project1@remoteserver:8084 projectx@myserver:8084 --authmode=LDAPWorkingMode --authdata=::0:dave:fPBea2rPsQaagEW3pKNveA
- (Hace push de la misma rama que antes, pero ahora el servidor remoto está
- configurado para autenticar usuarios contra un Active Directory. Por ejemplo,
- se puede conectar de una máquina Linux a un servidor Windows configurado
- para usar Active Directory. Para ello, se especificará el usuario y la
- contraseña cifrada.)
- cm push br:/main@project1@remoteserver:8084 projectx@myserver:8084 --authmode=UPWorkingMode --user=dave --password=mysecret
- (Hace push de la misma rama, pero ahora ambos usuarios están autenticados
- en el servidor remoto mediante el sistema de gestión de usuarios integrado
- en Plastic SCM.)
- Nota adicional:
- La tabla de traducción tiene entradas (una por línea) de la forma:
- nombre antiguo;nombre nuevo
- == CMD_DESCRIPTION_CLONE ==
- Clona un repositorio remoto.
- == CMD_USAGE_CLONE ==
- Sintaxis:
- cm clone src_rep_spec [dst_rep_spec | repserver:dst_repserver_spec]
- [--user=usr_name [--password=pwd] | AuthOptions]
- [TranslateOptions]
- (Clonado directo repositorio-a-repositorio.)
- cm clone src_rep_spec --package=pack_file
- [--user=usr_name [--password=pwd] | AuthOptions]
- (Clonado utilizando un paquete intermedio, que se podrá importar
- posteriormente al repositorio destino mediante un pull.)
- src_rep_spec Repositorio origen de la operación de clonado.
- dst_rep_spec Repositorio destino de la operación de clonado.
- Si existe, debe estar vacío. Si no existe, será creado
- automáticamente.
- Si no se especifica, el comando utilizará el servidor
- de repositorios por defecto.
- Usa 'cm help objectspec' para obtener más información
- sobre la especificación de repositorios.
- dst_repserver_spec Servidor de repositorios destino de la operación de
- clonado. Si existe un repositorio con el mismo nombre
- que src_rep_spec, debe estar vacío. Si no existe, será
- creado automáticamente.
- Si no se especifica, el comando utilizará el servidor
- de repositorios por defecto.
- Usa 'cm help objectspec' para obtener más información
- sobre la especificación servidores de repositorio.
- pack_file Ruta de destino del paquete.
- Options:
- --user, --password Credenciales para utilizar en caso de que el modo de
- autenticación de los servidores origen y destino
- difieran, y no exista un profile para autenticarse
- contra el remoto.
- --package Exporta un paquete de replicación al fichero
- especificado.
- Es útil para mover datos entre servidores sin una
- conexión de red directa.
- El paquete resultante ha de ser importado mediante el
- comand pull.
- Opciones de traducción (TranslateOptions):
- --trmode={copy|name|table}
- El servidor de origen y de destino pueden utilizar modos distintos de
- autenticación. Este argumento especifica cómo se han de traducir los
- nombres de usuario del origen al destino.
- - copy El modo por defecto, indica que los nombres de usuario serán
- simplemente copiados.
- - name Los nombres de usuario serán emparejados entre origen y
- destino por coincidencia.
- - table Se utilizará una tabla de traducción (más información a
- continuación).
- --trtable={translation_table_file}
- Si el modo de traducción es 'table', entonces una tabla de traducción
- es un fichero que contiene líneas de la forma nombreantiguo;nombrenuevo.
- Cuando la rama se escribe en el repositorio de destino, los objetos
- creados por un usuario identificado por "nombreantiguo" en el
- repositorio de origen serán asignados al usuario identificado por
- "nombrenuevo" en el repositorio de destino.
- Opciones de autentificación (AuthOptions):
- Hay dos formas de especificar los datos de autentificación:
- 1) Especificando la autentificación mediante parámetros:
- --authmode={NameWorkingMode|LDAPWorkingMode|ADWorkingMode|UPWorkingMode}
- (LDAPWorkingMode) --authdata=::0:dave:fPBea2rPsQaagEW3pKNveA
- (UPWorkingMode) --authdata=dave:fPBea2rPsQaagEW3pKNveA==
- El parámetro '--authdata' es el contenido del campo <SecurityConfig>
- en los ficheros client.conf o profiles.conf. El fichero profiles.conf
- puede ser generado desde la GUI de Plastic SCM (Windows).
- Si se utiliza UPWorkingMode, se puede especificar simplemente:
- --authmode=UPWorkingMode --user=user --password=pwd
- 2.1) Para UPWorkingMode o LDAPWorkingMode:
- --authdata=datos_de_autentificación
- Ejemplos:
- --authdata=ActiveDirectory:192.168.1.3:389:john.doe@factory.com:fPBea2rPsQaagEW3pKNveA==:dc=factory,dc=com (LDAPWorkingMode)
- --authdata=john:fPBea2rPsQaagEW3pKNveA== (UPWorkingMode)
- 2.2) Solamente para UPWorkingMode:
- --user=usuario
- --password=contraseña
- 1) Especificando un fichero de autentificación. Se pueden tener varios
- ficheros de autenticación, uno por servidor al que se conecte,
- conteniendo las credenciales específicas para dicho servidor.
- --authfile=fichero
- Contiene 2 líneas:
- Línea 1) modo de autenticación, igual que para --authmode.
- Línea 2) datos de autenticación, igual que para --authdata.
- == CMD_HELP_CLONE ==
- Notas:
- El comando clone replica ramas (junto a sus changesets, etiquetas, atributos,
- reviews, etc.) desde un repositorio origen a otro repositorio destino.
- Los repositorios pueden encontrarse en diferentes servidores.
- El repositorio destino puede existir de antemano, pero si contiene datos
- previos, la operación de clone fallará.
- La operación de clone NO clona submódulos, ni repositorios que se encuentren
- debajo de un xLink.
- Ejemplos:
- cm clone awesomeProject@tardis@cloud
- (Clona el repositorio 'awesomeProject' de la organización Cloud tardis@cloud
- en un repositorio local del mismo nombre.)
- cm clone repo@server.home:9095 repo-local
- (Clona 'repo' desde 'server.home:9095' en 'repo-local' localizado en el
- servidor de repositorios por defecto del usuario.)
- cm clone project@192.168.111.130:8084 repserver:192.168.111.200:9095
- (Clona 'project' desde '192.168.111.130:8084' en
- 'project@192.168.111.200:9095'.)
- cm clone project@ldapserver:8084 --authfile=credentials.txt --trmode=table --trtable=table.txt
- (Clona el repositorio 'project' desde 'ldapserver:8084' utilizando un fichero
- para autenticarse contra el servidor remoto, y traduciendo los usuarios
- siguiendo la tabla de traducción especificada.)
- cm clone project@server.home:9095 --package=project.plasticpkg
- cm mkrep project@mordor.home:8084
- cm pull --package=project.plasticpkg project@mordor.home:8084
- (Clona 'project' desde 'server.home:9095' al paquete 'project.plasticpkg',
- que se importa posteriormente en el repositorio 'project' de
- 'mordor.home:8084' mediante una operación de pull.)
- Nota adicional:
- La tabla de traducción tiene entradas (una por línea) de la forma:
- nombre antiguo;nombre nuevo
- == CMD_DESCRIPTION_REVERT ==
- Carga en el espacio de trabajo la revisión especificada y desprotege el elemento.
- == CMD_USAGE_REVERT ==
- Sintaxis:
- cm revert cset_spec
- cset_spec Especificación del changeset que contiene la revisión del ítem
- cuyo contenido se desea cargar en el espacio de trabajo.
- Usa 'cm help objectspec' para obtener más información sobre la
- especificación de changesets.
- == CMD_HELP_REVERT ==
- Notas:
- El ítem ha de esta estar protegido.
- Ejemplos:
- cm revert dir#cs:0
- cm revert C:\mywks\dir\file1.txt#cs:23456
- == CMD_DESCRIPTION_REVISION_HISTORY ==
- Muestra la historia de revisiones de un ítem.
- == CMD_USAGE_REVISION_HISTORY ==
- Sintaxis:
- cm history [opciones] rutas
- rutas: Rutas de los ítems a mostrar, separadas por comas.
- También pueden ser especificaciones de revisiones en servidor.
- Usa comillas (") para indicar rutas que contengan espacios.
- Usa 'cm help objectspec' para obtener más información sobre la
- especificación de estas rutas.
- Opciones:
- -R: Descender recursivamente dentro de los directorios.
- --long: Muestra información adicional.
- --format: Muestra la salida con el formato especificado.
- No compatible con la opción '--long'. Significado:
- {0} fecha, {1} changeset, {2} rama, {3} etiquetas,
- {4} comentario, {5} propietario, {6} revisionid
- --symlink: Efectúa la operación "history" sobre el fichero de link y
- no sobre el ítem al que apunta
- --xml: Permite volcar la salida del comando en formato xml a la salida
- estándar. También se permite especificar un fichero de salida
- (--xml=output.xml).
- --encoding: si se utiliza con la opción --xml, permite especificar el
- encoding con el que se guardará la salida del comando. Consulte la
- documentación de la MSDN para obtener la tabla completa de codificaciones
- soportadas y su formato; al final de la página en la columna "Name":
- http://msdn.microsoft.com/en-us/library/system.text.encoding.aspx
- == CMD_HELP_REVISION_HISTORY ==
- Notas:
- Este comando muestra una lista con todas revisiones de un ítem determinado.
- Para cada una de ellas se muestra la rama a la que pertenece, comentarios
- de checkin y información sobre las etiquetas.
- Este comando acepta formato para mostrar la salida.
- Los parámetros que acepta son los siguientes:
- {0} | {date} Fecha.
- {1} | {changesetid} Número de changeset.
- {2} | {branch} Rama.
- {4} | {comment} Comentario.
- {5} | {owner} Propietario.
- {6} | {id} Id de revisión.
- {7} | {repository} Repositorio.
- {8} | {server} Servidor.
- {9} | {repspec} Especificación de repositorio.
- {tab} Inserta un tabulador.
- {newline} Inserta una nueva línea.
- Ejemplos
- cm history fichero1.txt fichero2.txt
- cm history c:\workspace
- cm history link --symlink
- (Recupera la historia del fichero de link y no sobre el elemento al que
- apunta)
- cm history serverpath:/src/foo/bar.c#br:/main/task001@myserver
- (Recupera la historia del elemento /src/foo/bar.c presente en el último
- changeset de la rama /main/task001 del repositorio 'myserver')
- == CMD_DESCRIPTION_REVISION_TREE ==
- Muestra un árbol de revisiones para el ítem dado.
- == CMD_USAGE_REVISION_TREE ==
- Sintaxis:
- cm tree ruta
- ruta: Ruta del ítem sobre el que se mostrará el árbol.
- Opciones:
- --symlink: Efectúa la operación sobre el fichero de link y no sobre el ítem
- al que apunta.
- == CMD_HELP_REVISION_TREE ==
- Ejemplos:
- cm tree fichero1.txt
- cm tree c:\workspace
- cm tree link --symlink
- (Efectúa la operación sobre el fichero de link
- y no sobre el que apunta, disponible en entornos UNIX).
- == CMD_DESCRIPTION_RM ==
- Use este comando para borrar ficheros y directorios.
- == CMD_USAGE_RM ==
- Sintaxis:
- cm remove | em comando [opciones]
- Comandos:
- controlled (opcional)
- private
- Para obtener más información sobre cada comando:
- cm remove comando --usage
- cm remove comando --help
- == CMD_HELP_RM ==
- Ejemplos:
- cm remove \fichero_controlado.txt
- cm remove private \fichero_privado.txt
- == CMD_DESCRIPTION_RM_CONTROLLED ==
- Borra un ítem del control de versiones.
- == CMD_USAGE_RM_CONTROLLED ==
- Sintaxis:
- cm remove [opciones] rutas
- rutas: Rutas de los ítem a borrar.
- Opciones:
- -R: Descender recursivamente dentro de directorios.
- == CMD_HELP_RM_CONTROLLED ==
- Notas:
- El ítem nunca borra del disco.
- Requisitos para borrar:
- El ítem ha de estar controlado en Plastic SCM.
- El directorio padre debe estar desprotegido.
- El elemento no debe estar desprotegido.
- Si el ítem es un directorio, no debe tener desprotecciones pendientes.
- Ejemplos:
- cm remove src (borra el directorio 'src')
- cm remove c:\workspace\fichero.txt
- == CMD_DESCRIPTION_RM_PRIVATE ==
- Borra ficheros y directorios privados.
- Advertencia: este comando elimina permanentemente ficheros y directorios, y no
- son recuperables. Es recomendable utilizar antes la opción '--dry-run' para
- comprobar qué ficheros y directorios serán afectados por el comando.
- == CMD_USAGE_RM_PRIVATE ==
- Sintaxis:
- cm remove | rm private <ruta>+ [-r] [--verbose] [--dry-run]
- ruta Ruta del fichero o directorio a borrar.
- Se pueden usar comillas (") para especificar rutas que
- contengan espacios.
- Opciones:
- --r Elimina ficheros privados recursivamente dentro de
- directorios controlados.
- --ignored También se elimina ficheros y directorios ignorados y
- cloaked.
- --verbose Muestra todos las rutas afectadas.
- --dry-run Ejecuta el comando sin hacer cambios en disco.
- == CMD_HELP_RM_PRIVATE ==
- Notas:
- Si la ruta especificada corresponde a un fichero o directorio privados, este
- será eliminado de disco.
- Si la ruta corresponde a un fichero bajo control de versiones, el comando
- fallará.
- Si la ruta pertenece a un directorio bajo control de versiones, el comando
- fallará salvo que se especifique la opción '-r', en cuyo caso se borrarán
- todos los ficheros y directorios privados dentro del directorio controlado
- especificado.
- Ejemplos:
- cm remove private private_directory
- (Eliminina el directorio 'private_directory'.)
- cm remove private c:\workspace\controlled_directory
- (Falla, pues el directorio 'controlled_directory' no es privado.)
- cm remove private -r c:\workspace\controlled_directory
- (Elimina todos los ficheros y directorios privados dentro de
- 'controlled_directory'.)
- cm rm private --dry-run --verbose c:\workspace\controlled_directory -r
- (Muestra todas las rutas afectadas por la operación de borrado de elementos
- privados dentro de 'controlled_directory' sin borrar nada.)
- cm rm private --verbose c:\workspace\controlled_directory -r
- (Muestra todas las rutas afectadas por la operación de borrado de elementos
- privados dentro de 'controlled_directory', ejecutando el borrado.)
- == CMD_DESCRIPTION_TRIGGER_DELETE ==
- Elimina un trigger identificado por un tipo y una posicion de un servidor dado.
- == CMD_USAGE_TRIGGER_DELETE ==
- Sintaxis:
- cm trigger delete subtipo-tipo posicion [opciones]
- subtipo-tipo: momento de ejecución del trigger y operacion del trigger.
- Teclee 'cm showtriggertypes' para ver una lista completa de los tipos
- de trigger disponibles. Algunos ejemplos son:
- before-mkbranch
- after-mkwokspace
- after-setselector
- posicion: posicion que se le asigno al trigger en el momento de su creación.
- Opciones:
- --server=servidor: Elimina el trigger del servidor especificado.
- Si no se especifica ninguno lo elimina en aquél configurado
- en el cliente.
- == CMD_HELP_TRIGGER_DELETE ==
- Ejemplos:
- cm trigger delete after-setselector 4
- cm tr rm after-setselector 4
- == CMD_DESCRIPTION_ATTRIBUTE_SET ==
- Fija un atributo al objeto indicado.
- == CMD_USAGE_ATTRIBUTE_SET ==
- Sintaxis:
- cm attribute set spec_atributo spec_objeto valor_atributo
- spec_atributo Especificación del atributo.
- spec_objeto Especificación del objeto sobre el que fijar el atributo.
- Objetos válidos para este comando son: rama, changeset,
- shelveset, etiqueta, item y revisión.
- valor_atributo Valor con el que se quiere fijar el atributo indicado
- para ese objeto.
- Usa 'cm help objectspec' para obtener más información sobre especificaciones.
- == CMD_HELP_ATTRIBUTE_SET ==
- Notas:
- A los objetos se les puede fijar un atributo para poder guardar información
- adicional en el objeto.
- Se pueden fijar atributos sobre los siguientes objetos:
- ramas, changesets, shelvesets, etiquetas, items y revisiones.
- Ejemplo:
- cm attribute set att:Status br:/main/SCM105 Integrated
- == CMD_DESCRIPTION_SETOWNER ==
- Establece el propietario de un objeto.
- == CMD_USAGE_SETOWNER ==
- Sintaxis:
- cm setowner | sto --user=usuario | --group=grupo spec_objeto
- --user Nombre de usuario. Nuevo propietario del objeto.
- --group Nombre de grupo. Nuevo propietario del objeto.
- spec_objeto Especificación del objeto sobre el que asignar el nuevo
- propietario.
- Se puede asignar nuevo usuario a los siguientes objetos:
- repserver, repositorio, rama, changeset, etiqueta, item,
- revisión y atributo.
- Usa 'cm help objectspec' para obtener más información
- sobre la especificación de objetos.
- == CMD_HELP_SETOWNER ==
- Notas:
- Es posible modificar el propietario de un objeto mediante el comando
- setowner. El propietario de un objeto puede ser un usuario o un grupo.
- Para especificar un usuario se utiliza la opción –-user=xxx y para
- especificar un grupo se utiliza la opción -–group=xxx. El objeto que se
- quiere modificar se especifica mediante una especificación de objeto.
- Se puede modificar el propietario de los siguientes objetos:
- servidor de repositorios, repositorio, rama, changeset, etiqueta, item,
- revisión y atributo.
- Ejemplos:
- cm setowner --user=danipen repserver:localhost:8084
- (establece a 'danipen' como propietario del servidor de repositorios)
- cm sto --group=development rep:principal@PlasticServer:8084
- (establece al grupo 'development' como el propietario del repositorio 'principal')
- == CMD_DESCRIPTION_SETSELECTOR ==
- Establece un selector para un espacio de trabajo.
- == CMD_USAGE_SETSELECTOR ==
- Sintaxis:
- cm setselector [opciones] [wk_ruta | wk_spec]
- wk_ruta Ruta del espacio de trabajo sobre el que establecer el
- selector.
- wk_spec Especificación del espacio de trabajo sobre el que
- establecer el selector.
- Usa 'cm help objectspec' para obtener más información
- sobre especificaciones de espacios de trabajo.
- Opciones:
- --file Fichero del que cargar un selector.
- --ignorechanges Ignora el mensaje de aviso de cambios pendientes que se
- muestra si existen cambios pendientes cuando se
- actualiza el espacio de trabajo.
- --forcedetailedprogress Fuerza mostrar progreso detallado incluso cuando se
- redirige la salida estándar.
- == CMD_HELP_SETSELECTOR ==
- Notas:
- Este comando establece un selector para un espacio de trabajo determinado.
- Un workspace necesita información acerca de dónde obtener las revisiones
- con las que trabajará el usuario. Para especificar esa información se
- utilizan los selectores.
- Mediante un selector se puede indicar, por ejemplo, que se carguen las
- revisiones desde una rama determinada o desde la rama ‘main’, desde una
- etiqueta, y especificar la rama donde se alojarán las desprotecciones.
- Si no se especifica ningún fichero del que cargar el selector se abrirá
- un editor de texto.
- Indicar una ruta o una especificación de workspace es opcional. Si no se
- especifica ninguno el selector se fijará para el espacio de trabajo en
- el que se encuentra el usuario.
- Un selector de ejemplo:
- repository "default" // indica el repositorio con el que se trabaja
- path "/" // se aplica al path raíz
- branch "/main" // se obtendrán las últimas revisiones de br:/main
- checkout "/main" // los checkouts se ubicarán en la rama br:/main
- Ejemplos:
- cm setselector
- cm setselector --file=c:\selectores\miRama.xml
- cm setselector --file=c:\selectores\rama5.xml MiWorkspace
- cm setselector wk:workspace_projA@BEARDTONGUE
- == CMD_DESCRIPTION_SHELVE ==
- El comando shelve almacena el contenido de las revisiones en checkout.
- == CMD_USAGE_SHELVE ==
- Este comando está obsoleto. Se ha reemplazado por 'cm shelveset'.
- Sintaxis:
- cm shelve [opciones] [rutas]
- rutas: rutas de los items a guardar.
- Opciones:
- --apply=shelve_spec : Restaura los contenidos almancenados en el
- repositorio, identificados por "shelve_spec" en el espacio de trabajo
- local.
- --delete=shelve_spec: Elimina los contenidos almancenados en el repositorio
- identificados por "shelve_spec"
- --all (-a): Los ítems cambiados, movidos y borrados localmente, en las
- rutas dadas, también serán guardados.
- --dependencies: Incluir las dependencias de los cambios locales entre los
- ítems a guardar.
- -c=comentarios: Añade un comentario al shelve creado en la operación.
- --commentsfile=comment.txt: Carga el comentario del fichero especificado.
- --mount: El punto de montaje del respositorio especificado.
- --encoding=codificación: Especifica la codificación de los ficheros de
- origen (por ejemplo, UTF-8 o Unicode)
- --comparisonmethod=tipo: cualquiera de las siguientes opciones:
- IgnoreEol: Ignora diferencias de final de línea.
- IgnoreWhitespaces: Ignora diferencias de espacios en blanco.
- IgnoreEolWhitespaces: Ignora diferencias de final de línea y espacios en
- blanco.
- NotIgnore: Detecta diferencias de final de línea y espacios en
- blanco.
- == CMD_HELP_SHELVE ==
- Notas:
- - Si no se especifican [opciones] ni [rutas], la operación involucrará a
- todos los cambios pendientes en el espacio de trabajo.
- - La operación de shelve se aplica siempre recursivamente desde la
- ruta indicada.
- - Requisitos para hacer shelve de un ítem:
- * El ítem debe estar controlado por Plastic SCM.
- * El ítem ha de estar desprotegido.
- Ejemplos:
- cm shelve
- cm shelve fichero1.txt fichero2.txt
- Comentarios:
- Para especificar comentarios use el switch "-c" o "-m" del siguiente modo:
- cm shelve -c="my comment"
- cm shelve -m "my comment"
- Si existe una variable de entorno llamada PLASTICEDITOR apuntando al
- ejecutable de un editor de texto, y no se especifica un comentario al
- crear una shelve, el editor se abrirá automáticamente para que especifique
- un comentario.
- Ejemplo: Aplicar un shelve almacenado en el repositorio:
- cm shelve --apply=sh:3
- Ejemplo: Eliminar un shelve almacenado en el repositorio
- cm shelve --delete=sh:3
- Ejemplo: Shelve 'changelist'
- cm status --short --changelist=pending_to_review | cm shelve -
- (El comando listará los paths en el changelist llamado 'pending_to_review'
- y dicha lista será redirigida a la entrada del comando 'shelve').
- == CMD_DESCRIPTION_SHELVESET ==
- Use este comando para administrar shelvesets.
- == CMD_USAGE_SHELVESET ==
- Sintaxis:
- cm shelveset comando [opciones]
- Comandos:
- create | mk
- delete | rm
- apply
- Para obtener más información sobre cada comando:
- cm shelveset command --usage
- cm shelveset command --help
- == CMD_HELP_ATTRIBUTE ==
- Ejemplos:
- cm shelveset create -c="my comment"
- cm shelveset delete sh:3
- cm shelve apply sh:3
- == CMD_DESCRIPTION_SHELVESET_CREATE ==
- El comando shelve almacena los cambios pendientes.
- == CMD_USAGE_SHELVESET_CREATE ==
- Sintaxis:
- cm shelveset create [opciones] [rutas]
- rutas: rutas de los items a guardar.
- Opciones:
- --all (-a): Los ítems cambiados, movidos y borrados localmente, en las
- rutas dadas, también serán guardados.
- --dependencies: Incluir las dependencias de los cambios locales entre los
- ítems a guardar.
- -c=comentarios: Añade un comentario al shelve creado en la operación.
- --commentsfile=comment.txt: Carga el comentario del fichero especificado.
- == CMD_HELP_SHELVESET ==
- Ejemplos:
- cm shelveset create -c="my comment"
- cm shelveset delete sh:3
- cm shelve apply sh:3
- == CMD_HELP_SHELVESET_CREATE ==
- El comando shelveset create almacena los ítems en checkout especificados
- dentro del repositorio. De este modo el contenido queda almacenado en el
- servidor sin necesidad de hacer check in.
- Notas:
- - Si no se especifican [opciones] ni [rutas], la operación involucrará a
- todos los cambios pendientes en el espacio de trabajo.
- - La operación de shelve se aplica siempre recursivamente desde la
- ruta indicada.
- - Requisitos para hacer shelve de un ítem:
- * El ítem debe estar controlado por Plastic SCM.
- * El ítem ha de estar desprotegido.
- Ejemplos:
- cm shelveset create
- cm shelveset fichero1.txt fichero2.txt
- Comentarios:
- Para especificar comentarios use el switch "-c" o "-m" del siguiente modo:
- cm shelveset -c="my comment"
- cm shelveset -m "my comment"
- Si existe una variable de entorno llamada PLASTICEDITOR apuntando al
- ejecutable de un editor de texto, y no se especifica un comentario al
- crear una shelve, el editor se abrirá automáticamente para que especifique
- un comentario.
- Ejemplo: Shelve 'changelist'
- cm status --short --changelist=pending_to_review | cm shelveset -
- (El comando listará los paths en el changelist llamado 'pending_to_review'
- y dicha lista será redirigida a la entrada del comando 'shelve').
- == CMD_DESCRIPTION_SHELVESET_DELETE ==
- El comando shelveset delete borra un shelveset.
- == CMD_USAGE_SHELVESET_DELETE ==
- Sintaxis:
- cm shelveset delete shelve_spec
- shelve_spec: Elimina los contenidos almancenados en el repositorio
- identificados por "shelve_spec"
- == CMD_HELP_SHELVESET_DELETE ==
- El comando shelveset delete borra un shelveset creado anteriormente.
- Ejemplo: Eliminar un shelve almacenado en el repositorio
- cm shelveset delete sh:3
- == CMD_DESCRIPTION_SHELVESET_APPLY ==
- El comando shelveset apply restaura los contenidos almancenados en el
- repositorio.
- == CMD_USAGE_SHELVESET_APPLY ==
- Sintaxis:
- cm shelveset apply shelve_spec [opciones]
- shelve_spec: Restaura los contenidos almancenados en el repositorio
- identificados por "shelve_spec"
- Opciones:
- --mount: El punto de montaje del respositorio especificado.
- --encoding=codificación: Especifica la codificación de los ficheros de
- origen (por ejemplo, UTF-8 o Unicode)
- --comparisonmethod=tipo: cualquiera de las siguientes opciones:
- IgnoreEol: Ignora diferencias de final de línea.
- IgnoreWhitespaces: Ignora diferencias de espacios en blanco.
- IgnoreEolWhitespaces: Ignora diferencias de final de línea y espacios en
- blanco.
- NotIgnore: Detecta diferencias de final de línea y espacios en
- blanco.
- == CMD_HELP_SHELVESET_APPLY ==
- El comando shelveset apply restaura los contenidos almancenados en el
- repositorio.
- Ejemplo: Aplicar un shelve almacenado en el repositorio:
- cm shelveset apply sh:3
- == CMD_DESCRIPTION_SHOW_FIND_OBJECTS ==
- Muestra la lista de objetos disponibles y sus atributos correspondientes.
- == CMD_USAGE_SHOW_FIND_OBJECTS ==
- Sintaxis:
- cm showfindobjects
- == CMD_HELP_SHOW_FIND_OBJECTS ==
- Objetos y atributos disponibles:
- attribute:
- Se puede buscar atributos filtrando por los siguientes campos:
- Type : string.
- Value : string.
- Date : fecha.
- Consulte la sección "constantes de fecha" en esta guía para más
- info.
- Owner : usuario.
- Admite el usuario especial 'me'.
- GUID : Identificador Global Único.
- Id hexadecimal con el formato xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx.
- Comment : string.
- SrcObj : object spec.
- ID : integer.
- attributetype:
- Se puede buscar tipos de atributo filtrando por los siguientes campos:
- Name : string.
- Value : string.
- Date : fecha.
- Consulte la sección "constantes de fecha" en esta guía para más
- info.
- Owner : usuario.
- Admite el usuario especial 'me'.
- GUID : Identificador Global Único.
- Id hexadecimal con el formato xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx.
- Comment : string.
- Source : object spec.
- ID : integer.
- Campos de replicación. Consulte la sección "campos relacionados con la réplica"
- en esta guía para más información sobre:
- ReplLogId
- ReplSrcDate
- ReplSrcId
- ReplSrcRepository
- ReplSrcServer
- branch:
- Se puede buscar ramas filtrando por los siguientes campos:
- Name : string.
- Date : fecha.
- Consulte la sección "constantes de fecha" en esta guía para más
- info.
- Changesets : fecha (de los changesets en la rama).
- Consulte la sección "constantes de fecha" en esta guía para más
- info.
- Attribute : string.
- AttrValue : string.
- Owner : usuario.
- Admite el usuario especial 'me'.
- Parent : branch spec.
- Comment : string.
- GUID : Identificador Global Único.
- Id hexadecimal con el formato xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx.
- Item : item spec or item id (integer).
- ID : integer.
- Campos de replicación. Consulte la sección "campos relacionados con la réplica"
- en esta guía para más información sobre:
- ReplLogId
- ReplSrcDate
- ReplSrcId
- ReplSrcRepository
- ReplSrcServer
- changeset:
- Se puede buscar changesets filtrando por los siguientes campos:
- Branch : branch spec.
- ChangesetId : integer.
- Attribute : string.
- AttrValue : string.
- Date : fecha.
- Consulte la sección "constantes de fecha" en esta guía
- para más info.
- Owner : usuario.
- Admite el usuario especial 'me'.
- GUID : Identificador Global Único.
- Id hexadecimal con el formato xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx.
- Comment : string.
- OnlyWithRevisions : boolean.
- ReturnParent : boolean.
- Parent : changeset id (integer).
- ID : integer.
- Campos de replicación. Consulte la sección "campos relacionados con la réplica"
- en esta guía para más información sobre:
- ReplLogId
- ReplSrcDate
- ReplSrcId
- ReplSrcRepository
- ReplSrcServer
- label:
- Se puede buscar etiquetas filtrando por los siguientes campos:
- Name : string.
- Attribute : string.
- AttrValue : string.
- Date : fecha.
- Consulte la sección "constantes de fecha" en esta guía para más
- info.
- Owner : usuario.
- Admite el usuario especial 'me'.
- GUID : Identificador Global Único.
- Id hexadecimal con el formato xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx.
- Branch : branch spec.
- Branchid : integer.
- Changeset : changeset id (integer).
- Comment : string.
- ID : integer.
- Campos de replicación. Consulte la sección "campos relacionados con la réplica"
- en esta guía para más información sobre:
- ReplLogId
- ReplSrcDate
- ReplSrcId
- ReplSrcRepository
- ReplSrcServer
- merge:
- Se puede buscar merges filtrando por los siguientes campos:
- SrcBranch : branch spec.
- SrcChangeset : changeset id (integer).
- DstBranch : branch spec.
- DstChangeset : changeset id (integer).
- Date : fecha.
- Consulte la sección "constantes de fecha" en esta guía para
- más info.
- Owner : usuario.
- Admite el usuario especial 'me'.
- GUID : Identificador Global Único.
- Id hexadecimal con el formato xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx.
- Type : string.
- Los posibles valores son 'merge', 'cherrypick',
- 'cherrypicksubstractive', 'interval', 'intervalcherrypick'
- e 'intervalcherrypicksubstractive'
- ID : integer.
- replicationlog:
- Se puede buscar replication log filtrando por los siguientes campos:
- Branch : branch spec.
- RepositoryName : string.
- Owner : usuario.
- Admite el usuario especial 'me'.
- Date : fecha.
- Consulte la sección "constantes de fecha" en esta guía para
- más info.
- Server : string.
- Package : boolean.
- ID : integer.
- review:
- Se puede buscar code reviews filtrando por los siguientes campos:
- Status : string.
- Assignee : string.
- Title : string.
- Target : object spec.
- TargetId : integer.
- TargetType : string.
- Los posibles valores son 'branch' y 'changeset'.
- Date : fecha.
- Consulte la sección "constantes de fecha" en esta guía para más
- info.
- Owner : usuario.
- Admite el usuario especial 'me'.
- GUID : Identificador Global Único.
- Id hexadecimal con el formato xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx.
- Id : integer.
- revision:
- Se puede buscar revisiones filtrando por los siguientes campos:
- Branch : branch spec.
- Changeset : changeset id (integer).
- Item : string o integer.
- ItemId : integer.
- Attribute : string.
- AttrValue : string.
- Archived : boolean.
- Comment : string.
- Date : fecha.
- Consulte la sección "constantes de fecha" en esta guía
- para más info.
- GUID : Identificador Global Único.
- Id hexadecimal con el formato xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx.
- Owner : usuario.
- Admite el usuario especial 'me'.
- Parent : revision id (integer).
- ReturnParent : boolean.
- Shelve : shelve id (integer).
- Size : integer (en bytes).
- Type : string.
- Los posibles valores son 'dir', 'bin' y 'txt'.
- WorkspaceCheckoutId : integer.
- ID : integer.
- Campos de replicación. Consulte la sección "campos relacionados con la réplica"
- en esta guía para más información sobre:
- ReplLogId
- ReplSrcDate
- ReplSrcId
- ReplSrcRepository
- ReplSrcServer
- shelve:
- Se puede buscar shelves filtrando por los siguientes campos:
- Owner : usuario.
- Admite el usuario especial 'me'.
- Date : fecha.
- Consulte la sección "constantes de fecha" en esta guía para más
- info.
- Attribute : string.
- AttrValue : string.
- Comment : string.
- GUID : Identificador Global Único.
- Id hexadecimal con el formato xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx.
- Parent : integer.
- ShelveId : integer.
- ID : integer.
- Campos de replicación. Consulte la sección "campos relacionados con la réplica"
- en esta guía para más información sobre:
- ReplLogId
- ReplSrcDate
- ReplSrcId
- ReplSrcRepository
- ReplSrcServer
- Campos relacionados con la réplica:
- Muchos objetos mantienen información de replicación, lo que significa que
- Plastic mantiene el rastro de dónde se crearon originalmente.
- Los campos que se pueden utilizar son:
- ReplSrcServer : Significa "servidor origen de la réplica", y es el
- servidor de donde se trajeron los objetos.
- Ejemplo:
- cm find branch "where replsrcserver='skull.codicefactory.com:9095'"
- ReplSrcRepository : string. Significa "repositorio origen de la réplica",
- y es el repositorio de donde se trajeron los objetos.
- Ejemplo:
- cm find branch "where \
- replsrcserver = 'skull.codicefactory.com:9095' \
- and replsrcrepository = 'codice'"
- ReplLogId : integer. El identificador de la operación de réplica. En
- Plastic, cada vez que un objeto nuevo se crea de una réplica,
- también se crea un nuevo 'replicationlog'.
- Ejemplo:
- cm find replicationlog
- 324054 9/13/2018 02:00:15 /main/scm23064 sluisp plasticscm.com T
- 327255 9/11/2018 12:33:38 /main/scm23042 maria plasticscm.com T
- 329631 9/17/2018 13:06:49 /main/scm23099 sluisp plasticscm.com T
- Ahora se pueden buscar las ramas creadas en la réplica 327255, en
- caso de haber alguna:
- cm find branch "where replogid=327255"
- ReplSrcDate: fecha. Es la fecha en la que la operación de réplica tuvo
- lugar. Los objetos replicados mantienen la fecha en la que
- fueron creados originalmente, por lo que este campo es útil
- si se necesita buscar objetos que fueron replicados en un
- determinado marco temporal.
- Ejemplo:
- cm find replicationlog "where date > 'one week ago'"
- 8780433 27/09/2018 8:49:38 codice@BACKYARD:8087 F mbarriosc
- Ahora se puede verificar que la rama replicada se creó antes de la
- propia operación de réplica:
- cm find branch "where repllogid = 8780433"
- 8780443 26/09/2018 12:20:55 /main/scm23078 maria codice T
- ReplSrcId: integer. Es el ID del servidor origen de la réplica
- (ReplSrcServer). Este ID se puede descubrir buscando objetos
- de tipo 'replicationsource' con el comando 'cm find'.
- Ejemplo:
- cm find replicationsource
- 7860739 codice@AFRODITA:8087 d9c4372a-dc55-4fdc-ad3d-baeb2e975f27
- 8175854 codice@BACKYARD:8087 66700d3a-036b-4b9a-a26f-adfc336b14f9
- Ahora se pueden buscar los changesets replicados desde
- codice@AFRODITA:8087 de la siguiente forma:
- cm find changesets "where replsrcid = 7860739"
- Constantes de fecha:
- Se pueden usar fechas formateadas siguiendo la configuración de localización
- del Sistema Operativo. Por ejemplo, si el SO muestra fechas en el formato
- 'dd/MM/yyyy', se pueden utilizar fechas como '31/12/2018' en las consultas.
- Sin embargo, también se pueden utilizar las siguientes constantes para
- facilitar la escritura de las queries:
- 'today' : la fecha de hoy.
- 'yesterday' : la fecha de ayer.
- 'this week' : la fecha del lunes de la semana actual.
- 'this month' : la fecha del primer día del mes actual.
- 'this year' : la fecha del 1 de enero del año actual.
- 'one day ago' : un día antes de la fecha actual.
- 'one week ago' : una semana antes de la fecha actual.
- 'one month ago' : un mes antes de la fecha actual.
- 'n days ago' : 'n' días antes de la fecha actual.
- 'n months ago' : 'n' meses antes de la fecha actual.
- 'n years ago' : 'n' años antes de la fecha actual.
- Las siguientes cláusulas 'where' son válidas para campos que admitan fechas:
- '(...) where date > 'today' (...)'
- '(...) where date < 'yesterday' (...)'
- '(...) where date > 'this week' (...)'
- '(...) where date > 'this month' (...)'
- '(...) where date < 'one day ago' and date > '3 days ago' (...)'
- '(...) where date < 'one week ago' and date > '3 weeks ago' (...)'
- '(...) where date < 'one month ago' and date > '3 months ago' (...)'
- '(...) where date > '1 year ago' (...)'
- También se puede forzar un determinado formato de fecha en el comando
- 'cm find' utilizando el flag --dateformat. Lee 'cm find --help' para más
- información.
- == CMD_DESCRIPTION_TRIGGER_SHOWTYPES ==
- Muestra la lista de los tipos de triggers disponibles.
- == CMD_USAGE_TRIGGER_SHOWTYPES ==
- Sintaxis:
- cm trigger showtypes
- == CMD_DESCRIPTION_SHOWACL ==
- Muestra la ACL (Lista de Control de Acceso) de un elemento.
- == CMD_USAGE_SHOWACL ==
- Sintaxis:
- cm showacl [opciones] spec_objeto
- spec_objeto Especificación del objeto sobre el que mostrar el ACL.
- Objetos válidos para este comando son repserver,
- repositorio, rama, changeset, etiqueta, item y atributo.
- Usa 'cm help objectspec' para obtener más información
- sobre la especificación de objetos.
- Opciones:
- --extended Muestra información detallada.
- --xml Permite volcar la salida del comando en formato xml
- a la salida estándar. También se permite especificar
- un fichero de salida (--xml=output.xml).
- --encoding Si se utiliza con la opción --xml, permite especificar
- el encoding con el que se guardará la salida del
- comando. Por ejemplo: --encoding=utf-8
- Consulte la documentación de la MSDN para obtener la
- tabla completa de codificaciones soportadas y su formato;
- al final de la página en la columna "Name":
- http://msdn.microsoft.com/en-us/library/system.text.encoding.aspx
- == CMD_HELP_SHOWACL ==
- Notas:
- Este comando se utiliza para obtener una lista de permisos de un usuario o
- un grupo sobre un elemento del repositorio.
- Ejemplos:
- cm showacl repserver:PlasticServer:8084
- cm showacl br:/main --extended
- == CMD_DESCRIPTION_SHOWCOMMANDS ==
- Muestra todos los comandos disponibles.
- == CMD_USAGE_SHOWCOMMANDS ==
- Sintaxis:
- cm showcommands
- == CMD_HELP_SHOWCOMMANDS ==
- == CMD_DESCRIPTION_SHOWOWNER ==
- Muestra el propietario de un elemento del repositorio.
- == CMD_USAGE_SHOWOWNER ==
- Sintaxis:
- cm showowner spec_objeto
- spec_objeto Especificación del objeto para mostar su propietario.
- Usa 'cm help objectspec' para obtener más información
- sobre la especificación de objetos.
- El objeto debe ser uno de los siguientes: repserver,
- repositorio, rama, changeset, etiqueta, atributo,
- revisión e item.
- == CMD_HELP_SHOWOWNER ==
- Notas:
- Este comando muestra el propietario de un elemento del repositorio.
- Puede ser un usuario o un grupo.
- El propietario se puede modificar con el comando 'cm setowner'.
- Ejemplos:
- cm showowner repserver:PlasticServer:8084
- cm showowner rev:fichero.cs#br:/main#LAST
- == CMD_DESCRIPTION_SHOWPERMISSIONS ==
- Muestra la lista de los permisos disponibles.
- == CMD_USAGE_SHOWPERMISSIONS ==
- Sintaxis:
- cm showpermissions
- == CMD_HELP_SHOWPERMISSIONS ==
- Ejemplos:
- cm showpermissions
- == CMD_DESCRIPTION_SHOWSELECTOR ==
- Muestra el selector del espacio de trabajo actual.
- == CMD_USAGE_SHOWSELECTOR ==
- Sintaxis:
- cm showselector [wk_ruta | wk_spec]
- wk_ruta Ruta del espacio de trabajo para mostrar su selector
- wk_spec Especificación del espacio de trabajo para mostrar su
- selector.
- Usa 'cm help objectspec' para obtener más información sobre
- especificaciones de espacios de trabajo.
- == CMD_HELP_SHOWSELECTOR ==
- Notas:
- Si no se especifica una ruta o un especificador de espacio de trabajo,
- el comando tomará como ruta el directorio actual.
- Ejemplos:
- cm showselector c:\workspace
- cm showselector
- cm showselector > miSelector.txt
- cm showselector wk:build_wk@BUILDER
- == CMD_DESCRIPTION_SUPPORT ==
- Este comando permite al usuario efectuar operaciones de soporte.
- == CMD_USAGE_SUPPORT ==
- Sintaxis:
- cm support comando [opciones]
- Comandos:
- bundle
- Para obtener más información sobre cada uno de los comandos ejecute:
- cm support comando --usage
- cm support comando --help
- == CMD_HELP_SUPPORT ==
- Ejemplos:
- cm support
- cm support bundle
- cm support bundle c:\outputfile.zip
- == CMD_DESCRIPTION_SUPPORT_BUNDLE ==
- Crea el paquete de soporte con los ficheros de log relevantes.
- Este paquete se puede adjuntar cuando se solicita la ayuda, cuando
- se pregunte por información extra o cuando se envíe un error.
- == CMD_USAGE_SUPPORT_BUNDLE ==
- Sintaxis:
- cm support bundle [outputfile]
- Opciones:
- outputfile Crea el paquete de soporte en la ruta especificado.
- == CMD_HELP_SUPPORT_BUNDLE ==
- Notas:
- Este comando permite al usuario crear un paquete de soporte con los
- ficheros de log relevantes. Es posible especificar un fichero de salida.
- Ejemplos:
- cm support bundle
- (Crea el paquete de soporte en el directorio temporal)
- cm support bundle c:\outputfile.zip
- (Crea el paquete de soporte en la ruta especificado)
- == CMD_DESCRIPTION_SWITCH ==
- Actualiza el espacio de trabajo a la rama, etiqueta, changeset o shelve especificado.
- == CMD_USAGE_SWITCH ==
- Sintaxis:
- cm switch brspec | csetspec | lbspec | shspec [--repository=name]
- [--workspace=path]
- Opciones:
- --workspace Ruta del espacio de trabajo a cambiar.
- --repository Repositorio al que se va a cambiar.
- Usa 'cm help objectspec' para aprender más sobre cómo indicar
- especificaciones de changesets, ramas y etiquetas.
- == CMD_HELP_SWITCH ==
- Notas:
- Este comando permite a los usuarios actualizar el espacio de trabajo
- con el contenido del objeto especificado (rama, etiqueta o changeset).
- Ejemplos:
- cm switch br:/main
- cm switch lb:Rel1.1
- cm switch Rel2.0
- cm switch cs:4375
- cm switch 5632
- cm switch sh:2
- == CMD_DESCRIPTION_SWITCH_TO_BRANCH ==
- Establece la rama especificada como rama de trabajo.
- == CMD_USAGE_SWITCH_TO_BRANCH ==
- Sintaxis:
- cm switchtobranch [opciones] [spec_rama]
- spec_rama: Especificación de rama.
- Opciones:
- --label=nombre | --changeset=número: Carga las revisiones de la etiqueta
- o changeset especificado. Si no se especifica spec_rama, una de
- estas opciones es obligatoria.
- --workspace | -wk=path: Ruta del espacio de trabajo a cambiar.
- == CMD_HELP_SWITCH_TO_BRANCH ==
- Notas:
- Este comando permite a los usuarios especificar una rama, como rama de
- trabajo. Adicionalmente se puede especificar una etiqueta o un changeset,
- desde la cual se cargarán las revisiones.
- Si no se especifica rama, se ha de especificar una etiqueta o un changeset
- obligatoriamente. Consulte el manual para obtener más información.
- Si no se especifica repositorio, la rama se fija sobre el repositorio
- actual.
- Ejemplos:
- cm switchtobranch br:/main
- cm switchtobranch br:/main/tarea001
- cm switchtobranch --label=BL050
- (Configuración de sólo lectura. Se cargan revisiones del changeset etiquetado)
- == CMD_DESCRIPTION_SYNC ==
- Sincroniza con Git
- == CMD_USAGE_SYNC ==
- Sintaxis:
- cm synchronize | sync repspec git [url [--user=usr_name --pwd=pwd]] [--author]
- [[--txtsimilaritypercent | --binsimilaritypercent | --dirsimilaritypercent]=value]
- repspec Especificación del repositorio.
- Usa 'cm help objectspec' para obtener más información
- sobre la especificación de repositorios.
- git (Default).
- Opciones:
- url URL del repositorio remoto
- (http(s):// o git:// o una URL ssh).
- --user Nombre de usuario para la URL especificada.
- --pwd Contraseña para la URL especificada.
- --txtsimilaritypercent | --binsimilaritypercent | --dirsimilaritypercent
- Opciones para detectar ítems movidos, del mismo modo que
- lo hace la GUI de Plastic SCM.
- --author Usa los valores de nombre y fecha (timestamp) del autor
- en git (git committer by default).
- --skipgitlfs Ignora la configuración de Git LFS que haya en el
- fichero '.gitattributes'. Se comporta como si no
- tuviese soporte de Git LFS.
- == CMD_HELP_SYNC ==
- Notas:
- En caso de sincronizar con un servidor que no requiera credenciales, tras
- la primera sincronización no es necesario introducir el parámetro URL.
- Este comando no soporta repositorios locales.
- En el caso de usar el protocolo SSH, es necesario tener añadido al PATH
- el cliente por línea de comandos 'ssh' y que esté correctamente configurado
- para conectarse al servidor remoto (claves públicas/privadas).
- Ejemplos:
- cm sync default@localhost:8087 git git://localhost/repository
- == CMD_DESCRIPTION_TRIGGER ==
- Use este comando para administrar triggers.
- == CMD_USAGE_TRIGGER ==
- Sintaxis:
- cm trigger | tr command [opciones]
- Comandos:
- create | mk
- delete | rm
- edit
- list | ls
- showtypes
- Para obtener más información sobre cada comando:
- cm trigger command --usage
- cm trigger command --help
- == CMD_HELP_TRIGGER ==
- Ejemplos:
- cm tr mk before-mklabel new "/path/to/script" --server=myserver:8084
- cm tr edit before-mklabel 7 --position=4 --server=myserver:8084
- cm tr ls before-mkbranch --server=myserver:8084
- cm tr rm after-setselector 4
- cm tr showtypes
- == CMD_DESCRIPTION_TUBE ==
- Ejecuta comandos relacionados con Plastic Tube.
- == CMD_USAGE_TUBE ==
- Sintaxis:
- cm tube config -u=user -p=password
- cm tube create remoteuser
- cm tube remove remoteuser
- cm tube local
- cm tube remote
- cm tube share <repository_spec>+ -u=remoteuser -a=access_mode
- cm tube unshare <repository_spec>+ -u=remoteuser
- cm tube connect
- cm tube disconnect
- cm tube status
- Opciones:
- -u Usuario de Tube (el usuario de plasticscm.com)
- -p Password del usuario
- -a Acceso: pull, push o ambos (pull | push | pull,push)
- rep_spec Especificación del repositorio.
- Usa 'cm help objectspec' para obtener más información
- sobre la especificación de repositorios.
- == CMD_HELP_TUBE ==
- Notas:
- config
- Configura Plastic SCM para usar Plastic Tube con el usuario y password
- especificados.
- create
- Crea el Tube remoteuser -> myuser.
- El usuario 'myuser' permite a 'remoteuser' conectarse al servidor
- de 'myuser'.
- Pueden establecerse conexiones de 'remoteuser' a 'myuser'.
- Sólo pueden crearse un Tube de otro usuario al usuario actual de
- Plastic Tube.
- remove
- Elimina el Tube remoteuser -> myuser.
- local
- Lista los repositorios locales compartidos en el servidor local y los
- usuarios con quien son compartidos.
- remote
- Lista los repositorios remotamente compartidos que son compartidos con
- el usuario actual de Plastic Tube.
- share
- Comparte el repositorio(s) local con el usuario y remoto y los permisos
- especificados.
- unshare
- Deja de compartir el repositorio local con el usuario remoto.
- connect
- Conecta el servidor de Plastic SCM a Plastic Tube.
- disconnect
- Desconecta el servidor de Plastic SCM de Plastic Tube.
- status
- Muestra si el servidor de Plastic SCM está conectado a Plastic Tube.
- Ejemplos:
- cm tube config -u=ruben@codicesoftware.com -p=rubenpassword
- cm tube create pablo@codicesoftware.com
- ('pablo@codicesoftware.com' puede conectar con el usuario actual del Tube)
- cm tube remove pablo@codicesoftware.com
- cm tube local
- cm tube remote
- cm tube share repo@server:8087 -u=pablo@codicesoftware.com -a=pull,push
- cm tube share repo@server:8087 doc@server:8087 -u=pablo@codicesoftware.com -a=push
- cm tube unshare repo@server:8087 -u=pablo@codicesoftware.com
- cm tube connect
- cm tube disconnect
- cm tube status
- == CMD_DESCRIPTION_UNCO ==
- Deshace la desprotección de un ítem.
- == CMD_USAGE_UNCO ==
- Sintaxis:
- cm undocheckout | unco <item_path>+ [--all] [--symlink] [--silent]
- item_path Especificación de los ítems para deshacer la desprotección,
- separados por comas.
- Se pueden usar comillas (") para especificar rutas que
- contengan espacios.
- Use . para aplicar la operación al directorio actual.
- Opciones:
- --all (-a) Los ítems especificados que han sido cambiados, movidos y
- borrados localmente también serán deshechos.
- --symlink Deshace la protección del fichero de link y no al elemento
- al que apunta.
- --silent No muestra salida.
- == CMD_HELP_UNCO ==
- Notas:
- Si se desean descartar los cambios realizados en un ítem desprotegido
- previamente, se utiliza este comando.
- El ítem se cambia a la revisión justamente anterior.
- Requisitos para deshacer la desprotección:
- El ítem ha de estar controlado por Plastic
- El ítem ha de estar desprotegido
- Ejemplos:
- cm undocheckout .
- (Desprotege el directorio actual)
-
- cm undocheckout fichero1.txt fichero2.txt
-
- cm unco c:\workspace\fichero.txt
-
- cm undocheckout -R c:\workspace\src
- (Deshace la desprotección de 'src' recursivamente)
-
- cm unco link --symlink
- (Efectúa la desprotección sobre el fichero de link y no del que apunta,
- disponible en entornos UNIX)
- cm unco code\cgame\cg_main.c --all
- (Deshace la desprotección del fichero cambiado)
- Deshacer 'changelist'. Ejemplo:
- cm status --short --changelist=pending_to_review | cm undocheckout -
- (El comando listará los paths en el changelist llamado 'pending_to_review'
- y dicha lista será redirigida a la entrada del comando 'uncheckout').
- == CMD_DESCRIPTION_UNCOUNCHANGED ==
- Deshace la desprotección en elementos que no han cambiado.
- == CMD_USAGE_UNCOUNCHANGED ==
- Sintaxis:
- cm uncounchanged [opciones]
- Opciones:
- -R|-r|--recursive Descender recursivamente dentro de directorios.
- == CMD_HELP_UNCOUNCHANGED ==
- Notas:
- Este comando se aplica desde la raíz del workspace recursivamente.
- Ejemplos:
- cm uncounchanged
- == CMD_DESCRIPTION_UNDELETE ==
- Recupera en el espacio de trabajo la revisión especificada en la ruta dada.
- == CMD_USAGE_UNDELETE ==
- Sintaxis:
- cm undelete rev_spec ruta
- rev_spec: Especificación de la revisión del ítem cuyo contenido se desea
- cargar en el espacio de trabajo.
- path: Ruta donde se va a restaurar.
- == CMD_HELP_UNDELETE ==
- Notas:
- El elemento a recuperar no debe de estar ya cargado en el workspace.
- La operación de recuperar no esta soportada para xlinks.
- Ejemplo:
- cm undelete revid:756 C:\mywks\src\foo.c
- cm undelete itemid:68#cs:2 C:\mywks\dir\myfile.pdf
- cm undelete serverpath:/src#br:/main C:\mywks\Dir
- == CMD_DESCRIPTION_UNDOCHANGE ==
- Deshace los cambios hechos en un fichero.
- == CMD_USAGE_UNDOCHANGE ==
- Notas:
- Si se desean descartar los cambios en un ítem, independientemente de su
- estado (desprotegido o modificado sin hacer desprotección), este comando
- vuelve a la revisión anterior. Si se ordena realizar la operación sobre
- un directorio en vez de un fichero la acción se realiza recursivamente por
- defecto.
- Ejemplo:
- cm unc . (Descarta los cambios de los ítems del directorio actual).
- cm unc fichero1.txt fichero2.txt
- cm unc c:\workspace\fichero1.txt
- == CMD_HELP_UNDOCHANGE ==
- Ejemplo:
- cm unc . (Descarta los cambios de los ítems del directorio actual).
- cm unc fichero1.txt fichero2.txt
- cm unc c:\workspace\fichero1.txt
- == CMD_DESCRIPTION_LOCK_UNLOCK ==
- Deshace los bloqueos en los elementos del servidor de bloqueos especificado
- == CMD_USAGE_LOCK_UNLOCK ==
- Sintaxis:
- cm lock unlock [repserverspec] <guid>+
- repserverspec Especificación del servidor de repositorio.
- Usa 'cm help objectspec' para obtener más información
- sobre la especificación de servidores.
- guid Lista de GUIDs de ítems a desbloquear, separados por
- espacios.
- == CMD_DESCRIPTION_UNDO ==
- Deshace cambios en un workspace.
- == CMD_USAGE_UNDO ==
- Syntaxis:
- cm undo [path]+ [--symlink] [-r | --recursive] [Filtros]+
- [Opciones de salida]
- path Rutas de los ficheros o carpetas a los que aplicar
- la operación, separados por espacios. Se pueden
- utilizar comillas (") para especificar rutas con
- espacios. Si no se especifica ninguna ruta, por
- defecto la operación se ejecutará sobre los ficheros
- en el directorio actual.
- Opciones:
- --symlink Aplica la operación de undo al enlace simbólico y
- no a su destino.
- -r Ejecuta el undo de manera recursiva.
- Filtros:
- Si ninguna de estas opciones está presente, por defecto se deshacen todos
- los tipos de cambio, pero los ficheros pueden filtrarse utilizando estas
- opciones.
- Si un fichero o directorio tiene uno o más de los tipos de cambio
- especificados, todos los cambios en ese fichero o directorio serán
- deshechos.
- Por ejemplo, si se especifica tanto --checkedout como --moved, si un fichero
- está tanto movido como checkedout, ambos cambios se desharán.
- --checkedout Selecciona ficheros y directorios marcados para
- cambios.
- --unchanged Selecciona ficheros sin modificaciones en su
- contenido.
- --changed Selecciona ficheros y directorios cambiados o
- marcados para cambios.
- --deleted Selecciona ficheros y directorios eliminados.
- --moved Selecciona ficheros y directorios movidos.
- --added Selecciona ficheros y directorios añadidos.
- Opciones de salida:
- --silent | --machinereadable [--startlineseparator=sep]
- [--endlineseparator=sep] [--fieldseparator=sep]
- --silent No muestra ninguna salida.
- --machinereadable Muestra la salida en un formato fácil de tratar.
- --startlineseparator Usado en conjunto con la opción '--machinereadable',
- especifica cómo deberían comenzar las líneas.
- --endlineseparator Usado en conjunto con la opción '--machinereadable',
- especifica cómo deberían terminar las líneas.
- --fieldseparator Usado en conjunto con la opción '--machinereadable',
- especifica cómo deberían separarse las líneas.
- == CMD_HELP_UNDO ==
- Notas:
- El comand undo es peligroso - deshace trabajo de una manera irreversible.
- Una vez que el undo termina, no hay manera posible de recuperar el estado
- anterior de los ficheros y directorios afectados. Si no se especifica
- ninguna ruta en los argumentos, por defecto se desharán los cambios en todos
- los elementos del directorio actual, pero NO de manera recursiva.
- Estos comandos son equivalentes ejecutados desde el directorio /src:
- /src
- |- file.txt
- |- code.cs
- \- /test
- |- test_a.py
- \- test_b.py
- $ cm undo
- $ cm undo *
- $ cm undo file.txt code.cs /test
- $ cm undo .
- $ cm undo /src file.txt code.cs
- Si se quiere que la operación sea recursiva, se necesita especificar la
- opción -r.
- Para deshacer todos los cambios debajo de un directorio (incluyendo los
- cambios sobre el propio directorio):
- $ cm undo dirpath -r
- Si dirpath es la ruta de un workspace, todos los cambios dentro del
- workspace serán deshechos.
- Ficheros borrados:
- Para deshacer borrados de fichero o directorios es necesario especificar la
- ruta completa del fichero o directorio, o el directorio padre más la opción
- -r (recursivo).
- Por ejemplo:
- $ cm undo .
- (NO deshace los borrados en el directorio actual.)
- $ cm undo . -r
- (Deshace todos los borrados (y otros cambios) recursivamente del directorio
- actual.)
- $ cm undo src/file.txt
- (Deshace el borrado (u otro cambio) del fichero src/file.txt.)
- Ejemplos:
- $ cm undo . -r
- (Deshace todos los cambios en el directorio actual de manera recursiva. Si
- se ejecuta desde la raíz del workspace, deshace todos los cambios en el
- workspace completo.)
- $ cm co file.txt
- $ cm undo file.txt
- (Deshace el checkout en file.txt.)
- $ echo content >> file.txt
- $ cm undo file.txt
- (Deshace el cambio local en file.txt.)
- $ cm undo src
- (Deshace los cambios en el directorio src y en todos los ficheros
- controlados que contenga)
- $ cm undo src/*
- (Deshace los cambios en todos los elementos contenidos en src, sin afectar
- al propio directorio. Por la expansión del wildcard, es equivalente a
- 'cm undo src/file1.txt src/file2.txt').
- $ cm undo *.cs
- (Deshace cambios en cada elemento que encaje con el patrón *.cs en el
- directorio actual.)
- $ cm undo *.cs -r
- (Deshace cambios en cada elemento que encaje con el patrón *.cs en el
- directorio actual, y en cada directorio por debajo de una manera recursiva.)
- $ cm co file1.txt file2.txt
- $ echo content >> file1.txt
- $ cm undo --unchanged
- (Deshace el checkout en file2.txt por no estar modificado, ignorando
- file1.txt ya que tiene cambios locales.)
- $ echo content >> file1.txt
- $ echo content >> file2.txt
- $ cm co file1.txt
- $ cm undo --checkedout
- (Deshace el cambio en el fichero en checkout file1.txt, ignorando file2.txt
- ya que no está en checkout.)
- $ cm add file.txt
- $ cm undo file.txt
- (Deshace el añadido de file.txt, dejándolo de nuevo como privado.)
- $ rm file1.txt
- $ echo content >> file2.txt
- $ cm add file3.txt
- $ cm undo --deleted --added *
- (Deshace el borrado de file1.txt y el añadido de file3.txt, ignorando
- el cambio en file2.txt.)
- == CMD_HELP_LOCK_UNLOCK ==
- Ejemplos:
- cm lock unlock 91961b14-3dfe-4062-8c4c-f33a81d201f5
- cm lock unlock DIGITALIS:8084 2340b4fa-47aa-4d0e-bb00-0311af847865 bcb98a61-2f62-4309-9a26-e21a2685e075
- Notas:
- El comando utilizará el servidor especificado para realizar los desbloqueos.
- Si no se especifica ningún servidor, el comando intentará obtener un
- servidor válido a través del espacio de trabajo actual.
- Si con los pasos anteriores no se pudo calcular ningún servidor, el comando
- utilizará el servidor especificado en la configuración del cliente.
- Sólo el usuario administrador del servidor de repositorios podrá ejecutar
- el comando "cm unlock".
- Para la especificación de los GUID's de los elementos, el formato ha de ser
- de 32 dígitos separados por guiones (y opcionalmente, rodeado por llaves):
- {00000000-0000-0000-0000-000000000000} ó 00000000-0000-0000-0000-000000000000
- == CMD_DESCRIPTION_UPDATE ==
- Actualiza el espacio de trabajo.
- == CMD_USAGE_UPDATE ==
- Sintaxis:
- cm update [<ruta> | --last]
- [--changeset=csetspec] [--cloaked] [--dontmerge] [--forced]
- [--ignorechanges] [--override] [--recursewk] [--skipchangedcheck]
- [--silent] [--verbose] [--xml[=output_file]] [--encoding=name]
- ruta Ruta a actualizar.
- Usa . para aplicar la actualización al directorio actual.
- Omita la ruta para actualizar todo el espacio de trabajo
- Si no se especifica ninguna ruta, entonces se actualiza
- todo el espacio de trabajo parcial.
- --last Antes de la actualización, cambia el selector del
- espacio de trabajo de una configuración de changeset o
- de etiqueta a una configuración de rama.
- El selector se cambia a la rama a la que pertenece el
- changeset o la etiqueta.
-
- Opciones:
-
- --changeset Actualiza el espacio de trabajo a un changeset concreto.
- Usa 'cm help objectspec' para obtener más información
- sobre la especificación de changesets.
- --cloaked Incluye los ítems cloaked en la operación de update. Si
- no se utiliza esta opción, aquellos ítems marcados como
- cloaked serán ignorados en la operación.
- --dontmerge En el caso en que se necesite una operación de update
- merge, esta operación no se realizará.
- --forced Fuerza la escritura de todas las revisiones.
- --ignorechanges Ignora el mensaje de aviso de "cambios pendientes" si
- existen cambios pendientes durante la actualización del
- espacio de trabajo.
- --override Se ignoran los ficheros cambiados fuera del control de
- Plastic SCM, sobrescribiendo su contenido con el del
- control de versiones.
- --recursewk Actualiza todos los espacios de trabajo encontrados en
- la actual ruta. Esto es útil para actualizar todos los
- espacios de trabajo contenidos en la ruta especificada.
- --skipchangedcheck El update comprueba si hay cambios locales en el
- workspace antes de empezar. Si siempre haces co antes
- de modificar un fichero, puedes usar esta opción para
- acelarar la operación.
- --silent No muestra ninguna salida.
- --verbose Muestra información adicional.
- --xml Permite volcar la salida del comando en formato xml a la
- salida estándar. También se permite especificar un
- fichero de salida (--xml=output.xml).
- --forcedetailedprogress Fuerza mostrar progreso detallado incluso cuando se
- redirige la salida estándar.
- --encoding Si se utiliza con la opción --xml, permite especificar
- el encoding con el que se guardará la salida del
- comando. Consulte la documentación de MSDN para obtener
- la tabla completa de codificaciones soportadas y su
- formato (al final de la página, en la columna "Name"):
- http://msdn.microsoft.com/en-us/library/system.text.encoding.aspx
- == CMD_HELP_UPDATE ==
- Notas:
- Cuando se trabaja con varias ramas o cuando varias personas trabajan contra
- una rama, la información que tenemos en el espacio de trabajo puede quedar
- desactualizada. El caso más sencillo se da cuando cambiamos de rama. Al
- cambiar el selector apuntando a otra rama, debemos actualizar el espacio de
- trabajo con las revisiones de esa rama.
- Cuando varias personas trabajan contra una rama, crean revisiones nuevas
- cada poco tiempo y es fundamental poder actualizar el espacio de trabajo
- para obtener las últimas revisiones.
- Para ello utilizaremos el comando update. Este comando actualiza el espacio
- de trabajo con las revisiones que se le indiquen en el selector.
- Solamente obtiene los ficheros necesarios. Si la revisión que hay en el
- espacio de trabajo coincide con la que hay en el repositorio no se
- actualiza, a no ser que se utilice la opción -–forced. Si la revisión del
- espacio de trabajo es más nueva que la que hay en el repositorio tampoco
- se actualiza. En este caso no nos valdrá la opción -–forced.
- NOTA: El comando update siempre asume recursividad.
- Cuando se especifica la opción --last, no es necesario especificar una ruta.
- En ese caso, el espacio de trabajo del directorio actual es actualizado.
- (Recuerde que al especificar el flag --last puede causar que el selector
- del espacio de trabajo cambie a una rama si previamente apuntaba a un
- changeset o una etiqueta).
- Ejemplos:
- cm update (actualiza el espacio de trabajo actual)
- cm update . (obtiene el directorio actual y todos sus hijos)
- cm update . --forced --verbose (fuerza a escibir todas las revisiones,
- y muestra más información)
- cm udpate --last
- == CMD_DESCRIPTION_VERSION ==
- Muestra el número de versión del cliente.
- == CMD_USAGE_VERSION ==
- Sintaxis:
- cm version
- == CMD_HELP_VERSION ==
- == CMD_DESCRIPTION_WHOAMI ==
- Muestra el usuario actual de Plastic SCM.
- == CMD_USAGE_WHOAMI ==
- Sintaxis:
- cm whoami
- == CMD_HELP_WHOAMI ==
- == CMD_USAGE_WKTREENODESTATUS ==
- Uso:
- cm wktreenodestatus path1, path2, ...
- == CMD_DESCRIPTION_WORKSPACE ==
- Use este comando para administrar workspaces.
- == CMD_USAGE_WORKSPACE ==
- Sintaxis:
- cm workspace | wk comando [options]
- Comandos:
- list | ls
- create | mk
- delete | rm
- move | mv
- rename
- Para obtener más información sobre cada comando:
- cm workspace comando --usage
- cm workspace comando --help
- == CMD_HELP_WORKSPACE ==
- Ejemplos:
- cm workspace create myWorkspace wk_path
- cm workspace list
- cm workspace delete myWorkspace
- == CMD_DESCRIPTION_WORKSPACE_CREATE ==
- Crea un nuevo workspace.
- == CMD_USAGE_WORKSPACE_CREATE ==
- Sintaxis:
- cm workspace | wk [create | mk] nombre ruta [rep_spec] [--selector[=selector_file]
- nombre ruta --dynamic --tree=[tree]
- nombre Nombre del nuevo workspace.
- ruta Ruta de acceso del workspace.
- rep_spec Crea el nuevo workspace con el repositorio especificado.
- Use 'cm help objectspec' para obtener más
- información sobre especificaciones de repositorios.
- Opciones:
- --selector Edita el selector para el nuevo workspace.
- Si se especifica selector-file, entonces el selector
- para el nuevo workspace se fiha desde el fichero
- especificado.
- --dynamic Crea un workspace dinámico. Esta funcionalidad es
- todavía experimental, y solo está disponible para
- Windows. Si se usa esta opción, es obligatorio usar el
- parámetro --tree.
- --tree Especifica el punto inicial al que apuntará el
- workspace dinámico. Puede ser una especificación de
- rama, changeset o etiqueta. El workspace continuará
- usando el repositorio de la especificación. Use
- 'cm help objectspec' para obtener más información sobre
- la especificación.
- == CMD_HELP_WORKSPACE_CREATE ==
- Notas:
- - Un workspace es una vista del repositorio mapeado en el sistema de
- ficheros local, en un directorio especificado. Utilice los comandos
- 'cm showselector' y 'cm setselector' para ver y modificar el selector.
- - Si no se especifica rep_spec ni --selector, el workspace cargará
- automáticamente el contenido del primer repositorio (alfabéticamente) del
- servidor configurado en el fichero de configuración client.conf
- - Los workspaces dinámicos son una funcionalidad experimental (sólo Windows),
- y requiere que el programa plasticfs.exe se esté ejecutando en segundo
- plano.
- Ejemplos:
- cm workspace create myworkspace c:\workspace
- cm wk mk myworkspace /home/john/wkspace
- (Crea el workspace 'myworkspace' en 'c:\workspace' y '/home/john/wkspace'
- respectivamente.)
- cm wk mywktest c:\wks\wktest --selector=myselector.txt
- (Crea 'mywktest' utilizando como selector 'myselector.txt'.)
- cm wk mywkprj c:\wks\wkprj myrep@repserver:localhost:8084
- (Crea 'mywkprj' en 'c:\wks\wkprj' con el repositorio seleccionado.)
- cm wk mywkprj c:\dynwks\mywkprj --dynamic --tree=br:/main@myrep@localhost:8084
- (Crea el workspace dinámico 'mywkprj' en 'c:\dynwks\mywkprj' con el
- repositorio 'myrep@localhost:8084', apuntando a la rama '/main' la primera
- vez que se monte.)
- == CMD_DESCRIPTION_WORKSPACE_DELETE ==
- Borra un workspace.
- == CMD_USAGE_WORKSPACE_DELETE ==
- Sintaxis:
- cm workspace | wk delete | rm [ruta | wkspec] [--keepmetadata]
- ruta Ruta del workspace.
- wkspec Especificación del workspace a borrar.
- Use 'cm help objectspec' para obtener más información sobre la
- especificación de espacios de trabajo.
- Opciones:
- --keepmetadata: No elimina los archivos de metadatos del directorio
- .plastic.
- == CMD_HELP_WORKSPACE_DELETE ==
- Notas:
- Si no se especifican parámetros, se borrará el workspace actual.
- Ejemplos:
- cm workspace delete
- (Elimina el workspace actual)
- cm wk delete c:\workspace
- cm workspace rm /home/danipen/wks
- cm wk rm wk:MiWorkspace
- cm wk rm wk:MiWorkspace@DIGITALIS
- == CMD_DESCRIPTION_WORKSPACE_LIST ==
- Muestra la lista de workspaces.
- == CMD_USAGE_WORKSPACE_LIST ==
- Sintaxis:
- cm workspace | wk [list | ls] [--format=str_format]
- Opciones:
- --format Devuelve el mensaje de respuesta con el formato
- especificado. Consulte la ayuda para más información.
- == CMD_HELP_WORKSPACE_LIST ==
- Notas:
- Este comando acepta una cadena de texto formateada para mostrar la
- salida.
- Los parámetros de salida del comando son los siguientes:
- {0} | {wkname} Nombre del workspace.
- {1} | {machine} Nombre de la máquina.
- {2} | {path} Ruta del workspace.
- {3} | {wkid} Identificador único del workspace.
- {4} | {wkspec} Especificación del workspace en el formato:
- 'wkname@machine'.
- {tab} Inserta un tabulador.
- {newline} Inserta una nueva línea.
- Ejemplos:
- cm wk
- (Lista todos los workspaces.)
- cm workspace list --format={0}#{3,40}
- cm workspace list --format={wkname}#{wkid,40}
- (Lista todos los workspaces mostrando el nombre del workspaces, el
- símbolo '#' y el identificador del workspace utilizando 40 espacios y
- alineado a la izquierda.)
- cm wk --format="Workspace {0} in path {2}"
- cm wk --format="Workspace {wkname} in path {path}"
- (Lista todos los workspaces, mostrando los resultados en cadenas
- formateadas.)
- == CMD_DESCRIPTION_WORKSPACE_MOVE ==
- Mueve un workspace.
- == CMD_USAGE_WORKSPACE_MOVE ==
- Sintaxis:
- cm workspace | wk move | mv [wkspec] ruta
- Opciones:
- wkspec Especificación del workspace a ser movido.
- Use 'cm help objectspec' para obtener más información sobre la
- especificación de espacios de trabajo.
- ruta La ruta destino a la que mover el workspace.
- == CMD_HELP_WORKSPACE_MOVE ==
- Notas:
- Este comando permite al usuario mover workspace a otro lugar en disco.
- Ejemplos:
- cm workspace move myWorkspace \new\workspaceDirectory
- (Mueve el workspace a la ruta especificada.)
- cm wk mv C:\wkspaces\newpath
- (Mueve el workspace de trabajo a 'C:\wkspaces\newpath')
- == CMD_DESCRIPTION_WORKSPACE_RENAME ==
- Cambia el nombre de un workspace.
- == CMD_USAGE_WORKSPACE_RENAME ==
- Sintaxis:
- cm workspace | wk rename [nombre_antiguo] nombre_nuevo
- nombre_antiguo Nombre antiguo del workspace.
- nombre_nuevo Nombre nuevo del workspace.
- == CMD_HELP_WORKSPACE_RENAME ==
- Notas:
- Este comando renombra un workspace. Si no se especifica nombre_antiguo,
- el sistema tomará el nombre del workspace actual.
- Ejemplos:
- cm workspace rename miworkspace wk2
- (El workspace 'miworkspace' se renombra a 'wk2'.)
- cm wk rename nuevoNombre
- (El workspace actual se renombra a 'nuevoNombre'.)
- == CMD_DESCRIPTION_WORKSPACESTATUS ==
- Muestra el changeset cargado en un workspace y si los hay los elementos cambios que contiene.
- == CMD_USAGE_WORKSPACESTATUS ==
- Sintaxis:
- cm status [workspacepath] [opciones] [tipos_de_búsqueda]
- workspacepath: El path de un workspace determinado o una ruta por debajo
- del mismo. La búsqueda de cambiados se realizará a partir del path
- especificado y de manera recursiva.
- Opciones generales:
- --changelist=NAME: Muestra los cambios en el 'changelist' llamado "NAME".
- --changelists: Muestra los cambios agrupados en 'changelists'.
- --cutignored: Evita mostrar los contenidos de los directorios ignorados.
- Requiere el tipo de búsqueda --ignored.
- --header: Solo imprimirá la información del changeset cargado en el
- workspace, no realizará la búsqueda de elementos cambiados.
- --noheader: El comando no imprimirá el estado del workspace, sólo
- realizará e imprimirá la búsqueda de elementos cambiados.
- --nomergesinfo: La información de los merges de los cambios no se imprimirá.
- --head: El comando imprimirá el estado del último changeset de la rama.
- --short: Muestra únicamente rutas de elementos que tienen cambios.
- --symlink: Aplica la operación a los enlaces simbólicos en lugar de
- aplicarla a sus destinos.
- --dirwithchanges: Muestra directorios que contienen cambios (ítems
- añadidos, movidos o eliminados en su interior).
- --xml: Permite volcar la salida del comando en formato xml. Por defecto la
- salida sale en la pantalla, pero si se especifica un fichero
- (--xml=output.xml) la salida se vuelca en dicho fichero.
- --encoding: si se utiliza con la opción --xml, permite especificar el
- encoding con el que se guardará la salida del comando. Consulte la
- documentación de la MSDN para obtener la tabla completa de
- codificaciones soportadas y su formato; al final de la página en la
- columna "Name":
- http://msdn.microsoft.com/en-us/library/system.text.encoding.aspx
- --wkrootrelativepaths, --wrp: Muestra rutas relativas a la raíz del
- workspace en vez de rutas relativas al directorio actual.
- --fullpaths, --fp: Fuerza al comando a imprimir rutas absolutas,
- sobreescribiendo cualquier otra configuración acerca de impresión
- de rutas.
- Opciones del viejo formato:
- --cset: El comando imprimirá el estado del workspace en el viejo formato.
- --compact: El comando imprimirá el estado del workspace y la búsqueda de
- elementos cambiados en el viejo formato.
- --noheaders: Usado junto con --compact, la información de cada grupo de
- cambiós no se imprimirá. (No aplica al nuevo formato.)
- Tipos de búsqueda:
- --added: El comando busca elementos añadidos.
- --checkout: El comando busca elementos en checkout.
- --changed: El comando busca elementos cambiados.
- --copied: El comando busca elementos copiados.
- --replaced: El comando busca elementos reemplazados.
- --deleted: El comando busca elementos borrados.
- --localdeleted: El comando busca elementos borrados localmente.
- --moved: El comando busca elementos movidos.
- --localmoved: El comando busca elementos movidos localmente.
- --percentofsimilarity (-p)=valor: Porcentaje de similitud entre dos
- ficheros para considerarlos el mismo en la búsqueda de movidos
- locales, su valor por defecto es un 20%.
- --txtsameext: Sólo aquellos ficheros de texto que tengan la misma
- extensión serán tenidos en cuenta para la búsqueda de movidos basada
- en la similitud del contenido. Por defecto todos los ficheros de texto
- son procesados.
- --binanyext: Cualquier fichero binario es tenido en cuenta para la
- búsqueda de movidos basada en la similitud del contenido. Por defecto
- sólo aquellos ficheros binarios que tengan la misma extensión
- son procesados.
- --private: El comando busca elementos no controlados.
- --ignored: El comando busca elementos ignorados.
- --hiddenchanged: El comando busca elementos cambiados marcados como
- ocultos (incluye '--changed').
- --cloaked: El comando busca elementos marcados como cloaked.
- --controlledchanged: Este modificador engloba los siguientes parámetros:
- '--added' '--checkout' '--copied' '--replaced' '--deleted' '--moved'.
- --all (-a): Este modificador engloba los siguientes parámetros:
- '--controlledchanged' '--changed' '--localdeleted' '--localmoved'
- '--private'.
- == CMD_HELP_WORKSPACESTATUS ==
- Notas:
- El comando status muestra el changeset cargado en un workspace
- y si los hay, los cambios que contiene.
- Se puede utilizar el comando para saber cuál es el changeset con el que se
- está trabajando en un momento dado, y poder utilizarlo, por ejemplo, para
- marcar configuraciones concretas mediante etiquetas de tipo changeset.
- También es útil para conocer los cambios pendientes que existen dentro
- del workspace, los tipos de cambios que deseamos obtener del workspace pueden
- ser modificados gracias a los parámetros que el comando admite. Por defecto
- se muestran todos los cambios, controlados y locales.
- El porcentaje de similitud entre dos ficheros usado por el algoritmo de
- cálculo de movidos locales se puede especicifar mediante la option '--percentofsimilarity'
- o '-p' y su rango va desde 0 hasta 100. Si este parámetro no es especidicado
- su valor por por defecto es del 20%.
- A través de éste comando, también es posible mostrar los cambios agrupados
- en 'changelists' de cliente. El changelist por defecto del sistema (llamado
- 'default'), agrupa los cambios que no están contenidos en el resto de
- 'changelists', por lo que los cambios que se muestran especificando éste
- 'changelist', dependerán del tipo de búsquedas especificados en el comando.
- La opción de mostrar cambios agrupados en 'changelists' requiere mostrar cambios
- controlados (en estado 'added', 'checkout', 'copied', 'replaced', 'deleted' o
- 'moved'), por lo que la opción '--controlledchanged' se activará automáticamente
- cuando se muestren 'changelists'.
- El formato por defecto para la salida en XML es UTF-8. Es posible cambiar
- dicho encoding usando la opción --encoding=otro_encoding.
- El comando 'status' imprime por defecto rutas relativas al directorio de trabajo,
- a menos que se especifiquen las opciones '--machinereadable' o '--short'
- (en cuyo caso, se imprimen rutas absolutas).
- Si se usa la opción '--xml', el comando 'status' imprimirá por defecto rutas
- relativas a la raíz del workspace, a menos que se especifique adicionalmente
- la opción '--fp' (en cuyo caso, se imprimen rutas absolutas).
- Ejemplos:
- cm status
- (Ejecutándolo dentro de un workspace el comando imprime el changeset cargado
- y los elementos en checkout, añadidos, copiados, reemplazados, borrados, borrados locales,
- movidos, movidos locales, y privados. La busqueda de los elementos se realiza
- sobre el workspace de forma recursiva)
- cm status --controlledchanged
- (Ejecutándolo dentro de un workspace el comando imprime el changeset cargado
- y los elementos del workspace en checkout, añadidos, copiados, reemplazados,
- borrados, y movidos)
- cm status --added
- (Ejecutándolo dentro de workspace el comando imprime el changeset cargado
- y solamente los elementos añadidos. La búsqueda de los elementos se realiza
- sobre el workspace de forma recursiva)
- cm status c:\workspaceLocation\code\client --added
- (El comando imprime el changeset cargado y solamente los elementos añadidos.
- La búsqueda de los elementos se realiza sobre el path proporcionado de forma recursiva)
- cm status --changelists
- cm status --changelist
- (El comando muestra todos los cambios en el espacio de trabajo, agrupados
- por 'changelists').
- cm status --changelist=pending_to_review
- (El comando muestra los cambios que contiene el changelist 'pending_to_review')
- cm status --changelist=default --private
- (El comando muestra los cambios que contiene el changelist 'default',
- el changelist por defecto del sistema, mostrando elementos privados,
- además de elementos con cambios controlados si los hubiese).
- cm status --short --changelist=pending_to_review | cm checkin -
- (Se protegen los cambios en el changelist llamado 'pending_to_review').
- cm status c:\workspaceLocation\code\client --xml=output.xml
- (Guarda la salida del status en el fichero output.xml, en formato XML y
- usando UTF-8.)
- cm status --ignored
- (Muestra todos los elementos ignorados)
- Salida:
- IG src
- IG src/version.c
- IG out/app.exe
- cm status --ignored --cutignored
- (Muestra ficheros ignorados cuyo directorio padre no está ignorado y
- directorios ignorados pero no el árbol de sus contenidos)
- Salida:
- IG src
- IG out/app.exe
- == CMD_DESCRIPTION_XLINK ==
- Crea, edita o muestra un xlink
- == CMD_USAGE_XLINK ==
- Sintaxis:
- cm xlink [-w] [-rs] xlink_path / <csetspec | lbspec | brspec> [<expansion_rules>+]
- (Crea un xlink).
- cm xlink [-rs] xlink_path /relative_path <csetspec | lbspec | brspec> [<expansion_rules>+]
- (Crea un xlink parcial de solo lectura apuntando a /relative_path en lugar
- de apuntar a la raíz por defecto / ).
- cm xlink -e xlink_path <csetspec | lbspec | brspec>
- (Edita un xlink para cambiar la especificación destino).
- cm xlink -s|--show xlink_path
- (Muestra la información de un xlink incluyendo las reglas de expansión).
- cm xlink -ar|--addrules xlink_path <expansion_rules>+
- (Añade al xlink las reglas de expansión proporcionadas).
- cm xlink -dr|--deleterules xlink_path <expansion_rules>+
- (Borra del xlink las reglas de expansión especificadas).
- xlink_path Ruta en el espacio de trabajo actual donde se cargan
- los contenidos del repositorio que se va a enlazar
- (cuando se crea un xlink) o que ya está enlazado
- (cuando se edita un xlink).
- csetspec Especificación del changeset que se va a enlazar.
- Determina qué versión y rama se carga en el espacio de
- trabajo para el repositorio enlazado.
- Usa 'cm help objectspec' para obtener más información
- sobre la especificación de changesets.
- lbspec Especificación de la etiqueta que se va a enlazar.
- Usa 'cm help objectspec' para obtener más información
- sobre la especificación de etiquetas.
- brspec Especificación de la rama que se va a enlazar.
- Usa el changeset actual a donde la rama especificada
- está apuntando.
- Usa 'cm help objectspec' para obtener más información
- sobre la especificación de ramas.
- -e Indica que el comando va a editar un xlink existente
- para cambiar la especificación del changeset enlazado.
- -s | --show Muestra información sobre el xlink seleccionado.
- -ar | --addrules Añade una o más reglas de expansión al xlink indicado.
- -dr | --deleterules Borra una o más reglas de expansión del xlink indicado.
- expansion_rules Especifica una o más reglas de expansión. Cada regla de
- expansión es un par (rama)-(rama a enlazar)
- br:/main/fix-br:/main/develop/fix
- Opciones:
- -w Crea un xlink de escritura. Esto significa que los
- contenidos bajo el xlink se podrán editar mediante el
- uso de autoexpansión de ramas.
- -rs Relative server. Permite crear un xlink a un repositorio
- que es una réplica de otro que existe en un servidor
- central. De este modo se reconcilian automáticamente los
- repositorios replicados con el original.
- Ejemplos:
- cm xlink codigo\segundorepositorio / 1@segundo@localhost:8084
- cm xlink codigo\segundorepositorio / lb:LB001@segundo@localhost:8084
- cm xlink -s codigo\segundorepositorio
- cm xlink -ar codigo\segundorepositorio br:/main-br:/main/develop br:/main/fix-br:/main/develop/fix
- cm xlink -dr codigo\segundorepositorio br:/main/fix-br:/main/develop/fix
- == CMD_HELP_XLINK ==
- Notas:
- Este comando crea un xlink al changeset especificado. Por defecto se
- creará como un xlink de sólo lectura. Esto significa que los contenidos
- correspondientes a otro repositorio cargados por debajo del xlink no
- podrán ser modificados.
- Para la edición del changeset de un xlink se puede utilizar una sintaxis
- reducida en la que no hay que especificar el resto de parámetros del
- xlink. Solamente es necesario en nuevo changeset al que apuntará.
- Auto-expansión de ramas:
- Cuando se realiza un cambio en uno de los repositorios enlazados en modo
- de lectura y escritura (opción -e) es necesario crear una nueva rama en
- dicho repositorio basándose en la rama en la que se está trabajando en el
- repositorio principal. Para determinar el nombre de dicha rama, se aplican
- las siguientes reglas:
- 1) Se comprueba si el nombre completo de la rama existe en el
- repositorio enlazado:
- - Si existe, se utiliza dicha rama.
- - Si no existe, Plastic construye el nombre de la rama de esta forma:
- - Nombre de la rama que contiene el changeset enlazado + nombre
- de la rama del repositorio principal.
- - Si existe una rama con dicho nombre, se utiliza como rama de
- trabajo.
- - Si no, se crea una rama nueva con el nombre así construido y
- se establece como base de la rama el changeset enlazado.
- 2) Después, se crea una nueva versión del xlink dentro de la nueva rama
- apuntando al nuevo changeset.
- De este modo, la estructura completa del xlink se mantiene actualizada con
- los últimos cambios en las versiones correctas.
- Ejemplos:
- cm xlink code\firstrepo / 1@first@localhost:8084
- (Crea un xlink en la carpeta 'firstrepo' en el espacio de trabajo actual
- donde el changeset '1' en el repositorio 'first' se enlazará).
- cm xlink opengl\include /includes/opengl 1627@includes@localhost:8087
- (Crea un xlink parcial de solo lectura en la ruta 'opengl\include' en el
- espacio de trabajo actual donde la ruta '/includes/opengl' en el changeset
- '1627' del repositorio 'includes' se enlazará como raíz. Esto significa
- que cualquier ítem dentro de '/includes/opengl' se enlazará en
- 'opengl\include' mientras que el resto del repositorio se ignorará).
- cm xlink -w -rs code\secondrepo / lb:LB001@second@localhost:8084
- (Crea un xlink de escritura y relativo en la ruta 'secondrepo' en el
- espacio de trabajo actual donde la etiqueta'LB001' en el repositorio
- 'second' se enlazará).
- cm xlink code\thirdrepo / 3@third@localhost:8087 br:/main-br:/main/scm003
- (Crea un xlink en la ruta 'thirdrepo' dentro del espacio de trabajo actual
- donde el changeset '3' en el repositorio 'third' se enlazará).
- cm xlink -e code\secondrepo br:/main/task1234@second@localhost:8084
- (Edita el xlink 'code\secondrepo' para cambiar el repositorio destino
- enlazando la rama 'main/task1234' en el repositorio 'second').
- cm xlink --show code\thirdrepo
- (Muestra información del xlink 'code\thirdrepo' incluyendo las reglas de
- expansión si éstas existen).
- cm xlink -ar code\secondrepo br:/main-br:/main/develop br:/main/fix-br:/main/develop/fix
- (Añade dos reglas de expansión al xlink 'code\secondrepo').
- cm xlink -dr code\secondrepo br:/main/fix-br:/main/develop/fix
- (Borra la regla de expansión del xlink 'code\secondrepo').
- cm xlink code\secondrepo / 1@second@localhost:8084
- cm xlink code\secondrepo / lb:LB001@second@localhost:8084
- == CMD_USAGE_AUTOCOMPLETE ==
- Sintaxis:
- cm autocomplete install
- Instala el autocompletado de comandos para 'cm' en la shell.
- cm autocomplete uninstall
- Desinstala el autocompletado de comandos para 'cm' de la shell.
- cm autocomplete --line <shell_line> --position <cursor_position>
- Devuelve sugerencias de autocompletado para 'shell_line', que deben ser
- insertadas en 'cursor_position'. Este comando no está pensado para ser
- ejecutado por el usuario final, pero está documentado en caso de que se
- quiera extender el soporte de autocompletado a otras shells.
- shell_line La linea que el usuario ha escrito en la shell cuando se
- pidió el autocompletado.
- En Bash, encuentra en la variable de entorno COMP_LINE.
- En PowerShell, se encuentra en la variable $wordToComplete.
- cursor_position La posición del cursor cuando se pidió el autocompletado.
- En Bash, se encuentra en la variable de entorno COMP_POINT.
- En PowerShell, se encuentra en la variable $cursorPoint.
|