hadoop-hdfs_0.21.0.xml 698 KB

1234567891011121314151617181920212223242526272829303132333435363738394041424344454647484950515253545556575859606162636465666768697071727374757677787980818283848586878889909192939495969798991001011021031041051061071081091101111121131141151161171181191201211221231241251261271281291301311321331341351361371381391401411421431441451461471481491501511521531541551561571581591601611621631641651661671681691701711721731741751761771781791801811821831841851861871881891901911921931941951961971981992002012022032042052062072082092102112122132142152162172182192202212222232242252262272282292302312322332342352362372382392402412422432442452462472482492502512522532542552562572582592602612622632642652662672682692702712722732742752762772782792802812822832842852862872882892902912922932942952962972982993003013023033043053063073083093103113123133143153163173183193203213223233243253263273283293303313323333343353363373383393403413423433443453463473483493503513523533543553563573583593603613623633643653663673683693703713723733743753763773783793803813823833843853863873883893903913923933943953963973983994004014024034044054064074084094104114124134144154164174184194204214224234244254264274284294304314324334344354364374384394404414424434444454464474484494504514524534544554564574584594604614624634644654664674684694704714724734744754764774784794804814824834844854864874884894904914924934944954964974984995005015025035045055065075085095105115125135145155165175185195205215225235245255265275285295305315325335345355365375385395405415425435445455465475485495505515525535545555565575585595605615625635645655665675685695705715725735745755765775785795805815825835845855865875885895905915925935945955965975985996006016026036046056066076086096106116126136146156166176186196206216226236246256266276286296306316326336346356366376386396406416426436446456466476486496506516526536546556566576586596606616626636646656666676686696706716726736746756766776786796806816826836846856866876886896906916926936946956966976986997007017027037047057067077087097107117127137147157167177187197207217227237247257267277287297307317327337347357367377387397407417427437447457467477487497507517527537547557567577587597607617627637647657667677687697707717727737747757767777787797807817827837847857867877887897907917927937947957967977987998008018028038048058068078088098108118128138148158168178188198208218228238248258268278288298308318328338348358368378388398408418428438448458468478488498508518528538548558568578588598608618628638648658668678688698708718728738748758768778788798808818828838848858868878888898908918928938948958968978988999009019029039049059069079089099109119129139149159169179189199209219229239249259269279289299309319329339349359369379389399409419429439449459469479489499509519529539549559569579589599609619629639649659669679689699709719729739749759769779789799809819829839849859869879889899909919929939949959969979989991000100110021003100410051006100710081009101010111012101310141015101610171018101910201021102210231024102510261027102810291030103110321033103410351036103710381039104010411042104310441045104610471048104910501051105210531054105510561057105810591060106110621063106410651066106710681069107010711072107310741075107610771078107910801081108210831084108510861087108810891090109110921093109410951096109710981099110011011102110311041105110611071108110911101111111211131114111511161117111811191120112111221123112411251126112711281129113011311132113311341135113611371138113911401141114211431144114511461147114811491150115111521153115411551156115711581159116011611162116311641165116611671168116911701171117211731174117511761177117811791180118111821183118411851186118711881189119011911192119311941195119611971198119912001201120212031204120512061207120812091210121112121213121412151216121712181219122012211222122312241225122612271228122912301231123212331234123512361237123812391240124112421243124412451246124712481249125012511252125312541255125612571258125912601261126212631264126512661267126812691270127112721273127412751276127712781279128012811282128312841285128612871288128912901291129212931294129512961297129812991300130113021303130413051306130713081309131013111312131313141315131613171318131913201321132213231324132513261327132813291330133113321333133413351336133713381339134013411342134313441345134613471348134913501351135213531354135513561357135813591360136113621363136413651366136713681369137013711372137313741375137613771378137913801381138213831384138513861387138813891390139113921393139413951396139713981399140014011402140314041405140614071408140914101411141214131414141514161417141814191420142114221423142414251426142714281429143014311432143314341435143614371438143914401441144214431444144514461447144814491450145114521453145414551456145714581459146014611462146314641465146614671468146914701471147214731474147514761477147814791480148114821483148414851486148714881489149014911492149314941495149614971498149915001501150215031504150515061507150815091510151115121513151415151516151715181519152015211522152315241525152615271528152915301531153215331534153515361537153815391540154115421543154415451546154715481549155015511552155315541555155615571558155915601561156215631564156515661567156815691570157115721573157415751576157715781579158015811582158315841585158615871588158915901591159215931594159515961597159815991600160116021603160416051606160716081609161016111612161316141615161616171618161916201621162216231624162516261627162816291630163116321633163416351636163716381639164016411642164316441645164616471648164916501651165216531654165516561657165816591660166116621663166416651666166716681669167016711672167316741675167616771678167916801681168216831684168516861687168816891690169116921693169416951696169716981699170017011702170317041705170617071708170917101711171217131714171517161717171817191720172117221723172417251726172717281729173017311732173317341735173617371738173917401741174217431744174517461747174817491750175117521753175417551756175717581759176017611762176317641765176617671768176917701771177217731774177517761777177817791780178117821783178417851786178717881789179017911792179317941795179617971798179918001801180218031804180518061807180818091810181118121813181418151816181718181819182018211822182318241825182618271828182918301831183218331834183518361837183818391840184118421843184418451846184718481849185018511852185318541855185618571858185918601861186218631864186518661867186818691870187118721873187418751876187718781879188018811882188318841885188618871888188918901891189218931894189518961897189818991900190119021903190419051906190719081909191019111912191319141915191619171918191919201921192219231924192519261927192819291930193119321933193419351936193719381939194019411942194319441945194619471948194919501951195219531954195519561957195819591960196119621963196419651966196719681969197019711972197319741975197619771978197919801981198219831984198519861987198819891990199119921993199419951996199719981999200020012002200320042005200620072008200920102011201220132014201520162017201820192020202120222023202420252026202720282029203020312032203320342035203620372038203920402041204220432044204520462047204820492050205120522053205420552056205720582059206020612062206320642065206620672068206920702071207220732074207520762077207820792080208120822083208420852086208720882089209020912092209320942095209620972098209921002101210221032104210521062107210821092110211121122113211421152116211721182119212021212122212321242125212621272128212921302131213221332134213521362137213821392140214121422143214421452146214721482149215021512152215321542155215621572158215921602161216221632164216521662167216821692170217121722173217421752176217721782179218021812182218321842185218621872188218921902191219221932194219521962197219821992200220122022203220422052206220722082209221022112212221322142215221622172218221922202221222222232224222522262227222822292230223122322233223422352236223722382239224022412242224322442245224622472248224922502251225222532254225522562257225822592260226122622263226422652266226722682269227022712272227322742275227622772278227922802281228222832284228522862287228822892290229122922293229422952296229722982299230023012302230323042305230623072308230923102311231223132314231523162317231823192320232123222323232423252326232723282329233023312332233323342335233623372338233923402341234223432344234523462347234823492350235123522353235423552356235723582359236023612362236323642365236623672368236923702371237223732374237523762377237823792380238123822383238423852386238723882389239023912392239323942395239623972398239924002401240224032404240524062407240824092410241124122413241424152416241724182419242024212422242324242425242624272428242924302431243224332434243524362437243824392440244124422443244424452446244724482449245024512452245324542455245624572458245924602461246224632464246524662467246824692470247124722473247424752476247724782479248024812482248324842485248624872488248924902491249224932494249524962497249824992500250125022503250425052506250725082509251025112512251325142515251625172518251925202521252225232524252525262527252825292530253125322533253425352536253725382539254025412542254325442545254625472548254925502551255225532554255525562557255825592560256125622563256425652566256725682569257025712572257325742575257625772578257925802581258225832584258525862587258825892590259125922593259425952596259725982599260026012602260326042605260626072608260926102611261226132614261526162617261826192620262126222623262426252626262726282629263026312632263326342635263626372638263926402641264226432644264526462647264826492650265126522653265426552656265726582659266026612662266326642665266626672668266926702671267226732674267526762677267826792680268126822683268426852686268726882689269026912692269326942695269626972698269927002701270227032704270527062707270827092710271127122713271427152716271727182719272027212722272327242725272627272728272927302731273227332734273527362737273827392740274127422743274427452746274727482749275027512752275327542755275627572758275927602761276227632764276527662767276827692770277127722773277427752776277727782779278027812782278327842785278627872788278927902791279227932794279527962797279827992800280128022803280428052806280728082809281028112812281328142815281628172818281928202821282228232824282528262827282828292830283128322833283428352836283728382839284028412842284328442845284628472848284928502851285228532854285528562857285828592860286128622863286428652866286728682869287028712872287328742875287628772878287928802881288228832884288528862887288828892890289128922893289428952896289728982899290029012902290329042905290629072908290929102911291229132914291529162917291829192920292129222923292429252926292729282929293029312932293329342935293629372938293929402941294229432944294529462947294829492950295129522953295429552956295729582959296029612962296329642965296629672968296929702971297229732974297529762977297829792980298129822983298429852986298729882989299029912992299329942995299629972998299930003001300230033004300530063007300830093010301130123013301430153016301730183019302030213022302330243025302630273028302930303031303230333034303530363037303830393040304130423043304430453046304730483049305030513052305330543055305630573058305930603061306230633064306530663067306830693070307130723073307430753076307730783079308030813082308330843085308630873088308930903091309230933094309530963097309830993100310131023103310431053106310731083109311031113112311331143115311631173118311931203121312231233124312531263127312831293130313131323133313431353136313731383139314031413142314331443145314631473148314931503151315231533154315531563157315831593160316131623163316431653166316731683169317031713172317331743175317631773178317931803181318231833184318531863187318831893190319131923193319431953196319731983199320032013202320332043205320632073208320932103211321232133214321532163217321832193220322132223223322432253226322732283229323032313232323332343235323632373238323932403241324232433244324532463247324832493250325132523253325432553256325732583259326032613262326332643265326632673268326932703271327232733274327532763277327832793280328132823283328432853286328732883289329032913292329332943295329632973298329933003301330233033304330533063307330833093310331133123313331433153316331733183319332033213322332333243325332633273328332933303331333233333334333533363337333833393340334133423343334433453346334733483349335033513352335333543355335633573358335933603361336233633364336533663367336833693370337133723373337433753376337733783379338033813382338333843385338633873388338933903391339233933394339533963397339833993400340134023403340434053406340734083409341034113412341334143415341634173418341934203421342234233424342534263427342834293430343134323433343434353436343734383439344034413442344334443445344634473448344934503451345234533454345534563457345834593460346134623463346434653466346734683469347034713472347334743475347634773478347934803481348234833484348534863487348834893490349134923493349434953496349734983499350035013502350335043505350635073508350935103511351235133514351535163517351835193520352135223523352435253526352735283529353035313532353335343535353635373538353935403541354235433544354535463547354835493550355135523553355435553556355735583559356035613562356335643565356635673568356935703571357235733574357535763577357835793580358135823583358435853586358735883589359035913592359335943595359635973598359936003601360236033604360536063607360836093610361136123613361436153616361736183619362036213622362336243625362636273628362936303631363236333634363536363637363836393640364136423643364436453646364736483649365036513652365336543655365636573658365936603661366236633664366536663667366836693670367136723673367436753676367736783679368036813682368336843685368636873688368936903691369236933694369536963697369836993700370137023703370437053706370737083709371037113712371337143715371637173718371937203721372237233724372537263727372837293730373137323733373437353736373737383739374037413742374337443745374637473748374937503751375237533754375537563757375837593760376137623763376437653766376737683769377037713772377337743775377637773778377937803781378237833784378537863787378837893790379137923793379437953796379737983799380038013802380338043805380638073808380938103811381238133814381538163817381838193820382138223823382438253826382738283829383038313832383338343835383638373838383938403841384238433844384538463847384838493850385138523853385438553856385738583859386038613862386338643865386638673868386938703871387238733874387538763877387838793880388138823883388438853886388738883889389038913892389338943895389638973898389939003901390239033904390539063907390839093910391139123913391439153916391739183919392039213922392339243925392639273928392939303931393239333934393539363937393839393940394139423943394439453946394739483949395039513952395339543955395639573958395939603961396239633964396539663967396839693970397139723973397439753976397739783979398039813982398339843985398639873988398939903991399239933994399539963997399839994000400140024003400440054006400740084009401040114012401340144015401640174018401940204021402240234024402540264027402840294030403140324033403440354036403740384039404040414042404340444045404640474048404940504051405240534054405540564057405840594060406140624063406440654066406740684069407040714072407340744075407640774078407940804081408240834084408540864087408840894090409140924093409440954096409740984099410041014102410341044105410641074108410941104111411241134114411541164117411841194120412141224123412441254126412741284129413041314132413341344135413641374138413941404141414241434144414541464147414841494150415141524153415441554156415741584159416041614162416341644165416641674168416941704171417241734174417541764177417841794180418141824183418441854186418741884189419041914192419341944195419641974198419942004201420242034204420542064207420842094210421142124213421442154216421742184219422042214222422342244225422642274228422942304231423242334234423542364237423842394240424142424243424442454246424742484249425042514252425342544255425642574258425942604261426242634264426542664267426842694270427142724273427442754276427742784279428042814282428342844285428642874288428942904291429242934294429542964297429842994300430143024303430443054306430743084309431043114312431343144315431643174318431943204321432243234324432543264327432843294330433143324333433443354336433743384339434043414342434343444345434643474348434943504351435243534354435543564357435843594360436143624363436443654366436743684369437043714372437343744375437643774378437943804381438243834384438543864387438843894390439143924393439443954396439743984399440044014402440344044405440644074408440944104411441244134414441544164417441844194420442144224423442444254426442744284429443044314432443344344435443644374438443944404441444244434444444544464447444844494450445144524453445444554456445744584459446044614462446344644465446644674468446944704471447244734474447544764477447844794480448144824483448444854486448744884489449044914492449344944495449644974498449945004501450245034504450545064507450845094510451145124513451445154516451745184519452045214522452345244525452645274528452945304531453245334534453545364537453845394540454145424543454445454546454745484549455045514552455345544555455645574558455945604561456245634564456545664567456845694570457145724573457445754576457745784579458045814582458345844585458645874588458945904591459245934594459545964597459845994600460146024603460446054606460746084609461046114612461346144615461646174618461946204621462246234624462546264627462846294630463146324633463446354636463746384639464046414642464346444645464646474648464946504651465246534654465546564657465846594660466146624663466446654666466746684669467046714672467346744675467646774678467946804681468246834684468546864687468846894690469146924693469446954696469746984699470047014702470347044705470647074708470947104711471247134714471547164717471847194720472147224723472447254726472747284729473047314732473347344735473647374738473947404741474247434744474547464747474847494750475147524753475447554756475747584759476047614762476347644765476647674768476947704771477247734774477547764777477847794780478147824783478447854786478747884789479047914792479347944795479647974798479948004801480248034804480548064807480848094810481148124813481448154816481748184819482048214822482348244825482648274828482948304831483248334834483548364837483848394840484148424843484448454846484748484849485048514852485348544855485648574858485948604861486248634864486548664867486848694870487148724873487448754876487748784879488048814882488348844885488648874888488948904891489248934894489548964897489848994900490149024903490449054906490749084909491049114912491349144915491649174918491949204921492249234924492549264927492849294930493149324933493449354936493749384939494049414942494349444945494649474948494949504951495249534954495549564957495849594960496149624963496449654966496749684969497049714972497349744975497649774978497949804981498249834984498549864987498849894990499149924993499449954996499749984999500050015002500350045005500650075008500950105011501250135014501550165017501850195020502150225023502450255026502750285029503050315032503350345035503650375038503950405041504250435044504550465047504850495050505150525053505450555056505750585059506050615062506350645065506650675068506950705071507250735074507550765077507850795080508150825083508450855086508750885089509050915092509350945095509650975098509951005101510251035104510551065107510851095110511151125113511451155116511751185119512051215122512351245125512651275128512951305131513251335134513551365137513851395140514151425143514451455146514751485149515051515152515351545155515651575158515951605161516251635164516551665167516851695170517151725173517451755176517751785179518051815182518351845185518651875188518951905191519251935194519551965197519851995200520152025203520452055206520752085209521052115212521352145215521652175218521952205221522252235224522552265227522852295230523152325233523452355236523752385239524052415242524352445245524652475248524952505251525252535254525552565257525852595260526152625263526452655266526752685269527052715272527352745275527652775278527952805281528252835284528552865287528852895290529152925293529452955296529752985299530053015302530353045305530653075308530953105311531253135314531553165317531853195320532153225323532453255326532753285329533053315332533353345335533653375338533953405341534253435344534553465347534853495350535153525353535453555356535753585359536053615362536353645365536653675368536953705371537253735374537553765377537853795380538153825383538453855386538753885389539053915392539353945395539653975398539954005401540254035404540554065407540854095410541154125413541454155416541754185419542054215422542354245425542654275428542954305431543254335434543554365437543854395440544154425443544454455446544754485449545054515452545354545455545654575458545954605461546254635464546554665467546854695470547154725473547454755476547754785479548054815482548354845485548654875488548954905491549254935494549554965497549854995500550155025503550455055506550755085509551055115512551355145515551655175518551955205521552255235524552555265527552855295530553155325533553455355536553755385539554055415542554355445545554655475548554955505551555255535554555555565557555855595560556155625563556455655566556755685569557055715572557355745575557655775578557955805581558255835584558555865587558855895590559155925593559455955596559755985599560056015602560356045605560656075608560956105611561256135614561556165617561856195620562156225623562456255626562756285629563056315632563356345635563656375638563956405641564256435644564556465647564856495650565156525653565456555656565756585659566056615662566356645665566656675668566956705671567256735674567556765677567856795680568156825683568456855686568756885689569056915692569356945695569656975698569957005701570257035704570557065707570857095710571157125713571457155716571757185719572057215722572357245725572657275728572957305731573257335734573557365737573857395740574157425743574457455746574757485749575057515752575357545755575657575758575957605761576257635764576557665767576857695770577157725773577457755776577757785779578057815782578357845785578657875788578957905791579257935794579557965797579857995800580158025803580458055806580758085809581058115812581358145815581658175818581958205821582258235824582558265827582858295830583158325833583458355836583758385839584058415842584358445845584658475848584958505851585258535854585558565857585858595860586158625863586458655866586758685869587058715872587358745875587658775878587958805881588258835884588558865887588858895890589158925893589458955896589758985899590059015902590359045905590659075908590959105911591259135914591559165917591859195920592159225923592459255926592759285929593059315932593359345935593659375938593959405941594259435944594559465947594859495950595159525953595459555956595759585959596059615962596359645965596659675968596959705971597259735974597559765977597859795980598159825983598459855986598759885989599059915992599359945995599659975998599960006001600260036004600560066007600860096010601160126013601460156016601760186019602060216022602360246025602660276028602960306031603260336034603560366037603860396040604160426043604460456046604760486049605060516052605360546055605660576058605960606061606260636064606560666067606860696070607160726073607460756076607760786079608060816082608360846085608660876088608960906091609260936094609560966097609860996100610161026103610461056106610761086109611061116112611361146115611661176118611961206121612261236124612561266127612861296130613161326133613461356136613761386139614061416142614361446145614661476148614961506151615261536154615561566157615861596160616161626163616461656166616761686169617061716172617361746175617661776178617961806181618261836184618561866187618861896190619161926193619461956196619761986199620062016202620362046205620662076208620962106211621262136214621562166217621862196220622162226223622462256226622762286229623062316232623362346235623662376238623962406241624262436244624562466247624862496250625162526253625462556256625762586259626062616262626362646265626662676268626962706271627262736274627562766277627862796280628162826283628462856286628762886289629062916292629362946295629662976298629963006301630263036304630563066307630863096310631163126313631463156316631763186319632063216322632363246325632663276328632963306331633263336334633563366337633863396340634163426343634463456346634763486349635063516352635363546355635663576358635963606361636263636364636563666367636863696370637163726373637463756376637763786379638063816382638363846385638663876388638963906391639263936394639563966397639863996400640164026403640464056406640764086409641064116412641364146415641664176418641964206421642264236424642564266427642864296430643164326433643464356436643764386439644064416442644364446445644664476448644964506451645264536454645564566457645864596460646164626463646464656466646764686469647064716472647364746475647664776478647964806481648264836484648564866487648864896490649164926493649464956496649764986499650065016502650365046505650665076508650965106511651265136514651565166517651865196520652165226523652465256526652765286529653065316532653365346535653665376538653965406541654265436544654565466547654865496550655165526553655465556556655765586559656065616562656365646565656665676568656965706571657265736574657565766577657865796580658165826583658465856586658765886589659065916592659365946595659665976598659966006601660266036604660566066607660866096610661166126613661466156616661766186619662066216622662366246625662666276628662966306631663266336634663566366637663866396640664166426643664466456646664766486649665066516652665366546655665666576658665966606661666266636664666566666667666866696670667166726673667466756676667766786679668066816682668366846685668666876688668966906691669266936694669566966697669866996700670167026703670467056706670767086709671067116712671367146715671667176718671967206721672267236724672567266727672867296730673167326733673467356736673767386739674067416742674367446745674667476748674967506751675267536754675567566757675867596760676167626763676467656766676767686769677067716772677367746775677667776778677967806781678267836784678567866787678867896790679167926793679467956796679767986799680068016802680368046805680668076808680968106811681268136814681568166817681868196820682168226823682468256826682768286829683068316832683368346835683668376838683968406841684268436844684568466847684868496850685168526853685468556856685768586859686068616862686368646865686668676868686968706871687268736874687568766877687868796880688168826883688468856886688768886889689068916892689368946895689668976898689969006901690269036904690569066907690869096910691169126913691469156916691769186919692069216922692369246925692669276928692969306931693269336934693569366937693869396940694169426943694469456946694769486949695069516952695369546955695669576958695969606961696269636964696569666967696869696970697169726973697469756976697769786979698069816982698369846985698669876988698969906991699269936994699569966997699869997000700170027003700470057006700770087009701070117012701370147015701670177018701970207021702270237024702570267027702870297030703170327033703470357036703770387039704070417042704370447045704670477048704970507051705270537054705570567057705870597060706170627063706470657066706770687069707070717072707370747075707670777078707970807081708270837084708570867087708870897090709170927093709470957096709770987099710071017102710371047105710671077108710971107111711271137114711571167117711871197120712171227123712471257126712771287129713071317132713371347135713671377138713971407141714271437144714571467147714871497150715171527153715471557156715771587159716071617162716371647165716671677168716971707171717271737174717571767177717871797180718171827183718471857186718771887189719071917192719371947195719671977198719972007201720272037204720572067207720872097210721172127213721472157216721772187219722072217222722372247225722672277228722972307231723272337234723572367237723872397240724172427243724472457246724772487249725072517252725372547255725672577258725972607261726272637264726572667267726872697270727172727273727472757276727772787279728072817282728372847285728672877288728972907291729272937294729572967297729872997300730173027303730473057306730773087309731073117312731373147315731673177318731973207321732273237324732573267327732873297330733173327333733473357336733773387339734073417342734373447345734673477348734973507351735273537354735573567357735873597360736173627363736473657366736773687369737073717372737373747375737673777378737973807381738273837384738573867387738873897390739173927393739473957396739773987399740074017402740374047405740674077408740974107411741274137414741574167417741874197420742174227423742474257426742774287429743074317432743374347435743674377438743974407441744274437444744574467447744874497450745174527453745474557456745774587459746074617462746374647465746674677468746974707471747274737474747574767477747874797480748174827483748474857486748774887489749074917492749374947495749674977498749975007501750275037504750575067507750875097510751175127513751475157516751775187519752075217522752375247525752675277528752975307531753275337534753575367537753875397540754175427543754475457546754775487549755075517552755375547555755675577558755975607561756275637564756575667567756875697570757175727573757475757576757775787579758075817582758375847585758675877588758975907591759275937594759575967597759875997600760176027603760476057606760776087609761076117612761376147615761676177618761976207621762276237624762576267627762876297630763176327633763476357636763776387639764076417642764376447645764676477648764976507651765276537654765576567657765876597660766176627663766476657666766776687669767076717672767376747675767676777678767976807681768276837684768576867687768876897690769176927693769476957696769776987699770077017702770377047705770677077708770977107711771277137714771577167717771877197720772177227723772477257726772777287729773077317732773377347735773677377738773977407741774277437744774577467747774877497750775177527753775477557756775777587759776077617762776377647765776677677768776977707771777277737774777577767777777877797780778177827783778477857786778777887789779077917792779377947795779677977798779978007801780278037804780578067807780878097810781178127813781478157816781778187819782078217822782378247825782678277828782978307831783278337834783578367837783878397840784178427843784478457846784778487849785078517852785378547855785678577858785978607861786278637864786578667867786878697870787178727873787478757876787778787879788078817882788378847885788678877888788978907891789278937894789578967897789878997900790179027903790479057906790779087909791079117912791379147915791679177918791979207921792279237924792579267927792879297930793179327933793479357936793779387939794079417942794379447945794679477948794979507951795279537954795579567957795879597960796179627963796479657966796779687969797079717972797379747975797679777978797979807981798279837984798579867987798879897990799179927993799479957996799779987999800080018002800380048005800680078008800980108011801280138014801580168017801880198020802180228023802480258026802780288029803080318032803380348035803680378038803980408041804280438044804580468047804880498050805180528053805480558056805780588059806080618062806380648065806680678068806980708071807280738074807580768077807880798080808180828083808480858086808780888089809080918092809380948095809680978098809981008101810281038104810581068107810881098110811181128113811481158116811781188119812081218122812381248125812681278128812981308131813281338134813581368137813881398140814181428143814481458146814781488149815081518152815381548155815681578158815981608161816281638164816581668167816881698170817181728173817481758176817781788179818081818182818381848185818681878188818981908191819281938194819581968197819881998200820182028203820482058206820782088209821082118212821382148215821682178218821982208221822282238224822582268227822882298230823182328233823482358236823782388239824082418242824382448245824682478248824982508251825282538254825582568257825882598260826182628263826482658266826782688269827082718272827382748275827682778278827982808281828282838284828582868287828882898290829182928293829482958296829782988299830083018302830383048305830683078308830983108311831283138314831583168317831883198320832183228323832483258326832783288329833083318332833383348335833683378338833983408341834283438344834583468347834883498350835183528353835483558356835783588359836083618362836383648365836683678368836983708371837283738374837583768377837883798380838183828383838483858386838783888389839083918392839383948395839683978398839984008401840284038404840584068407840884098410841184128413841484158416841784188419842084218422842384248425842684278428842984308431843284338434843584368437843884398440844184428443844484458446844784488449845084518452845384548455845684578458845984608461846284638464846584668467846884698470847184728473847484758476847784788479848084818482848384848485848684878488848984908491849284938494849584968497849884998500850185028503850485058506850785088509851085118512851385148515851685178518851985208521852285238524852585268527852885298530853185328533853485358536853785388539854085418542854385448545854685478548854985508551855285538554855585568557855885598560856185628563856485658566856785688569857085718572857385748575857685778578857985808581858285838584858585868587858885898590859185928593859485958596859785988599860086018602860386048605860686078608860986108611861286138614861586168617861886198620862186228623862486258626862786288629863086318632863386348635863686378638863986408641864286438644864586468647864886498650865186528653865486558656865786588659866086618662866386648665866686678668866986708671867286738674867586768677867886798680868186828683868486858686868786888689869086918692869386948695869686978698869987008701870287038704870587068707870887098710871187128713871487158716871787188719872087218722872387248725872687278728872987308731873287338734873587368737873887398740874187428743874487458746874787488749875087518752875387548755875687578758875987608761876287638764876587668767876887698770877187728773877487758776877787788779878087818782878387848785878687878788878987908791879287938794879587968797879887998800880188028803880488058806880788088809881088118812881388148815881688178818881988208821882288238824882588268827882888298830883188328833883488358836883788388839884088418842884388448845884688478848884988508851885288538854885588568857885888598860886188628863886488658866886788688869887088718872887388748875887688778878887988808881888288838884888588868887888888898890889188928893889488958896889788988899890089018902890389048905890689078908890989108911891289138914891589168917891889198920892189228923892489258926892789288929893089318932893389348935893689378938893989408941894289438944894589468947894889498950895189528953895489558956895789588959896089618962896389648965896689678968896989708971897289738974897589768977897889798980898189828983898489858986898789888989899089918992899389948995899689978998899990009001900290039004900590069007900890099010901190129013901490159016901790189019902090219022902390249025902690279028902990309031903290339034903590369037903890399040904190429043904490459046904790489049905090519052905390549055905690579058905990609061906290639064906590669067906890699070907190729073907490759076907790789079908090819082908390849085908690879088908990909091909290939094909590969097909890999100910191029103910491059106910791089109911091119112911391149115911691179118911991209121912291239124912591269127912891299130913191329133913491359136913791389139914091419142914391449145914691479148914991509151915291539154915591569157915891599160916191629163916491659166916791689169917091719172917391749175917691779178917991809181918291839184918591869187918891899190919191929193919491959196919791989199920092019202920392049205920692079208920992109211921292139214921592169217921892199220922192229223922492259226922792289229923092319232923392349235923692379238923992409241924292439244924592469247924892499250925192529253925492559256925792589259926092619262926392649265926692679268926992709271927292739274927592769277927892799280928192829283928492859286928792889289929092919292929392949295929692979298929993009301930293039304930593069307930893099310931193129313931493159316931793189319932093219322932393249325932693279328932993309331933293339334933593369337933893399340934193429343934493459346934793489349935093519352935393549355935693579358935993609361936293639364936593669367936893699370937193729373937493759376937793789379938093819382938393849385938693879388938993909391939293939394939593969397939893999400940194029403940494059406940794089409941094119412941394149415941694179418941994209421942294239424942594269427942894299430943194329433943494359436943794389439944094419442944394449445944694479448944994509451945294539454945594569457945894599460946194629463946494659466946794689469947094719472947394749475947694779478947994809481948294839484948594869487948894899490949194929493949494959496949794989499950095019502950395049505950695079508950995109511951295139514951595169517951895199520952195229523952495259526952795289529953095319532953395349535953695379538953995409541954295439544954595469547954895499550955195529553955495559556955795589559956095619562956395649565956695679568956995709571957295739574957595769577957895799580958195829583958495859586958795889589959095919592959395949595959695979598959996009601960296039604960596069607960896099610961196129613961496159616961796189619962096219622962396249625962696279628962996309631963296339634963596369637963896399640964196429643964496459646964796489649965096519652965396549655965696579658965996609661966296639664966596669667966896699670967196729673967496759676967796789679968096819682968396849685968696879688968996909691969296939694969596969697969896999700970197029703970497059706970797089709971097119712971397149715971697179718971997209721972297239724972597269727972897299730973197329733973497359736973797389739974097419742974397449745974697479748974997509751975297539754975597569757975897599760976197629763976497659766976797689769977097719772977397749775977697779778977997809781978297839784978597869787978897899790979197929793979497959796979797989799980098019802980398049805980698079808980998109811981298139814981598169817981898199820982198229823982498259826982798289829983098319832983398349835983698379838983998409841984298439844984598469847984898499850985198529853985498559856985798589859986098619862986398649865986698679868986998709871987298739874987598769877987898799880988198829883988498859886988798889889989098919892989398949895989698979898989999009901990299039904990599069907990899099910991199129913991499159916991799189919992099219922992399249925992699279928992999309931993299339934993599369937993899399940994199429943994499459946994799489949995099519952995399549955995699579958995999609961996299639964996599669967996899699970997199729973997499759976997799789979998099819982998399849985998699879988998999909991999299939994999599969997999899991000010001100021000310004100051000610007100081000910010100111001210013100141001510016100171001810019100201002110022100231002410025100261002710028100291003010031100321003310034100351003610037100381003910040100411004210043100441004510046100471004810049100501005110052100531005410055100561005710058100591006010061100621006310064100651006610067100681006910070100711007210073100741007510076100771007810079100801008110082100831008410085100861008710088100891009010091100921009310094100951009610097100981009910100101011010210103101041010510106101071010810109101101011110112101131011410115101161011710118101191012010121101221012310124101251012610127101281012910130101311013210133101341013510136101371013810139101401014110142101431014410145101461014710148101491015010151101521015310154101551015610157101581015910160101611016210163101641016510166101671016810169101701017110172101731017410175101761017710178101791018010181101821018310184101851018610187101881018910190101911019210193101941019510196101971019810199102001020110202102031020410205102061020710208102091021010211102121021310214102151021610217102181021910220102211022210223102241022510226102271022810229102301023110232102331023410235102361023710238102391024010241102421024310244102451024610247102481024910250102511025210253102541025510256102571025810259102601026110262102631026410265102661026710268102691027010271102721027310274102751027610277102781027910280102811028210283102841028510286102871028810289102901029110292102931029410295102961029710298102991030010301103021030310304103051030610307103081030910310103111031210313103141031510316103171031810319103201032110322103231032410325103261032710328103291033010331103321033310334103351033610337103381033910340103411034210343103441034510346103471034810349103501035110352103531035410355103561035710358103591036010361103621036310364103651036610367103681036910370103711037210373103741037510376103771037810379103801038110382103831038410385103861038710388103891039010391103921039310394103951039610397103981039910400104011040210403104041040510406104071040810409104101041110412104131041410415104161041710418104191042010421104221042310424104251042610427104281042910430104311043210433104341043510436104371043810439104401044110442104431044410445104461044710448104491045010451104521045310454104551045610457104581045910460104611046210463104641046510466104671046810469104701047110472104731047410475104761047710478104791048010481104821048310484104851048610487104881048910490104911049210493104941049510496104971049810499105001050110502105031050410505105061050710508105091051010511105121051310514105151051610517105181051910520105211052210523105241052510526105271052810529105301053110532105331053410535105361053710538105391054010541105421054310544105451054610547105481054910550105511055210553105541055510556105571055810559105601056110562105631056410565105661056710568105691057010571105721057310574105751057610577105781057910580105811058210583105841058510586105871058810589105901059110592105931059410595105961059710598105991060010601106021060310604106051060610607106081060910610106111061210613106141061510616106171061810619106201062110622106231062410625106261062710628106291063010631106321063310634106351063610637106381063910640106411064210643106441064510646106471064810649106501065110652106531065410655106561065710658106591066010661106621066310664106651066610667106681066910670106711067210673106741067510676106771067810679106801068110682106831068410685106861068710688106891069010691106921069310694106951069610697106981069910700107011070210703107041070510706107071070810709107101071110712107131071410715107161071710718107191072010721107221072310724107251072610727107281072910730107311073210733107341073510736107371073810739107401074110742107431074410745107461074710748107491075010751107521075310754107551075610757107581075910760107611076210763107641076510766107671076810769107701077110772107731077410775107761077710778107791078010781107821078310784107851078610787107881078910790107911079210793107941079510796107971079810799108001080110802108031080410805108061080710808108091081010811108121081310814108151081610817108181081910820108211082210823108241082510826108271082810829108301083110832108331083410835108361083710838108391084010841108421084310844108451084610847108481084910850108511085210853108541085510856108571085810859108601086110862108631086410865108661086710868108691087010871108721087310874108751087610877108781087910880108811088210883108841088510886108871088810889108901089110892108931089410895108961089710898108991090010901109021090310904109051090610907109081090910910109111091210913109141091510916109171091810919109201092110922109231092410925109261092710928109291093010931109321093310934109351093610937109381093910940109411094210943109441094510946109471094810949109501095110952109531095410955109561095710958109591096010961109621096310964109651096610967109681096910970109711097210973109741097510976109771097810979109801098110982109831098410985109861098710988109891099010991109921099310994109951099610997109981099911000110011100211003110041100511006110071100811009110101101111012110131101411015110161101711018110191102011021110221102311024110251102611027110281102911030110311103211033110341103511036110371103811039110401104111042110431104411045110461104711048110491105011051110521105311054110551105611057110581105911060110611106211063110641106511066110671106811069110701107111072110731107411075110761107711078110791108011081110821108311084110851108611087110881108911090110911109211093110941109511096110971109811099111001110111102111031110411105111061110711108111091111011111111121111311114111151111611117111181111911120111211112211123111241112511126111271112811129111301113111132111331113411135111361113711138111391114011141111421114311144111451114611147111481114911150111511115211153111541115511156111571115811159111601116111162111631116411165111661116711168111691117011171111721117311174111751117611177111781117911180111811118211183111841118511186111871118811189111901119111192111931119411195111961119711198111991120011201112021120311204112051120611207112081120911210112111121211213112141121511216112171121811219112201122111222112231122411225112261122711228112291123011231112321123311234112351123611237112381123911240112411124211243112441124511246112471124811249112501125111252112531125411255112561125711258112591126011261112621126311264112651126611267112681126911270112711127211273112741127511276112771127811279112801128111282112831128411285112861128711288112891129011291112921129311294112951129611297112981129911300113011130211303113041130511306113071130811309113101131111312113131131411315113161131711318113191132011321113221132311324113251132611327113281132911330113311133211333113341133511336113371133811339113401134111342113431134411345113461134711348113491135011351113521135311354113551135611357113581135911360113611136211363113641136511366113671136811369113701137111372113731137411375113761137711378113791138011381113821138311384113851138611387113881138911390113911139211393113941139511396113971139811399114001140111402114031140411405114061140711408114091141011411114121141311414114151141611417114181141911420114211142211423114241142511426114271142811429114301143111432114331143411435114361143711438114391144011441114421144311444114451144611447114481144911450114511145211453114541145511456114571145811459114601146111462114631146411465114661146711468114691147011471114721147311474114751147611477114781147911480114811148211483114841148511486114871148811489114901149111492114931149411495114961149711498114991150011501115021150311504115051150611507115081150911510115111151211513115141151511516115171151811519115201152111522115231152411525115261152711528115291153011531115321153311534115351153611537115381153911540115411154211543115441154511546115471154811549115501155111552115531155411555115561155711558115591156011561115621156311564115651156611567115681156911570115711157211573115741157511576115771157811579115801158111582115831158411585115861158711588115891159011591115921159311594115951159611597115981159911600116011160211603116041160511606116071160811609116101161111612116131161411615116161161711618116191162011621116221162311624116251162611627116281162911630116311163211633116341163511636116371163811639116401164111642116431164411645116461164711648116491165011651116521165311654116551165611657116581165911660116611166211663116641166511666116671166811669116701167111672116731167411675116761167711678116791168011681116821168311684116851168611687116881168911690116911169211693116941169511696116971169811699117001170111702117031170411705117061170711708117091171011711117121171311714117151171611717117181171911720117211172211723117241172511726117271172811729117301173111732117331173411735117361173711738117391174011741117421174311744117451174611747117481174911750117511175211753117541175511756117571175811759117601176111762117631176411765117661176711768117691177011771117721177311774117751177611777117781177911780117811178211783117841178511786117871178811789117901179111792117931179411795117961179711798117991180011801118021180311804118051180611807118081180911810118111181211813118141181511816118171181811819118201182111822118231182411825118261182711828118291183011831118321183311834118351183611837118381183911840118411184211843118441184511846118471184811849118501185111852118531185411855118561185711858118591186011861118621186311864118651186611867118681186911870118711187211873118741187511876118771187811879118801188111882118831188411885118861188711888118891189011891118921189311894118951189611897118981189911900119011190211903119041190511906119071190811909119101191111912119131191411915119161191711918119191192011921119221192311924119251192611927119281192911930119311193211933119341193511936119371193811939119401194111942119431194411945119461194711948119491195011951119521195311954119551195611957119581195911960119611196211963119641196511966119671196811969119701197111972119731197411975119761197711978119791198011981119821198311984119851198611987119881198911990119911199211993119941199511996119971199811999120001200112002120031200412005120061200712008120091201012011120121201312014120151201612017120181201912020120211202212023120241202512026120271202812029120301203112032120331203412035120361203712038120391204012041120421204312044120451204612047120481204912050120511205212053120541205512056120571205812059120601206112062120631206412065120661206712068120691207012071120721207312074120751207612077120781207912080120811208212083120841208512086120871208812089120901209112092120931209412095120961209712098120991210012101121021210312104121051210612107121081210912110121111211212113121141211512116121171211812119121201212112122121231212412125121261212712128121291213012131121321213312134121351213612137121381213912140121411214212143121441214512146121471214812149121501215112152121531215412155121561215712158121591216012161121621216312164121651216612167121681216912170121711217212173121741217512176121771217812179121801218112182121831218412185121861218712188121891219012191121921219312194121951219612197121981219912200122011220212203122041220512206122071220812209122101221112212122131221412215122161221712218122191222012221122221222312224122251222612227122281222912230122311223212233122341223512236122371223812239122401224112242122431224412245122461224712248122491225012251122521225312254122551225612257122581225912260122611226212263122641226512266122671226812269122701227112272122731227412275122761227712278122791228012281122821228312284122851228612287122881228912290122911229212293122941229512296122971229812299123001230112302123031230412305123061230712308123091231012311123121231312314123151231612317123181231912320123211232212323123241232512326123271232812329123301233112332123331233412335123361233712338123391234012341123421234312344123451234612347123481234912350123511235212353123541235512356123571235812359123601236112362123631236412365123661236712368123691237012371123721237312374123751237612377123781237912380123811238212383123841238512386123871238812389123901239112392123931239412395123961239712398123991240012401124021240312404124051240612407124081240912410124111241212413124141241512416124171241812419124201242112422124231242412425124261242712428124291243012431124321243312434124351243612437124381243912440124411244212443124441244512446124471244812449124501245112452124531245412455124561245712458124591246012461124621246312464124651246612467124681246912470124711247212473124741247512476124771247812479124801248112482124831248412485124861248712488124891249012491124921249312494124951249612497124981249912500125011250212503125041250512506125071250812509125101251112512125131251412515125161251712518125191252012521125221252312524125251252612527125281252912530125311253212533125341253512536125371253812539125401254112542125431254412545125461254712548125491255012551125521255312554125551255612557125581255912560125611256212563125641256512566125671256812569125701257112572125731257412575125761257712578125791258012581125821258312584125851258612587125881258912590125911259212593125941259512596125971259812599126001260112602126031260412605126061260712608126091261012611126121261312614126151261612617126181261912620126211262212623126241262512626126271262812629126301263112632126331263412635126361263712638126391264012641126421264312644126451264612647126481264912650126511265212653126541265512656126571265812659126601266112662126631266412665126661266712668126691267012671126721267312674126751267612677126781267912680126811268212683126841268512686126871268812689126901269112692126931269412695126961269712698126991270012701127021270312704127051270612707127081270912710127111271212713127141271512716127171271812719127201272112722127231272412725127261272712728127291273012731127321273312734127351273612737127381273912740127411274212743127441274512746127471274812749127501275112752127531275412755127561275712758127591276012761127621276312764127651276612767127681276912770127711277212773127741277512776127771277812779127801278112782127831278412785127861278712788127891279012791127921279312794127951279612797127981279912800128011280212803128041280512806128071280812809128101281112812128131281412815128161281712818128191282012821128221282312824128251282612827128281282912830128311283212833128341283512836128371283812839128401284112842128431284412845128461284712848128491285012851128521285312854128551285612857128581285912860128611286212863128641286512866128671286812869128701287112872128731287412875128761287712878128791288012881128821288312884128851288612887128881288912890128911289212893128941289512896128971289812899129001290112902129031290412905129061290712908129091291012911129121291312914129151291612917129181291912920129211292212923129241292512926129271292812929129301293112932129331293412935129361293712938129391294012941129421294312944129451294612947129481294912950129511295212953129541295512956129571295812959129601296112962129631296412965129661296712968129691297012971129721297312974129751297612977129781297912980129811298212983129841298512986129871298812989129901299112992129931299412995129961299712998129991300013001130021300313004130051300613007130081300913010130111301213013130141301513016130171301813019130201302113022130231302413025130261302713028130291303013031130321303313034130351303613037130381303913040130411304213043130441304513046130471304813049130501305113052130531305413055130561305713058130591306013061130621306313064130651306613067130681306913070130711307213073130741307513076130771307813079130801308113082130831308413085130861308713088130891309013091130921309313094130951309613097130981309913100131011310213103131041310513106131071310813109131101311113112131131311413115131161311713118131191312013121131221312313124131251312613127131281312913130131311313213133131341313513136131371313813139131401314113142131431314413145131461314713148131491315013151131521315313154131551315613157131581315913160131611316213163131641316513166131671316813169131701317113172131731317413175131761317713178131791318013181131821318313184131851318613187131881318913190131911319213193131941319513196131971319813199132001320113202132031320413205132061320713208132091321013211132121321313214132151321613217132181321913220132211322213223132241322513226132271322813229132301323113232132331323413235132361323713238132391324013241132421324313244132451324613247132481324913250132511325213253132541325513256132571325813259132601326113262132631326413265132661326713268132691327013271132721327313274132751327613277132781327913280132811328213283132841328513286132871328813289132901329113292132931329413295132961329713298132991330013301133021330313304133051330613307133081330913310133111331213313133141331513316133171331813319133201332113322133231332413325133261332713328133291333013331133321333313334133351333613337133381333913340133411334213343133441334513346133471334813349133501335113352133531335413355133561335713358133591336013361133621336313364133651336613367133681336913370133711337213373133741337513376133771337813379133801338113382133831338413385133861338713388133891339013391133921339313394133951339613397133981339913400134011340213403134041340513406134071340813409134101341113412134131341413415134161341713418134191342013421134221342313424134251342613427134281342913430134311343213433134341343513436134371343813439134401344113442134431344413445134461344713448134491345013451134521345313454134551345613457134581345913460134611346213463134641346513466134671346813469134701347113472134731347413475134761347713478134791348013481134821348313484134851348613487134881348913490134911349213493134941349513496134971349813499135001350113502135031350413505135061350713508135091351013511135121351313514135151351613517135181351913520135211352213523135241352513526135271352813529135301353113532135331353413535135361353713538135391354013541135421354313544135451354613547135481354913550135511355213553135541355513556135571355813559135601356113562135631356413565135661356713568135691357013571135721357313574135751357613577135781357913580135811358213583135841358513586135871358813589135901359113592135931359413595135961359713598135991360013601136021360313604136051360613607136081360913610136111361213613136141361513616136171361813619136201362113622136231362413625136261362713628136291363013631136321363313634136351363613637136381363913640136411364213643136441364513646136471364813649136501365113652136531365413655136561365713658136591366013661136621366313664136651366613667136681366913670136711367213673136741367513676136771367813679136801368113682136831368413685136861368713688136891369013691136921369313694136951369613697136981369913700137011370213703137041370513706137071370813709137101371113712137131371413715137161371713718137191372013721137221372313724137251372613727137281372913730137311373213733137341373513736137371373813739137401374113742137431374413745137461374713748137491375013751137521375313754137551375613757137581375913760137611376213763137641376513766137671376813769137701377113772137731377413775137761377713778137791378013781137821378313784137851378613787137881378913790137911379213793137941379513796137971379813799138001380113802138031380413805138061380713808138091381013811138121381313814138151381613817138181381913820138211382213823138241382513826138271382813829138301383113832138331383413835138361383713838138391384013841138421384313844138451384613847138481384913850138511385213853138541385513856138571385813859138601386113862138631386413865138661386713868138691387013871138721387313874138751387613877138781387913880138811388213883138841388513886138871388813889138901389113892138931389413895138961389713898138991390013901139021390313904139051390613907139081390913910139111391213913139141391513916139171391813919139201392113922139231392413925139261392713928139291393013931139321393313934139351393613937139381393913940139411394213943139441394513946139471394813949139501395113952139531395413955139561395713958139591396013961139621396313964139651396613967139681396913970139711397213973139741397513976139771397813979139801398113982139831398413985139861398713988139891399013991139921399313994139951399613997139981399914000140011400214003140041400514006140071400814009140101401114012140131401414015140161401714018140191402014021140221402314024140251402614027140281402914030140311403214033140341403514036140371403814039140401404114042140431404414045140461404714048140491405014051140521405314054140551405614057140581405914060140611406214063140641406514066140671406814069140701407114072140731407414075140761407714078140791408014081140821408314084140851408614087140881408914090140911409214093140941409514096140971409814099141001410114102141031410414105141061410714108141091411014111141121411314114141151411614117141181411914120141211412214123141241412514126141271412814129141301413114132141331413414135141361413714138141391414014141141421414314144141451414614147141481414914150141511415214153141541415514156141571415814159141601416114162141631416414165141661416714168141691417014171141721417314174141751417614177141781417914180141811418214183141841418514186141871418814189141901419114192141931419414195141961419714198141991420014201142021420314204142051420614207142081420914210142111421214213142141421514216142171421814219142201422114222142231422414225142261422714228142291423014231142321423314234142351423614237142381423914240142411424214243142441424514246142471424814249142501425114252142531425414255142561425714258142591426014261142621426314264142651426614267142681426914270142711427214273142741427514276142771427814279142801428114282142831428414285142861428714288142891429014291142921429314294142951429614297142981429914300143011430214303143041430514306143071430814309143101431114312143131431414315143161431714318143191432014321143221432314324143251432614327143281432914330143311433214333143341433514336143371433814339143401434114342143431434414345143461434714348143491435014351143521435314354143551435614357143581435914360143611436214363143641436514366143671436814369143701437114372143731437414375143761437714378143791438014381143821438314384143851438614387143881438914390143911439214393143941439514396143971439814399144001440114402144031440414405144061440714408144091441014411144121441314414144151441614417144181441914420144211442214423144241442514426144271442814429144301443114432144331443414435144361443714438144391444014441144421444314444144451444614447144481444914450144511445214453144541445514456144571445814459144601446114462144631446414465144661446714468144691447014471144721447314474144751447614477144781447914480144811448214483144841448514486144871448814489144901449114492144931449414495144961449714498144991450014501145021450314504145051450614507145081450914510145111451214513145141451514516145171451814519145201452114522145231452414525145261452714528145291453014531145321453314534145351453614537145381453914540145411454214543145441454514546145471454814549145501455114552145531455414555145561455714558145591456014561145621456314564145651456614567145681456914570145711457214573145741457514576145771457814579145801458114582145831458414585145861458714588145891459014591145921459314594145951459614597145981459914600146011460214603146041460514606146071460814609146101461114612146131461414615146161461714618146191462014621146221462314624146251462614627146281462914630146311463214633146341463514636146371463814639146401464114642146431464414645146461464714648146491465014651146521465314654146551465614657146581465914660146611466214663146641466514666146671466814669146701467114672146731467414675146761467714678146791468014681146821468314684146851468614687146881468914690146911469214693146941469514696146971469814699147001470114702147031470414705147061470714708147091471014711147121471314714147151471614717147181471914720147211472214723147241472514726147271472814729147301473114732147331473414735147361473714738147391474014741147421474314744147451474614747147481474914750147511475214753147541475514756147571475814759147601476114762147631476414765147661476714768147691477014771147721477314774147751477614777147781477914780147811478214783147841478514786147871478814789147901479114792147931479414795147961479714798147991480014801148021480314804148051480614807148081480914810148111481214813148141481514816148171481814819148201482114822148231482414825148261482714828148291483014831148321483314834148351483614837148381483914840148411484214843148441484514846148471484814849148501485114852148531485414855148561485714858148591486014861148621486314864148651486614867148681486914870148711487214873148741487514876148771487814879148801488114882148831488414885148861488714888148891489014891148921489314894148951489614897148981489914900149011490214903149041490514906149071490814909149101491114912149131491414915149161491714918149191492014921149221492314924149251492614927149281492914930149311493214933149341493514936149371493814939149401494114942149431494414945149461494714948149491495014951149521495314954149551495614957149581495914960149611496214963149641496514966149671496814969149701497114972149731497414975149761497714978149791498014981149821498314984149851498614987149881498914990149911499214993149941499514996149971499814999150001500115002150031500415005150061500715008150091501015011150121501315014150151501615017150181501915020150211502215023150241502515026150271502815029150301503115032150331503415035150361503715038150391504015041150421504315044150451504615047150481504915050150511505215053150541505515056150571505815059150601506115062150631506415065150661506715068150691507015071150721507315074150751507615077150781507915080150811508215083150841508515086150871508815089150901509115092150931509415095150961509715098150991510015101151021510315104151051510615107151081510915110151111511215113151141511515116151171511815119151201512115122151231512415125151261512715128151291513015131151321513315134151351513615137151381513915140151411514215143151441514515146151471514815149151501515115152151531515415155151561515715158151591516015161151621516315164151651516615167151681516915170151711517215173151741517515176151771517815179151801518115182151831518415185151861518715188151891519015191151921519315194151951519615197151981519915200152011520215203152041520515206152071520815209152101521115212152131521415215152161521715218152191522015221152221522315224152251522615227152281522915230152311523215233152341523515236152371523815239152401524115242152431524415245152461524715248152491525015251152521525315254152551525615257152581525915260152611526215263152641526515266152671526815269152701527115272152731527415275152761527715278152791528015281152821528315284152851528615287152881528915290152911529215293152941529515296152971529815299153001530115302153031530415305153061530715308153091531015311153121531315314153151531615317153181531915320153211532215323153241532515326153271532815329153301533115332153331533415335153361533715338153391534015341153421534315344153451534615347153481534915350153511535215353153541535515356153571535815359153601536115362153631536415365153661536715368153691537015371153721537315374153751537615377153781537915380153811538215383153841538515386153871538815389153901539115392153931539415395153961539715398153991540015401154021540315404154051540615407154081540915410154111541215413154141541515416154171541815419154201542115422154231542415425154261542715428154291543015431154321543315434154351543615437154381543915440154411544215443154441544515446154471544815449154501545115452154531545415455154561545715458154591546015461154621546315464154651546615467154681546915470154711547215473154741547515476154771547815479154801548115482154831548415485154861548715488154891549015491154921549315494154951549615497154981549915500155011550215503155041550515506155071550815509155101551115512155131551415515155161551715518155191552015521155221552315524155251552615527155281552915530155311553215533155341553515536155371553815539155401554115542155431554415545155461554715548155491555015551155521555315554155551555615557155581555915560155611556215563155641556515566155671556815569155701557115572155731557415575155761557715578155791558015581155821558315584155851558615587155881558915590155911559215593155941559515596155971559815599156001560115602156031560415605156061560715608156091561015611156121561315614156151561615617156181561915620156211562215623156241562515626156271562815629156301563115632156331563415635156361563715638156391564015641156421564315644156451564615647156481564915650156511565215653156541565515656156571565815659156601566115662156631566415665156661566715668156691567015671156721567315674156751567615677156781567915680156811568215683156841568515686156871568815689156901569115692156931569415695156961569715698156991570015701157021570315704157051570615707157081570915710157111571215713157141571515716157171571815719157201572115722157231572415725157261572715728157291573015731157321573315734157351573615737157381573915740157411574215743157441574515746157471574815749157501575115752157531575415755157561575715758157591576015761157621576315764157651576615767157681576915770157711577215773157741577515776157771577815779157801578115782157831578415785157861578715788157891579015791157921579315794157951579615797157981579915800158011580215803158041580515806158071580815809158101581115812158131581415815158161581715818158191582015821158221582315824158251582615827158281582915830158311583215833158341583515836158371583815839158401584115842158431584415845158461584715848158491585015851158521585315854158551585615857158581585915860158611586215863158641586515866158671586815869158701587115872158731587415875158761587715878158791588015881158821588315884158851588615887158881588915890158911589215893158941589515896158971589815899159001590115902159031590415905159061590715908159091591015911159121591315914159151591615917159181591915920159211592215923159241592515926159271592815929159301593115932159331593415935159361593715938159391594015941159421594315944159451594615947159481594915950159511595215953159541595515956159571595815959159601596115962159631596415965159661596715968159691597015971159721597315974159751597615977159781597915980159811598215983159841598515986159871598815989159901599115992159931599415995159961599715998159991600016001160021600316004160051600616007160081600916010160111601216013160141601516016160171601816019160201602116022160231602416025160261602716028160291603016031160321603316034160351603616037160381603916040160411604216043160441604516046160471604816049160501605116052160531605416055160561605716058160591606016061160621606316064160651606616067160681606916070160711607216073160741607516076160771607816079160801608116082160831608416085160861608716088160891609016091160921609316094160951609616097160981609916100161011610216103161041610516106161071610816109161101611116112161131611416115161161611716118161191612016121161221612316124161251612616127161281612916130161311613216133161341613516136161371613816139161401614116142161431614416145161461614716148161491615016151161521615316154161551615616157161581615916160161611616216163161641616516166161671616816169161701617116172161731617416175161761617716178161791618016181161821618316184161851618616187161881618916190161911619216193161941619516196161971619816199162001620116202162031620416205162061620716208162091621016211162121621316214162151621616217162181621916220
  1. <?xml version="1.0" encoding="iso-8859-1" standalone="no"?>
  2. <!-- Generated by the JDiff Javadoc doclet -->
  3. <!-- (http://www.jdiff.org) -->
  4. <!-- on Tue Aug 24 10:48:17 PDT 2010 -->
  5. <api
  6. xmlns:xsi='http://www.w3.org/2001/XMLSchema-instance'
  7. xsi:noNamespaceSchemaLocation='api.xsd'
  8. name="hadoop-hdfs 0.21.0"
  9. jdversion="1.0.9">
  10. <!-- Command line arguments = -doclet jdiff.JDiff -docletpath /Users/tom/workspace/hadoop-hdfs-0.21-committer/build/ivy/lib/Hadoop-Hdfs/jdiff/jdiff-1.0.9.jar:/Users/tom/workspace/hadoop-hdfs-0.21-committer/build/ivy/lib/Hadoop-Hdfs/jdiff/xerces-1.4.4.jar -classpath /Users/tom/workspace/hadoop-hdfs-0.21-committer/build/classes:/Users/tom/workspace/hadoop-hdfs-0.21-committer/conf:/Users/tom/.ivy2/cache/org.apache.hadoop/hadoop-common/jars/hadoop-common-0.21.0-SNAPSHOT.jar:/Users/tom/.ivy2/cache/commons-cli/commons-cli/jars/commons-cli-1.2.jar:/Users/tom/.ivy2/cache/xmlenc/xmlenc/jars/xmlenc-0.52.jar:/Users/tom/.ivy2/cache/commons-httpclient/commons-httpclient/jars/commons-httpclient-3.1.jar:/Users/tom/.ivy2/cache/commons-codec/commons-codec/jars/commons-codec-1.4.jar:/Users/tom/.ivy2/cache/commons-net/commons-net/jars/commons-net-1.4.1.jar:/Users/tom/.ivy2/cache/oro/oro/jars/oro-2.0.8.jar:/Users/tom/.ivy2/cache/org.mortbay.jetty/jetty/jars/jetty-6.1.14.jar:/Users/tom/.ivy2/cache/org.mortbay.jetty/jetty-util/jars/jetty-util-6.1.14.jar:/Users/tom/.ivy2/cache/org.mortbay.jetty/servlet-api-2.5/jars/servlet-api-2.5-6.1.14.jar:/Users/tom/.ivy2/cache/tomcat/jasper-runtime/jars/jasper-runtime-5.5.12.jar:/Users/tom/.ivy2/cache/tomcat/jasper-compiler/jars/jasper-compiler-5.5.12.jar:/Users/tom/.ivy2/cache/org.mortbay.jetty/jsp-api-2.1/jars/jsp-api-2.1-6.1.14.jar:/Users/tom/.ivy2/cache/org.mortbay.jetty/jsp-2.1/jars/jsp-2.1-6.1.14.jar:/Users/tom/.ivy2/cache/org.eclipse.jdt/core/jars/core-3.1.1.jar:/Users/tom/.ivy2/cache/ant/ant/jars/ant-1.6.5.jar:/Users/tom/.ivy2/cache/commons-el/commons-el/jars/commons-el-1.0.jar:/Users/tom/.ivy2/cache/net.java.dev.jets3t/jets3t/jars/jets3t-0.7.1.jar:/Users/tom/.ivy2/cache/commons-logging/commons-logging/jars/commons-logging-1.1.1.jar:/Users/tom/.ivy2/cache/net.sf.kosmosfs/kfs/jars/kfs-0.3.jar:/Users/tom/.ivy2/cache/junit/junit/jars/junit-4.8.1.jar:/Users/tom/.ivy2/cache/hsqldb/hsqldb/jars/hsqldb-1.8.0.10.jar:/Users/tom/.ivy2/cache/org.apache.hadoop/avro/jars/avro-1.3.2.jar:/Users/tom/.ivy2/cache/org.codehaus.jackson/jackson-mapper-asl/jars/jackson-mapper-asl-1.4.2.jar:/Users/tom/.ivy2/cache/org.codehaus.jackson/jackson-core-asl/jars/jackson-core-asl-1.4.2.jar:/Users/tom/.ivy2/cache/org.slf4j/slf4j-api/jars/slf4j-api-1.5.11.jar:/Users/tom/.ivy2/cache/com.thoughtworks.paranamer/paranamer/jars/paranamer-2.2.jar:/Users/tom/.ivy2/cache/com.thoughtworks.paranamer/paranamer-ant/jars/paranamer-ant-2.2.jar:/Users/tom/.ivy2/cache/com.thoughtworks.paranamer/paranamer-generator/jars/paranamer-generator-2.2.jar:/Users/tom/.ivy2/cache/com.thoughtworks.qdox/qdox/jars/qdox-1.10.1.jar:/Users/tom/.ivy2/cache/asm/asm/jars/asm-3.2.jar:/Users/tom/.ivy2/cache/commons-lang/commons-lang/jars/commons-lang-2.5.jar:/Users/tom/.ivy2/cache/log4j/log4j/jars/log4j-1.2.15.jar:/Users/tom/.ivy2/cache/org.aspectj/aspectjrt/jars/aspectjrt-1.6.5.jar:/Users/tom/.ivy2/cache/org.aspectj/aspectjtools/jars/aspectjtools-1.6.5.jar:/Users/tom/.ivy2/cache/org.mockito/mockito-all/jars/mockito-all-1.8.2.jar:/Users/tom/.ivy2/cache/jdiff/jdiff/jars/jdiff-1.0.9.jar:/Users/tom/.ivy2/cache/xerces/xerces/jars/xerces-1.4.4.jar:/usr/share/ant/lib/ant-launcher.jar:/Users/tom/.ant/lib/ivy.jar:/usr/share/ant/lib/ant-antlr.jar:/usr/share/ant/lib/ant-jai.jar:/usr/share/ant/lib/ant-jmf.jar:/usr/share/ant/lib/ant-junit.jar:/usr/share/ant/lib/ant-nodeps.jar:/usr/share/ant/lib/ant-swing.jar:/usr/share/ant/lib/ant-testutil.jar:/usr/share/ant/lib/ant-trax.jar:/usr/share/ant/lib/ant.jar:/usr/share/ant/lib/ivy-2.1.0.jar:/usr/share/ant/lib/xercesImpl.jar:/usr/share/ant/lib/xml-apis.jar -sourcepath /Users/tom/workspace/hadoop-hdfs-0.21-committer/src/java -apidir /Users/tom/workspace/hadoop-hdfs-0.21-committer/lib/jdiff -apiname hadoop-hdfs 0.21.0 -->
  11. <package name="org.apache.hadoop.fs">
  12. <!-- start class org.apache.hadoop.fs.Hdfs -->
  13. <class name="Hdfs" extends="org.apache.hadoop.fs.AbstractFileSystem"
  14. abstract="false"
  15. static="false" final="false" visibility="public"
  16. deprecated="not deprecated">
  17. <method name="getUriDefaultPort" return="int"
  18. abstract="false" native="false" synchronized="false"
  19. static="false" final="false" visibility="protected"
  20. deprecated="not deprecated">
  21. </method>
  22. <method name="createInternal" return="org.apache.hadoop.fs.FSDataOutputStream"
  23. abstract="false" native="false" synchronized="false"
  24. static="false" final="false" visibility="protected"
  25. deprecated="not deprecated">
  26. <param name="f" type="org.apache.hadoop.fs.Path"/>
  27. <param name="createFlag" type="java.util.EnumSet"/>
  28. <param name="absolutePermission" type="org.apache.hadoop.fs.permission.FsPermission"/>
  29. <param name="bufferSize" type="int"/>
  30. <param name="replication" type="short"/>
  31. <param name="blockSize" type="long"/>
  32. <param name="progress" type="org.apache.hadoop.util.Progressable"/>
  33. <param name="bytesPerChecksum" type="int"/>
  34. <param name="createParent" type="boolean"/>
  35. <exception name="IOException" type="java.io.IOException"/>
  36. </method>
  37. <method name="delete" return="boolean"
  38. abstract="false" native="false" synchronized="false"
  39. static="false" final="false" visibility="protected"
  40. deprecated="not deprecated">
  41. <param name="f" type="org.apache.hadoop.fs.Path"/>
  42. <param name="recursive" type="boolean"/>
  43. <exception name="IOException" type="java.io.IOException"/>
  44. <exception name="UnresolvedLinkException" type="org.apache.hadoop.fs.UnresolvedLinkException"/>
  45. </method>
  46. <method name="getFileBlockLocations" return="org.apache.hadoop.fs.BlockLocation[]"
  47. abstract="false" native="false" synchronized="false"
  48. static="false" final="false" visibility="protected"
  49. deprecated="not deprecated">
  50. <param name="p" type="org.apache.hadoop.fs.Path"/>
  51. <param name="start" type="long"/>
  52. <param name="len" type="long"/>
  53. <exception name="IOException" type="java.io.IOException"/>
  54. <exception name="UnresolvedLinkException" type="org.apache.hadoop.fs.UnresolvedLinkException"/>
  55. </method>
  56. <method name="getFileChecksum" return="org.apache.hadoop.fs.FileChecksum"
  57. abstract="false" native="false" synchronized="false"
  58. static="false" final="false" visibility="protected"
  59. deprecated="not deprecated">
  60. <param name="f" type="org.apache.hadoop.fs.Path"/>
  61. <exception name="IOException" type="java.io.IOException"/>
  62. <exception name="UnresolvedLinkException" type="org.apache.hadoop.fs.UnresolvedLinkException"/>
  63. </method>
  64. <method name="getFileStatus" return="org.apache.hadoop.fs.FileStatus"
  65. abstract="false" native="false" synchronized="false"
  66. static="false" final="false" visibility="protected"
  67. deprecated="not deprecated">
  68. <param name="f" type="org.apache.hadoop.fs.Path"/>
  69. <exception name="IOException" type="java.io.IOException"/>
  70. <exception name="UnresolvedLinkException" type="org.apache.hadoop.fs.UnresolvedLinkException"/>
  71. </method>
  72. <method name="getFileLinkStatus" return="org.apache.hadoop.fs.FileStatus"
  73. abstract="false" native="false" synchronized="false"
  74. static="false" final="false" visibility="public"
  75. deprecated="not deprecated">
  76. <param name="f" type="org.apache.hadoop.fs.Path"/>
  77. <exception name="IOException" type="java.io.IOException"/>
  78. <exception name="UnresolvedLinkException" type="org.apache.hadoop.fs.UnresolvedLinkException"/>
  79. </method>
  80. <method name="getFsStatus" return="org.apache.hadoop.fs.FsStatus"
  81. abstract="false" native="false" synchronized="false"
  82. static="false" final="false" visibility="protected"
  83. deprecated="not deprecated">
  84. <exception name="IOException" type="java.io.IOException"/>
  85. </method>
  86. <method name="getServerDefaults" return="org.apache.hadoop.fs.FsServerDefaults"
  87. abstract="false" native="false" synchronized="false"
  88. static="false" final="false" visibility="protected"
  89. deprecated="not deprecated">
  90. <exception name="IOException" type="java.io.IOException"/>
  91. </method>
  92. <method name="listStatusIterator" return="java.util.Iterator"
  93. abstract="false" native="false" synchronized="false"
  94. static="false" final="false" visibility="protected"
  95. deprecated="not deprecated">
  96. <param name="f" type="org.apache.hadoop.fs.Path"/>
  97. <exception name="AccessControlException" type="org.apache.hadoop.security.AccessControlException"/>
  98. <exception name="FileNotFoundException" type="java.io.FileNotFoundException"/>
  99. <exception name="UnresolvedLinkException" type="org.apache.hadoop.fs.UnresolvedLinkException"/>
  100. <exception name="IOException" type="java.io.IOException"/>
  101. </method>
  102. <method name="listStatus" return="org.apache.hadoop.fs.FileStatus[]"
  103. abstract="false" native="false" synchronized="false"
  104. static="false" final="false" visibility="protected"
  105. deprecated="not deprecated">
  106. <param name="f" type="org.apache.hadoop.fs.Path"/>
  107. <exception name="IOException" type="java.io.IOException"/>
  108. <exception name="UnresolvedLinkException" type="org.apache.hadoop.fs.UnresolvedLinkException"/>
  109. </method>
  110. <method name="mkdir"
  111. abstract="false" native="false" synchronized="false"
  112. static="false" final="false" visibility="protected"
  113. deprecated="not deprecated">
  114. <param name="dir" type="org.apache.hadoop.fs.Path"/>
  115. <param name="permission" type="org.apache.hadoop.fs.permission.FsPermission"/>
  116. <param name="createParent" type="boolean"/>
  117. <exception name="IOException" type="java.io.IOException"/>
  118. <exception name="UnresolvedLinkException" type="org.apache.hadoop.fs.UnresolvedLinkException"/>
  119. </method>
  120. <method name="open" return="org.apache.hadoop.fs.FSDataInputStream"
  121. abstract="false" native="false" synchronized="false"
  122. static="false" final="false" visibility="protected"
  123. deprecated="not deprecated">
  124. <param name="f" type="org.apache.hadoop.fs.Path"/>
  125. <param name="bufferSize" type="int"/>
  126. <exception name="IOException" type="java.io.IOException"/>
  127. <exception name="UnresolvedLinkException" type="org.apache.hadoop.fs.UnresolvedLinkException"/>
  128. </method>
  129. <method name="renameInternal"
  130. abstract="false" native="false" synchronized="false"
  131. static="false" final="false" visibility="protected"
  132. deprecated="not deprecated">
  133. <param name="src" type="org.apache.hadoop.fs.Path"/>
  134. <param name="dst" type="org.apache.hadoop.fs.Path"/>
  135. <exception name="IOException" type="java.io.IOException"/>
  136. <exception name="UnresolvedLinkException" type="org.apache.hadoop.fs.UnresolvedLinkException"/>
  137. </method>
  138. <method name="renameInternal"
  139. abstract="false" native="false" synchronized="false"
  140. static="false" final="false" visibility="protected"
  141. deprecated="not deprecated">
  142. <param name="src" type="org.apache.hadoop.fs.Path"/>
  143. <param name="dst" type="org.apache.hadoop.fs.Path"/>
  144. <param name="overwrite" type="boolean"/>
  145. <exception name="IOException" type="java.io.IOException"/>
  146. <exception name="UnresolvedLinkException" type="org.apache.hadoop.fs.UnresolvedLinkException"/>
  147. </method>
  148. <method name="setOwner"
  149. abstract="false" native="false" synchronized="false"
  150. static="false" final="false" visibility="protected"
  151. deprecated="not deprecated">
  152. <param name="f" type="org.apache.hadoop.fs.Path"/>
  153. <param name="username" type="java.lang.String"/>
  154. <param name="groupname" type="java.lang.String"/>
  155. <exception name="IOException" type="java.io.IOException"/>
  156. <exception name="UnresolvedLinkException" type="org.apache.hadoop.fs.UnresolvedLinkException"/>
  157. </method>
  158. <method name="setPermission"
  159. abstract="false" native="false" synchronized="false"
  160. static="false" final="false" visibility="protected"
  161. deprecated="not deprecated">
  162. <param name="f" type="org.apache.hadoop.fs.Path"/>
  163. <param name="permission" type="org.apache.hadoop.fs.permission.FsPermission"/>
  164. <exception name="IOException" type="java.io.IOException"/>
  165. <exception name="UnresolvedLinkException" type="org.apache.hadoop.fs.UnresolvedLinkException"/>
  166. </method>
  167. <method name="setReplication" return="boolean"
  168. abstract="false" native="false" synchronized="false"
  169. static="false" final="false" visibility="protected"
  170. deprecated="not deprecated">
  171. <param name="f" type="org.apache.hadoop.fs.Path"/>
  172. <param name="replication" type="short"/>
  173. <exception name="IOException" type="java.io.IOException"/>
  174. <exception name="UnresolvedLinkException" type="org.apache.hadoop.fs.UnresolvedLinkException"/>
  175. </method>
  176. <method name="setTimes"
  177. abstract="false" native="false" synchronized="false"
  178. static="false" final="false" visibility="protected"
  179. deprecated="not deprecated">
  180. <param name="f" type="org.apache.hadoop.fs.Path"/>
  181. <param name="mtime" type="long"/>
  182. <param name="atime" type="long"/>
  183. <exception name="IOException" type="java.io.IOException"/>
  184. <exception name="UnresolvedLinkException" type="org.apache.hadoop.fs.UnresolvedLinkException"/>
  185. </method>
  186. <method name="setVerifyChecksum"
  187. abstract="false" native="false" synchronized="false"
  188. static="false" final="false" visibility="protected"
  189. deprecated="not deprecated">
  190. <param name="verifyChecksum" type="boolean"/>
  191. <exception name="IOException" type="java.io.IOException"/>
  192. </method>
  193. <method name="supportsSymlinks" return="boolean"
  194. abstract="false" native="false" synchronized="false"
  195. static="false" final="false" visibility="protected"
  196. deprecated="not deprecated">
  197. </method>
  198. <method name="createSymlink"
  199. abstract="false" native="false" synchronized="false"
  200. static="false" final="false" visibility="protected"
  201. deprecated="not deprecated">
  202. <param name="target" type="org.apache.hadoop.fs.Path"/>
  203. <param name="link" type="org.apache.hadoop.fs.Path"/>
  204. <param name="createParent" type="boolean"/>
  205. <exception name="IOException" type="java.io.IOException"/>
  206. <exception name="UnresolvedLinkException" type="org.apache.hadoop.fs.UnresolvedLinkException"/>
  207. </method>
  208. <method name="getLinkTarget" return="org.apache.hadoop.fs.Path"
  209. abstract="false" native="false" synchronized="false"
  210. static="false" final="false" visibility="protected"
  211. deprecated="not deprecated">
  212. <param name="p" type="org.apache.hadoop.fs.Path"/>
  213. <exception name="IOException" type="java.io.IOException"/>
  214. </method>
  215. </class>
  216. <!-- end class org.apache.hadoop.fs.Hdfs -->
  217. </package>
  218. <package name="org.apache.hadoop.hdfs">
  219. <!-- start class org.apache.hadoop.hdfs.BlockMissingException -->
  220. <class name="BlockMissingException" extends="java.io.IOException"
  221. abstract="false"
  222. static="false" final="false" visibility="public"
  223. deprecated="not deprecated">
  224. <constructor name="BlockMissingException" type="java.lang.String, java.lang.String, long"
  225. static="false" final="false" visibility="public"
  226. deprecated="not deprecated">
  227. <doc>
  228. <![CDATA[An exception that indicates that file was corrupted.
  229. @param filename name of corrupted file
  230. @param description a description of the corruption details]]>
  231. </doc>
  232. </constructor>
  233. <method name="getFile" return="java.lang.String"
  234. abstract="false" native="false" synchronized="false"
  235. static="false" final="false" visibility="public"
  236. deprecated="not deprecated">
  237. <doc>
  238. <![CDATA[Returns the name of the corrupted file.
  239. @return name of corrupted file]]>
  240. </doc>
  241. </method>
  242. <method name="getOffset" return="long"
  243. abstract="false" native="false" synchronized="false"
  244. static="false" final="false" visibility="public"
  245. deprecated="not deprecated">
  246. <doc>
  247. <![CDATA[Returns the offset at which this file is corrupted
  248. @return offset of corrupted file]]>
  249. </doc>
  250. </method>
  251. <doc>
  252. <![CDATA[This exception is thrown when a read encounters a block that has no locations
  253. associated with it.]]>
  254. </doc>
  255. </class>
  256. <!-- end class org.apache.hadoop.hdfs.BlockMissingException -->
  257. <!-- start class org.apache.hadoop.hdfs.BlockReader -->
  258. <class name="BlockReader" extends="org.apache.hadoop.fs.FSInputChecker"
  259. abstract="false"
  260. static="false" final="false" visibility="public"
  261. deprecated="not deprecated">
  262. <method name="read" return="int"
  263. abstract="false" native="false" synchronized="true"
  264. static="false" final="false" visibility="public"
  265. deprecated="not deprecated">
  266. <param name="buf" type="byte[]"/>
  267. <param name="off" type="int"/>
  268. <param name="len" type="int"/>
  269. <exception name="IOException" type="java.io.IOException"/>
  270. </method>
  271. <method name="skip" return="long"
  272. abstract="false" native="false" synchronized="true"
  273. static="false" final="false" visibility="public"
  274. deprecated="not deprecated">
  275. <param name="n" type="long"/>
  276. <exception name="IOException" type="java.io.IOException"/>
  277. </method>
  278. <method name="read" return="int"
  279. abstract="false" native="false" synchronized="false"
  280. static="false" final="false" visibility="public"
  281. deprecated="not deprecated">
  282. <exception name="IOException" type="java.io.IOException"/>
  283. </method>
  284. <method name="seekToNewSource" return="boolean"
  285. abstract="false" native="false" synchronized="false"
  286. static="false" final="false" visibility="public"
  287. deprecated="not deprecated">
  288. <param name="targetPos" type="long"/>
  289. <exception name="IOException" type="java.io.IOException"/>
  290. </method>
  291. <method name="seek"
  292. abstract="false" native="false" synchronized="false"
  293. static="false" final="false" visibility="public"
  294. deprecated="not deprecated">
  295. <param name="pos" type="long"/>
  296. <exception name="IOException" type="java.io.IOException"/>
  297. </method>
  298. <method name="getChunkPosition" return="long"
  299. abstract="false" native="false" synchronized="false"
  300. static="false" final="false" visibility="protected"
  301. deprecated="not deprecated">
  302. <param name="pos" type="long"/>
  303. </method>
  304. <method name="readChunk" return="int"
  305. abstract="false" native="false" synchronized="true"
  306. static="false" final="false" visibility="protected"
  307. deprecated="not deprecated">
  308. <param name="pos" type="long"/>
  309. <param name="buf" type="byte[]"/>
  310. <param name="offset" type="int"/>
  311. <param name="len" type="int"/>
  312. <param name="checksumBuf" type="byte[]"/>
  313. <exception name="IOException" type="java.io.IOException"/>
  314. </method>
  315. <method name="newBlockReader" return="org.apache.hadoop.hdfs.BlockReader"
  316. abstract="false" native="false" synchronized="false"
  317. static="true" final="false" visibility="public"
  318. deprecated="not deprecated">
  319. <param name="sock" type="java.net.Socket"/>
  320. <param name="file" type="java.lang.String"/>
  321. <param name="blockId" type="long"/>
  322. <param name="accessToken" type="org.apache.hadoop.hdfs.security.BlockAccessToken"/>
  323. <param name="genStamp" type="long"/>
  324. <param name="startOffset" type="long"/>
  325. <param name="len" type="long"/>
  326. <param name="bufferSize" type="int"/>
  327. <exception name="IOException" type="java.io.IOException"/>
  328. </method>
  329. <method name="newBlockReader" return="org.apache.hadoop.hdfs.BlockReader"
  330. abstract="false" native="false" synchronized="false"
  331. static="true" final="false" visibility="public"
  332. deprecated="not deprecated">
  333. <param name="sock" type="java.net.Socket"/>
  334. <param name="file" type="java.lang.String"/>
  335. <param name="blockId" type="long"/>
  336. <param name="accessToken" type="org.apache.hadoop.hdfs.security.BlockAccessToken"/>
  337. <param name="genStamp" type="long"/>
  338. <param name="startOffset" type="long"/>
  339. <param name="len" type="long"/>
  340. <param name="bufferSize" type="int"/>
  341. <param name="verifyChecksum" type="boolean"/>
  342. <exception name="IOException" type="java.io.IOException"/>
  343. <doc>
  344. <![CDATA[Java Doc required]]>
  345. </doc>
  346. </method>
  347. <method name="newBlockReader" return="org.apache.hadoop.hdfs.BlockReader"
  348. abstract="false" native="false" synchronized="false"
  349. static="true" final="false" visibility="public"
  350. deprecated="not deprecated">
  351. <param name="sock" type="java.net.Socket"/>
  352. <param name="file" type="java.lang.String"/>
  353. <param name="blockId" type="long"/>
  354. <param name="accessToken" type="org.apache.hadoop.hdfs.security.BlockAccessToken"/>
  355. <param name="genStamp" type="long"/>
  356. <param name="startOffset" type="long"/>
  357. <param name="len" type="long"/>
  358. <param name="bufferSize" type="int"/>
  359. <param name="verifyChecksum" type="boolean"/>
  360. <param name="clientName" type="java.lang.String"/>
  361. <exception name="IOException" type="java.io.IOException"/>
  362. </method>
  363. <method name="close"
  364. abstract="false" native="false" synchronized="true"
  365. static="false" final="false" visibility="public"
  366. deprecated="not deprecated">
  367. <exception name="IOException" type="java.io.IOException"/>
  368. </method>
  369. <method name="readAll" return="int"
  370. abstract="false" native="false" synchronized="false"
  371. static="false" final="false" visibility="public"
  372. deprecated="not deprecated">
  373. <param name="buf" type="byte[]"/>
  374. <param name="offset" type="int"/>
  375. <param name="len" type="int"/>
  376. <exception name="IOException" type="java.io.IOException"/>
  377. <doc>
  378. <![CDATA[kind of like readFully(). Only reads as much as possible.
  379. And allows use of protected readFully().]]>
  380. </doc>
  381. </method>
  382. <doc>
  383. <![CDATA[This is a wrapper around connection to datadone
  384. and understands checksum, offset etc]]>
  385. </doc>
  386. </class>
  387. <!-- end class org.apache.hadoop.hdfs.BlockReader -->
  388. <!-- start class org.apache.hadoop.hdfs.DeprecatedUTF8 -->
  389. <class name="DeprecatedUTF8" extends="org.apache.hadoop.io.UTF8"
  390. abstract="false"
  391. static="false" final="false" visibility="public"
  392. deprecated="not deprecated">
  393. <constructor name="DeprecatedUTF8"
  394. static="false" final="false" visibility="public"
  395. deprecated="not deprecated">
  396. </constructor>
  397. <constructor name="DeprecatedUTF8" type="java.lang.String"
  398. static="false" final="false" visibility="public"
  399. deprecated="not deprecated">
  400. <doc>
  401. <![CDATA[Construct from a given string.]]>
  402. </doc>
  403. </constructor>
  404. <constructor name="DeprecatedUTF8" type="org.apache.hadoop.hdfs.DeprecatedUTF8"
  405. static="false" final="false" visibility="public"
  406. deprecated="not deprecated">
  407. <doc>
  408. <![CDATA[Construct from a given string.]]>
  409. </doc>
  410. </constructor>
  411. <method name="readString" return="java.lang.String"
  412. abstract="false" native="false" synchronized="false"
  413. static="true" final="false" visibility="public"
  414. deprecated="not deprecated">
  415. <param name="in" type="java.io.DataInput"/>
  416. <exception name="IOException" type="java.io.IOException"/>
  417. </method>
  418. <method name="writeString" return="int"
  419. abstract="false" native="false" synchronized="false"
  420. static="true" final="false" visibility="public"
  421. deprecated="not deprecated">
  422. <param name="out" type="java.io.DataOutput"/>
  423. <param name="s" type="java.lang.String"/>
  424. <exception name="IOException" type="java.io.IOException"/>
  425. </method>
  426. <doc>
  427. <![CDATA[A simple wrapper around {@link org.apache.hadoop.io.UTF8}.
  428. This class should be used only when it is absolutely necessary
  429. to use {@link org.apache.hadoop.io.UTF8}. The only difference is that
  430. using this class does not require "@SuppressWarning" annotation to avoid
  431. javac warning. Instead the deprecation is implied in the class name.
  432. This should be treated as package private class to HDFS.]]>
  433. </doc>
  434. </class>
  435. <!-- end class org.apache.hadoop.hdfs.DeprecatedUTF8 -->
  436. <!-- start class org.apache.hadoop.hdfs.DFSClient -->
  437. <class name="DFSClient" extends="java.lang.Object"
  438. abstract="false"
  439. static="false" final="false" visibility="public"
  440. deprecated="not deprecated">
  441. <implements name="org.apache.hadoop.hdfs.protocol.FSConstants"/>
  442. <implements name="java.io.Closeable"/>
  443. <constructor name="DFSClient" type="org.apache.hadoop.conf.Configuration"
  444. static="false" final="false" visibility="public"
  445. deprecated="Deprecated at 0.21">
  446. <exception name="IOException" type="java.io.IOException"/>
  447. <doc>
  448. <![CDATA[Same as this(NameNode.getAddress(conf), conf);
  449. @see #DFSClient(InetSocketAddress, Configuration)
  450. @deprecated Deprecated at 0.21]]>
  451. </doc>
  452. </constructor>
  453. <constructor name="DFSClient" type="java.net.InetSocketAddress, org.apache.hadoop.conf.Configuration"
  454. static="false" final="false" visibility="public"
  455. deprecated="not deprecated">
  456. <exception name="IOException" type="java.io.IOException"/>
  457. <doc>
  458. <![CDATA[Same as this(nameNodeAddr, conf, null);
  459. @see #DFSClient(InetSocketAddress, Configuration, org.apache.hadoop.fs.FileSystem.Statistics)]]>
  460. </doc>
  461. </constructor>
  462. <constructor name="DFSClient" type="java.net.InetSocketAddress, org.apache.hadoop.conf.Configuration, org.apache.hadoop.fs.FileSystem.Statistics"
  463. static="false" final="false" visibility="public"
  464. deprecated="not deprecated">
  465. <exception name="IOException" type="java.io.IOException"/>
  466. <doc>
  467. <![CDATA[Same as this(nameNodeAddr, null, conf, stats);
  468. @see #DFSClient(InetSocketAddress, ClientProtocol, Configuration, org.apache.hadoop.fs.FileSystem.Statistics)]]>
  469. </doc>
  470. </constructor>
  471. <method name="createNamenode" return="org.apache.hadoop.hdfs.protocol.ClientProtocol"
  472. abstract="false" native="false" synchronized="false"
  473. static="true" final="false" visibility="public"
  474. deprecated="not deprecated">
  475. <param name="conf" type="org.apache.hadoop.conf.Configuration"/>
  476. <exception name="IOException" type="java.io.IOException"/>
  477. <doc>
  478. <![CDATA[The locking hierarchy is to first acquire lock on DFSClient object, followed by
  479. lock on leasechecker, followed by lock on an individual DFSOutputStream.]]>
  480. </doc>
  481. </method>
  482. <method name="createNamenode" return="org.apache.hadoop.hdfs.protocol.ClientProtocol"
  483. abstract="false" native="false" synchronized="false"
  484. static="true" final="false" visibility="public"
  485. deprecated="not deprecated">
  486. <param name="nameNodeAddr" type="java.net.InetSocketAddress"/>
  487. <param name="conf" type="org.apache.hadoop.conf.Configuration"/>
  488. <exception name="IOException" type="java.io.IOException"/>
  489. </method>
  490. <method name="close"
  491. abstract="false" native="false" synchronized="true"
  492. static="false" final="false" visibility="public"
  493. deprecated="not deprecated">
  494. <exception name="IOException" type="java.io.IOException"/>
  495. <doc>
  496. <![CDATA[Close the file system, abandoning all of the leases and files being
  497. created and close connections to the namenode.]]>
  498. </doc>
  499. </method>
  500. <method name="getDefaultBlockSize" return="long"
  501. abstract="false" native="false" synchronized="false"
  502. static="false" final="false" visibility="public"
  503. deprecated="not deprecated">
  504. <doc>
  505. <![CDATA[Get the default block size for this cluster
  506. @return the default block size in bytes]]>
  507. </doc>
  508. </method>
  509. <method name="getBlockSize" return="long"
  510. abstract="false" native="false" synchronized="false"
  511. static="false" final="false" visibility="public"
  512. deprecated="not deprecated">
  513. <param name="f" type="java.lang.String"/>
  514. <exception name="IOException" type="java.io.IOException"/>
  515. </method>
  516. <method name="getServerDefaults" return="org.apache.hadoop.fs.FsServerDefaults"
  517. abstract="false" native="false" synchronized="false"
  518. static="false" final="false" visibility="public"
  519. deprecated="not deprecated">
  520. <exception name="IOException" type="java.io.IOException"/>
  521. <doc>
  522. <![CDATA[Get server default values for a number of configuration params.]]>
  523. </doc>
  524. </method>
  525. <method name="getDelegationToken" return="org.apache.hadoop.security.token.Token"
  526. abstract="false" native="false" synchronized="false"
  527. static="false" final="false" visibility="public"
  528. deprecated="not deprecated">
  529. <param name="renewer" type="org.apache.hadoop.io.Text"/>
  530. <exception name="IOException" type="java.io.IOException"/>
  531. </method>
  532. <method name="renewDelegationToken" return="long"
  533. abstract="false" native="false" synchronized="false"
  534. static="false" final="false" visibility="public"
  535. deprecated="not deprecated">
  536. <param name="token" type="org.apache.hadoop.security.token.Token"/>
  537. <exception name="SecretManager.InvalidToken" type="org.apache.hadoop.security.token.SecretManager.InvalidToken"/>
  538. <exception name="IOException" type="java.io.IOException"/>
  539. </method>
  540. <method name="cancelDelegationToken"
  541. abstract="false" native="false" synchronized="false"
  542. static="false" final="false" visibility="public"
  543. deprecated="not deprecated">
  544. <param name="token" type="org.apache.hadoop.security.token.Token"/>
  545. <exception name="SecretManager.InvalidToken" type="org.apache.hadoop.security.token.SecretManager.InvalidToken"/>
  546. <exception name="IOException" type="java.io.IOException"/>
  547. </method>
  548. <method name="reportBadBlocks"
  549. abstract="false" native="false" synchronized="false"
  550. static="false" final="false" visibility="public"
  551. deprecated="not deprecated">
  552. <param name="blocks" type="org.apache.hadoop.hdfs.protocol.LocatedBlock[]"/>
  553. <exception name="IOException" type="java.io.IOException"/>
  554. <doc>
  555. <![CDATA[Report corrupt blocks that were discovered by the client.]]>
  556. </doc>
  557. </method>
  558. <method name="getDefaultReplication" return="short"
  559. abstract="false" native="false" synchronized="false"
  560. static="false" final="false" visibility="public"
  561. deprecated="not deprecated">
  562. </method>
  563. <method name="getBlockLocations" return="org.apache.hadoop.fs.BlockLocation[]"
  564. abstract="false" native="false" synchronized="false"
  565. static="false" final="false" visibility="public"
  566. deprecated="not deprecated">
  567. <param name="src" type="java.lang.String"/>
  568. <param name="start" type="long"/>
  569. <param name="length" type="long"/>
  570. <exception name="IOException" type="java.io.IOException"/>
  571. <exception name="UnresolvedLinkException" type="org.apache.hadoop.fs.UnresolvedLinkException"/>
  572. <doc>
  573. <![CDATA[Get block location info about file
  574. getBlockLocations() returns a list of hostnames that store
  575. data for a specific file region. It returns a set of hostnames
  576. for every block within the indicated region.
  577. This function is very useful when writing code that considers
  578. data-placement when performing operations. For example, the
  579. MapReduce system tries to schedule tasks on the same machines
  580. as the data-block the task processes.]]>
  581. </doc>
  582. </method>
  583. <method name="open" return="org.apache.hadoop.hdfs.DFSInputStream"
  584. abstract="false" native="false" synchronized="false"
  585. static="false" final="false" visibility="public"
  586. deprecated="not deprecated">
  587. <param name="src" type="java.lang.String"/>
  588. <exception name="IOException" type="java.io.IOException"/>
  589. <exception name="UnresolvedLinkException" type="org.apache.hadoop.fs.UnresolvedLinkException"/>
  590. </method>
  591. <method name="open" return="org.apache.hadoop.hdfs.DFSInputStream"
  592. abstract="false" native="false" synchronized="false"
  593. static="false" final="false" visibility="public"
  594. deprecated="Use {@link #open(String, int, boolean)} instead.">
  595. <param name="src" type="java.lang.String"/>
  596. <param name="buffersize" type="int"/>
  597. <param name="verifyChecksum" type="boolean"/>
  598. <param name="stats" type="org.apache.hadoop.fs.FileSystem.Statistics"/>
  599. <exception name="IOException" type="java.io.IOException"/>
  600. <exception name="UnresolvedLinkException" type="org.apache.hadoop.fs.UnresolvedLinkException"/>
  601. <doc>
  602. <![CDATA[Create an input stream that obtains a nodelist from the
  603. namenode, and then reads from all the right places. Creates
  604. inner subclass of InputStream that does the right out-of-band
  605. work.
  606. @deprecated Use {@link #open(String, int, boolean)} instead.]]>
  607. </doc>
  608. </method>
  609. <method name="open" return="org.apache.hadoop.hdfs.DFSInputStream"
  610. abstract="false" native="false" synchronized="false"
  611. static="false" final="false" visibility="public"
  612. deprecated="not deprecated">
  613. <param name="src" type="java.lang.String"/>
  614. <param name="buffersize" type="int"/>
  615. <param name="verifyChecksum" type="boolean"/>
  616. <exception name="IOException" type="java.io.IOException"/>
  617. <exception name="UnresolvedLinkException" type="org.apache.hadoop.fs.UnresolvedLinkException"/>
  618. <doc>
  619. <![CDATA[Create an input stream that obtains a nodelist from the
  620. namenode, and then reads from all the right places. Creates
  621. inner subclass of InputStream that does the right out-of-band
  622. work.]]>
  623. </doc>
  624. </method>
  625. <method name="create" return="java.io.OutputStream"
  626. abstract="false" native="false" synchronized="false"
  627. static="false" final="false" visibility="public"
  628. deprecated="not deprecated">
  629. <param name="src" type="java.lang.String"/>
  630. <param name="overwrite" type="boolean"/>
  631. <exception name="IOException" type="java.io.IOException"/>
  632. <exception name="UnresolvedLinkException" type="org.apache.hadoop.fs.UnresolvedLinkException"/>
  633. <doc>
  634. <![CDATA[Create a new dfs file and return an output stream for writing into it.
  635. @param src stream name
  636. @param overwrite do not check for file existence if true
  637. @return output stream
  638. @throws UnresolvedLinkException if a symlink is encountered in src.
  639. @throws IOException]]>
  640. </doc>
  641. </method>
  642. <method name="create" return="java.io.OutputStream"
  643. abstract="false" native="false" synchronized="false"
  644. static="false" final="false" visibility="public"
  645. deprecated="not deprecated">
  646. <param name="src" type="java.lang.String"/>
  647. <param name="overwrite" type="boolean"/>
  648. <param name="progress" type="org.apache.hadoop.util.Progressable"/>
  649. <exception name="IOException" type="java.io.IOException"/>
  650. <exception name="UnresolvedLinkException" type="org.apache.hadoop.fs.UnresolvedLinkException"/>
  651. <doc>
  652. <![CDATA[Create a new dfs file and return an output stream for writing into it
  653. with write-progress reporting.
  654. @param src stream name
  655. @param overwrite do not check for file existence if true
  656. @return output stream
  657. @throws UnresolvedLinkException if a symlink is encountered in src.
  658. @throws IOException]]>
  659. </doc>
  660. </method>
  661. <method name="create" return="java.io.OutputStream"
  662. abstract="false" native="false" synchronized="false"
  663. static="false" final="false" visibility="public"
  664. deprecated="not deprecated">
  665. <param name="src" type="java.lang.String"/>
  666. <param name="overwrite" type="boolean"/>
  667. <param name="replication" type="short"/>
  668. <param name="blockSize" type="long"/>
  669. <exception name="IOException" type="java.io.IOException"/>
  670. <exception name="UnresolvedLinkException" type="org.apache.hadoop.fs.UnresolvedLinkException"/>
  671. <doc>
  672. <![CDATA[Create a new dfs file with the specified block replication
  673. and return an output stream for writing into the file.
  674. @param src stream name
  675. @param overwrite do not check for file existence if true
  676. @param replication block replication
  677. @return output stream
  678. @throws UnresolvedLinkException if a symlink is encountered in src.
  679. @throws IOException]]>
  680. </doc>
  681. </method>
  682. <method name="getNamenode" return="org.apache.hadoop.hdfs.protocol.ClientProtocol"
  683. abstract="false" native="false" synchronized="false"
  684. static="false" final="false" visibility="public"
  685. deprecated="not deprecated">
  686. <doc>
  687. <![CDATA[Get the namenode associated with this DFSClient object
  688. @return the namenode associated with this DFSClient object]]>
  689. </doc>
  690. </method>
  691. <method name="create" return="java.io.OutputStream"
  692. abstract="false" native="false" synchronized="false"
  693. static="false" final="false" visibility="public"
  694. deprecated="not deprecated">
  695. <param name="src" type="java.lang.String"/>
  696. <param name="overwrite" type="boolean"/>
  697. <param name="replication" type="short"/>
  698. <param name="blockSize" type="long"/>
  699. <param name="progress" type="org.apache.hadoop.util.Progressable"/>
  700. <exception name="IOException" type="java.io.IOException"/>
  701. <exception name="UnresolvedLinkException" type="org.apache.hadoop.fs.UnresolvedLinkException"/>
  702. <doc>
  703. <![CDATA[Create a new dfs file with the specified block replication
  704. with write-progress reporting and return an output stream for writing
  705. into the file.
  706. @param src stream name
  707. @param overwrite do not check for file existence if true
  708. @param replication block replication
  709. @return output stream
  710. @throws UnresolvedLinkException if a symlink is encountered in src.
  711. @throws IOException]]>
  712. </doc>
  713. </method>
  714. <method name="create" return="java.io.OutputStream"
  715. abstract="false" native="false" synchronized="false"
  716. static="false" final="false" visibility="public"
  717. deprecated="not deprecated">
  718. <param name="src" type="java.lang.String"/>
  719. <param name="overwrite" type="boolean"/>
  720. <param name="replication" type="short"/>
  721. <param name="blockSize" type="long"/>
  722. <param name="progress" type="org.apache.hadoop.util.Progressable"/>
  723. <param name="buffersize" type="int"/>
  724. <exception name="IOException" type="java.io.IOException"/>
  725. <exception name="UnresolvedLinkException" type="org.apache.hadoop.fs.UnresolvedLinkException"/>
  726. <doc>
  727. <![CDATA[Call
  728. {@link #create(String,FsPermission,EnumSet,short,long,Progressable,int)}
  729. with default permission.
  730. @see FsPermission#getDefault()]]>
  731. </doc>
  732. </method>
  733. <method name="create" return="java.io.OutputStream"
  734. abstract="false" native="false" synchronized="false"
  735. static="false" final="false" visibility="public"
  736. deprecated="not deprecated">
  737. <param name="src" type="java.lang.String"/>
  738. <param name="permission" type="org.apache.hadoop.fs.permission.FsPermission"/>
  739. <param name="flag" type="java.util.EnumSet"/>
  740. <param name="replication" type="short"/>
  741. <param name="blockSize" type="long"/>
  742. <param name="progress" type="org.apache.hadoop.util.Progressable"/>
  743. <param name="buffersize" type="int"/>
  744. <exception name="IOException" type="java.io.IOException"/>
  745. <exception name="UnresolvedLinkException" type="org.apache.hadoop.fs.UnresolvedLinkException"/>
  746. <doc>
  747. <![CDATA[Call
  748. {@link #create(String,FsPermission,EnumSet,boolean,short,long,Progressable,int)}
  749. with createParent set to true.]]>
  750. </doc>
  751. </method>
  752. <method name="create" return="java.io.OutputStream"
  753. abstract="false" native="false" synchronized="false"
  754. static="false" final="false" visibility="public"
  755. deprecated="not deprecated">
  756. <param name="src" type="java.lang.String"/>
  757. <param name="permission" type="org.apache.hadoop.fs.permission.FsPermission"/>
  758. <param name="flag" type="java.util.EnumSet"/>
  759. <param name="createParent" type="boolean"/>
  760. <param name="replication" type="short"/>
  761. <param name="blockSize" type="long"/>
  762. <param name="progress" type="org.apache.hadoop.util.Progressable"/>
  763. <param name="buffersize" type="int"/>
  764. <exception name="IOException" type="java.io.IOException"/>
  765. <exception name="UnresolvedLinkException" type="org.apache.hadoop.fs.UnresolvedLinkException"/>
  766. <doc>
  767. <![CDATA[Create a new dfs file with the specified block replication
  768. with write-progress reporting and return an output stream for writing
  769. into the file.
  770. @param src stream name
  771. @param permission The permission of the directory being created.
  772. If permission == null, use {@link FsPermission#getDefault()}.
  773. @param flag do not check for file existence if true
  774. @param createParent create missing parent directory if true
  775. @param replication block replication
  776. @return output stream
  777. @throws IOException
  778. @throws UnresolvedLinkException if src contains a symlink.
  779. @see ClientProtocol#create(String, FsPermission, String, EnumSetWritable, boolean, short, long)]]>
  780. </doc>
  781. </method>
  782. <method name="primitiveCreate" return="java.io.OutputStream"
  783. abstract="false" native="false" synchronized="false"
  784. static="false" final="false" visibility="public"
  785. deprecated="not deprecated">
  786. <param name="src" type="java.lang.String"/>
  787. <param name="absPermission" type="org.apache.hadoop.fs.permission.FsPermission"/>
  788. <param name="flag" type="java.util.EnumSet"/>
  789. <param name="createParent" type="boolean"/>
  790. <param name="replication" type="short"/>
  791. <param name="blockSize" type="long"/>
  792. <param name="progress" type="org.apache.hadoop.util.Progressable"/>
  793. <param name="buffersize" type="int"/>
  794. <param name="bytesPerChecksum" type="int"/>
  795. <exception name="IOException" type="java.io.IOException"/>
  796. <exception name="UnresolvedLinkException" type="org.apache.hadoop.fs.UnresolvedLinkException"/>
  797. <doc>
  798. <![CDATA[Same as {{@link #create(String, FsPermission, EnumSet, short, long,
  799. Progressable, int)} except that the permission
  800. is absolute (ie has already been masked with umask.]]>
  801. </doc>
  802. </method>
  803. <method name="createSymlink"
  804. abstract="false" native="false" synchronized="false"
  805. static="false" final="false" visibility="public"
  806. deprecated="not deprecated">
  807. <param name="target" type="java.lang.String"/>
  808. <param name="link" type="java.lang.String"/>
  809. <param name="createParent" type="boolean"/>
  810. <exception name="IOException" type="java.io.IOException"/>
  811. <exception name="UnresolvedLinkException" type="org.apache.hadoop.fs.UnresolvedLinkException"/>
  812. <doc>
  813. <![CDATA[Creates a symbolic link.
  814. @see ClientProtocol#createSymlink(String, String,FsPermission, boolean)]]>
  815. </doc>
  816. </method>
  817. <method name="getLinkTarget" return="java.lang.String"
  818. abstract="false" native="false" synchronized="false"
  819. static="false" final="false" visibility="public"
  820. deprecated="not deprecated">
  821. <param name="path" type="java.lang.String"/>
  822. <exception name="IOException" type="java.io.IOException"/>
  823. <doc>
  824. <![CDATA[Resolve the *first* symlink, if any, in the path.
  825. @see ClientProtocol#getLinkTarget(String)]]>
  826. </doc>
  827. </method>
  828. <method name="setReplication" return="boolean"
  829. abstract="false" native="false" synchronized="false"
  830. static="false" final="false" visibility="public"
  831. deprecated="not deprecated">
  832. <param name="src" type="java.lang.String"/>
  833. <param name="replication" type="short"/>
  834. <exception name="IOException" type="java.io.IOException"/>
  835. <exception name="UnresolvedLinkException" type="org.apache.hadoop.fs.UnresolvedLinkException"/>
  836. <doc>
  837. <![CDATA[Set replication for an existing file.
  838. @see ClientProtocol#setReplication(String, short)
  839. @param replication
  840. @throws IOException
  841. @return true is successful or false if file does not exist]]>
  842. </doc>
  843. </method>
  844. <method name="rename" return="boolean"
  845. abstract="false" native="false" synchronized="false"
  846. static="false" final="false" visibility="public"
  847. deprecated="Use {@link #rename(String, String, Options.Rename...)} instead.">
  848. <param name="src" type="java.lang.String"/>
  849. <param name="dst" type="java.lang.String"/>
  850. <exception name="IOException" type="java.io.IOException"/>
  851. <exception name="UnresolvedLinkException" type="org.apache.hadoop.fs.UnresolvedLinkException"/>
  852. <doc>
  853. <![CDATA[Rename file or directory.
  854. See {@link ClientProtocol#rename(String, String)}.
  855. @deprecated Use {@link #rename(String, String, Options.Rename...)} instead.]]>
  856. </doc>
  857. </method>
  858. <method name="concat"
  859. abstract="false" native="false" synchronized="false"
  860. static="false" final="false" visibility="public"
  861. deprecated="not deprecated">
  862. <param name="trg" type="java.lang.String"/>
  863. <param name="srcs" type="java.lang.String[]"/>
  864. <exception name="IOException" type="java.io.IOException"/>
  865. <exception name="UnresolvedLinkException" type="org.apache.hadoop.fs.UnresolvedLinkException"/>
  866. <doc>
  867. <![CDATA[Move blocks from src to trg and delete src
  868. See {@link ClientProtocol#concat(String, String [])}.]]>
  869. </doc>
  870. </method>
  871. <method name="rename"
  872. abstract="false" native="false" synchronized="false"
  873. static="false" final="false" visibility="public"
  874. deprecated="not deprecated">
  875. <param name="src" type="java.lang.String"/>
  876. <param name="dst" type="java.lang.String"/>
  877. <param name="options" type="org.apache.hadoop.fs.Options.Rename[]"/>
  878. <exception name="IOException" type="java.io.IOException"/>
  879. <exception name="UnresolvedLinkException" type="org.apache.hadoop.fs.UnresolvedLinkException"/>
  880. <doc>
  881. <![CDATA[Rename file or directory.
  882. See {@link ClientProtocol#rename(String, String, Options.Rename...)}]]>
  883. </doc>
  884. </method>
  885. <method name="delete" return="boolean"
  886. abstract="false" native="false" synchronized="false"
  887. static="false" final="false" visibility="public"
  888. deprecated="not deprecated">
  889. <param name="src" type="java.lang.String"/>
  890. <exception name="IOException" type="java.io.IOException"/>
  891. <exception name="UnresolvedLinkException" type="org.apache.hadoop.fs.UnresolvedLinkException"/>
  892. <doc>
  893. <![CDATA[Delete file or directory.
  894. See {@link ClientProtocol#delete(String)}.]]>
  895. </doc>
  896. </method>
  897. <method name="delete" return="boolean"
  898. abstract="false" native="false" synchronized="false"
  899. static="false" final="false" visibility="public"
  900. deprecated="not deprecated">
  901. <param name="src" type="java.lang.String"/>
  902. <param name="recursive" type="boolean"/>
  903. <exception name="IOException" type="java.io.IOException"/>
  904. <exception name="UnresolvedLinkException" type="org.apache.hadoop.fs.UnresolvedLinkException"/>
  905. <doc>
  906. <![CDATA[delete file or directory.
  907. delete contents of the directory if non empty and recursive
  908. set to true]]>
  909. </doc>
  910. </method>
  911. <method name="exists" return="boolean"
  912. abstract="false" native="false" synchronized="false"
  913. static="false" final="false" visibility="public"
  914. deprecated="not deprecated">
  915. <param name="src" type="java.lang.String"/>
  916. <exception name="IOException" type="java.io.IOException"/>
  917. <doc>
  918. <![CDATA[Implemented using getFileInfo(src)]]>
  919. </doc>
  920. </method>
  921. <method name="listPaths" return="org.apache.hadoop.hdfs.protocol.DirectoryListing"
  922. abstract="false" native="false" synchronized="false"
  923. static="false" final="false" visibility="public"
  924. deprecated="not deprecated">
  925. <param name="src" type="java.lang.String"/>
  926. <param name="startAfter" type="byte[]"/>
  927. <exception name="IOException" type="java.io.IOException"/>
  928. <exception name="UnresolvedLinkException" type="org.apache.hadoop.fs.UnresolvedLinkException"/>
  929. <doc>
  930. <![CDATA[Get a partial listing of the indicated directory
  931. Recommend to use HdfsFileStatus.EMPTY_NAME as startAfter
  932. if the application wants to fetch a listing starting from
  933. the first entry in the directory
  934. @param src the directory name
  935. @param startAfter the name to start listing after encoded in java UTF8
  936. @return a partial listing starting after startAfter]]>
  937. </doc>
  938. </method>
  939. <method name="getFileInfo" return="org.apache.hadoop.hdfs.protocol.HdfsFileStatus"
  940. abstract="false" native="false" synchronized="false"
  941. static="false" final="false" visibility="public"
  942. deprecated="not deprecated">
  943. <param name="src" type="java.lang.String"/>
  944. <exception name="IOException" type="java.io.IOException"/>
  945. <exception name="UnresolvedLinkException" type="org.apache.hadoop.fs.UnresolvedLinkException"/>
  946. </method>
  947. <method name="getFileLinkInfo" return="org.apache.hadoop.hdfs.protocol.HdfsFileStatus"
  948. abstract="false" native="false" synchronized="false"
  949. static="false" final="false" visibility="public"
  950. deprecated="not deprecated">
  951. <param name="src" type="java.lang.String"/>
  952. <exception name="IOException" type="java.io.IOException"/>
  953. <exception name="UnresolvedLinkException" type="org.apache.hadoop.fs.UnresolvedLinkException"/>
  954. <doc>
  955. <![CDATA[Get the file info for a specific file or directory. If src
  956. refers to a symlink then the FileStatus of the link is returned.
  957. @param src path to a file or directory.
  958. @throws IOException
  959. @throws UnresolvedLinkException if the path contains symlinks
  960. @return FileStatus describing src.]]>
  961. </doc>
  962. </method>
  963. <method name="getFileChecksum" return="org.apache.hadoop.fs.MD5MD5CRC32FileChecksum"
  964. abstract="false" native="false" synchronized="false"
  965. static="false" final="false" visibility="public"
  966. deprecated="not deprecated">
  967. <param name="src" type="java.lang.String"/>
  968. <exception name="IOException" type="java.io.IOException"/>
  969. <doc>
  970. <![CDATA[Get the checksum of a file.
  971. @param src The file path
  972. @return The checksum
  973. @see DistributedFileSystem#getFileChecksum(Path)]]>
  974. </doc>
  975. </method>
  976. <method name="getFileChecksum" return="org.apache.hadoop.fs.MD5MD5CRC32FileChecksum"
  977. abstract="false" native="false" synchronized="false"
  978. static="true" final="false" visibility="public"
  979. deprecated="not deprecated">
  980. <param name="src" type="java.lang.String"/>
  981. <param name="namenode" type="org.apache.hadoop.hdfs.protocol.ClientProtocol"/>
  982. <param name="socketFactory" type="javax.net.SocketFactory"/>
  983. <param name="socketTimeout" type="int"/>
  984. <exception name="IOException" type="java.io.IOException"/>
  985. <doc>
  986. <![CDATA[Get the checksum of a file.
  987. @param src The file path
  988. @return The checksum]]>
  989. </doc>
  990. </method>
  991. <method name="setPermission"
  992. abstract="false" native="false" synchronized="false"
  993. static="false" final="false" visibility="public"
  994. deprecated="not deprecated">
  995. <param name="src" type="java.lang.String"/>
  996. <param name="permission" type="org.apache.hadoop.fs.permission.FsPermission"/>
  997. <exception name="IOException" type="java.io.IOException"/>
  998. <exception name="UnresolvedLinkException" type="org.apache.hadoop.fs.UnresolvedLinkException"/>
  999. <doc>
  1000. <![CDATA[Set permissions to a file or directory.
  1001. @param src path name.
  1002. @param permission
  1003. @throws <code>FileNotFoundException</code> is file does not exist.
  1004. @throws UnresolvedLinkException if the path contains a symlink.]]>
  1005. </doc>
  1006. </method>
  1007. <method name="setOwner"
  1008. abstract="false" native="false" synchronized="false"
  1009. static="false" final="false" visibility="public"
  1010. deprecated="not deprecated">
  1011. <param name="src" type="java.lang.String"/>
  1012. <param name="username" type="java.lang.String"/>
  1013. <param name="groupname" type="java.lang.String"/>
  1014. <exception name="IOException" type="java.io.IOException"/>
  1015. <exception name="UnresolvedLinkException" type="org.apache.hadoop.fs.UnresolvedLinkException"/>
  1016. <doc>
  1017. <![CDATA[Set file or directory owner.
  1018. @param src path name.
  1019. @param username user id.
  1020. @param groupname user group.
  1021. @throws <code>FileNotFoundException</code> is file does not exist.
  1022. @throws UnresolvedLinkException if the path contains a symlink.]]>
  1023. </doc>
  1024. </method>
  1025. <method name="getDiskStatus" return="org.apache.hadoop.fs.FsStatus"
  1026. abstract="false" native="false" synchronized="false"
  1027. static="false" final="false" visibility="public"
  1028. deprecated="not deprecated">
  1029. <exception name="IOException" type="java.io.IOException"/>
  1030. </method>
  1031. <method name="getMissingBlocksCount" return="long"
  1032. abstract="false" native="false" synchronized="false"
  1033. static="false" final="false" visibility="public"
  1034. deprecated="not deprecated">
  1035. <exception name="IOException" type="java.io.IOException"/>
  1036. <doc>
  1037. <![CDATA[Returns count of blocks with no good replicas left. Normally should be
  1038. zero.
  1039. @throws IOException]]>
  1040. </doc>
  1041. </method>
  1042. <method name="getUnderReplicatedBlocksCount" return="long"
  1043. abstract="false" native="false" synchronized="false"
  1044. static="false" final="false" visibility="public"
  1045. deprecated="not deprecated">
  1046. <exception name="IOException" type="java.io.IOException"/>
  1047. <doc>
  1048. <![CDATA[Returns count of blocks with one of more replica missing.
  1049. @throws IOException]]>
  1050. </doc>
  1051. </method>
  1052. <method name="getCorruptBlocksCount" return="long"
  1053. abstract="false" native="false" synchronized="false"
  1054. static="false" final="false" visibility="public"
  1055. deprecated="not deprecated">
  1056. <exception name="IOException" type="java.io.IOException"/>
  1057. <doc>
  1058. <![CDATA[Returns count of blocks with at least one replica marked corrupt.
  1059. @throws IOException]]>
  1060. </doc>
  1061. </method>
  1062. <method name="datanodeReport" return="org.apache.hadoop.hdfs.protocol.DatanodeInfo[]"
  1063. abstract="false" native="false" synchronized="false"
  1064. static="false" final="false" visibility="public"
  1065. deprecated="not deprecated">
  1066. <param name="type" type="org.apache.hadoop.hdfs.protocol.FSConstants.DatanodeReportType"/>
  1067. <exception name="IOException" type="java.io.IOException"/>
  1068. </method>
  1069. <method name="setSafeMode" return="boolean"
  1070. abstract="false" native="false" synchronized="false"
  1071. static="false" final="false" visibility="public"
  1072. deprecated="not deprecated">
  1073. <param name="action" type="org.apache.hadoop.hdfs.protocol.FSConstants.SafeModeAction"/>
  1074. <exception name="IOException" type="java.io.IOException"/>
  1075. <doc>
  1076. <![CDATA[Enter, leave or get safe mode.
  1077. See {@link ClientProtocol#setSafeMode(FSConstants.SafeModeAction)}
  1078. for more details.
  1079. @see ClientProtocol#setSafeMode(FSConstants.SafeModeAction)]]>
  1080. </doc>
  1081. </method>
  1082. <method name="refreshNodes"
  1083. abstract="false" native="false" synchronized="false"
  1084. static="false" final="false" visibility="public"
  1085. deprecated="not deprecated">
  1086. <exception name="IOException" type="java.io.IOException"/>
  1087. <doc>
  1088. <![CDATA[Refresh the hosts and exclude files. (Rereads them.)
  1089. See {@link ClientProtocol#refreshNodes()}
  1090. for more details.
  1091. @see ClientProtocol#refreshNodes()]]>
  1092. </doc>
  1093. </method>
  1094. <method name="metaSave"
  1095. abstract="false" native="false" synchronized="false"
  1096. static="false" final="false" visibility="public"
  1097. deprecated="not deprecated">
  1098. <param name="pathname" type="java.lang.String"/>
  1099. <exception name="IOException" type="java.io.IOException"/>
  1100. <doc>
  1101. <![CDATA[Dumps DFS data structures into specified file.
  1102. See {@link ClientProtocol#metaSave(String)}
  1103. for more details.
  1104. @see ClientProtocol#metaSave(String)]]>
  1105. </doc>
  1106. </method>
  1107. <method name="finalizeUpgrade"
  1108. abstract="false" native="false" synchronized="false"
  1109. static="false" final="false" visibility="public"
  1110. deprecated="not deprecated">
  1111. <exception name="IOException" type="java.io.IOException"/>
  1112. <doc>
  1113. <![CDATA[@see ClientProtocol#finalizeUpgrade()]]>
  1114. </doc>
  1115. </method>
  1116. <method name="distributedUpgradeProgress" return="org.apache.hadoop.hdfs.server.common.UpgradeStatusReport"
  1117. abstract="false" native="false" synchronized="false"
  1118. static="false" final="false" visibility="public"
  1119. deprecated="not deprecated">
  1120. <param name="action" type="org.apache.hadoop.hdfs.protocol.FSConstants.UpgradeAction"/>
  1121. <exception name="IOException" type="java.io.IOException"/>
  1122. <doc>
  1123. <![CDATA[@see ClientProtocol#distributedUpgradeProgress(FSConstants.UpgradeAction)]]>
  1124. </doc>
  1125. </method>
  1126. <method name="mkdirs" return="boolean"
  1127. abstract="false" native="false" synchronized="false"
  1128. static="false" final="false" visibility="public"
  1129. deprecated="not deprecated">
  1130. <param name="src" type="java.lang.String"/>
  1131. <exception name="IOException" type="java.io.IOException"/>
  1132. </method>
  1133. <method name="mkdirs" return="boolean"
  1134. abstract="false" native="false" synchronized="false"
  1135. static="false" final="false" visibility="public"
  1136. deprecated="not deprecated">
  1137. <param name="src" type="java.lang.String"/>
  1138. <param name="permission" type="org.apache.hadoop.fs.permission.FsPermission"/>
  1139. <param name="createParent" type="boolean"/>
  1140. <exception name="IOException" type="java.io.IOException"/>
  1141. <exception name="UnresolvedLinkException" type="org.apache.hadoop.fs.UnresolvedLinkException"/>
  1142. <doc>
  1143. <![CDATA[Create a directory (or hierarchy of directories) with the given
  1144. name and permission.
  1145. @param src The path of the directory being created
  1146. @param permission The permission of the directory being created.
  1147. If permission == null, use {@link FsPermission#getDefault()}.
  1148. @param createParent create missing parent directory if true
  1149. @return True if the operation success.
  1150. @throws UnresolvedLinkException if the path contains a symlink.
  1151. @see ClientProtocol#mkdirs(String, FsPermission, boolean)]]>
  1152. </doc>
  1153. </method>
  1154. <method name="primitiveMkdir" return="boolean"
  1155. abstract="false" native="false" synchronized="false"
  1156. static="false" final="false" visibility="public"
  1157. deprecated="not deprecated">
  1158. <param name="src" type="java.lang.String"/>
  1159. <param name="absPermission" type="org.apache.hadoop.fs.permission.FsPermission"/>
  1160. <exception name="IOException" type="java.io.IOException"/>
  1161. <exception name="UnresolvedLinkException" type="org.apache.hadoop.fs.UnresolvedLinkException"/>
  1162. <doc>
  1163. <![CDATA[Same {{@link #mkdirs(String, FsPermission, boolean)} except
  1164. that the permissions has already been masked against umask.
  1165. @throws UnresolvedLinkException if the path contains a symlink.]]>
  1166. </doc>
  1167. </method>
  1168. <method name="setTimes"
  1169. abstract="false" native="false" synchronized="false"
  1170. static="false" final="false" visibility="public"
  1171. deprecated="not deprecated">
  1172. <param name="src" type="java.lang.String"/>
  1173. <param name="mtime" type="long"/>
  1174. <param name="atime" type="long"/>
  1175. <exception name="IOException" type="java.io.IOException"/>
  1176. <exception name="UnresolvedLinkException" type="org.apache.hadoop.fs.UnresolvedLinkException"/>
  1177. <doc>
  1178. <![CDATA[set the modification and access time of a file
  1179. @throws FileNotFoundException if the path is not a file]]>
  1180. </doc>
  1181. </method>
  1182. <method name="toString" return="java.lang.String"
  1183. abstract="false" native="false" synchronized="false"
  1184. static="false" final="false" visibility="public"
  1185. deprecated="not deprecated">
  1186. <doc>
  1187. <![CDATA[{@inheritDoc}]]>
  1188. </doc>
  1189. </method>
  1190. <field name="LOG" type="org.apache.commons.logging.Log"
  1191. transient="false" volatile="false"
  1192. static="true" final="true" visibility="public"
  1193. deprecated="not deprecated">
  1194. </field>
  1195. <field name="SERVER_DEFAULTS_VALIDITY_PERIOD" type="long"
  1196. transient="false" volatile="false"
  1197. static="true" final="true" visibility="public"
  1198. deprecated="not deprecated">
  1199. </field>
  1200. <field name="MAX_BLOCK_ACQUIRE_FAILURES" type="int"
  1201. transient="false" volatile="false"
  1202. static="true" final="true" visibility="public"
  1203. deprecated="not deprecated">
  1204. </field>
  1205. <doc>
  1206. <![CDATA[DFSClient can connect to a Hadoop Filesystem and
  1207. perform basic file tasks. It uses the ClientProtocol
  1208. to communicate with a NameNode daemon, and connects
  1209. directly to DataNodes to read/write block data.
  1210. Hadoop DFS users should obtain an instance of
  1211. DistributedFileSystem, which uses DFSClient to handle
  1212. filesystem tasks.]]>
  1213. </doc>
  1214. </class>
  1215. <!-- end class org.apache.hadoop.hdfs.DFSClient -->
  1216. <!-- start class org.apache.hadoop.hdfs.DFSClient.DFSDataInputStream -->
  1217. <class name="DFSClient.DFSDataInputStream" extends="org.apache.hadoop.fs.FSDataInputStream"
  1218. abstract="false"
  1219. static="true" final="false" visibility="public"
  1220. deprecated="not deprecated">
  1221. <constructor name="DFSClient.DFSDataInputStream" type="org.apache.hadoop.hdfs.DFSInputStream"
  1222. static="false" final="false" visibility="public"
  1223. deprecated="not deprecated">
  1224. <exception name="IOException" type="java.io.IOException"/>
  1225. </constructor>
  1226. <method name="getCurrentDatanode" return="org.apache.hadoop.hdfs.protocol.DatanodeInfo"
  1227. abstract="false" native="false" synchronized="false"
  1228. static="false" final="false" visibility="public"
  1229. deprecated="not deprecated">
  1230. <doc>
  1231. <![CDATA[Returns the datanode from which the stream is currently reading.]]>
  1232. </doc>
  1233. </method>
  1234. <method name="getCurrentBlock" return="org.apache.hadoop.hdfs.protocol.Block"
  1235. abstract="false" native="false" synchronized="false"
  1236. static="false" final="false" visibility="public"
  1237. deprecated="not deprecated">
  1238. <doc>
  1239. <![CDATA[Returns the block containing the target position.]]>
  1240. </doc>
  1241. </method>
  1242. <method name="getVisibleLength" return="long"
  1243. abstract="false" native="false" synchronized="false"
  1244. static="false" final="false" visibility="public"
  1245. deprecated="not deprecated">
  1246. <exception name="IOException" type="java.io.IOException"/>
  1247. <doc>
  1248. <![CDATA[@return The visible length of the file.]]>
  1249. </doc>
  1250. </method>
  1251. <doc>
  1252. <![CDATA[The Hdfs implementation of {@link FSDataInputStream}]]>
  1253. </doc>
  1254. </class>
  1255. <!-- end class org.apache.hadoop.hdfs.DFSClient.DFSDataInputStream -->
  1256. <!-- start class org.apache.hadoop.hdfs.DFSConfigKeys -->
  1257. <class name="DFSConfigKeys" extends="org.apache.hadoop.fs.CommonConfigurationKeys"
  1258. abstract="false"
  1259. static="false" final="false" visibility="public"
  1260. deprecated="not deprecated">
  1261. <constructor name="DFSConfigKeys"
  1262. static="false" final="false" visibility="public"
  1263. deprecated="not deprecated">
  1264. </constructor>
  1265. <field name="DFS_BLOCK_SIZE_KEY" type="java.lang.String"
  1266. transient="false" volatile="false"
  1267. static="true" final="true" visibility="public"
  1268. deprecated="not deprecated">
  1269. </field>
  1270. <field name="DFS_BLOCK_SIZE_DEFAULT" type="long"
  1271. transient="false" volatile="false"
  1272. static="true" final="true" visibility="public"
  1273. deprecated="not deprecated">
  1274. </field>
  1275. <field name="DFS_REPLICATION_KEY" type="java.lang.String"
  1276. transient="false" volatile="false"
  1277. static="true" final="true" visibility="public"
  1278. deprecated="not deprecated">
  1279. </field>
  1280. <field name="DFS_REPLICATION_DEFAULT" type="short"
  1281. transient="false" volatile="false"
  1282. static="true" final="true" visibility="public"
  1283. deprecated="not deprecated">
  1284. </field>
  1285. <field name="DFS_STREAM_BUFFER_SIZE_KEY" type="java.lang.String"
  1286. transient="false" volatile="false"
  1287. static="true" final="true" visibility="public"
  1288. deprecated="not deprecated">
  1289. </field>
  1290. <field name="DFS_STREAM_BUFFER_SIZE_DEFAULT" type="int"
  1291. transient="false" volatile="false"
  1292. static="true" final="true" visibility="public"
  1293. deprecated="not deprecated">
  1294. </field>
  1295. <field name="DFS_BYTES_PER_CHECKSUM_KEY" type="java.lang.String"
  1296. transient="false" volatile="false"
  1297. static="true" final="true" visibility="public"
  1298. deprecated="not deprecated">
  1299. </field>
  1300. <field name="DFS_BYTES_PER_CHECKSUM_DEFAULT" type="int"
  1301. transient="false" volatile="false"
  1302. static="true" final="true" visibility="public"
  1303. deprecated="not deprecated">
  1304. </field>
  1305. <field name="DFS_CLIENT_WRITE_PACKET_SIZE_KEY" type="java.lang.String"
  1306. transient="false" volatile="false"
  1307. static="true" final="true" visibility="public"
  1308. deprecated="not deprecated">
  1309. </field>
  1310. <field name="DFS_CLIENT_WRITE_PACKET_SIZE_DEFAULT" type="int"
  1311. transient="false" volatile="false"
  1312. static="true" final="true" visibility="public"
  1313. deprecated="not deprecated">
  1314. </field>
  1315. <field name="DFS_NAMENODE_BACKUP_ADDRESS_KEY" type="java.lang.String"
  1316. transient="false" volatile="false"
  1317. static="true" final="true" visibility="public"
  1318. deprecated="not deprecated">
  1319. </field>
  1320. <field name="DFS_NAMENODE_BACKUP_ADDRESS_DEFAULT" type="java.lang.String"
  1321. transient="false" volatile="false"
  1322. static="true" final="true" visibility="public"
  1323. deprecated="not deprecated">
  1324. </field>
  1325. <field name="DFS_NAMENODE_BACKUP_HTTP_ADDRESS_KEY" type="java.lang.String"
  1326. transient="false" volatile="false"
  1327. static="true" final="true" visibility="public"
  1328. deprecated="not deprecated">
  1329. </field>
  1330. <field name="DFS_NAMENODE_BACKUP_HTTP_ADDRESS_DEFAULT" type="java.lang.String"
  1331. transient="false" volatile="false"
  1332. static="true" final="true" visibility="public"
  1333. deprecated="not deprecated">
  1334. </field>
  1335. <field name="DFS_DATANODE_BALANCE_BANDWIDTHPERSEC_KEY" type="java.lang.String"
  1336. transient="false" volatile="false"
  1337. static="true" final="true" visibility="public"
  1338. deprecated="not deprecated">
  1339. </field>
  1340. <field name="DFS_DATANODE_BALANCE_BANDWIDTHPERSEC_DEFAULT" type="long"
  1341. transient="false" volatile="false"
  1342. static="true" final="true" visibility="public"
  1343. deprecated="not deprecated">
  1344. </field>
  1345. <field name="DFS_NAMENODE_HTTP_ADDRESS_KEY" type="java.lang.String"
  1346. transient="false" volatile="false"
  1347. static="true" final="true" visibility="public"
  1348. deprecated="not deprecated">
  1349. </field>
  1350. <field name="DFS_NAMENODE_HTTP_ADDRESS_DEFAULT" type="java.lang.String"
  1351. transient="false" volatile="false"
  1352. static="true" final="true" visibility="public"
  1353. deprecated="not deprecated">
  1354. </field>
  1355. <field name="DFS_NAMENODE_MAX_OBJECTS_KEY" type="java.lang.String"
  1356. transient="false" volatile="false"
  1357. static="true" final="true" visibility="public"
  1358. deprecated="not deprecated">
  1359. </field>
  1360. <field name="DFS_NAMENODE_MAX_OBJECTS_DEFAULT" type="long"
  1361. transient="false" volatile="false"
  1362. static="true" final="true" visibility="public"
  1363. deprecated="not deprecated">
  1364. </field>
  1365. <field name="DFS_NAMENODE_SAFEMODE_EXTENSION_KEY" type="java.lang.String"
  1366. transient="false" volatile="false"
  1367. static="true" final="true" visibility="public"
  1368. deprecated="not deprecated">
  1369. </field>
  1370. <field name="DFS_NAMENODE_SAFEMODE_EXTENSION_DEFAULT" type="int"
  1371. transient="false" volatile="false"
  1372. static="true" final="true" visibility="public"
  1373. deprecated="not deprecated">
  1374. </field>
  1375. <field name="DFS_NAMENODE_SAFEMODE_THRESHOLD_PCT_KEY" type="java.lang.String"
  1376. transient="false" volatile="false"
  1377. static="true" final="true" visibility="public"
  1378. deprecated="not deprecated">
  1379. </field>
  1380. <field name="DFS_NAMENODE_SAFEMODE_THRESHOLD_PCT_DEFAULT" type="float"
  1381. transient="false" volatile="false"
  1382. static="true" final="true" visibility="public"
  1383. deprecated="not deprecated">
  1384. </field>
  1385. <field name="DFS_NAMENODE_SECONDARY_HTTP_ADDRESS_KEY" type="java.lang.String"
  1386. transient="false" volatile="false"
  1387. static="true" final="true" visibility="public"
  1388. deprecated="not deprecated">
  1389. </field>
  1390. <field name="DFS_NAMENODE_SECONDARY_HTTP_ADDRESS_DEFAULT" type="java.lang.String"
  1391. transient="false" volatile="false"
  1392. static="true" final="true" visibility="public"
  1393. deprecated="not deprecated">
  1394. </field>
  1395. <field name="DFS_NAMENODE_CHECKPOINT_PERIOD_KEY" type="java.lang.String"
  1396. transient="false" volatile="false"
  1397. static="true" final="true" visibility="public"
  1398. deprecated="not deprecated">
  1399. </field>
  1400. <field name="DFS_NAMENODE_CHECKPOINT_PERIOD_DEFAULT" type="long"
  1401. transient="false" volatile="false"
  1402. static="true" final="true" visibility="public"
  1403. deprecated="not deprecated">
  1404. </field>
  1405. <field name="DFS_NAMENODE_CHECKPOINT_SIZE_KEY" type="java.lang.String"
  1406. transient="false" volatile="false"
  1407. static="true" final="true" visibility="public"
  1408. deprecated="not deprecated">
  1409. </field>
  1410. <field name="DFS_NAMENODE_CHECKPOINT_SIZE_DEFAULT" type="long"
  1411. transient="false" volatile="false"
  1412. static="true" final="true" visibility="public"
  1413. deprecated="not deprecated">
  1414. </field>
  1415. <field name="DFS_NAMENODE_UPGRADE_PERMISSION_KEY" type="java.lang.String"
  1416. transient="false" volatile="false"
  1417. static="true" final="true" visibility="public"
  1418. deprecated="not deprecated">
  1419. </field>
  1420. <field name="DFS_NAMENODE_UPGRADE_PERMISSION_DEFAULT" type="int"
  1421. transient="false" volatile="false"
  1422. static="true" final="true" visibility="public"
  1423. deprecated="not deprecated">
  1424. </field>
  1425. <field name="DFS_NAMENODE_HEARTBEAT_RECHECK_INTERVAL_KEY" type="java.lang.String"
  1426. transient="false" volatile="false"
  1427. static="true" final="true" visibility="public"
  1428. deprecated="not deprecated">
  1429. </field>
  1430. <field name="DFS_NAMENODE_HEARTBEAT_RECHECK_INTERVAL_DEFAULT" type="int"
  1431. transient="false" volatile="false"
  1432. static="true" final="true" visibility="public"
  1433. deprecated="not deprecated">
  1434. </field>
  1435. <field name="DFS_CLIENT_HTTPS_KEYSTORE_RESOURCE_KEY" type="java.lang.String"
  1436. transient="false" volatile="false"
  1437. static="true" final="true" visibility="public"
  1438. deprecated="not deprecated">
  1439. </field>
  1440. <field name="DFS_CLIENT_HTTPS_KEYSTORE_RESOURCE_DEFAULT" type="java.lang.String"
  1441. transient="false" volatile="false"
  1442. static="true" final="true" visibility="public"
  1443. deprecated="not deprecated">
  1444. </field>
  1445. <field name="DFS_CLIENT_HTTPS_NEED_AUTH_KEY" type="java.lang.String"
  1446. transient="false" volatile="false"
  1447. static="true" final="true" visibility="public"
  1448. deprecated="not deprecated">
  1449. </field>
  1450. <field name="DFS_CLIENT_HTTPS_NEED_AUTH_DEFAULT" type="boolean"
  1451. transient="false" volatile="false"
  1452. static="true" final="true" visibility="public"
  1453. deprecated="not deprecated">
  1454. </field>
  1455. <field name="DFS_NAMENODE_ACCESSTIME_PRECISION_KEY" type="java.lang.String"
  1456. transient="false" volatile="false"
  1457. static="true" final="true" visibility="public"
  1458. deprecated="not deprecated">
  1459. </field>
  1460. <field name="DFS_NAMENODE_ACCESSTIME_PRECISION_DEFAULT" type="long"
  1461. transient="false" volatile="false"
  1462. static="true" final="true" visibility="public"
  1463. deprecated="not deprecated">
  1464. </field>
  1465. <field name="DFS_NAMENODE_REPLICATION_CONSIDERLOAD_KEY" type="java.lang.String"
  1466. transient="false" volatile="false"
  1467. static="true" final="true" visibility="public"
  1468. deprecated="not deprecated">
  1469. </field>
  1470. <field name="DFS_NAMENODE_REPLICATION_CONSIDERLOAD_DEFAULT" type="boolean"
  1471. transient="false" volatile="false"
  1472. static="true" final="true" visibility="public"
  1473. deprecated="not deprecated">
  1474. </field>
  1475. <field name="DFS_NAMENODE_REPLICATION_INTERVAL_KEY" type="java.lang.String"
  1476. transient="false" volatile="false"
  1477. static="true" final="true" visibility="public"
  1478. deprecated="not deprecated">
  1479. </field>
  1480. <field name="DFS_NAMENODE_REPLICATION_INTERVAL_DEFAULT" type="int"
  1481. transient="false" volatile="false"
  1482. static="true" final="true" visibility="public"
  1483. deprecated="not deprecated">
  1484. </field>
  1485. <field name="DFS_NAMENODE_REPLICATION_MIN_KEY" type="java.lang.String"
  1486. transient="false" volatile="false"
  1487. static="true" final="true" visibility="public"
  1488. deprecated="not deprecated">
  1489. </field>
  1490. <field name="DFS_NAMENODE_REPLICATION_MIN_DEFAULT" type="int"
  1491. transient="false" volatile="false"
  1492. static="true" final="true" visibility="public"
  1493. deprecated="not deprecated">
  1494. </field>
  1495. <field name="DFS_NAMENODE_REPLICATION_PENDING_TIMEOUT_SEC_KEY" type="java.lang.String"
  1496. transient="false" volatile="false"
  1497. static="true" final="true" visibility="public"
  1498. deprecated="not deprecated">
  1499. </field>
  1500. <field name="DFS_NAMENODE_REPLICATION_PENDING_TIMEOUT_SEC_DEFAULT" type="int"
  1501. transient="false" volatile="false"
  1502. static="true" final="true" visibility="public"
  1503. deprecated="not deprecated">
  1504. </field>
  1505. <field name="DFS_NAMENODE_REPLICATION_MAX_STREAMS_KEY" type="java.lang.String"
  1506. transient="false" volatile="false"
  1507. static="true" final="true" visibility="public"
  1508. deprecated="not deprecated">
  1509. </field>
  1510. <field name="DFS_NAMENODE_REPLICATION_MAX_STREAMS_DEFAULT" type="int"
  1511. transient="false" volatile="false"
  1512. static="true" final="true" visibility="public"
  1513. deprecated="not deprecated">
  1514. </field>
  1515. <field name="DFS_PERMISSIONS_ENABLED_KEY" type="java.lang.String"
  1516. transient="false" volatile="false"
  1517. static="true" final="true" visibility="public"
  1518. deprecated="not deprecated">
  1519. </field>
  1520. <field name="DFS_PERMISSIONS_ENABLED_DEFAULT" type="boolean"
  1521. transient="false" volatile="false"
  1522. static="true" final="true" visibility="public"
  1523. deprecated="not deprecated">
  1524. </field>
  1525. <field name="DFS_PERMISSIONS_SUPERUSERGROUP_KEY" type="java.lang.String"
  1526. transient="false" volatile="false"
  1527. static="true" final="true" visibility="public"
  1528. deprecated="not deprecated">
  1529. </field>
  1530. <field name="DFS_PERMISSIONS_SUPERUSERGROUP_DEFAULT" type="java.lang.String"
  1531. transient="false" volatile="false"
  1532. static="true" final="true" visibility="public"
  1533. deprecated="not deprecated">
  1534. </field>
  1535. <field name="DFS_SERVER_HTTPS_KEYSTORE_RESOURCE_KEY" type="java.lang.String"
  1536. transient="false" volatile="false"
  1537. static="true" final="true" visibility="public"
  1538. deprecated="not deprecated">
  1539. </field>
  1540. <field name="DFS_SERVER_HTTPS_KEYSTORE_RESOURCE_DEFAULT" type="java.lang.String"
  1541. transient="false" volatile="false"
  1542. static="true" final="true" visibility="public"
  1543. deprecated="not deprecated">
  1544. </field>
  1545. <field name="DFS_NAMENODE_NAME_DIR_RESTORE_KEY" type="java.lang.String"
  1546. transient="false" volatile="false"
  1547. static="true" final="true" visibility="public"
  1548. deprecated="not deprecated">
  1549. </field>
  1550. <field name="DFS_NAMENODE_NAME_DIR_RESTORE_DEFAULT" type="boolean"
  1551. transient="false" volatile="false"
  1552. static="true" final="true" visibility="public"
  1553. deprecated="not deprecated">
  1554. </field>
  1555. <field name="DFS_LIST_LIMIT" type="java.lang.String"
  1556. transient="false" volatile="false"
  1557. static="true" final="true" visibility="public"
  1558. deprecated="not deprecated">
  1559. </field>
  1560. <field name="DFS_LIST_LIMIT_DEFAULT" type="int"
  1561. transient="false" volatile="false"
  1562. static="true" final="true" visibility="public"
  1563. deprecated="not deprecated">
  1564. </field>
  1565. <field name="DFS_DATANODE_FAILED_VOLUMES_TOLERATED_KEY" type="java.lang.String"
  1566. transient="false" volatile="false"
  1567. static="true" final="true" visibility="public"
  1568. deprecated="not deprecated">
  1569. </field>
  1570. <field name="DFS_DATANODE_FAILED_VOLUMES_TOLERATED_DEFAULT" type="int"
  1571. transient="false" volatile="false"
  1572. static="true" final="true" visibility="public"
  1573. deprecated="not deprecated">
  1574. </field>
  1575. <field name="DFS_NAMENODE_DELEGATION_KEY_UPDATE_INTERVAL_KEY" type="java.lang.String"
  1576. transient="false" volatile="false"
  1577. static="true" final="true" visibility="public"
  1578. deprecated="not deprecated">
  1579. </field>
  1580. <field name="DFS_NAMENODE_DELEGATION_KEY_UPDATE_INTERVAL_DEFAULT" type="long"
  1581. transient="false" volatile="false"
  1582. static="true" final="true" visibility="public"
  1583. deprecated="not deprecated">
  1584. </field>
  1585. <field name="DFS_NAMENODE_DELEGATION_TOKEN_RENEW_INTERVAL_KEY" type="java.lang.String"
  1586. transient="false" volatile="false"
  1587. static="true" final="true" visibility="public"
  1588. deprecated="not deprecated">
  1589. </field>
  1590. <field name="DFS_NAMENODE_DELEGATION_TOKEN_RENEW_INTERVAL_DEFAULT" type="long"
  1591. transient="false" volatile="false"
  1592. static="true" final="true" visibility="public"
  1593. deprecated="not deprecated">
  1594. </field>
  1595. <field name="DFS_NAMENODE_DELEGATION_TOKEN_MAX_LIFETIME_KEY" type="java.lang.String"
  1596. transient="false" volatile="false"
  1597. static="true" final="true" visibility="public"
  1598. deprecated="not deprecated">
  1599. </field>
  1600. <field name="DFS_NAMENODE_DELEGATION_TOKEN_MAX_LIFETIME_DEFAULT" type="long"
  1601. transient="false" volatile="false"
  1602. static="true" final="true" visibility="public"
  1603. deprecated="not deprecated">
  1604. </field>
  1605. <field name="DFS_DATANODE_DATA_DIR_KEY" type="java.lang.String"
  1606. transient="false" volatile="false"
  1607. static="true" final="true" visibility="public"
  1608. deprecated="not deprecated">
  1609. </field>
  1610. <field name="DFS_NAMENODE_HTTPS_ADDRESS_KEY" type="java.lang.String"
  1611. transient="false" volatile="false"
  1612. static="true" final="true" visibility="public"
  1613. deprecated="not deprecated">
  1614. </field>
  1615. <field name="DFS_NAMENODE_HTTPS_ADDRESS_DEFAULT" type="java.lang.String"
  1616. transient="false" volatile="false"
  1617. static="true" final="true" visibility="public"
  1618. deprecated="not deprecated">
  1619. </field>
  1620. <field name="DFS_NAMENODE_NAME_DIR_KEY" type="java.lang.String"
  1621. transient="false" volatile="false"
  1622. static="true" final="true" visibility="public"
  1623. deprecated="not deprecated">
  1624. </field>
  1625. <field name="DFS_NAMENODE_EDITS_DIR_KEY" type="java.lang.String"
  1626. transient="false" volatile="false"
  1627. static="true" final="true" visibility="public"
  1628. deprecated="not deprecated">
  1629. </field>
  1630. <field name="DFS_CLIENT_READ_PREFETCH_SIZE_KEY" type="java.lang.String"
  1631. transient="false" volatile="false"
  1632. static="true" final="true" visibility="public"
  1633. deprecated="not deprecated">
  1634. </field>
  1635. <field name="DFS_CLIENT_RETRY_WINDOW_BASE" type="java.lang.String"
  1636. transient="false" volatile="false"
  1637. static="true" final="true" visibility="public"
  1638. deprecated="not deprecated">
  1639. </field>
  1640. <field name="DFS_METRICS_SESSION_ID_KEY" type="java.lang.String"
  1641. transient="false" volatile="false"
  1642. static="true" final="true" visibility="public"
  1643. deprecated="not deprecated">
  1644. </field>
  1645. <field name="DFS_DATANODE_HOST_NAME_KEY" type="java.lang.String"
  1646. transient="false" volatile="false"
  1647. static="true" final="true" visibility="public"
  1648. deprecated="not deprecated">
  1649. </field>
  1650. <field name="DFS_DATANODE_STORAGEID_KEY" type="java.lang.String"
  1651. transient="false" volatile="false"
  1652. static="true" final="true" visibility="public"
  1653. deprecated="not deprecated">
  1654. </field>
  1655. <field name="DFS_NAMENODE_HOSTS_KEY" type="java.lang.String"
  1656. transient="false" volatile="false"
  1657. static="true" final="true" visibility="public"
  1658. deprecated="not deprecated">
  1659. </field>
  1660. <field name="DFS_NAMENODE_HOSTS_EXCLUDE_KEY" type="java.lang.String"
  1661. transient="false" volatile="false"
  1662. static="true" final="true" visibility="public"
  1663. deprecated="not deprecated">
  1664. </field>
  1665. <field name="DFS_CLIENT_SOCKET_TIMEOUT_KEY" type="java.lang.String"
  1666. transient="false" volatile="false"
  1667. static="true" final="true" visibility="public"
  1668. deprecated="not deprecated">
  1669. </field>
  1670. <field name="DFS_NAMENODE_CHECKPOINT_DIR_KEY" type="java.lang.String"
  1671. transient="false" volatile="false"
  1672. static="true" final="true" visibility="public"
  1673. deprecated="not deprecated">
  1674. </field>
  1675. <field name="DFS_NAMENODE_CHECKPOINT_EDITS_DIR_KEY" type="java.lang.String"
  1676. transient="false" volatile="false"
  1677. static="true" final="true" visibility="public"
  1678. deprecated="not deprecated">
  1679. </field>
  1680. <field name="DFS_CLIENT_BLOCK_WRITE_LOCATEFOLLOWINGBLOCK_RETRIES_KEY" type="java.lang.String"
  1681. transient="false" volatile="false"
  1682. static="true" final="true" visibility="public"
  1683. deprecated="not deprecated">
  1684. </field>
  1685. <field name="DFS_CLIENT_BLOCK_WRITE_LOCATEFOLLOWINGBLOCK_RETRIES_DEFAULT" type="int"
  1686. transient="false" volatile="false"
  1687. static="true" final="true" visibility="public"
  1688. deprecated="not deprecated">
  1689. </field>
  1690. <field name="DFS_CLIENT_BLOCK_WRITE_RETRIES_KEY" type="java.lang.String"
  1691. transient="false" volatile="false"
  1692. static="true" final="true" visibility="public"
  1693. deprecated="not deprecated">
  1694. </field>
  1695. <field name="DFS_CLIENT_BLOCK_WRITE_RETRIES_DEFAULT" type="int"
  1696. transient="false" volatile="false"
  1697. static="true" final="true" visibility="public"
  1698. deprecated="not deprecated">
  1699. </field>
  1700. <field name="DFS_CLIENT_MAX_BLOCK_ACQUIRE_FAILURES_KEY" type="java.lang.String"
  1701. transient="false" volatile="false"
  1702. static="true" final="true" visibility="public"
  1703. deprecated="not deprecated">
  1704. </field>
  1705. <field name="DFS_CLIENT_MAX_BLOCK_ACQUIRE_FAILURES_DEFAULT" type="int"
  1706. transient="false" volatile="false"
  1707. static="true" final="true" visibility="public"
  1708. deprecated="not deprecated">
  1709. </field>
  1710. <field name="DFS_BALANCER_MOVEDWINWIDTH_KEY" type="java.lang.String"
  1711. transient="false" volatile="false"
  1712. static="true" final="true" visibility="public"
  1713. deprecated="not deprecated">
  1714. </field>
  1715. <field name="DFS_BALANCER_MOVEDWINWIDTH_DEFAULT" type="int"
  1716. transient="false" volatile="false"
  1717. static="true" final="true" visibility="public"
  1718. deprecated="not deprecated">
  1719. </field>
  1720. <field name="DFS_DATANODE_ADDRESS_KEY" type="java.lang.String"
  1721. transient="false" volatile="false"
  1722. static="true" final="true" visibility="public"
  1723. deprecated="not deprecated">
  1724. </field>
  1725. <field name="DFS_DATANODE_ADDRESS_DEFAULT" type="java.lang.String"
  1726. transient="false" volatile="false"
  1727. static="true" final="true" visibility="public"
  1728. deprecated="not deprecated">
  1729. </field>
  1730. <field name="DFS_DATANODE_DATA_DIR_PERMISSION_KEY" type="java.lang.String"
  1731. transient="false" volatile="false"
  1732. static="true" final="true" visibility="public"
  1733. deprecated="not deprecated">
  1734. </field>
  1735. <field name="DFS_DATANODE_DATA_DIR_PERMISSION_DEFAULT" type="java.lang.String"
  1736. transient="false" volatile="false"
  1737. static="true" final="true" visibility="public"
  1738. deprecated="not deprecated">
  1739. </field>
  1740. <field name="DFS_DATANODE_DIRECTORYSCAN_INTERVAL_KEY" type="java.lang.String"
  1741. transient="false" volatile="false"
  1742. static="true" final="true" visibility="public"
  1743. deprecated="not deprecated">
  1744. </field>
  1745. <field name="DFS_DATANODE_DIRECTORYSCAN_INTERVAL_DEFAULT" type="int"
  1746. transient="false" volatile="false"
  1747. static="true" final="true" visibility="public"
  1748. deprecated="not deprecated">
  1749. </field>
  1750. <field name="DFS_DATANODE_DIRECTORYSCAN_THREADS_KEY" type="java.lang.String"
  1751. transient="false" volatile="false"
  1752. static="true" final="true" visibility="public"
  1753. deprecated="not deprecated">
  1754. </field>
  1755. <field name="DFS_DATANODE_DIRECTORYSCAN_THREADS_DEFAULT" type="int"
  1756. transient="false" volatile="false"
  1757. static="true" final="true" visibility="public"
  1758. deprecated="not deprecated">
  1759. </field>
  1760. <field name="DFS_DATANODE_DNS_INTERFACE_KEY" type="java.lang.String"
  1761. transient="false" volatile="false"
  1762. static="true" final="true" visibility="public"
  1763. deprecated="not deprecated">
  1764. </field>
  1765. <field name="DFS_DATANODE_DNS_INTERFACE_DEFAULT" type="java.lang.String"
  1766. transient="false" volatile="false"
  1767. static="true" final="true" visibility="public"
  1768. deprecated="not deprecated">
  1769. </field>
  1770. <field name="DFS_DATANODE_DNS_NAMESERVER_KEY" type="java.lang.String"
  1771. transient="false" volatile="false"
  1772. static="true" final="true" visibility="public"
  1773. deprecated="not deprecated">
  1774. </field>
  1775. <field name="DFS_DATANODE_DNS_NAMESERVER_DEFAULT" type="java.lang.String"
  1776. transient="false" volatile="false"
  1777. static="true" final="true" visibility="public"
  1778. deprecated="not deprecated">
  1779. </field>
  1780. <field name="DFS_DATANODE_DU_RESERVED_KEY" type="java.lang.String"
  1781. transient="false" volatile="false"
  1782. static="true" final="true" visibility="public"
  1783. deprecated="not deprecated">
  1784. </field>
  1785. <field name="DFS_DATANODE_DU_RESERVED_DEFAULT" type="long"
  1786. transient="false" volatile="false"
  1787. static="true" final="true" visibility="public"
  1788. deprecated="not deprecated">
  1789. </field>
  1790. <field name="DFS_DATANODE_HANDLER_COUNT_KEY" type="java.lang.String"
  1791. transient="false" volatile="false"
  1792. static="true" final="true" visibility="public"
  1793. deprecated="not deprecated">
  1794. </field>
  1795. <field name="DFS_DATANODE_HANDLER_COUNT_DEFAULT" type="int"
  1796. transient="false" volatile="false"
  1797. static="true" final="true" visibility="public"
  1798. deprecated="not deprecated">
  1799. </field>
  1800. <field name="DFS_DATANODE_HTTP_ADDRESS_KEY" type="java.lang.String"
  1801. transient="false" volatile="false"
  1802. static="true" final="true" visibility="public"
  1803. deprecated="not deprecated">
  1804. </field>
  1805. <field name="DFS_DATANODE_HTTP_ADDRESS_DEFAULT" type="java.lang.String"
  1806. transient="false" volatile="false"
  1807. static="true" final="true" visibility="public"
  1808. deprecated="not deprecated">
  1809. </field>
  1810. <field name="DFS_DATANODE_MAX_XCIEVERS_KEY" type="java.lang.String"
  1811. transient="false" volatile="false"
  1812. static="true" final="true" visibility="public"
  1813. deprecated="not deprecated">
  1814. </field>
  1815. <field name="DFS_DATANODE_MAX_XCIEVERS_DEFAULT" type="int"
  1816. transient="false" volatile="false"
  1817. static="true" final="true" visibility="public"
  1818. deprecated="not deprecated">
  1819. </field>
  1820. <field name="DFS_DATANODE_NUMBLOCKS_KEY" type="java.lang.String"
  1821. transient="false" volatile="false"
  1822. static="true" final="true" visibility="public"
  1823. deprecated="not deprecated">
  1824. </field>
  1825. <field name="DFS_DATANODE_NUMBLOCKS_DEFAULT" type="int"
  1826. transient="false" volatile="false"
  1827. static="true" final="true" visibility="public"
  1828. deprecated="not deprecated">
  1829. </field>
  1830. <field name="DFS_DATANODE_SCAN_PERIOD_HOURS_KEY" type="java.lang.String"
  1831. transient="false" volatile="false"
  1832. static="true" final="true" visibility="public"
  1833. deprecated="not deprecated">
  1834. </field>
  1835. <field name="DFS_DATANODE_SCAN_PERIOD_HOURS_DEFAULT" type="int"
  1836. transient="false" volatile="false"
  1837. static="true" final="true" visibility="public"
  1838. deprecated="not deprecated">
  1839. </field>
  1840. <field name="DFS_DATANODE_SIMULATEDDATASTORAGE_KEY" type="java.lang.String"
  1841. transient="false" volatile="false"
  1842. static="true" final="true" visibility="public"
  1843. deprecated="not deprecated">
  1844. </field>
  1845. <field name="DFS_DATANODE_SIMULATEDDATASTORAGE_DEFAULT" type="boolean"
  1846. transient="false" volatile="false"
  1847. static="true" final="true" visibility="public"
  1848. deprecated="not deprecated">
  1849. </field>
  1850. <field name="DFS_DATANODE_SIMULATEDDATASTORAGE_CAPACITY_KEY" type="java.lang.String"
  1851. transient="false" volatile="false"
  1852. static="true" final="true" visibility="public"
  1853. deprecated="not deprecated">
  1854. </field>
  1855. <field name="DFS_DATANODE_SIMULATEDDATASTORAGE_CAPACITY_DEFAULT" type="long"
  1856. transient="false" volatile="false"
  1857. static="true" final="true" visibility="public"
  1858. deprecated="not deprecated">
  1859. </field>
  1860. <field name="DFS_DATANODE_TRANSFERTO_ALLOWED_KEY" type="java.lang.String"
  1861. transient="false" volatile="false"
  1862. static="true" final="true" visibility="public"
  1863. deprecated="not deprecated">
  1864. </field>
  1865. <field name="DFS_DATANODE_TRANSFERTO_ALLOWED_DEFAULT" type="boolean"
  1866. transient="false" volatile="false"
  1867. static="true" final="true" visibility="public"
  1868. deprecated="not deprecated">
  1869. </field>
  1870. <field name="DFS_HEARTBEAT_INTERVAL_KEY" type="java.lang.String"
  1871. transient="false" volatile="false"
  1872. static="true" final="true" visibility="public"
  1873. deprecated="not deprecated">
  1874. </field>
  1875. <field name="DFS_HEARTBEAT_INTERVAL_DEFAULT" type="long"
  1876. transient="false" volatile="false"
  1877. static="true" final="true" visibility="public"
  1878. deprecated="not deprecated">
  1879. </field>
  1880. <field name="DFS_NAMENODE_DECOMMISSION_INTERVAL_KEY" type="java.lang.String"
  1881. transient="false" volatile="false"
  1882. static="true" final="true" visibility="public"
  1883. deprecated="not deprecated">
  1884. </field>
  1885. <field name="DFS_NAMENODE_DECOMMISSION_INTERVAL_DEFAULT" type="int"
  1886. transient="false" volatile="false"
  1887. static="true" final="true" visibility="public"
  1888. deprecated="not deprecated">
  1889. </field>
  1890. <field name="DFS_NAMENODE_DECOMMISSION_NODES_PER_INTERVAL_KEY" type="java.lang.String"
  1891. transient="false" volatile="false"
  1892. static="true" final="true" visibility="public"
  1893. deprecated="not deprecated">
  1894. </field>
  1895. <field name="DFS_NAMENODE_DECOMMISSION_NODES_PER_INTERVAL_DEFAULT" type="int"
  1896. transient="false" volatile="false"
  1897. static="true" final="true" visibility="public"
  1898. deprecated="not deprecated">
  1899. </field>
  1900. <field name="DFS_NAMENODE_HANDLER_COUNT_KEY" type="java.lang.String"
  1901. transient="false" volatile="false"
  1902. static="true" final="true" visibility="public"
  1903. deprecated="not deprecated">
  1904. </field>
  1905. <field name="DFS_NAMENODE_HANDLER_COUNT_DEFAULT" type="int"
  1906. transient="false" volatile="false"
  1907. static="true" final="true" visibility="public"
  1908. deprecated="not deprecated">
  1909. </field>
  1910. <field name="DFS_SUPPORT_APPEND_KEY" type="java.lang.String"
  1911. transient="false" volatile="false"
  1912. static="true" final="true" visibility="public"
  1913. deprecated="not deprecated">
  1914. </field>
  1915. <field name="DFS_SUPPORT_APPEND_DEFAULT" type="boolean"
  1916. transient="false" volatile="false"
  1917. static="true" final="true" visibility="public"
  1918. deprecated="not deprecated">
  1919. </field>
  1920. <field name="DFS_HTTPS_ENABLE_KEY" type="java.lang.String"
  1921. transient="false" volatile="false"
  1922. static="true" final="true" visibility="public"
  1923. deprecated="not deprecated">
  1924. </field>
  1925. <field name="DFS_HTTPS_ENABLE_DEFAULT" type="boolean"
  1926. transient="false" volatile="false"
  1927. static="true" final="true" visibility="public"
  1928. deprecated="not deprecated">
  1929. </field>
  1930. <field name="DFS_DEFAULT_CHUNK_VIEW_SIZE_KEY" type="java.lang.String"
  1931. transient="false" volatile="false"
  1932. static="true" final="true" visibility="public"
  1933. deprecated="not deprecated">
  1934. </field>
  1935. <field name="DFS_DEFAULT_CHUNK_VIEW_SIZE_DEFAULT" type="int"
  1936. transient="false" volatile="false"
  1937. static="true" final="true" visibility="public"
  1938. deprecated="not deprecated">
  1939. </field>
  1940. <field name="DFS_DATANODE_HTTPS_ADDRESS_KEY" type="java.lang.String"
  1941. transient="false" volatile="false"
  1942. static="true" final="true" visibility="public"
  1943. deprecated="not deprecated">
  1944. </field>
  1945. <field name="DFS_DATANODE_HTTPS_ADDRESS_DEFAULT" type="java.lang.String"
  1946. transient="false" volatile="false"
  1947. static="true" final="true" visibility="public"
  1948. deprecated="not deprecated">
  1949. </field>
  1950. <field name="DFS_DATANODE_IPC_ADDRESS_KEY" type="java.lang.String"
  1951. transient="false" volatile="false"
  1952. static="true" final="true" visibility="public"
  1953. deprecated="not deprecated">
  1954. </field>
  1955. <field name="DFS_DATANODE_IPC_ADDRESS_DEFAULT" type="java.lang.String"
  1956. transient="false" volatile="false"
  1957. static="true" final="true" visibility="public"
  1958. deprecated="not deprecated">
  1959. </field>
  1960. <field name="DFS_BLOCK_ACCESS_TOKEN_ENABLE_KEY" type="java.lang.String"
  1961. transient="false" volatile="false"
  1962. static="true" final="true" visibility="public"
  1963. deprecated="not deprecated">
  1964. </field>
  1965. <field name="DFS_BLOCK_ACCESS_TOKEN_ENABLE_DEFAULT" type="boolean"
  1966. transient="false" volatile="false"
  1967. static="true" final="true" visibility="public"
  1968. deprecated="not deprecated">
  1969. </field>
  1970. <field name="DFS_BLOCK_ACCESS_KEY_UPDATE_INTERVAL_KEY" type="java.lang.String"
  1971. transient="false" volatile="false"
  1972. static="true" final="true" visibility="public"
  1973. deprecated="not deprecated">
  1974. </field>
  1975. <field name="DFS_BLOCK_ACCESS_KEY_UPDATE_INTERVAL_DEFAULT" type="long"
  1976. transient="false" volatile="false"
  1977. static="true" final="true" visibility="public"
  1978. deprecated="not deprecated">
  1979. </field>
  1980. <field name="DFS_BLOCK_ACCESS_TOKEN_LIFETIME_KEY" type="java.lang.String"
  1981. transient="false" volatile="false"
  1982. static="true" final="true" visibility="public"
  1983. deprecated="not deprecated">
  1984. </field>
  1985. <field name="DFS_BLOCK_ACCESS_TOKEN_LIFETIME_DEFAULT" type="long"
  1986. transient="false" volatile="false"
  1987. static="true" final="true" visibility="public"
  1988. deprecated="not deprecated">
  1989. </field>
  1990. <field name="DFS_REPLICATION_MAX_KEY" type="java.lang.String"
  1991. transient="false" volatile="false"
  1992. static="true" final="true" visibility="public"
  1993. deprecated="not deprecated">
  1994. </field>
  1995. <field name="DFS_REPLICATION_MAX_DEFAULT" type="int"
  1996. transient="false" volatile="false"
  1997. static="true" final="true" visibility="public"
  1998. deprecated="not deprecated">
  1999. </field>
  2000. <field name="DFS_DF_INTERVAL_KEY" type="java.lang.String"
  2001. transient="false" volatile="false"
  2002. static="true" final="true" visibility="public"
  2003. deprecated="not deprecated">
  2004. </field>
  2005. <field name="DFS_DF_INTERVAL_DEFAULT" type="int"
  2006. transient="false" volatile="false"
  2007. static="true" final="true" visibility="public"
  2008. deprecated="not deprecated">
  2009. </field>
  2010. <field name="DFS_BLOCKREPORT_INTERVAL_MSEC_KEY" type="java.lang.String"
  2011. transient="false" volatile="false"
  2012. static="true" final="true" visibility="public"
  2013. deprecated="not deprecated">
  2014. </field>
  2015. <field name="DFS_BLOCKREPORT_INTERVAL_MSEC_DEFAULT" type="long"
  2016. transient="false" volatile="false"
  2017. static="true" final="true" visibility="public"
  2018. deprecated="not deprecated">
  2019. </field>
  2020. <field name="DFS_BLOCKREPORT_INITIAL_DELAY_KEY" type="java.lang.String"
  2021. transient="false" volatile="false"
  2022. static="true" final="true" visibility="public"
  2023. deprecated="not deprecated">
  2024. </field>
  2025. <field name="DFS_BLOCKREPORT_INITIAL_DELAY_DEFAULT" type="int"
  2026. transient="false" volatile="false"
  2027. static="true" final="true" visibility="public"
  2028. deprecated="not deprecated">
  2029. </field>
  2030. <field name="DFS_DATANODE_PLUGINS_KEY" type="java.lang.String"
  2031. transient="false" volatile="false"
  2032. static="true" final="true" visibility="public"
  2033. deprecated="not deprecated">
  2034. </field>
  2035. <field name="DFS_DATANODE_SOCKET_WRITE_TIMEOUT_KEY" type="java.lang.String"
  2036. transient="false" volatile="false"
  2037. static="true" final="true" visibility="public"
  2038. deprecated="not deprecated">
  2039. </field>
  2040. <field name="DFS_DATANODE_STARTUP_KEY" type="java.lang.String"
  2041. transient="false" volatile="false"
  2042. static="true" final="true" visibility="public"
  2043. deprecated="not deprecated">
  2044. </field>
  2045. <field name="DFS_NAMENODE_PLUGINS_KEY" type="java.lang.String"
  2046. transient="false" volatile="false"
  2047. static="true" final="true" visibility="public"
  2048. deprecated="not deprecated">
  2049. </field>
  2050. <field name="DFS_WEB_UGI_KEY" type="java.lang.String"
  2051. transient="false" volatile="false"
  2052. static="true" final="true" visibility="public"
  2053. deprecated="not deprecated">
  2054. </field>
  2055. <field name="DFS_NAMENODE_STARTUP_KEY" type="java.lang.String"
  2056. transient="false" volatile="false"
  2057. static="true" final="true" visibility="public"
  2058. deprecated="not deprecated">
  2059. </field>
  2060. <field name="DFS_DATANODE_KEYTAB_FILE_KEY" type="java.lang.String"
  2061. transient="false" volatile="false"
  2062. static="true" final="true" visibility="public"
  2063. deprecated="not deprecated">
  2064. </field>
  2065. <field name="DFS_DATANODE_USER_NAME_KEY" type="java.lang.String"
  2066. transient="false" volatile="false"
  2067. static="true" final="true" visibility="public"
  2068. deprecated="not deprecated">
  2069. </field>
  2070. <field name="DFS_NAMENODE_KEYTAB_FILE_KEY" type="java.lang.String"
  2071. transient="false" volatile="false"
  2072. static="true" final="true" visibility="public"
  2073. deprecated="not deprecated">
  2074. </field>
  2075. <field name="DFS_NAMENODE_USER_NAME_KEY" type="java.lang.String"
  2076. transient="false" volatile="false"
  2077. static="true" final="true" visibility="public"
  2078. deprecated="not deprecated">
  2079. </field>
  2080. <doc>
  2081. <![CDATA[This class contains constants for configuration keys used
  2082. in hdfs.]]>
  2083. </doc>
  2084. </class>
  2085. <!-- end class org.apache.hadoop.hdfs.DFSConfigKeys -->
  2086. <!-- start class org.apache.hadoop.hdfs.DFSUtil -->
  2087. <class name="DFSUtil" extends="java.lang.Object"
  2088. abstract="false"
  2089. static="false" final="false" visibility="public"
  2090. deprecated="not deprecated">
  2091. <constructor name="DFSUtil"
  2092. static="false" final="false" visibility="public"
  2093. deprecated="not deprecated">
  2094. </constructor>
  2095. <method name="isValidName" return="boolean"
  2096. abstract="false" native="false" synchronized="false"
  2097. static="true" final="false" visibility="public"
  2098. deprecated="not deprecated">
  2099. <param name="src" type="java.lang.String"/>
  2100. <doc>
  2101. <![CDATA[Whether the pathname is valid. Currently prohibits relative paths,
  2102. and names which contain a ":" or "/"]]>
  2103. </doc>
  2104. </method>
  2105. <method name="login"
  2106. abstract="false" native="false" synchronized="false"
  2107. static="true" final="false" visibility="public"
  2108. deprecated="not deprecated">
  2109. <param name="conf" type="org.apache.hadoop.conf.Configuration"/>
  2110. <param name="keytabFileKey" type="java.lang.String"/>
  2111. <param name="userNameKey" type="java.lang.String"/>
  2112. <exception name="IOException" type="java.io.IOException"/>
  2113. <doc>
  2114. <![CDATA[If a keytab has been provided, login as that user.]]>
  2115. </doc>
  2116. </method>
  2117. <method name="bytes2String" return="java.lang.String"
  2118. abstract="false" native="false" synchronized="false"
  2119. static="true" final="false" visibility="public"
  2120. deprecated="not deprecated">
  2121. <param name="bytes" type="byte[]"/>
  2122. <doc>
  2123. <![CDATA[Converts a byte array to a string using UTF8 encoding.]]>
  2124. </doc>
  2125. </method>
  2126. <method name="string2Bytes" return="byte[]"
  2127. abstract="false" native="false" synchronized="false"
  2128. static="true" final="false" visibility="public"
  2129. deprecated="not deprecated">
  2130. <param name="str" type="java.lang.String"/>
  2131. <doc>
  2132. <![CDATA[Converts a string to a byte array using UTF8 encoding.]]>
  2133. </doc>
  2134. </method>
  2135. </class>
  2136. <!-- end class org.apache.hadoop.hdfs.DFSUtil -->
  2137. <!-- start class org.apache.hadoop.hdfs.DFSUtil.ErrorSimulator -->
  2138. <class name="DFSUtil.ErrorSimulator" extends="java.lang.Object"
  2139. abstract="false"
  2140. static="true" final="false" visibility="public"
  2141. deprecated="not deprecated">
  2142. <constructor name="DFSUtil.ErrorSimulator"
  2143. static="false" final="false" visibility="public"
  2144. deprecated="not deprecated">
  2145. </constructor>
  2146. <method name="initializeErrorSimulationEvent"
  2147. abstract="false" native="false" synchronized="false"
  2148. static="true" final="false" visibility="public"
  2149. deprecated="not deprecated">
  2150. <param name="numberOfEvents" type="int"/>
  2151. </method>
  2152. <method name="getErrorSimulation" return="boolean"
  2153. abstract="false" native="false" synchronized="false"
  2154. static="true" final="false" visibility="public"
  2155. deprecated="not deprecated">
  2156. <param name="index" type="int"/>
  2157. </method>
  2158. <method name="setErrorSimulation"
  2159. abstract="false" native="false" synchronized="false"
  2160. static="true" final="false" visibility="public"
  2161. deprecated="not deprecated">
  2162. <param name="index" type="int"/>
  2163. </method>
  2164. <method name="clearErrorSimulation"
  2165. abstract="false" native="false" synchronized="false"
  2166. static="true" final="false" visibility="public"
  2167. deprecated="not deprecated">
  2168. <param name="index" type="int"/>
  2169. </method>
  2170. <doc>
  2171. <![CDATA[Utility class to facilitate junit test error simulation.]]>
  2172. </doc>
  2173. </class>
  2174. <!-- end class org.apache.hadoop.hdfs.DFSUtil.ErrorSimulator -->
  2175. <!-- start class org.apache.hadoop.hdfs.DistributedFileSystem -->
  2176. <class name="DistributedFileSystem" extends="org.apache.hadoop.fs.FileSystem"
  2177. abstract="false"
  2178. static="false" final="false" visibility="public"
  2179. deprecated="not deprecated">
  2180. <constructor name="DistributedFileSystem"
  2181. static="false" final="false" visibility="public"
  2182. deprecated="not deprecated">
  2183. </constructor>
  2184. <constructor name="DistributedFileSystem" type="java.net.InetSocketAddress, org.apache.hadoop.conf.Configuration"
  2185. static="false" final="false" visibility="public"
  2186. deprecated="not deprecated">
  2187. <exception name="IOException" type="java.io.IOException"/>
  2188. </constructor>
  2189. <method name="getUri" return="java.net.URI"
  2190. abstract="false" native="false" synchronized="false"
  2191. static="false" final="false" visibility="public"
  2192. deprecated="not deprecated">
  2193. </method>
  2194. <method name="initialize"
  2195. abstract="false" native="false" synchronized="false"
  2196. static="false" final="false" visibility="public"
  2197. deprecated="not deprecated">
  2198. <param name="uri" type="java.net.URI"/>
  2199. <param name="conf" type="org.apache.hadoop.conf.Configuration"/>
  2200. <exception name="IOException" type="java.io.IOException"/>
  2201. </method>
  2202. <method name="checkPath"
  2203. abstract="false" native="false" synchronized="false"
  2204. static="false" final="false" visibility="protected"
  2205. deprecated="not deprecated">
  2206. <param name="path" type="org.apache.hadoop.fs.Path"/>
  2207. <doc>
  2208. <![CDATA[Permit paths which explicitly specify the default port.]]>
  2209. </doc>
  2210. </method>
  2211. <method name="makeQualified" return="org.apache.hadoop.fs.Path"
  2212. abstract="false" native="false" synchronized="false"
  2213. static="false" final="false" visibility="public"
  2214. deprecated="not deprecated">
  2215. <param name="path" type="org.apache.hadoop.fs.Path"/>
  2216. <doc>
  2217. <![CDATA[Normalize paths that explicitly specify the default port.]]>
  2218. </doc>
  2219. </method>
  2220. <method name="getWorkingDirectory" return="org.apache.hadoop.fs.Path"
  2221. abstract="false" native="false" synchronized="false"
  2222. static="false" final="false" visibility="public"
  2223. deprecated="not deprecated">
  2224. </method>
  2225. <method name="getDefaultBlockSize" return="long"
  2226. abstract="false" native="false" synchronized="false"
  2227. static="false" final="false" visibility="public"
  2228. deprecated="not deprecated">
  2229. </method>
  2230. <method name="getDefaultReplication" return="short"
  2231. abstract="false" native="false" synchronized="false"
  2232. static="false" final="false" visibility="public"
  2233. deprecated="not deprecated">
  2234. </method>
  2235. <method name="setWorkingDirectory"
  2236. abstract="false" native="false" synchronized="false"
  2237. static="false" final="false" visibility="public"
  2238. deprecated="not deprecated">
  2239. <param name="dir" type="org.apache.hadoop.fs.Path"/>
  2240. </method>
  2241. <method name="getHomeDirectory" return="org.apache.hadoop.fs.Path"
  2242. abstract="false" native="false" synchronized="false"
  2243. static="false" final="false" visibility="public"
  2244. deprecated="not deprecated">
  2245. <doc>
  2246. <![CDATA[{@inheritDoc}]]>
  2247. </doc>
  2248. </method>
  2249. <method name="getFileBlockLocations" return="org.apache.hadoop.fs.BlockLocation[]"
  2250. abstract="false" native="false" synchronized="false"
  2251. static="false" final="false" visibility="public"
  2252. deprecated="not deprecated">
  2253. <param name="file" type="org.apache.hadoop.fs.FileStatus"/>
  2254. <param name="start" type="long"/>
  2255. <param name="len" type="long"/>
  2256. <exception name="IOException" type="java.io.IOException"/>
  2257. </method>
  2258. <method name="getFileBlockLocations" return="org.apache.hadoop.fs.BlockLocation[]"
  2259. abstract="false" native="false" synchronized="false"
  2260. static="false" final="false" visibility="public"
  2261. deprecated="not deprecated">
  2262. <param name="p" type="org.apache.hadoop.fs.Path"/>
  2263. <param name="start" type="long"/>
  2264. <param name="len" type="long"/>
  2265. <exception name="IOException" type="java.io.IOException"/>
  2266. </method>
  2267. <method name="setVerifyChecksum"
  2268. abstract="false" native="false" synchronized="false"
  2269. static="false" final="false" visibility="public"
  2270. deprecated="not deprecated">
  2271. <param name="verifyChecksum" type="boolean"/>
  2272. </method>
  2273. <method name="open" return="org.apache.hadoop.fs.FSDataInputStream"
  2274. abstract="false" native="false" synchronized="false"
  2275. static="false" final="false" visibility="public"
  2276. deprecated="not deprecated">
  2277. <param name="f" type="org.apache.hadoop.fs.Path"/>
  2278. <param name="bufferSize" type="int"/>
  2279. <exception name="IOException" type="java.io.IOException"/>
  2280. </method>
  2281. <method name="append" return="org.apache.hadoop.fs.FSDataOutputStream"
  2282. abstract="false" native="false" synchronized="false"
  2283. static="false" final="false" visibility="public"
  2284. deprecated="not deprecated">
  2285. <param name="f" type="org.apache.hadoop.fs.Path"/>
  2286. <param name="bufferSize" type="int"/>
  2287. <param name="progress" type="org.apache.hadoop.util.Progressable"/>
  2288. <exception name="IOException" type="java.io.IOException"/>
  2289. <doc>
  2290. <![CDATA[This optional operation is not yet supported.]]>
  2291. </doc>
  2292. </method>
  2293. <method name="create" return="org.apache.hadoop.fs.FSDataOutputStream"
  2294. abstract="false" native="false" synchronized="false"
  2295. static="false" final="false" visibility="public"
  2296. deprecated="not deprecated">
  2297. <param name="f" type="org.apache.hadoop.fs.Path"/>
  2298. <param name="permission" type="org.apache.hadoop.fs.permission.FsPermission"/>
  2299. <param name="overwrite" type="boolean"/>
  2300. <param name="bufferSize" type="int"/>
  2301. <param name="replication" type="short"/>
  2302. <param name="blockSize" type="long"/>
  2303. <param name="progress" type="org.apache.hadoop.util.Progressable"/>
  2304. <exception name="IOException" type="java.io.IOException"/>
  2305. </method>
  2306. <method name="primitiveCreate" return="org.apache.hadoop.fs.FSDataOutputStream"
  2307. abstract="false" native="false" synchronized="false"
  2308. static="false" final="false" visibility="protected"
  2309. deprecated="not deprecated">
  2310. <param name="f" type="org.apache.hadoop.fs.Path"/>
  2311. <param name="absolutePermission" type="org.apache.hadoop.fs.permission.FsPermission"/>
  2312. <param name="flag" type="java.util.EnumSet"/>
  2313. <param name="bufferSize" type="int"/>
  2314. <param name="replication" type="short"/>
  2315. <param name="blockSize" type="long"/>
  2316. <param name="progress" type="org.apache.hadoop.util.Progressable"/>
  2317. <param name="bytesPerChecksum" type="int"/>
  2318. <exception name="IOException" type="java.io.IOException"/>
  2319. </method>
  2320. <method name="createNonRecursive" return="org.apache.hadoop.fs.FSDataOutputStream"
  2321. abstract="false" native="false" synchronized="false"
  2322. static="false" final="false" visibility="public"
  2323. deprecated="not deprecated">
  2324. <param name="f" type="org.apache.hadoop.fs.Path"/>
  2325. <param name="permission" type="org.apache.hadoop.fs.permission.FsPermission"/>
  2326. <param name="flag" type="java.util.EnumSet"/>
  2327. <param name="bufferSize" type="int"/>
  2328. <param name="replication" type="short"/>
  2329. <param name="blockSize" type="long"/>
  2330. <param name="progress" type="org.apache.hadoop.util.Progressable"/>
  2331. <exception name="IOException" type="java.io.IOException"/>
  2332. <doc>
  2333. <![CDATA[Same as create(), except fails if parent directory doesn't already exist.]]>
  2334. </doc>
  2335. </method>
  2336. <method name="setReplication" return="boolean"
  2337. abstract="false" native="false" synchronized="false"
  2338. static="false" final="false" visibility="public"
  2339. deprecated="not deprecated">
  2340. <param name="src" type="org.apache.hadoop.fs.Path"/>
  2341. <param name="replication" type="short"/>
  2342. <exception name="IOException" type="java.io.IOException"/>
  2343. </method>
  2344. <method name="concat"
  2345. abstract="false" native="false" synchronized="false"
  2346. static="false" final="false" visibility="public"
  2347. deprecated="not deprecated">
  2348. <param name="trg" type="org.apache.hadoop.fs.Path"/>
  2349. <param name="psrcs" type="org.apache.hadoop.fs.Path[]"/>
  2350. <exception name="IOException" type="java.io.IOException"/>
  2351. <doc>
  2352. <![CDATA[THIS IS DFS only operations, it is not part of FileSystem
  2353. move blocks from srcs to trg
  2354. and delete srcs afterwards
  2355. all blocks should be the same size
  2356. @param trg existing file to append to
  2357. @param psrcs list of files (same block size, same replication)
  2358. @throws IOException]]>
  2359. </doc>
  2360. </method>
  2361. <method name="rename" return="boolean"
  2362. abstract="false" native="false" synchronized="false"
  2363. static="false" final="false" visibility="public"
  2364. deprecated="not deprecated">
  2365. <param name="src" type="org.apache.hadoop.fs.Path"/>
  2366. <param name="dst" type="org.apache.hadoop.fs.Path"/>
  2367. <exception name="IOException" type="java.io.IOException"/>
  2368. <doc>
  2369. <![CDATA[{@inheritDoc}]]>
  2370. </doc>
  2371. </method>
  2372. <method name="rename"
  2373. abstract="false" native="false" synchronized="false"
  2374. static="false" final="false" visibility="public"
  2375. deprecated="not deprecated">
  2376. <param name="src" type="org.apache.hadoop.fs.Path"/>
  2377. <param name="dst" type="org.apache.hadoop.fs.Path"/>
  2378. <param name="options" type="org.apache.hadoop.fs.Options.Rename[]"/>
  2379. <exception name="IOException" type="java.io.IOException"/>
  2380. <doc>
  2381. <![CDATA[{@inheritDoc}
  2382. This rename operation is guaranteed to be atomic.]]>
  2383. </doc>
  2384. </method>
  2385. <method name="delete" return="boolean"
  2386. abstract="false" native="false" synchronized="false"
  2387. static="false" final="false" visibility="public"
  2388. deprecated="not deprecated">
  2389. <param name="f" type="org.apache.hadoop.fs.Path"/>
  2390. <param name="recursive" type="boolean"/>
  2391. <exception name="IOException" type="java.io.IOException"/>
  2392. </method>
  2393. <method name="getContentSummary" return="org.apache.hadoop.fs.ContentSummary"
  2394. abstract="false" native="false" synchronized="false"
  2395. static="false" final="false" visibility="public"
  2396. deprecated="not deprecated">
  2397. <param name="f" type="org.apache.hadoop.fs.Path"/>
  2398. <exception name="IOException" type="java.io.IOException"/>
  2399. <doc>
  2400. <![CDATA[{@inheritDoc}]]>
  2401. </doc>
  2402. </method>
  2403. <method name="setQuota"
  2404. abstract="false" native="false" synchronized="false"
  2405. static="false" final="false" visibility="public"
  2406. deprecated="not deprecated">
  2407. <param name="src" type="org.apache.hadoop.fs.Path"/>
  2408. <param name="namespaceQuota" type="long"/>
  2409. <param name="diskspaceQuota" type="long"/>
  2410. <exception name="IOException" type="java.io.IOException"/>
  2411. <doc>
  2412. <![CDATA[Set a directory's quotas
  2413. @see org.apache.hadoop.hdfs.protocol.ClientProtocol#setQuota(String, long, long)]]>
  2414. </doc>
  2415. </method>
  2416. <method name="listStatus" return="org.apache.hadoop.fs.FileStatus[]"
  2417. abstract="false" native="false" synchronized="false"
  2418. static="false" final="false" visibility="public"
  2419. deprecated="not deprecated">
  2420. <param name="p" type="org.apache.hadoop.fs.Path"/>
  2421. <exception name="IOException" type="java.io.IOException"/>
  2422. <doc>
  2423. <![CDATA[List all the entries of a directory
  2424. Note that this operation is not atomic for a large directory.
  2425. The entries of a directory may be fetched from NameNode multiple times.
  2426. It only guarantees that each name occurs once if a directory
  2427. undergoes changes between the calls.]]>
  2428. </doc>
  2429. </method>
  2430. <method name="mkdir" return="boolean"
  2431. abstract="false" native="false" synchronized="false"
  2432. static="false" final="false" visibility="public"
  2433. deprecated="not deprecated">
  2434. <param name="f" type="org.apache.hadoop.fs.Path"/>
  2435. <param name="permission" type="org.apache.hadoop.fs.permission.FsPermission"/>
  2436. <exception name="IOException" type="java.io.IOException"/>
  2437. <doc>
  2438. <![CDATA[Create a directory with given name and permission, only when
  2439. parent directory exists.]]>
  2440. </doc>
  2441. </method>
  2442. <method name="mkdirs" return="boolean"
  2443. abstract="false" native="false" synchronized="false"
  2444. static="false" final="false" visibility="public"
  2445. deprecated="not deprecated">
  2446. <param name="f" type="org.apache.hadoop.fs.Path"/>
  2447. <param name="permission" type="org.apache.hadoop.fs.permission.FsPermission"/>
  2448. <exception name="IOException" type="java.io.IOException"/>
  2449. </method>
  2450. <method name="primitiveMkdir" return="boolean"
  2451. abstract="false" native="false" synchronized="false"
  2452. static="false" final="false" visibility="protected"
  2453. deprecated="not deprecated">
  2454. <param name="f" type="org.apache.hadoop.fs.Path"/>
  2455. <param name="absolutePermission" type="org.apache.hadoop.fs.permission.FsPermission"/>
  2456. <exception name="IOException" type="java.io.IOException"/>
  2457. </method>
  2458. <method name="close"
  2459. abstract="false" native="false" synchronized="false"
  2460. static="false" final="false" visibility="public"
  2461. deprecated="not deprecated">
  2462. <exception name="IOException" type="java.io.IOException"/>
  2463. <doc>
  2464. <![CDATA[{@inheritDoc}]]>
  2465. </doc>
  2466. </method>
  2467. <method name="toString" return="java.lang.String"
  2468. abstract="false" native="false" synchronized="false"
  2469. static="false" final="false" visibility="public"
  2470. deprecated="not deprecated">
  2471. </method>
  2472. <method name="getClient" return="org.apache.hadoop.hdfs.DFSClient"
  2473. abstract="false" native="false" synchronized="false"
  2474. static="false" final="false" visibility="public"
  2475. deprecated="not deprecated">
  2476. </method>
  2477. <method name="getStatus" return="org.apache.hadoop.fs.FsStatus"
  2478. abstract="false" native="false" synchronized="false"
  2479. static="false" final="false" visibility="public"
  2480. deprecated="not deprecated">
  2481. <param name="p" type="org.apache.hadoop.fs.Path"/>
  2482. <exception name="IOException" type="java.io.IOException"/>
  2483. <doc>
  2484. <![CDATA[{@inheritDoc}]]>
  2485. </doc>
  2486. </method>
  2487. <method name="getDiskStatus" return="org.apache.hadoop.hdfs.DistributedFileSystem.DiskStatus"
  2488. abstract="false" native="false" synchronized="false"
  2489. static="false" final="false" visibility="public"
  2490. deprecated="Use {@link org.apache.hadoop.fs.FileSystem#getStatus()}
  2491. instead">
  2492. <exception name="IOException" type="java.io.IOException"/>
  2493. <doc>
  2494. <![CDATA[Return the disk usage of the filesystem, including total capacity,
  2495. used space, and remaining space
  2496. @deprecated Use {@link org.apache.hadoop.fs.FileSystem#getStatus()}
  2497. instead]]>
  2498. </doc>
  2499. </method>
  2500. <method name="getRawCapacity" return="long"
  2501. abstract="false" native="false" synchronized="false"
  2502. static="false" final="false" visibility="public"
  2503. deprecated="Use {@link org.apache.hadoop.fs.FileSystem#getStatus()}
  2504. instead">
  2505. <exception name="IOException" type="java.io.IOException"/>
  2506. <doc>
  2507. <![CDATA[Return the total raw capacity of the filesystem, disregarding
  2508. replication.
  2509. @deprecated Use {@link org.apache.hadoop.fs.FileSystem#getStatus()}
  2510. instead]]>
  2511. </doc>
  2512. </method>
  2513. <method name="getRawUsed" return="long"
  2514. abstract="false" native="false" synchronized="false"
  2515. static="false" final="false" visibility="public"
  2516. deprecated="Use {@link org.apache.hadoop.fs.FileSystem#getStatus()}
  2517. instead">
  2518. <exception name="IOException" type="java.io.IOException"/>
  2519. <doc>
  2520. <![CDATA[Return the total raw used space in the filesystem, disregarding
  2521. replication.
  2522. @deprecated Use {@link org.apache.hadoop.fs.FileSystem#getStatus()}
  2523. instead]]>
  2524. </doc>
  2525. </method>
  2526. <method name="getMissingBlocksCount" return="long"
  2527. abstract="false" native="false" synchronized="false"
  2528. static="false" final="false" visibility="public"
  2529. deprecated="not deprecated">
  2530. <exception name="IOException" type="java.io.IOException"/>
  2531. <doc>
  2532. <![CDATA[Returns count of blocks with no good replicas left. Normally should be
  2533. zero.
  2534. @throws IOException]]>
  2535. </doc>
  2536. </method>
  2537. <method name="getUnderReplicatedBlocksCount" return="long"
  2538. abstract="false" native="false" synchronized="false"
  2539. static="false" final="false" visibility="public"
  2540. deprecated="not deprecated">
  2541. <exception name="IOException" type="java.io.IOException"/>
  2542. <doc>
  2543. <![CDATA[Returns count of blocks with one of more replica missing.
  2544. @throws IOException]]>
  2545. </doc>
  2546. </method>
  2547. <method name="getCorruptBlocksCount" return="long"
  2548. abstract="false" native="false" synchronized="false"
  2549. static="false" final="false" visibility="public"
  2550. deprecated="not deprecated">
  2551. <exception name="IOException" type="java.io.IOException"/>
  2552. <doc>
  2553. <![CDATA[Returns count of blocks with at least one replica marked corrupt.
  2554. @throws IOException]]>
  2555. </doc>
  2556. </method>
  2557. <method name="getDataNodeStats" return="org.apache.hadoop.hdfs.protocol.DatanodeInfo[]"
  2558. abstract="false" native="false" synchronized="false"
  2559. static="false" final="false" visibility="public"
  2560. deprecated="not deprecated">
  2561. <exception name="IOException" type="java.io.IOException"/>
  2562. <doc>
  2563. <![CDATA[Return statistics for each datanode.]]>
  2564. </doc>
  2565. </method>
  2566. <method name="setSafeMode" return="boolean"
  2567. abstract="false" native="false" synchronized="false"
  2568. static="false" final="false" visibility="public"
  2569. deprecated="not deprecated">
  2570. <param name="action" type="org.apache.hadoop.hdfs.protocol.FSConstants.SafeModeAction"/>
  2571. <exception name="IOException" type="java.io.IOException"/>
  2572. <doc>
  2573. <![CDATA[Enter, leave or get safe mode.
  2574. @see org.apache.hadoop.hdfs.protocol.ClientProtocol#setSafeMode(
  2575. FSConstants.SafeModeAction)]]>
  2576. </doc>
  2577. </method>
  2578. <method name="saveNamespace"
  2579. abstract="false" native="false" synchronized="false"
  2580. static="false" final="false" visibility="public"
  2581. deprecated="not deprecated">
  2582. <exception name="AccessControlException" type="org.apache.hadoop.security.AccessControlException"/>
  2583. <exception name="IOException" type="java.io.IOException"/>
  2584. <doc>
  2585. <![CDATA[Save namespace image.
  2586. @see org.apache.hadoop.hdfs.protocol.ClientProtocol#saveNamespace()]]>
  2587. </doc>
  2588. </method>
  2589. <method name="restoreFailedStorage" return="boolean"
  2590. abstract="false" native="false" synchronized="false"
  2591. static="false" final="false" visibility="public"
  2592. deprecated="not deprecated">
  2593. <param name="arg" type="java.lang.String"/>
  2594. <exception name="AccessControlException" type="org.apache.hadoop.security.AccessControlException"/>
  2595. <doc>
  2596. <![CDATA[enable/disable/check restoreFaileStorage
  2597. @see org.apache.hadoop.hdfs.protocol.ClientProtocol#restoreFailedStorage(String arg)]]>
  2598. </doc>
  2599. </method>
  2600. <method name="refreshNodes"
  2601. abstract="false" native="false" synchronized="false"
  2602. static="false" final="false" visibility="public"
  2603. deprecated="not deprecated">
  2604. <exception name="IOException" type="java.io.IOException"/>
  2605. <doc>
  2606. <![CDATA[Refreshes the list of hosts and excluded hosts from the configured
  2607. files.]]>
  2608. </doc>
  2609. </method>
  2610. <method name="finalizeUpgrade"
  2611. abstract="false" native="false" synchronized="false"
  2612. static="false" final="false" visibility="public"
  2613. deprecated="not deprecated">
  2614. <exception name="IOException" type="java.io.IOException"/>
  2615. <doc>
  2616. <![CDATA[Finalize previously upgraded files system state.
  2617. @throws IOException]]>
  2618. </doc>
  2619. </method>
  2620. <method name="distributedUpgradeProgress" return="org.apache.hadoop.hdfs.server.common.UpgradeStatusReport"
  2621. abstract="false" native="false" synchronized="false"
  2622. static="false" final="false" visibility="public"
  2623. deprecated="not deprecated">
  2624. <param name="action" type="org.apache.hadoop.hdfs.protocol.FSConstants.UpgradeAction"/>
  2625. <exception name="IOException" type="java.io.IOException"/>
  2626. </method>
  2627. <method name="metaSave"
  2628. abstract="false" native="false" synchronized="false"
  2629. static="false" final="false" visibility="public"
  2630. deprecated="not deprecated">
  2631. <param name="pathname" type="java.lang.String"/>
  2632. <exception name="IOException" type="java.io.IOException"/>
  2633. </method>
  2634. <method name="getServerDefaults" return="org.apache.hadoop.fs.FsServerDefaults"
  2635. abstract="false" native="false" synchronized="false"
  2636. static="false" final="false" visibility="public"
  2637. deprecated="not deprecated">
  2638. <exception name="IOException" type="java.io.IOException"/>
  2639. <doc>
  2640. <![CDATA[{@inheritDoc}]]>
  2641. </doc>
  2642. </method>
  2643. <method name="reportChecksumFailure" return="boolean"
  2644. abstract="false" native="false" synchronized="false"
  2645. static="false" final="false" visibility="public"
  2646. deprecated="not deprecated">
  2647. <param name="f" type="org.apache.hadoop.fs.Path"/>
  2648. <param name="in" type="org.apache.hadoop.fs.FSDataInputStream"/>
  2649. <param name="inPos" type="long"/>
  2650. <param name="sums" type="org.apache.hadoop.fs.FSDataInputStream"/>
  2651. <param name="sumsPos" type="long"/>
  2652. <doc>
  2653. <![CDATA[We need to find the blocks that didn't match. Likely only one
  2654. is corrupt but we will report both to the namenode. In the future,
  2655. we can consider figuring out exactly which block is corrupt.]]>
  2656. </doc>
  2657. </method>
  2658. <method name="getFileStatus" return="org.apache.hadoop.fs.FileStatus"
  2659. abstract="false" native="false" synchronized="false"
  2660. static="false" final="false" visibility="public"
  2661. deprecated="not deprecated">
  2662. <param name="f" type="org.apache.hadoop.fs.Path"/>
  2663. <exception name="IOException" type="java.io.IOException"/>
  2664. <doc>
  2665. <![CDATA[Returns the stat information about the file.
  2666. @throws FileNotFoundException if the file does not exist.]]>
  2667. </doc>
  2668. </method>
  2669. <method name="getFileChecksum" return="org.apache.hadoop.fs.MD5MD5CRC32FileChecksum"
  2670. abstract="false" native="false" synchronized="false"
  2671. static="false" final="false" visibility="public"
  2672. deprecated="not deprecated">
  2673. <param name="f" type="org.apache.hadoop.fs.Path"/>
  2674. <exception name="IOException" type="java.io.IOException"/>
  2675. <doc>
  2676. <![CDATA[{@inheritDoc}]]>
  2677. </doc>
  2678. </method>
  2679. <method name="setPermission"
  2680. abstract="false" native="false" synchronized="false"
  2681. static="false" final="false" visibility="public"
  2682. deprecated="not deprecated">
  2683. <param name="p" type="org.apache.hadoop.fs.Path"/>
  2684. <param name="permission" type="org.apache.hadoop.fs.permission.FsPermission"/>
  2685. <exception name="IOException" type="java.io.IOException"/>
  2686. <doc>
  2687. <![CDATA[{@inheritDoc }]]>
  2688. </doc>
  2689. </method>
  2690. <method name="setOwner"
  2691. abstract="false" native="false" synchronized="false"
  2692. static="false" final="false" visibility="public"
  2693. deprecated="not deprecated">
  2694. <param name="p" type="org.apache.hadoop.fs.Path"/>
  2695. <param name="username" type="java.lang.String"/>
  2696. <param name="groupname" type="java.lang.String"/>
  2697. <exception name="IOException" type="java.io.IOException"/>
  2698. <doc>
  2699. <![CDATA[{@inheritDoc }]]>
  2700. </doc>
  2701. </method>
  2702. <method name="setTimes"
  2703. abstract="false" native="false" synchronized="false"
  2704. static="false" final="false" visibility="public"
  2705. deprecated="not deprecated">
  2706. <param name="p" type="org.apache.hadoop.fs.Path"/>
  2707. <param name="mtime" type="long"/>
  2708. <param name="atime" type="long"/>
  2709. <exception name="IOException" type="java.io.IOException"/>
  2710. <doc>
  2711. <![CDATA[{@inheritDoc }]]>
  2712. </doc>
  2713. </method>
  2714. <method name="getDelegationToken" return="org.apache.hadoop.security.token.Token"
  2715. abstract="false" native="false" synchronized="false"
  2716. static="false" final="false" visibility="public"
  2717. deprecated="not deprecated">
  2718. <param name="renewer" type="org.apache.hadoop.io.Text"/>
  2719. <exception name="IOException" type="java.io.IOException"/>
  2720. <doc>
  2721. <![CDATA[Get a valid Delegation Token.
  2722. @param renewer Name of the designated renewer for the token
  2723. @return Token<DelegationTokenIdentifier>
  2724. @throws IOException]]>
  2725. </doc>
  2726. </method>
  2727. <method name="renewDelegationToken" return="long"
  2728. abstract="false" native="false" synchronized="false"
  2729. static="false" final="false" visibility="public"
  2730. deprecated="not deprecated">
  2731. <param name="token" type="org.apache.hadoop.security.token.Token"/>
  2732. <exception name="SecretManager.InvalidToken" type="org.apache.hadoop.security.token.SecretManager.InvalidToken"/>
  2733. <exception name="IOException" type="java.io.IOException"/>
  2734. <doc>
  2735. <![CDATA[Renew an existing delegation token.
  2736. @param token delegation token obtained earlier
  2737. @return the new expiration time
  2738. @throws IOException]]>
  2739. </doc>
  2740. </method>
  2741. <method name="cancelDelegationToken"
  2742. abstract="false" native="false" synchronized="false"
  2743. static="false" final="false" visibility="public"
  2744. deprecated="not deprecated">
  2745. <param name="token" type="org.apache.hadoop.security.token.Token"/>
  2746. <exception name="IOException" type="java.io.IOException"/>
  2747. <doc>
  2748. <![CDATA[Cancel an existing delegation token.
  2749. @param token delegation token
  2750. @throws IOException]]>
  2751. </doc>
  2752. </method>
  2753. <doc>
  2754. <![CDATA[Implementation of the abstract FileSystem for the DFS system.
  2755. This object is the way end-user code interacts with a Hadoop
  2756. DistributedFileSystem.]]>
  2757. </doc>
  2758. </class>
  2759. <!-- end class org.apache.hadoop.hdfs.DistributedFileSystem -->
  2760. <!-- start class org.apache.hadoop.hdfs.DistributedFileSystem.DiskStatus -->
  2761. <class name="DistributedFileSystem.DiskStatus" extends="org.apache.hadoop.fs.FsStatus"
  2762. abstract="false"
  2763. static="true" final="false" visibility="public"
  2764. deprecated="Use {@link org.apache.hadoop.fs.FsStatus} instead">
  2765. <constructor name="DistributedFileSystem.DiskStatus" type="org.apache.hadoop.fs.FsStatus"
  2766. static="false" final="false" visibility="public"
  2767. deprecated="not deprecated">
  2768. </constructor>
  2769. <constructor name="DistributedFileSystem.DiskStatus" type="long, long, long"
  2770. static="false" final="false" visibility="public"
  2771. deprecated="not deprecated">
  2772. </constructor>
  2773. <method name="getDfsUsed" return="long"
  2774. abstract="false" native="false" synchronized="false"
  2775. static="false" final="false" visibility="public"
  2776. deprecated="not deprecated">
  2777. </method>
  2778. <doc>
  2779. <![CDATA[@deprecated Use {@link org.apache.hadoop.fs.FsStatus} instead]]>
  2780. </doc>
  2781. </class>
  2782. <!-- end class org.apache.hadoop.hdfs.DistributedFileSystem.DiskStatus -->
  2783. <!-- start class org.apache.hadoop.hdfs.HdfsConfiguration -->
  2784. <class name="HdfsConfiguration" extends="org.apache.hadoop.conf.Configuration"
  2785. abstract="false"
  2786. static="false" final="false" visibility="public"
  2787. deprecated="not deprecated">
  2788. <constructor name="HdfsConfiguration"
  2789. static="false" final="false" visibility="public"
  2790. deprecated="not deprecated">
  2791. </constructor>
  2792. <constructor name="HdfsConfiguration" type="boolean"
  2793. static="false" final="false" visibility="public"
  2794. deprecated="not deprecated">
  2795. </constructor>
  2796. <constructor name="HdfsConfiguration" type="org.apache.hadoop.conf.Configuration"
  2797. static="false" final="false" visibility="public"
  2798. deprecated="not deprecated">
  2799. </constructor>
  2800. <doc>
  2801. <![CDATA[Adds deprecated keys into the configuration.]]>
  2802. </doc>
  2803. </class>
  2804. <!-- end class org.apache.hadoop.hdfs.HdfsConfiguration -->
  2805. <!-- start class org.apache.hadoop.hdfs.HDFSPolicyProvider -->
  2806. <class name="HDFSPolicyProvider" extends="org.apache.hadoop.security.authorize.PolicyProvider"
  2807. abstract="false"
  2808. static="false" final="false" visibility="public"
  2809. deprecated="not deprecated">
  2810. <constructor name="HDFSPolicyProvider"
  2811. static="false" final="false" visibility="public"
  2812. deprecated="not deprecated">
  2813. </constructor>
  2814. <method name="getServices" return="org.apache.hadoop.security.authorize.Service[]"
  2815. abstract="false" native="false" synchronized="false"
  2816. static="false" final="false" visibility="public"
  2817. deprecated="not deprecated">
  2818. </method>
  2819. <doc>
  2820. <![CDATA[{@link PolicyProvider} for HDFS protocols.]]>
  2821. </doc>
  2822. </class>
  2823. <!-- end class org.apache.hadoop.hdfs.HDFSPolicyProvider -->
  2824. <!-- start class org.apache.hadoop.hdfs.HftpFileSystem -->
  2825. <class name="HftpFileSystem" extends="org.apache.hadoop.fs.FileSystem"
  2826. abstract="false"
  2827. static="false" final="false" visibility="public"
  2828. deprecated="not deprecated">
  2829. <constructor name="HftpFileSystem"
  2830. static="false" final="false" visibility="public"
  2831. deprecated="not deprecated">
  2832. </constructor>
  2833. <method name="getDateFormat" return="java.text.SimpleDateFormat"
  2834. abstract="false" native="false" synchronized="false"
  2835. static="true" final="true" visibility="public"
  2836. deprecated="not deprecated">
  2837. </method>
  2838. <method name="initialize"
  2839. abstract="false" native="false" synchronized="false"
  2840. static="false" final="false" visibility="public"
  2841. deprecated="not deprecated">
  2842. <param name="name" type="java.net.URI"/>
  2843. <param name="conf" type="org.apache.hadoop.conf.Configuration"/>
  2844. <exception name="IOException" type="java.io.IOException"/>
  2845. </method>
  2846. <method name="getUri" return="java.net.URI"
  2847. abstract="false" native="false" synchronized="false"
  2848. static="false" final="false" visibility="public"
  2849. deprecated="not deprecated">
  2850. </method>
  2851. <method name="openConnection" return="java.net.HttpURLConnection"
  2852. abstract="false" native="false" synchronized="false"
  2853. static="false" final="false" visibility="protected"
  2854. deprecated="not deprecated">
  2855. <param name="path" type="java.lang.String"/>
  2856. <param name="query" type="java.lang.String"/>
  2857. <exception name="IOException" type="java.io.IOException"/>
  2858. <doc>
  2859. <![CDATA[Open an HTTP connection to the namenode to read file data and metadata.
  2860. @param path The path component of the URL
  2861. @param query The query component of the URL]]>
  2862. </doc>
  2863. </method>
  2864. <method name="open" return="org.apache.hadoop.fs.FSDataInputStream"
  2865. abstract="false" native="false" synchronized="false"
  2866. static="false" final="false" visibility="public"
  2867. deprecated="not deprecated">
  2868. <param name="f" type="org.apache.hadoop.fs.Path"/>
  2869. <param name="buffersize" type="int"/>
  2870. <exception name="IOException" type="java.io.IOException"/>
  2871. </method>
  2872. <method name="listStatus" return="org.apache.hadoop.fs.FileStatus[]"
  2873. abstract="false" native="false" synchronized="false"
  2874. static="false" final="false" visibility="public"
  2875. deprecated="not deprecated">
  2876. <param name="f" type="org.apache.hadoop.fs.Path"/>
  2877. <exception name="IOException" type="java.io.IOException"/>
  2878. </method>
  2879. <method name="getFileStatus" return="org.apache.hadoop.fs.FileStatus"
  2880. abstract="false" native="false" synchronized="false"
  2881. static="false" final="false" visibility="public"
  2882. deprecated="not deprecated">
  2883. <param name="f" type="org.apache.hadoop.fs.Path"/>
  2884. <exception name="IOException" type="java.io.IOException"/>
  2885. </method>
  2886. <method name="getFileChecksum" return="org.apache.hadoop.fs.FileChecksum"
  2887. abstract="false" native="false" synchronized="false"
  2888. static="false" final="false" visibility="public"
  2889. deprecated="not deprecated">
  2890. <param name="f" type="org.apache.hadoop.fs.Path"/>
  2891. <exception name="IOException" type="java.io.IOException"/>
  2892. <doc>
  2893. <![CDATA[{@inheritDoc}]]>
  2894. </doc>
  2895. </method>
  2896. <method name="getWorkingDirectory" return="org.apache.hadoop.fs.Path"
  2897. abstract="false" native="false" synchronized="false"
  2898. static="false" final="false" visibility="public"
  2899. deprecated="not deprecated">
  2900. </method>
  2901. <method name="setWorkingDirectory"
  2902. abstract="false" native="false" synchronized="false"
  2903. static="false" final="false" visibility="public"
  2904. deprecated="not deprecated">
  2905. <param name="f" type="org.apache.hadoop.fs.Path"/>
  2906. </method>
  2907. <method name="append" return="org.apache.hadoop.fs.FSDataOutputStream"
  2908. abstract="false" native="false" synchronized="false"
  2909. static="false" final="false" visibility="public"
  2910. deprecated="not deprecated">
  2911. <param name="f" type="org.apache.hadoop.fs.Path"/>
  2912. <param name="bufferSize" type="int"/>
  2913. <param name="progress" type="org.apache.hadoop.util.Progressable"/>
  2914. <exception name="IOException" type="java.io.IOException"/>
  2915. <doc>
  2916. <![CDATA[This optional operation is not yet supported.]]>
  2917. </doc>
  2918. </method>
  2919. <method name="create" return="org.apache.hadoop.fs.FSDataOutputStream"
  2920. abstract="false" native="false" synchronized="false"
  2921. static="false" final="false" visibility="public"
  2922. deprecated="not deprecated">
  2923. <param name="f" type="org.apache.hadoop.fs.Path"/>
  2924. <param name="permission" type="org.apache.hadoop.fs.permission.FsPermission"/>
  2925. <param name="overwrite" type="boolean"/>
  2926. <param name="bufferSize" type="int"/>
  2927. <param name="replication" type="short"/>
  2928. <param name="blockSize" type="long"/>
  2929. <param name="progress" type="org.apache.hadoop.util.Progressable"/>
  2930. <exception name="IOException" type="java.io.IOException"/>
  2931. </method>
  2932. <method name="rename" return="boolean"
  2933. abstract="false" native="false" synchronized="false"
  2934. static="false" final="false" visibility="public"
  2935. deprecated="not deprecated">
  2936. <param name="src" type="org.apache.hadoop.fs.Path"/>
  2937. <param name="dst" type="org.apache.hadoop.fs.Path"/>
  2938. <exception name="IOException" type="java.io.IOException"/>
  2939. </method>
  2940. <method name="delete" return="boolean"
  2941. abstract="false" native="false" synchronized="false"
  2942. static="false" final="false" visibility="public"
  2943. deprecated="not deprecated">
  2944. <param name="f" type="org.apache.hadoop.fs.Path"/>
  2945. <param name="recursive" type="boolean"/>
  2946. <exception name="IOException" type="java.io.IOException"/>
  2947. </method>
  2948. <method name="mkdirs" return="boolean"
  2949. abstract="false" native="false" synchronized="false"
  2950. static="false" final="false" visibility="public"
  2951. deprecated="not deprecated">
  2952. <param name="f" type="org.apache.hadoop.fs.Path"/>
  2953. <param name="permission" type="org.apache.hadoop.fs.permission.FsPermission"/>
  2954. <exception name="IOException" type="java.io.IOException"/>
  2955. </method>
  2956. <method name="getContentSummary" return="org.apache.hadoop.fs.ContentSummary"
  2957. abstract="false" native="false" synchronized="false"
  2958. static="false" final="false" visibility="public"
  2959. deprecated="not deprecated">
  2960. <param name="f" type="org.apache.hadoop.fs.Path"/>
  2961. <exception name="IOException" type="java.io.IOException"/>
  2962. <doc>
  2963. <![CDATA[{@inheritDoc}]]>
  2964. </doc>
  2965. </method>
  2966. <field name="nnAddr" type="java.net.InetSocketAddress"
  2967. transient="false" volatile="false"
  2968. static="false" final="false" visibility="protected"
  2969. deprecated="not deprecated">
  2970. </field>
  2971. <field name="ugi" type="org.apache.hadoop.security.UserGroupInformation"
  2972. transient="false" volatile="false"
  2973. static="false" final="false" visibility="protected"
  2974. deprecated="not deprecated">
  2975. </field>
  2976. <field name="ran" type="java.util.Random"
  2977. transient="false" volatile="false"
  2978. static="false" final="true" visibility="protected"
  2979. deprecated="not deprecated">
  2980. </field>
  2981. <field name="HFTP_TIMEZONE" type="java.lang.String"
  2982. transient="false" volatile="false"
  2983. static="true" final="true" visibility="public"
  2984. deprecated="not deprecated">
  2985. </field>
  2986. <field name="HFTP_DATE_FORMAT" type="java.lang.String"
  2987. transient="false" volatile="false"
  2988. static="true" final="true" visibility="public"
  2989. deprecated="not deprecated">
  2990. </field>
  2991. <field name="df" type="java.lang.ThreadLocal"
  2992. transient="false" volatile="false"
  2993. static="true" final="true" visibility="protected"
  2994. deprecated="not deprecated">
  2995. </field>
  2996. <doc>
  2997. <![CDATA[An implementation of a protocol for accessing filesystems over HTTP.
  2998. The following implementation provides a limited, read-only interface
  2999. to a filesystem over HTTP.
  3000. @see org.apache.hadoop.hdfs.server.namenode.ListPathsServlet
  3001. @see org.apache.hadoop.hdfs.server.namenode.FileDataServlet]]>
  3002. </doc>
  3003. </class>
  3004. <!-- end class org.apache.hadoop.hdfs.HftpFileSystem -->
  3005. <!-- start class org.apache.hadoop.hdfs.HsftpFileSystem -->
  3006. <class name="HsftpFileSystem" extends="org.apache.hadoop.hdfs.HftpFileSystem"
  3007. abstract="false"
  3008. static="false" final="false" visibility="public"
  3009. deprecated="not deprecated">
  3010. <constructor name="HsftpFileSystem"
  3011. static="false" final="false" visibility="public"
  3012. deprecated="not deprecated">
  3013. </constructor>
  3014. <method name="initialize"
  3015. abstract="false" native="false" synchronized="false"
  3016. static="false" final="false" visibility="public"
  3017. deprecated="not deprecated">
  3018. <param name="name" type="java.net.URI"/>
  3019. <param name="conf" type="org.apache.hadoop.conf.Configuration"/>
  3020. <exception name="IOException" type="java.io.IOException"/>
  3021. </method>
  3022. <method name="openConnection" return="java.net.HttpURLConnection"
  3023. abstract="false" native="false" synchronized="false"
  3024. static="false" final="false" visibility="protected"
  3025. deprecated="not deprecated">
  3026. <param name="path" type="java.lang.String"/>
  3027. <param name="query" type="java.lang.String"/>
  3028. <exception name="IOException" type="java.io.IOException"/>
  3029. </method>
  3030. <method name="getUri" return="java.net.URI"
  3031. abstract="false" native="false" synchronized="false"
  3032. static="false" final="false" visibility="public"
  3033. deprecated="not deprecated">
  3034. </method>
  3035. <doc>
  3036. <![CDATA[An implementation of a protocol for accessing filesystems over HTTPS. The
  3037. following implementation provides a limited, read-only interface to a
  3038. filesystem over HTTPS.
  3039. @see org.apache.hadoop.hdfs.server.namenode.ListPathsServlet
  3040. @see org.apache.hadoop.hdfs.server.namenode.FileDataServlet]]>
  3041. </doc>
  3042. </class>
  3043. <!-- end class org.apache.hadoop.hdfs.HsftpFileSystem -->
  3044. <!-- start class org.apache.hadoop.hdfs.HsftpFileSystem.DummyHostnameVerifier -->
  3045. <class name="HsftpFileSystem.DummyHostnameVerifier" extends="java.lang.Object"
  3046. abstract="false"
  3047. static="true" final="false" visibility="protected"
  3048. deprecated="not deprecated">
  3049. <implements name="javax.net.ssl.HostnameVerifier"/>
  3050. <constructor name="HsftpFileSystem.DummyHostnameVerifier"
  3051. static="false" final="false" visibility="protected"
  3052. deprecated="not deprecated">
  3053. </constructor>
  3054. <method name="verify" return="boolean"
  3055. abstract="false" native="false" synchronized="false"
  3056. static="false" final="false" visibility="public"
  3057. deprecated="not deprecated">
  3058. <param name="hostname" type="java.lang.String"/>
  3059. <param name="session" type="javax.net.ssl.SSLSession"/>
  3060. </method>
  3061. <doc>
  3062. <![CDATA[Dummy hostname verifier that is used to bypass hostname checking]]>
  3063. </doc>
  3064. </class>
  3065. <!-- end class org.apache.hadoop.hdfs.HsftpFileSystem.DummyHostnameVerifier -->
  3066. <!-- start class org.apache.hadoop.hdfs.HsftpFileSystem.DummyTrustManager -->
  3067. <class name="HsftpFileSystem.DummyTrustManager" extends="java.lang.Object"
  3068. abstract="false"
  3069. static="true" final="false" visibility="protected"
  3070. deprecated="not deprecated">
  3071. <implements name="javax.net.ssl.X509TrustManager"/>
  3072. <constructor name="HsftpFileSystem.DummyTrustManager"
  3073. static="false" final="false" visibility="protected"
  3074. deprecated="not deprecated">
  3075. </constructor>
  3076. <method name="checkClientTrusted"
  3077. abstract="false" native="false" synchronized="false"
  3078. static="false" final="false" visibility="public"
  3079. deprecated="not deprecated">
  3080. <param name="chain" type="java.security.cert.X509Certificate[]"/>
  3081. <param name="authType" type="java.lang.String"/>
  3082. </method>
  3083. <method name="checkServerTrusted"
  3084. abstract="false" native="false" synchronized="false"
  3085. static="false" final="false" visibility="public"
  3086. deprecated="not deprecated">
  3087. <param name="chain" type="java.security.cert.X509Certificate[]"/>
  3088. <param name="authType" type="java.lang.String"/>
  3089. </method>
  3090. <method name="getAcceptedIssuers" return="java.security.cert.X509Certificate[]"
  3091. abstract="false" native="false" synchronized="false"
  3092. static="false" final="false" visibility="public"
  3093. deprecated="not deprecated">
  3094. </method>
  3095. <doc>
  3096. <![CDATA[Dummy trustmanager that is used to trust all server certificates]]>
  3097. </doc>
  3098. </class>
  3099. <!-- end class org.apache.hadoop.hdfs.HsftpFileSystem.DummyTrustManager -->
  3100. <doc>
  3101. <![CDATA[<p>A distributed implementation of {@link
  3102. org.apache.hadoop.fs.FileSystem}. This is loosely modelled after
  3103. Google's <a href="http://labs.google.com/papers/gfs.html">GFS</a>.</p>
  3104. <p>The most important difference is that unlike GFS, Hadoop DFS files
  3105. have strictly one writer at any one time. Bytes are always appended
  3106. to the end of the writer's stream. There is no notion of "record appends"
  3107. or "mutations" that are then checked or reordered. Writers simply emit
  3108. a byte stream. That byte stream is guaranteed to be stored in the
  3109. order written.</p>]]>
  3110. </doc>
  3111. </package>
  3112. <package name="org.apache.hadoop.hdfs.protocol">
  3113. <!-- start class org.apache.hadoop.hdfs.protocol.AlreadyBeingCreatedException -->
  3114. <class name="AlreadyBeingCreatedException" extends="java.io.IOException"
  3115. abstract="false"
  3116. static="false" final="false" visibility="public"
  3117. deprecated="not deprecated">
  3118. <constructor name="AlreadyBeingCreatedException" type="java.lang.String"
  3119. static="false" final="false" visibility="public"
  3120. deprecated="not deprecated">
  3121. </constructor>
  3122. <doc>
  3123. <![CDATA[The exception that happens when you ask to create a file that already
  3124. is being created, but is not closed yet.]]>
  3125. </doc>
  3126. </class>
  3127. <!-- end class org.apache.hadoop.hdfs.protocol.AlreadyBeingCreatedException -->
  3128. <!-- start class org.apache.hadoop.hdfs.protocol.Block -->
  3129. <class name="Block" extends="java.lang.Object"
  3130. abstract="false"
  3131. static="false" final="false" visibility="public"
  3132. deprecated="not deprecated">
  3133. <implements name="org.apache.hadoop.io.Writable"/>
  3134. <implements name="java.lang.Comparable"/>
  3135. <constructor name="Block"
  3136. static="false" final="false" visibility="public"
  3137. deprecated="not deprecated">
  3138. </constructor>
  3139. <constructor name="Block" type="long, long, long"
  3140. static="false" final="false" visibility="public"
  3141. deprecated="not deprecated">
  3142. </constructor>
  3143. <constructor name="Block" type="long"
  3144. static="false" final="false" visibility="public"
  3145. deprecated="not deprecated">
  3146. </constructor>
  3147. <constructor name="Block" type="org.apache.hadoop.hdfs.protocol.Block"
  3148. static="false" final="false" visibility="public"
  3149. deprecated="not deprecated">
  3150. </constructor>
  3151. <constructor name="Block" type="java.io.File, long, long"
  3152. static="false" final="false" visibility="public"
  3153. deprecated="not deprecated">
  3154. <doc>
  3155. <![CDATA[Find the blockid from the given filename]]>
  3156. </doc>
  3157. </constructor>
  3158. <method name="isBlockFilename" return="boolean"
  3159. abstract="false" native="false" synchronized="false"
  3160. static="true" final="false" visibility="public"
  3161. deprecated="not deprecated">
  3162. <param name="f" type="java.io.File"/>
  3163. </method>
  3164. <method name="filename2id" return="long"
  3165. abstract="false" native="false" synchronized="false"
  3166. static="true" final="false" visibility="public"
  3167. deprecated="not deprecated">
  3168. <param name="name" type="java.lang.String"/>
  3169. </method>
  3170. <method name="isMetaFilename" return="boolean"
  3171. abstract="false" native="false" synchronized="false"
  3172. static="true" final="false" visibility="public"
  3173. deprecated="not deprecated">
  3174. <param name="name" type="java.lang.String"/>
  3175. </method>
  3176. <method name="getGenerationStamp" return="long"
  3177. abstract="false" native="false" synchronized="false"
  3178. static="true" final="false" visibility="public"
  3179. deprecated="not deprecated">
  3180. <param name="metaFile" type="java.lang.String"/>
  3181. <doc>
  3182. <![CDATA[Get generation stamp from the name of the metafile name]]>
  3183. </doc>
  3184. </method>
  3185. <method name="getBlockId" return="long"
  3186. abstract="false" native="false" synchronized="false"
  3187. static="true" final="false" visibility="public"
  3188. deprecated="not deprecated">
  3189. <param name="metaFile" type="java.lang.String"/>
  3190. <doc>
  3191. <![CDATA[Get the blockId from the name of the metafile name]]>
  3192. </doc>
  3193. </method>
  3194. <method name="set"
  3195. abstract="false" native="false" synchronized="false"
  3196. static="false" final="false" visibility="public"
  3197. deprecated="not deprecated">
  3198. <param name="blkid" type="long"/>
  3199. <param name="len" type="long"/>
  3200. <param name="genStamp" type="long"/>
  3201. </method>
  3202. <method name="getBlockId" return="long"
  3203. abstract="false" native="false" synchronized="false"
  3204. static="false" final="false" visibility="public"
  3205. deprecated="not deprecated">
  3206. </method>
  3207. <method name="setBlockId"
  3208. abstract="false" native="false" synchronized="false"
  3209. static="false" final="false" visibility="public"
  3210. deprecated="not deprecated">
  3211. <param name="bid" type="long"/>
  3212. </method>
  3213. <method name="getBlockName" return="java.lang.String"
  3214. abstract="false" native="false" synchronized="false"
  3215. static="false" final="false" visibility="public"
  3216. deprecated="not deprecated">
  3217. </method>
  3218. <method name="getNumBytes" return="long"
  3219. abstract="false" native="false" synchronized="false"
  3220. static="false" final="false" visibility="public"
  3221. deprecated="not deprecated">
  3222. </method>
  3223. <method name="setNumBytes"
  3224. abstract="false" native="false" synchronized="false"
  3225. static="false" final="false" visibility="public"
  3226. deprecated="not deprecated">
  3227. <param name="len" type="long"/>
  3228. </method>
  3229. <method name="getGenerationStamp" return="long"
  3230. abstract="false" native="false" synchronized="false"
  3231. static="false" final="false" visibility="public"
  3232. deprecated="not deprecated">
  3233. </method>
  3234. <method name="setGenerationStamp"
  3235. abstract="false" native="false" synchronized="false"
  3236. static="false" final="false" visibility="public"
  3237. deprecated="not deprecated">
  3238. <param name="stamp" type="long"/>
  3239. </method>
  3240. <method name="toString" return="java.lang.String"
  3241. abstract="false" native="false" synchronized="false"
  3242. static="false" final="false" visibility="public"
  3243. deprecated="not deprecated">
  3244. </method>
  3245. <method name="write"
  3246. abstract="false" native="false" synchronized="false"
  3247. static="false" final="false" visibility="public"
  3248. deprecated="not deprecated">
  3249. <param name="out" type="java.io.DataOutput"/>
  3250. <exception name="IOException" type="java.io.IOException"/>
  3251. </method>
  3252. <method name="readFields"
  3253. abstract="false" native="false" synchronized="false"
  3254. static="false" final="false" visibility="public"
  3255. deprecated="not deprecated">
  3256. <param name="in" type="java.io.DataInput"/>
  3257. <exception name="IOException" type="java.io.IOException"/>
  3258. </method>
  3259. <method name="compareTo" return="int"
  3260. abstract="false" native="false" synchronized="false"
  3261. static="false" final="false" visibility="public"
  3262. deprecated="not deprecated">
  3263. <param name="b" type="org.apache.hadoop.hdfs.protocol.Block"/>
  3264. </method>
  3265. <method name="equals" return="boolean"
  3266. abstract="false" native="false" synchronized="false"
  3267. static="false" final="false" visibility="public"
  3268. deprecated="not deprecated">
  3269. <param name="o" type="java.lang.Object"/>
  3270. </method>
  3271. <method name="hashCode" return="int"
  3272. abstract="false" native="false" synchronized="false"
  3273. static="false" final="false" visibility="public"
  3274. deprecated="not deprecated">
  3275. </method>
  3276. <field name="BLOCK_FILE_PREFIX" type="java.lang.String"
  3277. transient="false" volatile="false"
  3278. static="true" final="true" visibility="public"
  3279. deprecated="not deprecated">
  3280. </field>
  3281. <field name="METADATA_EXTENSION" type="java.lang.String"
  3282. transient="false" volatile="false"
  3283. static="true" final="true" visibility="public"
  3284. deprecated="not deprecated">
  3285. </field>
  3286. <field name="blockFilePattern" type="java.util.regex.Pattern"
  3287. transient="false" volatile="false"
  3288. static="true" final="true" visibility="public"
  3289. deprecated="not deprecated">
  3290. </field>
  3291. <field name="metaFilePattern" type="java.util.regex.Pattern"
  3292. transient="false" volatile="false"
  3293. static="true" final="true" visibility="public"
  3294. deprecated="not deprecated">
  3295. </field>
  3296. <doc>
  3297. <![CDATA[A Block is a Hadoop FS primitive, identified by a
  3298. long.]]>
  3299. </doc>
  3300. </class>
  3301. <!-- end class org.apache.hadoop.hdfs.protocol.Block -->
  3302. <!-- start class org.apache.hadoop.hdfs.protocol.BlockListAsLongs -->
  3303. <class name="BlockListAsLongs" extends="java.lang.Object"
  3304. abstract="false"
  3305. static="false" final="false" visibility="public"
  3306. deprecated="not deprecated">
  3307. <implements name="java.lang.Iterable"/>
  3308. <constructor name="BlockListAsLongs" type="java.util.List, java.util.List"
  3309. static="false" final="false" visibility="public"
  3310. deprecated="not deprecated">
  3311. <doc>
  3312. <![CDATA[Create block report from finalized and under construction lists of blocks.
  3313. @param finalized - list of finalized blocks
  3314. @param uc - list of under construction blocks]]>
  3315. </doc>
  3316. </constructor>
  3317. <constructor name="BlockListAsLongs"
  3318. static="false" final="false" visibility="public"
  3319. deprecated="not deprecated">
  3320. </constructor>
  3321. <constructor name="BlockListAsLongs" type="long[]"
  3322. static="false" final="false" visibility="public"
  3323. deprecated="not deprecated">
  3324. <doc>
  3325. <![CDATA[Constructor
  3326. @param iBlockList - BlockListALongs create from this long[] parameter]]>
  3327. </doc>
  3328. </constructor>
  3329. <method name="getBlockListAsLongs" return="long[]"
  3330. abstract="false" native="false" synchronized="false"
  3331. static="false" final="false" visibility="public"
  3332. deprecated="not deprecated">
  3333. </method>
  3334. <method name="iterator" return="java.util.Iterator"
  3335. abstract="false" native="false" synchronized="false"
  3336. static="false" final="false" visibility="public"
  3337. deprecated="not deprecated">
  3338. <doc>
  3339. <![CDATA[Returns an iterator over blocks in the block report.]]>
  3340. </doc>
  3341. </method>
  3342. <method name="getBlockReportIterator" return="org.apache.hadoop.hdfs.protocol.BlockListAsLongs.BlockReportIterator"
  3343. abstract="false" native="false" synchronized="false"
  3344. static="false" final="false" visibility="public"
  3345. deprecated="not deprecated">
  3346. <doc>
  3347. <![CDATA[Returns {@link BlockReportIterator}.]]>
  3348. </doc>
  3349. </method>
  3350. <method name="getNumberOfBlocks" return="int"
  3351. abstract="false" native="false" synchronized="false"
  3352. static="false" final="false" visibility="public"
  3353. deprecated="not deprecated">
  3354. <doc>
  3355. <![CDATA[The number of blocks
  3356. @return - the number of blocks]]>
  3357. </doc>
  3358. </method>
  3359. <method name="getBlockId" return="long"
  3360. abstract="false" native="false" synchronized="false"
  3361. static="false" final="false" visibility="public"
  3362. deprecated="not deprecated">
  3363. <param name="index" type="int"/>
  3364. <doc>
  3365. <![CDATA[The block-id of the indexTh block
  3366. @param index - the block whose block-id is desired
  3367. @return the block-id]]>
  3368. </doc>
  3369. </method>
  3370. <method name="getBlockLen" return="long"
  3371. abstract="false" native="false" synchronized="false"
  3372. static="false" final="false" visibility="public"
  3373. deprecated="not deprecated">
  3374. <param name="index" type="int"/>
  3375. <doc>
  3376. <![CDATA[The block-len of the indexTh block
  3377. @param index - the block whose block-len is desired
  3378. @return - the block-len]]>
  3379. </doc>
  3380. </method>
  3381. <method name="getBlockGenStamp" return="long"
  3382. abstract="false" native="false" synchronized="false"
  3383. static="false" final="false" visibility="public"
  3384. deprecated="not deprecated">
  3385. <param name="index" type="int"/>
  3386. <doc>
  3387. <![CDATA[The generation stamp of the indexTh block
  3388. @param index - the block whose block-len is desired
  3389. @return - the generation stamp]]>
  3390. </doc>
  3391. </method>
  3392. <doc>
  3393. <![CDATA[This class provides an interface for accessing list of blocks that
  3394. has been implemented as long[].
  3395. This class is useful for block report. Rather than send block reports
  3396. as a Block[] we can send it as a long[].
  3397. The structure of the array is as follows:
  3398. 0: the length of the finalized replica list;
  3399. 1: the length of the under-construction replica list;
  3400. - followed by finalized replica list where each replica is represented by
  3401. 3 longs: one for the blockId, one for the block length, and one for
  3402. the generation stamp;
  3403. - followed by the invalid replica represented with three -1s;
  3404. - followed by the under-construction replica list where each replica is
  3405. represented by 4 longs: three for the block id, length, generation
  3406. stamp, and the forth for the replica state.]]>
  3407. </doc>
  3408. </class>
  3409. <!-- end class org.apache.hadoop.hdfs.protocol.BlockListAsLongs -->
  3410. <!-- start class org.apache.hadoop.hdfs.protocol.BlockListAsLongs.BlockReportIterator -->
  3411. <class name="BlockListAsLongs.BlockReportIterator" extends="java.lang.Object"
  3412. abstract="false"
  3413. static="false" final="false" visibility="public"
  3414. deprecated="not deprecated">
  3415. <implements name="java.util.Iterator"/>
  3416. <method name="hasNext" return="boolean"
  3417. abstract="false" native="false" synchronized="false"
  3418. static="false" final="false" visibility="public"
  3419. deprecated="not deprecated">
  3420. </method>
  3421. <method name="next" return="org.apache.hadoop.hdfs.protocol.Block"
  3422. abstract="false" native="false" synchronized="false"
  3423. static="false" final="false" visibility="public"
  3424. deprecated="not deprecated">
  3425. </method>
  3426. <method name="remove"
  3427. abstract="false" native="false" synchronized="false"
  3428. static="false" final="false" visibility="public"
  3429. deprecated="not deprecated">
  3430. </method>
  3431. <method name="getCurrentReplicaState" return="org.apache.hadoop.hdfs.server.common.HdfsConstants.ReplicaState"
  3432. abstract="false" native="false" synchronized="false"
  3433. static="false" final="false" visibility="public"
  3434. deprecated="not deprecated">
  3435. <doc>
  3436. <![CDATA[Get the state of the current replica.
  3437. The state corresponds to the replica returned
  3438. by the latest {@link #next()}.]]>
  3439. </doc>
  3440. </method>
  3441. <doc>
  3442. <![CDATA[Iterates over blocks in the block report.
  3443. Avoids object allocation on each iteration.]]>
  3444. </doc>
  3445. </class>
  3446. <!-- end class org.apache.hadoop.hdfs.protocol.BlockListAsLongs.BlockReportIterator -->
  3447. <!-- start interface org.apache.hadoop.hdfs.protocol.ClientDatanodeProtocol -->
  3448. <interface name="ClientDatanodeProtocol" abstract="true"
  3449. static="false" final="false" visibility="public"
  3450. deprecated="not deprecated">
  3451. <implements name="org.apache.hadoop.ipc.VersionedProtocol"/>
  3452. <method name="getReplicaVisibleLength" return="long"
  3453. abstract="false" native="false" synchronized="false"
  3454. static="false" final="false" visibility="public"
  3455. deprecated="not deprecated">
  3456. <param name="b" type="org.apache.hadoop.hdfs.protocol.Block"/>
  3457. <exception name="IOException" type="java.io.IOException"/>
  3458. <doc>
  3459. <![CDATA[Return the visible length of a replica.]]>
  3460. </doc>
  3461. </method>
  3462. <field name="LOG" type="org.apache.commons.logging.Log"
  3463. transient="false" volatile="false"
  3464. static="true" final="true" visibility="public"
  3465. deprecated="not deprecated">
  3466. </field>
  3467. <field name="versionID" type="long"
  3468. transient="false" volatile="false"
  3469. static="true" final="true" visibility="public"
  3470. deprecated="not deprecated">
  3471. <doc>
  3472. <![CDATA[6: recoverBlock() removed.]]>
  3473. </doc>
  3474. </field>
  3475. <doc>
  3476. <![CDATA[An client-datanode protocol for block recovery]]>
  3477. </doc>
  3478. </interface>
  3479. <!-- end interface org.apache.hadoop.hdfs.protocol.ClientDatanodeProtocol -->
  3480. <!-- start interface org.apache.hadoop.hdfs.protocol.ClientProtocol -->
  3481. <interface name="ClientProtocol" abstract="true"
  3482. static="false" final="false" visibility="public"
  3483. deprecated="not deprecated">
  3484. <implements name="org.apache.hadoop.ipc.VersionedProtocol"/>
  3485. <method name="getBlockLocations" return="org.apache.hadoop.hdfs.protocol.LocatedBlocks"
  3486. abstract="false" native="false" synchronized="false"
  3487. static="false" final="false" visibility="public"
  3488. deprecated="not deprecated">
  3489. <param name="src" type="java.lang.String"/>
  3490. <param name="offset" type="long"/>
  3491. <param name="length" type="long"/>
  3492. <exception name="IOException" type="java.io.IOException"/>
  3493. <exception name="UnresolvedLinkException" type="org.apache.hadoop.fs.UnresolvedLinkException"/>
  3494. <exception name="FileNotFoundException" type="java.io.FileNotFoundException"/>
  3495. <doc>
  3496. <![CDATA[Get locations of the blocks of the specified file within the specified range.
  3497. DataNode locations for each block are sorted by
  3498. the proximity to the client.
  3499. <p>
  3500. Return {@link LocatedBlocks} which contains
  3501. file length, blocks and their locations.
  3502. DataNode locations for each block are sorted by
  3503. the distance to the client's address.
  3504. <p>
  3505. The client will then have to contact
  3506. one of the indicated DataNodes to obtain the actual data.
  3507. @param src file name
  3508. @param offset range start offset
  3509. @param length range length
  3510. @return file length and array of blocks with their locations
  3511. @throws IOException
  3512. @throws UnresolvedLinkException if the path contains a symlink.
  3513. @throws FileNotFoundException if the path does not exist.]]>
  3514. </doc>
  3515. </method>
  3516. <method name="getServerDefaults" return="org.apache.hadoop.fs.FsServerDefaults"
  3517. abstract="false" native="false" synchronized="false"
  3518. static="false" final="false" visibility="public"
  3519. deprecated="not deprecated">
  3520. <exception name="IOException" type="java.io.IOException"/>
  3521. <doc>
  3522. <![CDATA[Get server default values for a number of configuration params.
  3523. @return a set of server default configuration values
  3524. @throws IOException]]>
  3525. </doc>
  3526. </method>
  3527. <method name="create"
  3528. abstract="false" native="false" synchronized="false"
  3529. static="false" final="false" visibility="public"
  3530. deprecated="not deprecated">
  3531. <param name="src" type="java.lang.String"/>
  3532. <param name="masked" type="org.apache.hadoop.fs.permission.FsPermission"/>
  3533. <param name="clientName" type="java.lang.String"/>
  3534. <param name="flag" type="org.apache.hadoop.io.EnumSetWritable"/>
  3535. <param name="createParent" type="boolean"/>
  3536. <param name="replication" type="short"/>
  3537. <param name="blockSize" type="long"/>
  3538. <exception name="IOException" type="java.io.IOException"/>
  3539. <exception name="UnresolvedLinkException" type="org.apache.hadoop.fs.UnresolvedLinkException"/>
  3540. <exception name="AlreadyBeingCreatedException" type="org.apache.hadoop.hdfs.protocol.AlreadyBeingCreatedException"/>
  3541. <exception name="NSQuotaExceededException" type="org.apache.hadoop.hdfs.protocol.NSQuotaExceededException"/>
  3542. <doc>
  3543. <![CDATA[Create a new file entry in the namespace.
  3544. <p>
  3545. This will create an empty file specified by the source path.
  3546. The path should reflect a full path originated at the root.
  3547. The name-node does not have a notion of "current" directory for a client.
  3548. <p>
  3549. Once created, the file is visible and available for read to other clients.
  3550. Although, other clients cannot {@link #delete(String, boolean)}, re-create or
  3551. {@link #rename(String, String)} it until the file is completed
  3552. or explicitly as a result of lease expiration.
  3553. <p>
  3554. Blocks have a maximum size. Clients that intend to create
  3555. multi-block files must also use {@link #addBlock(String, String, Block, DatanodeInfo[])}.
  3556. @param src path of the file being created.
  3557. @param masked masked permission.
  3558. @param clientName name of the current client.
  3559. @param flag indicates whether the file should be
  3560. overwritten if it already exists or create if it does not exist or append.
  3561. @param createParent create missing parent directory if true
  3562. @param replication block replication factor.
  3563. @param blockSize maximum block size.
  3564. @throws AccessControlException if permission to create file is
  3565. denied by the system. As usually on the client side the exception will
  3566. be wrapped into {@link org.apache.hadoop.ipc.RemoteException}.
  3567. @throws QuotaExceededException if the file creation violates
  3568. any quota restriction
  3569. @throws IOException if other errors occur.
  3570. @throws UnresolvedLinkException if the path contains a symlink.
  3571. @throws AlreadyBeingCreatedException if the path does not exist.
  3572. @throws NSQuotaExceededException if the namespace quota is exceeded.]]>
  3573. </doc>
  3574. </method>
  3575. <method name="append" return="org.apache.hadoop.hdfs.protocol.LocatedBlock"
  3576. abstract="false" native="false" synchronized="false"
  3577. static="false" final="false" visibility="public"
  3578. deprecated="not deprecated">
  3579. <param name="src" type="java.lang.String"/>
  3580. <param name="clientName" type="java.lang.String"/>
  3581. <exception name="IOException" type="java.io.IOException"/>
  3582. <exception name="UnresolvedLinkException" type="org.apache.hadoop.fs.UnresolvedLinkException"/>
  3583. <doc>
  3584. <![CDATA[Append to the end of the file.
  3585. @param src path of the file being created.
  3586. @param clientName name of the current client.
  3587. @return information about the last partial block if any.
  3588. @throws AccessControlException if permission to append file is
  3589. denied by the system. As usually on the client side the exception will
  3590. be wrapped into {@link org.apache.hadoop.ipc.RemoteException}.
  3591. Allows appending to an existing file if the server is
  3592. configured with the parameter dfs.support.append set to true, otherwise
  3593. throws an IOException.
  3594. @throws IOException if other errors occur.
  3595. @throws UnresolvedLinkException if the path contains a symlink.]]>
  3596. </doc>
  3597. </method>
  3598. <method name="setReplication" return="boolean"
  3599. abstract="false" native="false" synchronized="false"
  3600. static="false" final="false" visibility="public"
  3601. deprecated="not deprecated">
  3602. <param name="src" type="java.lang.String"/>
  3603. <param name="replication" type="short"/>
  3604. <exception name="IOException" type="java.io.IOException"/>
  3605. <exception name="UnresolvedLinkException" type="org.apache.hadoop.fs.UnresolvedLinkException"/>
  3606. <doc>
  3607. <![CDATA[Set replication for an existing file.
  3608. <p>
  3609. The NameNode sets replication to the new value and returns.
  3610. The actual block replication is not expected to be performed during
  3611. this method call. The blocks will be populated or removed in the
  3612. background as the result of the routine block maintenance procedures.
  3613. @param src file name
  3614. @param replication new replication
  3615. @throws IOException
  3616. @return true if successful;
  3617. false if file does not exist or is a directory
  3618. @throws UnresolvedLinkException if the path contains a symlink.]]>
  3619. </doc>
  3620. </method>
  3621. <method name="setPermission"
  3622. abstract="false" native="false" synchronized="false"
  3623. static="false" final="false" visibility="public"
  3624. deprecated="not deprecated">
  3625. <param name="src" type="java.lang.String"/>
  3626. <param name="permission" type="org.apache.hadoop.fs.permission.FsPermission"/>
  3627. <exception name="IOException" type="java.io.IOException"/>
  3628. <exception name="UnresolvedLinkException" type="org.apache.hadoop.fs.UnresolvedLinkException"/>
  3629. <exception name="SafeModeException" type="org.apache.hadoop.hdfs.server.namenode.SafeModeException"/>
  3630. <doc>
  3631. <![CDATA[Set permissions for an existing file/directory.
  3632. @throws UnresolvedLinkException if the path contains a symlink.]]>
  3633. </doc>
  3634. </method>
  3635. <method name="setOwner"
  3636. abstract="false" native="false" synchronized="false"
  3637. static="false" final="false" visibility="public"
  3638. deprecated="not deprecated">
  3639. <param name="src" type="java.lang.String"/>
  3640. <param name="username" type="java.lang.String"/>
  3641. <param name="groupname" type="java.lang.String"/>
  3642. <exception name="IOException" type="java.io.IOException"/>
  3643. <exception name="UnresolvedLinkException" type="org.apache.hadoop.fs.UnresolvedLinkException"/>
  3644. <doc>
  3645. <![CDATA[Set Owner of a path (i.e. a file or a directory).
  3646. The parameters username and groupname cannot both be null.
  3647. @param src
  3648. @param username If it is null, the original username remains unchanged.
  3649. @param groupname If it is null, the original groupname remains unchanged.
  3650. @throws UnresolvedLinkException if the path contains a symlink.]]>
  3651. </doc>
  3652. </method>
  3653. <method name="abandonBlock"
  3654. abstract="false" native="false" synchronized="false"
  3655. static="false" final="false" visibility="public"
  3656. deprecated="not deprecated">
  3657. <param name="b" type="org.apache.hadoop.hdfs.protocol.Block"/>
  3658. <param name="src" type="java.lang.String"/>
  3659. <param name="holder" type="java.lang.String"/>
  3660. <exception name="IOException" type="java.io.IOException"/>
  3661. <exception name="UnresolvedLinkException" type="org.apache.hadoop.fs.UnresolvedLinkException"/>
  3662. <doc>
  3663. <![CDATA[The client can give up on a block by calling abandonBlock().
  3664. The client can then either obtain a new block, or complete or
  3665. abandon the file. Any partial writes to the block will be discarded.
  3666. @throws UnresolvedLinkException if the path contains a symlink.]]>
  3667. </doc>
  3668. </method>
  3669. <method name="addBlock" return="org.apache.hadoop.hdfs.protocol.LocatedBlock"
  3670. abstract="false" native="false" synchronized="false"
  3671. static="false" final="false" visibility="public"
  3672. deprecated="not deprecated">
  3673. <param name="src" type="java.lang.String"/>
  3674. <param name="clientName" type="java.lang.String"/>
  3675. <param name="previous" type="org.apache.hadoop.hdfs.protocol.Block"/>
  3676. <param name="excludedNodes" type="org.apache.hadoop.hdfs.protocol.DatanodeInfo[]"/>
  3677. <exception name="IOException" type="java.io.IOException"/>
  3678. <exception name="UnresolvedLinkException" type="org.apache.hadoop.fs.UnresolvedLinkException"/>
  3679. <exception name="DSQuotaExceededException" type="org.apache.hadoop.hdfs.protocol.DSQuotaExceededException"/>
  3680. <doc>
  3681. <![CDATA[A client that wants to write an additional block to the
  3682. indicated filename (which must currently be open for writing)
  3683. should call addBlock().
  3684. addBlock() allocates a new block and datanodes the block data
  3685. should be replicated to.
  3686. addBlock() also commits the previous block by reporting
  3687. to the name-node the actual generation stamp and the length
  3688. of the block that the client has transmitted to data-nodes.
  3689. @param src the file being created
  3690. @param clientName the name of the client that adds the block
  3691. @param previous previous block
  3692. @param excludedNodes a list of nodes that should not be
  3693. allocated for the current block
  3694. @return LocatedBlock allocated block information.
  3695. @throws UnresolvedLinkException if the path contains a symlink.
  3696. @throws DSQuotaExceededException if the directory's quota is exceeded.]]>
  3697. </doc>
  3698. </method>
  3699. <method name="complete" return="boolean"
  3700. abstract="false" native="false" synchronized="false"
  3701. static="false" final="false" visibility="public"
  3702. deprecated="not deprecated">
  3703. <param name="src" type="java.lang.String"/>
  3704. <param name="clientName" type="java.lang.String"/>
  3705. <param name="last" type="org.apache.hadoop.hdfs.protocol.Block"/>
  3706. <exception name="IOException" type="java.io.IOException"/>
  3707. <exception name="UnresolvedLinkException" type="org.apache.hadoop.fs.UnresolvedLinkException"/>
  3708. <doc>
  3709. <![CDATA[The client is done writing data to the given filename, and would
  3710. like to complete it.
  3711. The function returns whether the file has been closed successfully.
  3712. If the function returns false, the caller should try again.
  3713. close() also commits the last block of the file by reporting
  3714. to the name-node the actual generation stamp and the length
  3715. of the block that the client has transmitted to data-nodes.
  3716. A call to complete() will not return true until all the file's
  3717. blocks have been replicated the minimum number of times. Thus,
  3718. DataNode failures may cause a client to call complete() several
  3719. times before succeeding.
  3720. @throws UnresolvedLinkException if the path contains a symlink.]]>
  3721. </doc>
  3722. </method>
  3723. <method name="reportBadBlocks"
  3724. abstract="false" native="false" synchronized="false"
  3725. static="false" final="false" visibility="public"
  3726. deprecated="not deprecated">
  3727. <param name="blocks" type="org.apache.hadoop.hdfs.protocol.LocatedBlock[]"/>
  3728. <exception name="IOException" type="java.io.IOException"/>
  3729. <doc>
  3730. <![CDATA[The client wants to report corrupted blocks (blocks with specified
  3731. locations on datanodes).
  3732. @param blocks Array of located blocks to report]]>
  3733. </doc>
  3734. </method>
  3735. <method name="rename" return="boolean"
  3736. abstract="false" native="false" synchronized="false"
  3737. static="false" final="false" visibility="public"
  3738. deprecated="Use {@link #rename(String, String, Options.Rename...)} instead.">
  3739. <param name="src" type="java.lang.String"/>
  3740. <param name="dst" type="java.lang.String"/>
  3741. <exception name="IOException" type="java.io.IOException"/>
  3742. <exception name="UnresolvedLinkException" type="org.apache.hadoop.fs.UnresolvedLinkException"/>
  3743. <doc>
  3744. <![CDATA[Rename an item in the file system namespace.
  3745. @param src existing file or directory name.
  3746. @param dst new name.
  3747. @return true if successful, or false if the old name does not exist
  3748. or if the new name already belongs to the namespace.
  3749. @throws IOException if the new name is invalid.
  3750. @throws UnresolvedLinkException if the path contains a symlink.
  3751. @throws QuotaExceededException if the rename would violate
  3752. any quota restriction
  3753. @deprecated Use {@link #rename(String, String, Options.Rename...)} instead.]]>
  3754. </doc>
  3755. </method>
  3756. <method name="concat"
  3757. abstract="false" native="false" synchronized="false"
  3758. static="false" final="false" visibility="public"
  3759. deprecated="not deprecated">
  3760. <param name="trg" type="java.lang.String"/>
  3761. <param name="srcs" type="java.lang.String[]"/>
  3762. <exception name="IOException" type="java.io.IOException"/>
  3763. <exception name="UnresolvedLinkException" type="org.apache.hadoop.fs.UnresolvedLinkException"/>
  3764. <doc>
  3765. <![CDATA[Moves blocks from srcs to trg and delete srcs
  3766. @param trg existing file
  3767. @param srcs - list of existing files (same block size, same replication)
  3768. @throws IOException if some arguments are invalid
  3769. @throws UnresolvedLinkException if the path contains a symlink.
  3770. @throws QuotaExceededException if the rename would violate
  3771. any quota restriction]]>
  3772. </doc>
  3773. </method>
  3774. <method name="rename"
  3775. abstract="false" native="false" synchronized="false"
  3776. static="false" final="false" visibility="public"
  3777. deprecated="not deprecated">
  3778. <param name="src" type="java.lang.String"/>
  3779. <param name="dst" type="java.lang.String"/>
  3780. <param name="options" type="org.apache.hadoop.fs.Options.Rename[]"/>
  3781. <exception name="IOException" type="java.io.IOException"/>
  3782. <exception name="UnresolvedLinkException" type="org.apache.hadoop.fs.UnresolvedLinkException"/>
  3783. <doc>
  3784. <![CDATA[Rename src to dst.
  3785. <ul>
  3786. <li>Fails if src is a file and dst is a directory.
  3787. <li>Fails if src is a directory and dst is a file.
  3788. <li>Fails if the parent of dst does not exist or is a file.
  3789. </ul>
  3790. <p>
  3791. Without OVERWRITE option, rename fails if the dst already exists.
  3792. With OVERWRITE option, rename overwrites the dst, if it is a file
  3793. or an empty directory. Rename fails if dst is a non-empty directory.
  3794. <p>
  3795. This implementation of rename is atomic.
  3796. <p>
  3797. @param src existing file or directory name.
  3798. @param dst new name.
  3799. @param options Rename options
  3800. @throws IOException if rename failed
  3801. @throws UnresolvedLinkException if the path contains a symlink.]]>
  3802. </doc>
  3803. </method>
  3804. <method name="delete" return="boolean"
  3805. abstract="false" native="false" synchronized="false"
  3806. static="false" final="false" visibility="public"
  3807. deprecated="use {@link #delete(String, boolean)} istead.">
  3808. <param name="src" type="java.lang.String"/>
  3809. <exception name="IOException" type="java.io.IOException"/>
  3810. <exception name="UnresolvedLinkException" type="org.apache.hadoop.fs.UnresolvedLinkException"/>
  3811. <doc>
  3812. <![CDATA[Delete the given file or directory from the file system.
  3813. <p>
  3814. Any blocks belonging to the deleted files will be garbage-collected.
  3815. @param src existing name.
  3816. @return true only if the existing file or directory was actually removed
  3817. from the file system.
  3818. @throws UnresolvedLinkException if the path contains a symlink.
  3819. @deprecated use {@link #delete(String, boolean)} istead.]]>
  3820. </doc>
  3821. </method>
  3822. <method name="delete" return="boolean"
  3823. abstract="false" native="false" synchronized="false"
  3824. static="false" final="false" visibility="public"
  3825. deprecated="not deprecated">
  3826. <param name="src" type="java.lang.String"/>
  3827. <param name="recursive" type="boolean"/>
  3828. <exception name="IOException" type="java.io.IOException"/>
  3829. <exception name="UnresolvedLinkException" type="org.apache.hadoop.fs.UnresolvedLinkException"/>
  3830. <doc>
  3831. <![CDATA[Delete the given file or directory from the file system.
  3832. <p>
  3833. same as delete but provides a way to avoid accidentally
  3834. deleting non empty directories programmatically.
  3835. @param src existing name
  3836. @param recursive if true deletes a non empty directory recursively,
  3837. else throws an exception.
  3838. @return true only if the existing file or directory was actually removed
  3839. from the file system.
  3840. @throws UnresolvedLinkException if the path contains a symlink.]]>
  3841. </doc>
  3842. </method>
  3843. <method name="mkdirs" return="boolean"
  3844. abstract="false" native="false" synchronized="false"
  3845. static="false" final="false" visibility="public"
  3846. deprecated="not deprecated">
  3847. <param name="src" type="java.lang.String"/>
  3848. <param name="masked" type="org.apache.hadoop.fs.permission.FsPermission"/>
  3849. <param name="createParent" type="boolean"/>
  3850. <exception name="IOException" type="java.io.IOException"/>
  3851. <exception name="UnresolvedLinkException" type="org.apache.hadoop.fs.UnresolvedLinkException"/>
  3852. <exception name="NSQuotaExceededException" type="org.apache.hadoop.hdfs.protocol.NSQuotaExceededException"/>
  3853. <doc>
  3854. <![CDATA[Create a directory (or hierarchy of directories) with the given
  3855. name and permission.
  3856. @param src The path of the directory being created
  3857. @param masked The masked permission of the directory being created
  3858. @param createParent create missing parent directory if true
  3859. @return True if the operation success.
  3860. @throws UnresolvedLinkException if the path contains a symlink.
  3861. @throws {@link AccessControlException} if permission to create file is
  3862. denied by the system. As usually on the client side the exception will
  3863. be wraped into {@link org.apache.hadoop.ipc.RemoteException}.
  3864. @throws QuotaExceededException if the operation would violate
  3865. any quota restriction.]]>
  3866. </doc>
  3867. </method>
  3868. <method name="getListing" return="org.apache.hadoop.hdfs.protocol.DirectoryListing"
  3869. abstract="false" native="false" synchronized="false"
  3870. static="false" final="false" visibility="public"
  3871. deprecated="not deprecated">
  3872. <param name="src" type="java.lang.String"/>
  3873. <param name="startAfter" type="byte[]"/>
  3874. <exception name="IOException" type="java.io.IOException"/>
  3875. <exception name="UnresolvedLinkException" type="org.apache.hadoop.fs.UnresolvedLinkException"/>
  3876. <doc>
  3877. <![CDATA[Get a partial listing of the indicated directory
  3878. @param src the directory name
  3879. @param startAfter the name to start listing after encoded in java UTF8
  3880. @return a partial listing starting after startAfter
  3881. @throws UnresolvedLinkException if the path contains a symlink.]]>
  3882. </doc>
  3883. </method>
  3884. <method name="renewLease"
  3885. abstract="false" native="false" synchronized="false"
  3886. static="false" final="false" visibility="public"
  3887. deprecated="not deprecated">
  3888. <param name="clientName" type="java.lang.String"/>
  3889. <exception name="IOException" type="java.io.IOException"/>
  3890. <exception name="UnresolvedLinkException" type="org.apache.hadoop.fs.UnresolvedLinkException"/>
  3891. <doc>
  3892. <![CDATA[Client programs can cause stateful changes in the NameNode
  3893. that affect other clients. A client may obtain a file and
  3894. neither abandon nor complete it. A client might hold a series
  3895. of locks that prevent other clients from proceeding.
  3896. Clearly, it would be bad if a client held a bunch of locks
  3897. that it never gave up. This can happen easily if the client
  3898. dies unexpectedly.
  3899. <p>
  3900. So, the NameNode will revoke the locks and live file-creates
  3901. for clients that it thinks have died. A client tells the
  3902. NameNode that it is still alive by periodically calling
  3903. renewLease(). If a certain amount of time passes since
  3904. the last call to renewLease(), the NameNode assumes the
  3905. client has died.
  3906. @throws UnresolvedLinkException if the path contains a symlink.]]>
  3907. </doc>
  3908. </method>
  3909. <method name="getStats" return="long[]"
  3910. abstract="false" native="false" synchronized="false"
  3911. static="false" final="false" visibility="public"
  3912. deprecated="not deprecated">
  3913. <exception name="IOException" type="java.io.IOException"/>
  3914. <doc>
  3915. <![CDATA[Get a set of statistics about the filesystem.
  3916. Right now, only three values are returned.
  3917. <ul>
  3918. <li> [0] contains the total storage capacity of the system, in bytes.</li>
  3919. <li> [1] contains the total used space of the system, in bytes.</li>
  3920. <li> [2] contains the available storage of the system, in bytes.</li>
  3921. <li> [3] contains number of under replicated blocks in the system.</li>
  3922. <li> [4] contains number of blocks with a corrupt replica. </li>
  3923. <li> [5] contains number of blocks without any good replicas left. </li>
  3924. </ul>
  3925. Use public constants like {@link #GET_STATS_CAPACITY_IDX} in place of
  3926. actual numbers to index into the array.]]>
  3927. </doc>
  3928. </method>
  3929. <method name="getDatanodeReport" return="org.apache.hadoop.hdfs.protocol.DatanodeInfo[]"
  3930. abstract="false" native="false" synchronized="false"
  3931. static="false" final="false" visibility="public"
  3932. deprecated="not deprecated">
  3933. <param name="type" type="org.apache.hadoop.hdfs.protocol.FSConstants.DatanodeReportType"/>
  3934. <exception name="IOException" type="java.io.IOException"/>
  3935. <doc>
  3936. <![CDATA[Get a report on the system's current datanodes.
  3937. One DatanodeInfo object is returned for each DataNode.
  3938. Return live datanodes if type is LIVE; dead datanodes if type is DEAD;
  3939. otherwise all datanodes if type is ALL.]]>
  3940. </doc>
  3941. </method>
  3942. <method name="getPreferredBlockSize" return="long"
  3943. abstract="false" native="false" synchronized="false"
  3944. static="false" final="false" visibility="public"
  3945. deprecated="not deprecated">
  3946. <param name="filename" type="java.lang.String"/>
  3947. <exception name="IOException" type="java.io.IOException"/>
  3948. <exception name="UnresolvedLinkException" type="org.apache.hadoop.fs.UnresolvedLinkException"/>
  3949. <doc>
  3950. <![CDATA[Get the block size for the given file.
  3951. @param filename The name of the file
  3952. @return The number of bytes in each block
  3953. @throws IOException
  3954. @throws UnresolvedLinkException if the path contains a symlink.]]>
  3955. </doc>
  3956. </method>
  3957. <method name="setSafeMode" return="boolean"
  3958. abstract="false" native="false" synchronized="false"
  3959. static="false" final="false" visibility="public"
  3960. deprecated="not deprecated">
  3961. <param name="action" type="org.apache.hadoop.hdfs.protocol.FSConstants.SafeModeAction"/>
  3962. <exception name="IOException" type="java.io.IOException"/>
  3963. <doc>
  3964. <![CDATA[Enter, leave or get safe mode.
  3965. <p>
  3966. Safe mode is a name node state when it
  3967. <ol><li>does not accept changes to name space (read-only), and</li>
  3968. <li>does not replicate or delete blocks.</li></ol>
  3969. <p>
  3970. Safe mode is entered automatically at name node startup.
  3971. Safe mode can also be entered manually using
  3972. {@link #setSafeMode(FSConstants.SafeModeAction) setSafeMode(SafeModeAction.SAFEMODE_GET)}.
  3973. <p>
  3974. At startup the name node accepts data node reports collecting
  3975. information about block locations.
  3976. In order to leave safe mode it needs to collect a configurable
  3977. percentage called threshold of blocks, which satisfy the minimal
  3978. replication condition.
  3979. The minimal replication condition is that each block must have at least
  3980. <tt>dfs.namenode.replication.min</tt> replicas.
  3981. When the threshold is reached the name node extends safe mode
  3982. for a configurable amount of time
  3983. to let the remaining data nodes to check in before it
  3984. will start replicating missing blocks.
  3985. Then the name node leaves safe mode.
  3986. <p>
  3987. If safe mode is turned on manually using
  3988. {@link #setSafeMode(FSConstants.SafeModeAction) setSafeMode(SafeModeAction.SAFEMODE_ENTER)}
  3989. then the name node stays in safe mode until it is manually turned off
  3990. using {@link #setSafeMode(FSConstants.SafeModeAction) setSafeMode(SafeModeAction.SAFEMODE_LEAVE)}.
  3991. Current state of the name node can be verified using
  3992. {@link #setSafeMode(FSConstants.SafeModeAction) setSafeMode(SafeModeAction.SAFEMODE_GET)}
  3993. <h4>Configuration parameters:</h4>
  3994. <tt>dfs.safemode.threshold.pct</tt> is the threshold parameter.<br>
  3995. <tt>dfs.safemode.extension</tt> is the safe mode extension parameter.<br>
  3996. <tt>dfs.namenode.replication.min</tt> is the minimal replication parameter.
  3997. <h4>Special cases:</h4>
  3998. The name node does not enter safe mode at startup if the threshold is
  3999. set to 0 or if the name space is empty.<br>
  4000. If the threshold is set to 1 then all blocks need to have at least
  4001. minimal replication.<br>
  4002. If the threshold value is greater than 1 then the name node will not be
  4003. able to turn off safe mode automatically.<br>
  4004. Safe mode can always be turned off manually.
  4005. @param action <ul> <li>0 leave safe mode;</li>
  4006. <li>1 enter safe mode;</li>
  4007. <li>2 get safe mode state.</li></ul>
  4008. @return <ul><li>0 if the safe mode is OFF or</li>
  4009. <li>1 if the safe mode is ON.</li></ul>
  4010. @throws IOException]]>
  4011. </doc>
  4012. </method>
  4013. <method name="saveNamespace"
  4014. abstract="false" native="false" synchronized="false"
  4015. static="false" final="false" visibility="public"
  4016. deprecated="not deprecated">
  4017. <exception name="IOException" type="java.io.IOException"/>
  4018. <doc>
  4019. <![CDATA[Save namespace image.
  4020. <p>
  4021. Saves current namespace into storage directories and reset edits log.
  4022. Requires superuser privilege and safe mode.
  4023. @throws AccessControlException if the superuser privilege is violated.
  4024. @throws IOException if image creation failed.]]>
  4025. </doc>
  4026. </method>
  4027. <method name="restoreFailedStorage" return="boolean"
  4028. abstract="false" native="false" synchronized="false"
  4029. static="false" final="false" visibility="public"
  4030. deprecated="not deprecated">
  4031. <param name="arg" type="java.lang.String"/>
  4032. <exception name="AccessControlException" type="org.apache.hadoop.security.AccessControlException"/>
  4033. <doc>
  4034. <![CDATA[Enable/Disable restore failed storage.
  4035. <p>
  4036. sets flag to enable restore of failed storage replicas
  4037. @throws AccessControlException if the superuser privilege is violated.]]>
  4038. </doc>
  4039. </method>
  4040. <method name="refreshNodes"
  4041. abstract="false" native="false" synchronized="false"
  4042. static="false" final="false" visibility="public"
  4043. deprecated="not deprecated">
  4044. <exception name="IOException" type="java.io.IOException"/>
  4045. <doc>
  4046. <![CDATA[Tells the namenode to reread the hosts and exclude files.
  4047. @throws IOException]]>
  4048. </doc>
  4049. </method>
  4050. <method name="finalizeUpgrade"
  4051. abstract="false" native="false" synchronized="false"
  4052. static="false" final="false" visibility="public"
  4053. deprecated="not deprecated">
  4054. <exception name="IOException" type="java.io.IOException"/>
  4055. <doc>
  4056. <![CDATA[Finalize previous upgrade.
  4057. Remove file system state saved during the upgrade.
  4058. The upgrade will become irreversible.
  4059. @throws IOException]]>
  4060. </doc>
  4061. </method>
  4062. <method name="distributedUpgradeProgress" return="org.apache.hadoop.hdfs.server.common.UpgradeStatusReport"
  4063. abstract="false" native="false" synchronized="false"
  4064. static="false" final="false" visibility="public"
  4065. deprecated="not deprecated">
  4066. <param name="action" type="org.apache.hadoop.hdfs.protocol.FSConstants.UpgradeAction"/>
  4067. <exception name="IOException" type="java.io.IOException"/>
  4068. <doc>
  4069. <![CDATA[Report distributed upgrade progress or force current upgrade to proceed.
  4070. @param action {@link FSConstants.UpgradeAction} to perform
  4071. @return upgrade status information or null if no upgrades are in progress
  4072. @throws IOException]]>
  4073. </doc>
  4074. </method>
  4075. <method name="metaSave"
  4076. abstract="false" native="false" synchronized="false"
  4077. static="false" final="false" visibility="public"
  4078. deprecated="not deprecated">
  4079. <param name="filename" type="java.lang.String"/>
  4080. <exception name="IOException" type="java.io.IOException"/>
  4081. <doc>
  4082. <![CDATA[Dumps namenode data structures into specified file. If the file
  4083. already exists, then append.
  4084. @throws IOException]]>
  4085. </doc>
  4086. </method>
  4087. <method name="getCorruptFiles" return="org.apache.hadoop.fs.FileStatus[]"
  4088. abstract="false" native="false" synchronized="false"
  4089. static="false" final="false" visibility="public"
  4090. deprecated="not deprecated">
  4091. <exception name="AccessControlException" type="org.apache.hadoop.security.AccessControlException"/>
  4092. <exception name="IOException" type="java.io.IOException"/>
  4093. <doc>
  4094. <![CDATA[@return Array of FileStatus objects referring to corrupted files.
  4095. The server could return all or a few of the files that are corrupt.
  4096. @throws AccessControlException
  4097. @throws IOException]]>
  4098. </doc>
  4099. </method>
  4100. <method name="getFileInfo" return="org.apache.hadoop.hdfs.protocol.HdfsFileStatus"
  4101. abstract="false" native="false" synchronized="false"
  4102. static="false" final="false" visibility="public"
  4103. deprecated="not deprecated">
  4104. <param name="src" type="java.lang.String"/>
  4105. <exception name="IOException" type="java.io.IOException"/>
  4106. <exception name="UnresolvedLinkException" type="org.apache.hadoop.fs.UnresolvedLinkException"/>
  4107. <doc>
  4108. <![CDATA[Get the file info for a specific file or directory.
  4109. @param src The string representation of the path to the file
  4110. @throws UnresolvedLinkException if the path contains symlinks;
  4111. IOException if permission to access file is denied by the system
  4112. @return object containing information regarding the file
  4113. or null if file not found]]>
  4114. </doc>
  4115. </method>
  4116. <method name="getFileLinkInfo" return="org.apache.hadoop.hdfs.protocol.HdfsFileStatus"
  4117. abstract="false" native="false" synchronized="false"
  4118. static="false" final="false" visibility="public"
  4119. deprecated="not deprecated">
  4120. <param name="src" type="java.lang.String"/>
  4121. <exception name="IOException" type="java.io.IOException"/>
  4122. <exception name="UnresolvedLinkException" type="org.apache.hadoop.fs.UnresolvedLinkException"/>
  4123. <doc>
  4124. <![CDATA[Get the file info for a specific file or directory. If the path
  4125. refers to a symlink then the FileStatus of the symlink is returned.
  4126. @param src The string representation of the path to the file
  4127. @throws UnresolvedLinkException if the path contains symlinks;
  4128. IOException if permission to access file is denied by the system
  4129. @return object containing information regarding the file
  4130. or null if file not found]]>
  4131. </doc>
  4132. </method>
  4133. <method name="getContentSummary" return="org.apache.hadoop.fs.ContentSummary"
  4134. abstract="false" native="false" synchronized="false"
  4135. static="false" final="false" visibility="public"
  4136. deprecated="not deprecated">
  4137. <param name="path" type="java.lang.String"/>
  4138. <exception name="IOException" type="java.io.IOException"/>
  4139. <exception name="UnresolvedLinkException" type="org.apache.hadoop.fs.UnresolvedLinkException"/>
  4140. <doc>
  4141. <![CDATA[Get {@link ContentSummary} rooted at the specified directory.
  4142. @param path The string representation of the path
  4143. @throws UnresolvedLinkException if the path contains a symlink.]]>
  4144. </doc>
  4145. </method>
  4146. <method name="setQuota"
  4147. abstract="false" native="false" synchronized="false"
  4148. static="false" final="false" visibility="public"
  4149. deprecated="not deprecated">
  4150. <param name="path" type="java.lang.String"/>
  4151. <param name="namespaceQuota" type="long"/>
  4152. <param name="diskspaceQuota" type="long"/>
  4153. <exception name="IOException" type="java.io.IOException"/>
  4154. <exception name="UnresolvedLinkException" type="org.apache.hadoop.fs.UnresolvedLinkException"/>
  4155. <exception name="FileNotFoundException" type="java.io.FileNotFoundException"/>
  4156. <exception name="SafeModeException" type="org.apache.hadoop.hdfs.server.namenode.SafeModeException"/>
  4157. <doc>
  4158. <![CDATA[Set the quota for a directory.
  4159. @param path The string representation of the path to the directory
  4160. @param namespaceQuota Limit on the number of names in the tree rooted
  4161. at the directory
  4162. @param diskspaceQuota Limit on disk space occupied all the files under
  4163. this directory.
  4164. <br><br>
  4165. The quota can have three types of values : (1) 0 or more will set
  4166. the quota to that value, (2) {@link FSConstants#QUOTA_DONT_SET} implies
  4167. the quota will not be changed, and (3) {@link FSConstants#QUOTA_RESET}
  4168. implies the quota will be reset. Any other value is a runtime error.
  4169. @throws UnresolvedLinkException if the path contains a symlink.
  4170. @throws FileNotFoundException if the path is a file or
  4171. does not exist
  4172. @throws QuotaExceededException if the directory size
  4173. is greater than the given quota]]>
  4174. </doc>
  4175. </method>
  4176. <method name="fsync"
  4177. abstract="false" native="false" synchronized="false"
  4178. static="false" final="false" visibility="public"
  4179. deprecated="not deprecated">
  4180. <param name="src" type="java.lang.String"/>
  4181. <param name="client" type="java.lang.String"/>
  4182. <exception name="IOException" type="java.io.IOException"/>
  4183. <exception name="UnresolvedLinkException" type="org.apache.hadoop.fs.UnresolvedLinkException"/>
  4184. <doc>
  4185. <![CDATA[Write all metadata for this file into persistent storage.
  4186. The file must be currently open for writing.
  4187. @param src The string representation of the path
  4188. @param client The string representation of the client
  4189. @throws UnresolvedLinkException if the path contains a symlink.]]>
  4190. </doc>
  4191. </method>
  4192. <method name="setTimes"
  4193. abstract="false" native="false" synchronized="false"
  4194. static="false" final="false" visibility="public"
  4195. deprecated="not deprecated">
  4196. <param name="src" type="java.lang.String"/>
  4197. <param name="mtime" type="long"/>
  4198. <param name="atime" type="long"/>
  4199. <exception name="IOException" type="java.io.IOException"/>
  4200. <exception name="UnresolvedLinkException" type="org.apache.hadoop.fs.UnresolvedLinkException"/>
  4201. <doc>
  4202. <![CDATA[Sets the modification and access time of the file to the specified time.
  4203. @param src The string representation of the path
  4204. @param mtime The number of milliseconds since Jan 1, 1970.
  4205. Setting mtime to -1 means that modification time should not be set
  4206. by this call.
  4207. @param atime The number of milliseconds since Jan 1, 1970.
  4208. Setting atime to -1 means that access time should not be set
  4209. by this call.
  4210. @throws UnresolvedLinkException if the path contains a symlink.]]>
  4211. </doc>
  4212. </method>
  4213. <method name="createSymlink"
  4214. abstract="false" native="false" synchronized="false"
  4215. static="false" final="false" visibility="public"
  4216. deprecated="not deprecated">
  4217. <param name="target" type="java.lang.String"/>
  4218. <param name="link" type="java.lang.String"/>
  4219. <param name="dirPerm" type="org.apache.hadoop.fs.permission.FsPermission"/>
  4220. <param name="createParent" type="boolean"/>
  4221. <exception name="IOException" type="java.io.IOException"/>
  4222. <exception name="UnresolvedLinkException" type="org.apache.hadoop.fs.UnresolvedLinkException"/>
  4223. <doc>
  4224. <![CDATA[Create a symbolic link to a file or directory.
  4225. @param target The pathname of the destination that the
  4226. link points to.
  4227. @param link The pathname of the link being created.
  4228. @param dirPerm permissions to use when creating parent directories
  4229. @param createParent - if true then missing parent dirs are created
  4230. if false then parent must exist
  4231. @throws IOException
  4232. @throws UnresolvedLinkException if the path contains a symlink.]]>
  4233. </doc>
  4234. </method>
  4235. <method name="getLinkTarget" return="java.lang.String"
  4236. abstract="false" native="false" synchronized="false"
  4237. static="false" final="false" visibility="public"
  4238. deprecated="not deprecated">
  4239. <param name="path" type="java.lang.String"/>
  4240. <exception name="IOException" type="java.io.IOException"/>
  4241. <doc>
  4242. <![CDATA[Resolve the first symbolic link on the specified path.
  4243. @param path The pathname that needs to be resolved
  4244. @return The pathname after resolving the first symbolic link if any.
  4245. @throws IOException]]>
  4246. </doc>
  4247. </method>
  4248. <method name="updateBlockForPipeline" return="org.apache.hadoop.hdfs.protocol.LocatedBlock"
  4249. abstract="false" native="false" synchronized="false"
  4250. static="false" final="false" visibility="public"
  4251. deprecated="not deprecated">
  4252. <param name="block" type="org.apache.hadoop.hdfs.protocol.Block"/>
  4253. <param name="clientName" type="java.lang.String"/>
  4254. <exception name="IOException" type="java.io.IOException"/>
  4255. <doc>
  4256. <![CDATA[Get a new generation stamp together with an access token for
  4257. a block under construction
  4258. This method is called only when a client needs to recover a failed
  4259. pipeline or set up a pipeline for appending to a block.
  4260. @param block a block
  4261. @param clientName the name of the client
  4262. @return a located block with a new generation stamp and an access token
  4263. @throws IOException if any error occurs]]>
  4264. </doc>
  4265. </method>
  4266. <method name="updatePipeline"
  4267. abstract="false" native="false" synchronized="false"
  4268. static="false" final="false" visibility="public"
  4269. deprecated="not deprecated">
  4270. <param name="clientName" type="java.lang.String"/>
  4271. <param name="oldBlock" type="org.apache.hadoop.hdfs.protocol.Block"/>
  4272. <param name="newBlock" type="org.apache.hadoop.hdfs.protocol.Block"/>
  4273. <param name="newNodes" type="org.apache.hadoop.hdfs.protocol.DatanodeID[]"/>
  4274. <exception name="IOException" type="java.io.IOException"/>
  4275. <doc>
  4276. <![CDATA[Update a pipeline for a block under construction
  4277. @param clientName the name of the client
  4278. @param oldBlock the old block
  4279. @param newBlock the new block containing new generation stamp and length
  4280. @param newNodes datanodes in the pipeline
  4281. @throws IOException if any error occurs]]>
  4282. </doc>
  4283. </method>
  4284. <method name="getDelegationToken" return="org.apache.hadoop.security.token.Token"
  4285. abstract="false" native="false" synchronized="false"
  4286. static="false" final="false" visibility="public"
  4287. deprecated="not deprecated">
  4288. <param name="renewer" type="org.apache.hadoop.io.Text"/>
  4289. <exception name="IOException" type="java.io.IOException"/>
  4290. <doc>
  4291. <![CDATA[Get a valid Delegation Token.
  4292. @param renewer the designated renewer for the token
  4293. @return Token<DelegationTokenIdentifier>
  4294. @throws IOException]]>
  4295. </doc>
  4296. </method>
  4297. <method name="renewDelegationToken" return="long"
  4298. abstract="false" native="false" synchronized="false"
  4299. static="false" final="false" visibility="public"
  4300. deprecated="not deprecated">
  4301. <param name="token" type="org.apache.hadoop.security.token.Token"/>
  4302. <exception name="IOException" type="java.io.IOException"/>
  4303. <doc>
  4304. <![CDATA[Renew an existing delegation token.
  4305. @param token delegation token obtained earlier
  4306. @return the new expiration time
  4307. @throws IOException]]>
  4308. </doc>
  4309. </method>
  4310. <method name="cancelDelegationToken"
  4311. abstract="false" native="false" synchronized="false"
  4312. static="false" final="false" visibility="public"
  4313. deprecated="not deprecated">
  4314. <param name="token" type="org.apache.hadoop.security.token.Token"/>
  4315. <exception name="IOException" type="java.io.IOException"/>
  4316. <doc>
  4317. <![CDATA[Cancel an existing delegation token.
  4318. @param token delegation token
  4319. @throws IOException]]>
  4320. </doc>
  4321. </method>
  4322. <field name="versionID" type="long"
  4323. transient="false" volatile="false"
  4324. static="true" final="true" visibility="public"
  4325. deprecated="not deprecated">
  4326. <doc>
  4327. <![CDATA[Compared to the previous version the following changes have been introduced:
  4328. (Only the latest change is reflected.
  4329. The log of historical changes can be retrieved from the svn).
  4330. 60: Replace full getListing with iterative getListinng.]]>
  4331. </doc>
  4332. </field>
  4333. <field name="GET_STATS_CAPACITY_IDX" type="int"
  4334. transient="false" volatile="false"
  4335. static="true" final="true" visibility="public"
  4336. deprecated="not deprecated">
  4337. </field>
  4338. <field name="GET_STATS_USED_IDX" type="int"
  4339. transient="false" volatile="false"
  4340. static="true" final="true" visibility="public"
  4341. deprecated="not deprecated">
  4342. </field>
  4343. <field name="GET_STATS_REMAINING_IDX" type="int"
  4344. transient="false" volatile="false"
  4345. static="true" final="true" visibility="public"
  4346. deprecated="not deprecated">
  4347. </field>
  4348. <field name="GET_STATS_UNDER_REPLICATED_IDX" type="int"
  4349. transient="false" volatile="false"
  4350. static="true" final="true" visibility="public"
  4351. deprecated="not deprecated">
  4352. </field>
  4353. <field name="GET_STATS_CORRUPT_BLOCKS_IDX" type="int"
  4354. transient="false" volatile="false"
  4355. static="true" final="true" visibility="public"
  4356. deprecated="not deprecated">
  4357. </field>
  4358. <field name="GET_STATS_MISSING_BLOCKS_IDX" type="int"
  4359. transient="false" volatile="false"
  4360. static="true" final="true" visibility="public"
  4361. deprecated="not deprecated">
  4362. </field>
  4363. <doc>
  4364. <![CDATA[ClientProtocol is used by user code via
  4365. {@link org.apache.hadoop.hdfs.DistributedFileSystem} class to communicate
  4366. with the NameNode. User code can manipulate the directory namespace,
  4367. as well as open/close file streams, etc.]]>
  4368. </doc>
  4369. </interface>
  4370. <!-- end interface org.apache.hadoop.hdfs.protocol.ClientProtocol -->
  4371. <!-- start class org.apache.hadoop.hdfs.protocol.DatanodeID -->
  4372. <class name="DatanodeID" extends="java.lang.Object"
  4373. abstract="false"
  4374. static="false" final="false" visibility="public"
  4375. deprecated="not deprecated">
  4376. <implements name="org.apache.hadoop.io.WritableComparable"/>
  4377. <constructor name="DatanodeID"
  4378. static="false" final="false" visibility="public"
  4379. deprecated="not deprecated">
  4380. <doc>
  4381. <![CDATA[Equivalent to DatanodeID("").]]>
  4382. </doc>
  4383. </constructor>
  4384. <constructor name="DatanodeID" type="java.lang.String"
  4385. static="false" final="false" visibility="public"
  4386. deprecated="not deprecated">
  4387. <doc>
  4388. <![CDATA[Equivalent to DatanodeID(nodeName, "", -1, -1).]]>
  4389. </doc>
  4390. </constructor>
  4391. <constructor name="DatanodeID" type="org.apache.hadoop.hdfs.protocol.DatanodeID"
  4392. static="false" final="false" visibility="public"
  4393. deprecated="not deprecated">
  4394. <doc>
  4395. <![CDATA[DatanodeID copy constructor
  4396. @param from]]>
  4397. </doc>
  4398. </constructor>
  4399. <constructor name="DatanodeID" type="java.lang.String, java.lang.String, int, int"
  4400. static="false" final="false" visibility="public"
  4401. deprecated="not deprecated">
  4402. <doc>
  4403. <![CDATA[Create DatanodeID
  4404. @param nodeName (hostname:portNumber)
  4405. @param storageID data storage ID
  4406. @param infoPort info server port
  4407. @param ipcPort ipc server port]]>
  4408. </doc>
  4409. </constructor>
  4410. <method name="getName" return="java.lang.String"
  4411. abstract="false" native="false" synchronized="false"
  4412. static="false" final="false" visibility="public"
  4413. deprecated="not deprecated">
  4414. <doc>
  4415. <![CDATA[@return hostname:portNumber.]]>
  4416. </doc>
  4417. </method>
  4418. <method name="getStorageID" return="java.lang.String"
  4419. abstract="false" native="false" synchronized="false"
  4420. static="false" final="false" visibility="public"
  4421. deprecated="not deprecated">
  4422. <doc>
  4423. <![CDATA[@return data storage ID.]]>
  4424. </doc>
  4425. </method>
  4426. <method name="getInfoPort" return="int"
  4427. abstract="false" native="false" synchronized="false"
  4428. static="false" final="false" visibility="public"
  4429. deprecated="not deprecated">
  4430. <doc>
  4431. <![CDATA[@return infoPort (the port at which the HTTP server bound to)]]>
  4432. </doc>
  4433. </method>
  4434. <method name="getIpcPort" return="int"
  4435. abstract="false" native="false" synchronized="false"
  4436. static="false" final="false" visibility="public"
  4437. deprecated="not deprecated">
  4438. <doc>
  4439. <![CDATA[@return ipcPort (the port at which the IPC server bound to)]]>
  4440. </doc>
  4441. </method>
  4442. <method name="setStorageID"
  4443. abstract="false" native="false" synchronized="false"
  4444. static="false" final="false" visibility="public"
  4445. deprecated="not deprecated">
  4446. <param name="storageID" type="java.lang.String"/>
  4447. <doc>
  4448. <![CDATA[sets the data storage ID.]]>
  4449. </doc>
  4450. </method>
  4451. <method name="getHost" return="java.lang.String"
  4452. abstract="false" native="false" synchronized="false"
  4453. static="false" final="false" visibility="public"
  4454. deprecated="not deprecated">
  4455. <doc>
  4456. <![CDATA[@return hostname and no :portNumber.]]>
  4457. </doc>
  4458. </method>
  4459. <method name="getPort" return="int"
  4460. abstract="false" native="false" synchronized="false"
  4461. static="false" final="false" visibility="public"
  4462. deprecated="not deprecated">
  4463. </method>
  4464. <method name="equals" return="boolean"
  4465. abstract="false" native="false" synchronized="false"
  4466. static="false" final="false" visibility="public"
  4467. deprecated="not deprecated">
  4468. <param name="to" type="java.lang.Object"/>
  4469. </method>
  4470. <method name="hashCode" return="int"
  4471. abstract="false" native="false" synchronized="false"
  4472. static="false" final="false" visibility="public"
  4473. deprecated="not deprecated">
  4474. </method>
  4475. <method name="toString" return="java.lang.String"
  4476. abstract="false" native="false" synchronized="false"
  4477. static="false" final="false" visibility="public"
  4478. deprecated="not deprecated">
  4479. </method>
  4480. <method name="updateRegInfo"
  4481. abstract="false" native="false" synchronized="false"
  4482. static="false" final="false" visibility="public"
  4483. deprecated="not deprecated">
  4484. <param name="nodeReg" type="org.apache.hadoop.hdfs.protocol.DatanodeID"/>
  4485. <doc>
  4486. <![CDATA[Update fields when a new registration request comes in.
  4487. Note that this does not update storageID.]]>
  4488. </doc>
  4489. </method>
  4490. <method name="compareTo" return="int"
  4491. abstract="false" native="false" synchronized="false"
  4492. static="false" final="false" visibility="public"
  4493. deprecated="not deprecated">
  4494. <param name="that" type="org.apache.hadoop.hdfs.protocol.DatanodeID"/>
  4495. <doc>
  4496. <![CDATA[Comparable.
  4497. Basis of compare is the String name (host:portNumber) only.
  4498. @param that
  4499. @return as specified by Comparable.]]>
  4500. </doc>
  4501. </method>
  4502. <method name="write"
  4503. abstract="false" native="false" synchronized="false"
  4504. static="false" final="false" visibility="public"
  4505. deprecated="not deprecated">
  4506. <param name="out" type="java.io.DataOutput"/>
  4507. <exception name="IOException" type="java.io.IOException"/>
  4508. <doc>
  4509. <![CDATA[{@inheritDoc}]]>
  4510. </doc>
  4511. </method>
  4512. <method name="readFields"
  4513. abstract="false" native="false" synchronized="false"
  4514. static="false" final="false" visibility="public"
  4515. deprecated="not deprecated">
  4516. <param name="in" type="java.io.DataInput"/>
  4517. <exception name="IOException" type="java.io.IOException"/>
  4518. <doc>
  4519. <![CDATA[{@inheritDoc}]]>
  4520. </doc>
  4521. </method>
  4522. <field name="EMPTY_ARRAY" type="org.apache.hadoop.hdfs.protocol.DatanodeID[]"
  4523. transient="false" volatile="false"
  4524. static="true" final="true" visibility="public"
  4525. deprecated="not deprecated">
  4526. </field>
  4527. <field name="name" type="java.lang.String"
  4528. transient="false" volatile="false"
  4529. static="false" final="false" visibility="public"
  4530. deprecated="not deprecated">
  4531. </field>
  4532. <field name="storageID" type="java.lang.String"
  4533. transient="false" volatile="false"
  4534. static="false" final="false" visibility="public"
  4535. deprecated="not deprecated">
  4536. </field>
  4537. <field name="infoPort" type="int"
  4538. transient="false" volatile="false"
  4539. static="false" final="false" visibility="protected"
  4540. deprecated="not deprecated">
  4541. </field>
  4542. <field name="ipcPort" type="int"
  4543. transient="false" volatile="false"
  4544. static="false" final="false" visibility="public"
  4545. deprecated="not deprecated">
  4546. </field>
  4547. <doc>
  4548. <![CDATA[DatanodeID is composed of the data node
  4549. name (hostname:portNumber) and the data storage ID,
  4550. which it currently represents.]]>
  4551. </doc>
  4552. </class>
  4553. <!-- end class org.apache.hadoop.hdfs.protocol.DatanodeID -->
  4554. <!-- start class org.apache.hadoop.hdfs.protocol.DatanodeInfo -->
  4555. <class name="DatanodeInfo" extends="org.apache.hadoop.hdfs.protocol.DatanodeID"
  4556. abstract="false"
  4557. static="false" final="false" visibility="public"
  4558. deprecated="not deprecated">
  4559. <implements name="org.apache.hadoop.net.Node"/>
  4560. <constructor name="DatanodeInfo"
  4561. static="false" final="false" visibility="public"
  4562. deprecated="not deprecated">
  4563. </constructor>
  4564. <constructor name="DatanodeInfo" type="org.apache.hadoop.hdfs.protocol.DatanodeInfo"
  4565. static="false" final="false" visibility="public"
  4566. deprecated="not deprecated">
  4567. </constructor>
  4568. <constructor name="DatanodeInfo" type="org.apache.hadoop.hdfs.protocol.DatanodeID"
  4569. static="false" final="false" visibility="public"
  4570. deprecated="not deprecated">
  4571. </constructor>
  4572. <constructor name="DatanodeInfo" type="org.apache.hadoop.hdfs.protocol.DatanodeID, java.lang.String, java.lang.String"
  4573. static="false" final="false" visibility="protected"
  4574. deprecated="not deprecated">
  4575. </constructor>
  4576. <method name="getCapacity" return="long"
  4577. abstract="false" native="false" synchronized="false"
  4578. static="false" final="false" visibility="public"
  4579. deprecated="not deprecated">
  4580. <doc>
  4581. <![CDATA[The raw capacity.]]>
  4582. </doc>
  4583. </method>
  4584. <method name="getDfsUsed" return="long"
  4585. abstract="false" native="false" synchronized="false"
  4586. static="false" final="false" visibility="public"
  4587. deprecated="not deprecated">
  4588. <doc>
  4589. <![CDATA[The used space by the data node.]]>
  4590. </doc>
  4591. </method>
  4592. <method name="getNonDfsUsed" return="long"
  4593. abstract="false" native="false" synchronized="false"
  4594. static="false" final="false" visibility="public"
  4595. deprecated="not deprecated">
  4596. <doc>
  4597. <![CDATA[The used space by the data node.]]>
  4598. </doc>
  4599. </method>
  4600. <method name="getDfsUsedPercent" return="float"
  4601. abstract="false" native="false" synchronized="false"
  4602. static="false" final="false" visibility="public"
  4603. deprecated="not deprecated">
  4604. <doc>
  4605. <![CDATA[The used space by the data node as percentage of present capacity]]>
  4606. </doc>
  4607. </method>
  4608. <method name="getRemaining" return="long"
  4609. abstract="false" native="false" synchronized="false"
  4610. static="false" final="false" visibility="public"
  4611. deprecated="not deprecated">
  4612. <doc>
  4613. <![CDATA[The raw free space.]]>
  4614. </doc>
  4615. </method>
  4616. <method name="getRemainingPercent" return="float"
  4617. abstract="false" native="false" synchronized="false"
  4618. static="false" final="false" visibility="public"
  4619. deprecated="not deprecated">
  4620. <doc>
  4621. <![CDATA[The remaining space as percentage of configured capacity.]]>
  4622. </doc>
  4623. </method>
  4624. <method name="getLastUpdate" return="long"
  4625. abstract="false" native="false" synchronized="false"
  4626. static="false" final="false" visibility="public"
  4627. deprecated="not deprecated">
  4628. <doc>
  4629. <![CDATA[The time when this information was accurate.]]>
  4630. </doc>
  4631. </method>
  4632. <method name="getXceiverCount" return="int"
  4633. abstract="false" native="false" synchronized="false"
  4634. static="false" final="false" visibility="public"
  4635. deprecated="not deprecated">
  4636. <doc>
  4637. <![CDATA[number of active connections]]>
  4638. </doc>
  4639. </method>
  4640. <method name="setCapacity"
  4641. abstract="false" native="false" synchronized="false"
  4642. static="false" final="false" visibility="public"
  4643. deprecated="not deprecated">
  4644. <param name="capacity" type="long"/>
  4645. <doc>
  4646. <![CDATA[Sets raw capacity.]]>
  4647. </doc>
  4648. </method>
  4649. <method name="setRemaining"
  4650. abstract="false" native="false" synchronized="false"
  4651. static="false" final="false" visibility="public"
  4652. deprecated="not deprecated">
  4653. <param name="remaining" type="long"/>
  4654. <doc>
  4655. <![CDATA[Sets raw free space.]]>
  4656. </doc>
  4657. </method>
  4658. <method name="setLastUpdate"
  4659. abstract="false" native="false" synchronized="false"
  4660. static="false" final="false" visibility="public"
  4661. deprecated="not deprecated">
  4662. <param name="lastUpdate" type="long"/>
  4663. <doc>
  4664. <![CDATA[Sets time when this information was accurate.]]>
  4665. </doc>
  4666. </method>
  4667. <method name="setXceiverCount"
  4668. abstract="false" native="false" synchronized="false"
  4669. static="false" final="false" visibility="public"
  4670. deprecated="not deprecated">
  4671. <param name="xceiverCount" type="int"/>
  4672. <doc>
  4673. <![CDATA[Sets number of active connections]]>
  4674. </doc>
  4675. </method>
  4676. <method name="getNetworkLocation" return="java.lang.String"
  4677. abstract="false" native="false" synchronized="true"
  4678. static="false" final="false" visibility="public"
  4679. deprecated="not deprecated">
  4680. <doc>
  4681. <![CDATA[rack name]]>
  4682. </doc>
  4683. </method>
  4684. <method name="setNetworkLocation"
  4685. abstract="false" native="false" synchronized="true"
  4686. static="false" final="false" visibility="public"
  4687. deprecated="not deprecated">
  4688. <param name="location" type="java.lang.String"/>
  4689. <doc>
  4690. <![CDATA[Sets the rack name]]>
  4691. </doc>
  4692. </method>
  4693. <method name="getHostName" return="java.lang.String"
  4694. abstract="false" native="false" synchronized="false"
  4695. static="false" final="false" visibility="public"
  4696. deprecated="not deprecated">
  4697. </method>
  4698. <method name="setHostName"
  4699. abstract="false" native="false" synchronized="false"
  4700. static="false" final="false" visibility="public"
  4701. deprecated="not deprecated">
  4702. <param name="host" type="java.lang.String"/>
  4703. </method>
  4704. <method name="getDatanodeReport" return="java.lang.String"
  4705. abstract="false" native="false" synchronized="false"
  4706. static="false" final="false" visibility="public"
  4707. deprecated="not deprecated">
  4708. <doc>
  4709. <![CDATA[A formatted string for reporting the status of the DataNode.]]>
  4710. </doc>
  4711. </method>
  4712. <method name="dumpDatanode" return="java.lang.String"
  4713. abstract="false" native="false" synchronized="false"
  4714. static="false" final="false" visibility="public"
  4715. deprecated="not deprecated">
  4716. <doc>
  4717. <![CDATA[A formatted string for printing the status of the DataNode.]]>
  4718. </doc>
  4719. </method>
  4720. <method name="startDecommission"
  4721. abstract="false" native="false" synchronized="false"
  4722. static="false" final="false" visibility="public"
  4723. deprecated="not deprecated">
  4724. <doc>
  4725. <![CDATA[Start decommissioning a node.
  4726. old state.]]>
  4727. </doc>
  4728. </method>
  4729. <method name="stopDecommission"
  4730. abstract="false" native="false" synchronized="false"
  4731. static="false" final="false" visibility="public"
  4732. deprecated="not deprecated">
  4733. <doc>
  4734. <![CDATA[Stop decommissioning a node.
  4735. old state.]]>
  4736. </doc>
  4737. </method>
  4738. <method name="isDecommissionInProgress" return="boolean"
  4739. abstract="false" native="false" synchronized="false"
  4740. static="false" final="false" visibility="public"
  4741. deprecated="not deprecated">
  4742. <doc>
  4743. <![CDATA[Returns true if the node is in the process of being decommissioned]]>
  4744. </doc>
  4745. </method>
  4746. <method name="isDecommissioned" return="boolean"
  4747. abstract="false" native="false" synchronized="false"
  4748. static="false" final="false" visibility="public"
  4749. deprecated="not deprecated">
  4750. <doc>
  4751. <![CDATA[Returns true if the node has been decommissioned.]]>
  4752. </doc>
  4753. </method>
  4754. <method name="setDecommissioned"
  4755. abstract="false" native="false" synchronized="false"
  4756. static="false" final="false" visibility="public"
  4757. deprecated="not deprecated">
  4758. <doc>
  4759. <![CDATA[Sets the admin state to indicate that decommission is complete.]]>
  4760. </doc>
  4761. </method>
  4762. <method name="setAdminState"
  4763. abstract="false" native="false" synchronized="false"
  4764. static="false" final="false" visibility="protected"
  4765. deprecated="not deprecated">
  4766. <param name="newState" type="org.apache.hadoop.hdfs.protocol.DatanodeInfo.AdminStates"/>
  4767. <doc>
  4768. <![CDATA[Sets the admin state of this node.]]>
  4769. </doc>
  4770. </method>
  4771. <method name="getParent" return="org.apache.hadoop.net.Node"
  4772. abstract="false" native="false" synchronized="false"
  4773. static="false" final="false" visibility="public"
  4774. deprecated="not deprecated">
  4775. <doc>
  4776. <![CDATA[Return this node's parent]]>
  4777. </doc>
  4778. </method>
  4779. <method name="setParent"
  4780. abstract="false" native="false" synchronized="false"
  4781. static="false" final="false" visibility="public"
  4782. deprecated="not deprecated">
  4783. <param name="parent" type="org.apache.hadoop.net.Node"/>
  4784. </method>
  4785. <method name="getLevel" return="int"
  4786. abstract="false" native="false" synchronized="false"
  4787. static="false" final="false" visibility="public"
  4788. deprecated="not deprecated">
  4789. <doc>
  4790. <![CDATA[Return this node's level in the tree.
  4791. E.g. the root of a tree returns 0 and its children return 1]]>
  4792. </doc>
  4793. </method>
  4794. <method name="setLevel"
  4795. abstract="false" native="false" synchronized="false"
  4796. static="false" final="false" visibility="public"
  4797. deprecated="not deprecated">
  4798. <param name="level" type="int"/>
  4799. </method>
  4800. <method name="write"
  4801. abstract="false" native="false" synchronized="false"
  4802. static="false" final="false" visibility="public"
  4803. deprecated="not deprecated">
  4804. <param name="out" type="java.io.DataOutput"/>
  4805. <exception name="IOException" type="java.io.IOException"/>
  4806. <doc>
  4807. <![CDATA[{@inheritDoc}]]>
  4808. </doc>
  4809. </method>
  4810. <method name="readFields"
  4811. abstract="false" native="false" synchronized="false"
  4812. static="false" final="false" visibility="public"
  4813. deprecated="not deprecated">
  4814. <param name="in" type="java.io.DataInput"/>
  4815. <exception name="IOException" type="java.io.IOException"/>
  4816. <doc>
  4817. <![CDATA[{@inheritDoc}]]>
  4818. </doc>
  4819. </method>
  4820. <method name="read" return="org.apache.hadoop.hdfs.protocol.DatanodeInfo"
  4821. abstract="false" native="false" synchronized="false"
  4822. static="true" final="false" visibility="public"
  4823. deprecated="not deprecated">
  4824. <param name="in" type="java.io.DataInput"/>
  4825. <exception name="IOException" type="java.io.IOException"/>
  4826. <doc>
  4827. <![CDATA[Read a DatanodeInfo]]>
  4828. </doc>
  4829. </method>
  4830. <method name="hashCode" return="int"
  4831. abstract="false" native="false" synchronized="false"
  4832. static="false" final="false" visibility="public"
  4833. deprecated="not deprecated">
  4834. </method>
  4835. <method name="equals" return="boolean"
  4836. abstract="false" native="false" synchronized="false"
  4837. static="false" final="false" visibility="public"
  4838. deprecated="not deprecated">
  4839. <param name="obj" type="java.lang.Object"/>
  4840. </method>
  4841. <field name="capacity" type="long"
  4842. transient="false" volatile="false"
  4843. static="false" final="false" visibility="protected"
  4844. deprecated="not deprecated">
  4845. </field>
  4846. <field name="dfsUsed" type="long"
  4847. transient="false" volatile="false"
  4848. static="false" final="false" visibility="protected"
  4849. deprecated="not deprecated">
  4850. </field>
  4851. <field name="remaining" type="long"
  4852. transient="false" volatile="false"
  4853. static="false" final="false" visibility="protected"
  4854. deprecated="not deprecated">
  4855. </field>
  4856. <field name="lastUpdate" type="long"
  4857. transient="false" volatile="false"
  4858. static="false" final="false" visibility="protected"
  4859. deprecated="not deprecated">
  4860. </field>
  4861. <field name="xceiverCount" type="int"
  4862. transient="false" volatile="false"
  4863. static="false" final="false" visibility="protected"
  4864. deprecated="not deprecated">
  4865. </field>
  4866. <field name="location" type="java.lang.String"
  4867. transient="false" volatile="false"
  4868. static="false" final="false" visibility="protected"
  4869. deprecated="not deprecated">
  4870. </field>
  4871. <field name="hostName" type="java.lang.String"
  4872. transient="false" volatile="false"
  4873. static="false" final="false" visibility="protected"
  4874. deprecated="not deprecated">
  4875. <doc>
  4876. <![CDATA[HostName as supplied by the datanode during registration as its
  4877. name. Namenode uses datanode IP address as the name.]]>
  4878. </doc>
  4879. </field>
  4880. <field name="adminState" type="org.apache.hadoop.hdfs.protocol.DatanodeInfo.AdminStates"
  4881. transient="false" volatile="false"
  4882. static="false" final="false" visibility="protected"
  4883. deprecated="not deprecated">
  4884. </field>
  4885. <doc>
  4886. <![CDATA[DatanodeInfo represents the status of a DataNode.
  4887. This object is used for communication in the
  4888. Datanode Protocol and the Client Protocol.]]>
  4889. </doc>
  4890. </class>
  4891. <!-- end class org.apache.hadoop.hdfs.protocol.DatanodeInfo -->
  4892. <!-- start class org.apache.hadoop.hdfs.protocol.DatanodeInfo.AdminStates -->
  4893. <class name="DatanodeInfo.AdminStates" extends="java.lang.Enum"
  4894. abstract="false"
  4895. static="true" final="true" visibility="public"
  4896. deprecated="not deprecated">
  4897. <method name="values" return="org.apache.hadoop.hdfs.protocol.DatanodeInfo.AdminStates[]"
  4898. abstract="false" native="false" synchronized="false"
  4899. static="true" final="false" visibility="public"
  4900. deprecated="not deprecated">
  4901. </method>
  4902. <method name="valueOf" return="org.apache.hadoop.hdfs.protocol.DatanodeInfo.AdminStates"
  4903. abstract="false" native="false" synchronized="false"
  4904. static="true" final="false" visibility="public"
  4905. deprecated="not deprecated">
  4906. <param name="name" type="java.lang.String"/>
  4907. </method>
  4908. <field name="NORMAL" type="org.apache.hadoop.hdfs.protocol.DatanodeInfo.AdminStates"
  4909. transient="false" volatile="false"
  4910. static="true" final="true" visibility="public"
  4911. deprecated="not deprecated">
  4912. </field>
  4913. <field name="DECOMMISSION_INPROGRESS" type="org.apache.hadoop.hdfs.protocol.DatanodeInfo.AdminStates"
  4914. transient="false" volatile="false"
  4915. static="true" final="true" visibility="public"
  4916. deprecated="not deprecated">
  4917. </field>
  4918. <field name="DECOMMISSIONED" type="org.apache.hadoop.hdfs.protocol.DatanodeInfo.AdminStates"
  4919. transient="false" volatile="false"
  4920. static="true" final="true" visibility="public"
  4921. deprecated="not deprecated">
  4922. </field>
  4923. </class>
  4924. <!-- end class org.apache.hadoop.hdfs.protocol.DatanodeInfo.AdminStates -->
  4925. <!-- start interface org.apache.hadoop.hdfs.protocol.DataTransferProtocol -->
  4926. <interface name="DataTransferProtocol" abstract="true"
  4927. static="false" final="false" visibility="public"
  4928. deprecated="not deprecated">
  4929. <field name="DATA_TRANSFER_VERSION" type="int"
  4930. transient="false" volatile="false"
  4931. static="true" final="true" visibility="public"
  4932. deprecated="not deprecated">
  4933. <doc>
  4934. <![CDATA[Version for data transfers between clients and datanodes
  4935. This should change when serialization of DatanodeInfo, not just
  4936. when protocol changes. It is not very obvious.]]>
  4937. </doc>
  4938. </field>
  4939. <field name="OP_WRITE_BLOCK" type="byte"
  4940. transient="false" volatile="false"
  4941. static="true" final="true" visibility="public"
  4942. deprecated="Deprecated at 0.21. Use Op.WRITE_BLOCK instead.">
  4943. <doc>
  4944. <![CDATA[@deprecated Deprecated at 0.21. Use Op.WRITE_BLOCK instead.]]>
  4945. </doc>
  4946. </field>
  4947. <field name="OP_READ_BLOCK" type="byte"
  4948. transient="false" volatile="false"
  4949. static="true" final="true" visibility="public"
  4950. deprecated="Deprecated at 0.21. Use Op.READ_BLOCK instead.">
  4951. <doc>
  4952. <![CDATA[@deprecated Deprecated at 0.21. Use Op.READ_BLOCK instead.]]>
  4953. </doc>
  4954. </field>
  4955. <field name="OP_READ_METADATA" type="byte"
  4956. transient="false" volatile="false"
  4957. static="true" final="true" visibility="public"
  4958. deprecated="As of version 15, OP_READ_METADATA is no longer supported.">
  4959. <doc>
  4960. <![CDATA[@deprecated As of version 15, OP_READ_METADATA is no longer supported.]]>
  4961. </doc>
  4962. </field>
  4963. <field name="OP_REPLACE_BLOCK" type="byte"
  4964. transient="false" volatile="false"
  4965. static="true" final="true" visibility="public"
  4966. deprecated="Deprecated at 0.21. Use Op.REPLACE_BLOCK instead.">
  4967. <doc>
  4968. <![CDATA[@deprecated Deprecated at 0.21. Use Op.REPLACE_BLOCK instead.]]>
  4969. </doc>
  4970. </field>
  4971. <field name="OP_COPY_BLOCK" type="byte"
  4972. transient="false" volatile="false"
  4973. static="true" final="true" visibility="public"
  4974. deprecated="Deprecated at 0.21. Use Op.COPY_BLOCK instead.">
  4975. <doc>
  4976. <![CDATA[@deprecated Deprecated at 0.21. Use Op.COPY_BLOCK instead.]]>
  4977. </doc>
  4978. </field>
  4979. <field name="OP_BLOCK_CHECKSUM" type="byte"
  4980. transient="false" volatile="false"
  4981. static="true" final="true" visibility="public"
  4982. deprecated="Deprecated at 0.21. Use Op.BLOCK_CHECKSUM instead.">
  4983. <doc>
  4984. <![CDATA[@deprecated Deprecated at 0.21. Use Op.BLOCK_CHECKSUM instead.]]>
  4985. </doc>
  4986. </field>
  4987. <field name="OP_STATUS_SUCCESS" type="int"
  4988. transient="false" volatile="false"
  4989. static="true" final="true" visibility="public"
  4990. deprecated="Deprecated at 0.21. Use Status.SUCCESS instead.">
  4991. <doc>
  4992. <![CDATA[@deprecated Deprecated at 0.21. Use Status.SUCCESS instead.]]>
  4993. </doc>
  4994. </field>
  4995. <field name="OP_STATUS_ERROR" type="int"
  4996. transient="false" volatile="false"
  4997. static="true" final="true" visibility="public"
  4998. deprecated="Deprecated at 0.21. Use Status.ERROR instead.">
  4999. <doc>
  5000. <![CDATA[@deprecated Deprecated at 0.21. Use Status.ERROR instead.]]>
  5001. </doc>
  5002. </field>
  5003. <field name="OP_STATUS_ERROR_CHECKSUM" type="int"
  5004. transient="false" volatile="false"
  5005. static="true" final="true" visibility="public"
  5006. deprecated="Deprecated at 0.21. Use Status.ERROR_CHECKSUM instead.">
  5007. <doc>
  5008. <![CDATA[@deprecated Deprecated at 0.21. Use Status.ERROR_CHECKSUM instead.]]>
  5009. </doc>
  5010. </field>
  5011. <field name="OP_STATUS_ERROR_INVALID" type="int"
  5012. transient="false" volatile="false"
  5013. static="true" final="true" visibility="public"
  5014. deprecated="Deprecated at 0.21. Use Status.ERROR_INVALID instead.">
  5015. <doc>
  5016. <![CDATA[@deprecated Deprecated at 0.21. Use Status.ERROR_INVALID instead.]]>
  5017. </doc>
  5018. </field>
  5019. <field name="OP_STATUS_ERROR_EXISTS" type="int"
  5020. transient="false" volatile="false"
  5021. static="true" final="true" visibility="public"
  5022. deprecated="Deprecated at 0.21. Use Status.ERROR_EXISTS instead.">
  5023. <doc>
  5024. <![CDATA[@deprecated Deprecated at 0.21. Use Status.ERROR_EXISTS instead.]]>
  5025. </doc>
  5026. </field>
  5027. <field name="OP_STATUS_ERROR_ACCESS_TOKEN" type="int"
  5028. transient="false" volatile="false"
  5029. static="true" final="true" visibility="public"
  5030. deprecated="Deprecated at 0.21. Use Status.ERROR_ACCESS_TOKEN instead.">
  5031. <doc>
  5032. <![CDATA[@deprecated Deprecated at 0.21. Use Status.ERROR_ACCESS_TOKEN instead.]]>
  5033. </doc>
  5034. </field>
  5035. <field name="OP_STATUS_CHECKSUM_OK" type="int"
  5036. transient="false" volatile="false"
  5037. static="true" final="true" visibility="public"
  5038. deprecated="Deprecated at 0.21. Use Status.CHECKSUM_OK instead.">
  5039. <doc>
  5040. <![CDATA[@deprecated Deprecated at 0.21. Use Status.CHECKSUM_OK instead.]]>
  5041. </doc>
  5042. </field>
  5043. <doc>
  5044. <![CDATA[Transfer data to/from datanode using a streaming protocol.]]>
  5045. </doc>
  5046. </interface>
  5047. <!-- end interface org.apache.hadoop.hdfs.protocol.DataTransferProtocol -->
  5048. <!-- start class org.apache.hadoop.hdfs.protocol.DataTransferProtocol.BlockConstructionStage -->
  5049. <class name="DataTransferProtocol.BlockConstructionStage" extends="java.lang.Enum"
  5050. abstract="false"
  5051. static="true" final="true" visibility="public"
  5052. deprecated="not deprecated">
  5053. <method name="values" return="org.apache.hadoop.hdfs.protocol.DataTransferProtocol.BlockConstructionStage[]"
  5054. abstract="false" native="false" synchronized="false"
  5055. static="true" final="false" visibility="public"
  5056. deprecated="not deprecated">
  5057. </method>
  5058. <method name="valueOf" return="org.apache.hadoop.hdfs.protocol.DataTransferProtocol.BlockConstructionStage"
  5059. abstract="false" native="false" synchronized="false"
  5060. static="true" final="false" visibility="public"
  5061. deprecated="not deprecated">
  5062. <param name="name" type="java.lang.String"/>
  5063. </method>
  5064. <method name="getRecoveryStage" return="org.apache.hadoop.hdfs.protocol.DataTransferProtocol.BlockConstructionStage"
  5065. abstract="false" native="false" synchronized="false"
  5066. static="false" final="false" visibility="public"
  5067. deprecated="not deprecated">
  5068. <doc>
  5069. <![CDATA[get the recovery stage of this stage]]>
  5070. </doc>
  5071. </method>
  5072. <field name="PIPELINE_SETUP_APPEND" type="org.apache.hadoop.hdfs.protocol.DataTransferProtocol.BlockConstructionStage"
  5073. transient="false" volatile="false"
  5074. static="true" final="true" visibility="public"
  5075. deprecated="not deprecated">
  5076. <doc>
  5077. <![CDATA[The enumerates are always listed as regular stage followed by the
  5078. recovery stage.
  5079. Changing this order will make getRecoveryStage not working.]]>
  5080. </doc>
  5081. </field>
  5082. <field name="PIPELINE_SETUP_APPEND_RECOVERY" type="org.apache.hadoop.hdfs.protocol.DataTransferProtocol.BlockConstructionStage"
  5083. transient="false" volatile="false"
  5084. static="true" final="true" visibility="public"
  5085. deprecated="not deprecated">
  5086. </field>
  5087. <field name="DATA_STREAMING" type="org.apache.hadoop.hdfs.protocol.DataTransferProtocol.BlockConstructionStage"
  5088. transient="false" volatile="false"
  5089. static="true" final="true" visibility="public"
  5090. deprecated="not deprecated">
  5091. </field>
  5092. <field name="PIPELINE_SETUP_STREAMING_RECOVERY" type="org.apache.hadoop.hdfs.protocol.DataTransferProtocol.BlockConstructionStage"
  5093. transient="false" volatile="false"
  5094. static="true" final="true" visibility="public"
  5095. deprecated="not deprecated">
  5096. </field>
  5097. <field name="PIPELINE_CLOSE" type="org.apache.hadoop.hdfs.protocol.DataTransferProtocol.BlockConstructionStage"
  5098. transient="false" volatile="false"
  5099. static="true" final="true" visibility="public"
  5100. deprecated="not deprecated">
  5101. </field>
  5102. <field name="PIPELINE_CLOSE_RECOVERY" type="org.apache.hadoop.hdfs.protocol.DataTransferProtocol.BlockConstructionStage"
  5103. transient="false" volatile="false"
  5104. static="true" final="true" visibility="public"
  5105. deprecated="not deprecated">
  5106. </field>
  5107. <field name="PIPELINE_SETUP_CREATE" type="org.apache.hadoop.hdfs.protocol.DataTransferProtocol.BlockConstructionStage"
  5108. transient="false" volatile="false"
  5109. static="true" final="true" visibility="public"
  5110. deprecated="not deprecated">
  5111. </field>
  5112. </class>
  5113. <!-- end class org.apache.hadoop.hdfs.protocol.DataTransferProtocol.BlockConstructionStage -->
  5114. <!-- start class org.apache.hadoop.hdfs.protocol.DataTransferProtocol.Op -->
  5115. <class name="DataTransferProtocol.Op" extends="java.lang.Enum"
  5116. abstract="false"
  5117. static="true" final="true" visibility="public"
  5118. deprecated="not deprecated">
  5119. <method name="values" return="org.apache.hadoop.hdfs.protocol.DataTransferProtocol.Op[]"
  5120. abstract="false" native="false" synchronized="false"
  5121. static="true" final="false" visibility="public"
  5122. deprecated="not deprecated">
  5123. </method>
  5124. <method name="valueOf" return="org.apache.hadoop.hdfs.protocol.DataTransferProtocol.Op"
  5125. abstract="false" native="false" synchronized="false"
  5126. static="true" final="false" visibility="public"
  5127. deprecated="not deprecated">
  5128. <param name="name" type="java.lang.String"/>
  5129. </method>
  5130. <method name="read" return="org.apache.hadoop.hdfs.protocol.DataTransferProtocol.Op"
  5131. abstract="false" native="false" synchronized="false"
  5132. static="true" final="false" visibility="public"
  5133. deprecated="not deprecated">
  5134. <param name="in" type="java.io.DataInput"/>
  5135. <exception name="IOException" type="java.io.IOException"/>
  5136. <doc>
  5137. <![CDATA[Read from in]]>
  5138. </doc>
  5139. </method>
  5140. <method name="write"
  5141. abstract="false" native="false" synchronized="false"
  5142. static="false" final="false" visibility="public"
  5143. deprecated="not deprecated">
  5144. <param name="out" type="java.io.DataOutput"/>
  5145. <exception name="IOException" type="java.io.IOException"/>
  5146. <doc>
  5147. <![CDATA[Write to out]]>
  5148. </doc>
  5149. </method>
  5150. <field name="WRITE_BLOCK" type="org.apache.hadoop.hdfs.protocol.DataTransferProtocol.Op"
  5151. transient="false" volatile="false"
  5152. static="true" final="true" visibility="public"
  5153. deprecated="not deprecated">
  5154. </field>
  5155. <field name="READ_BLOCK" type="org.apache.hadoop.hdfs.protocol.DataTransferProtocol.Op"
  5156. transient="false" volatile="false"
  5157. static="true" final="true" visibility="public"
  5158. deprecated="not deprecated">
  5159. </field>
  5160. <field name="READ_METADATA" type="org.apache.hadoop.hdfs.protocol.DataTransferProtocol.Op"
  5161. transient="false" volatile="false"
  5162. static="true" final="true" visibility="public"
  5163. deprecated="not deprecated">
  5164. </field>
  5165. <field name="REPLACE_BLOCK" type="org.apache.hadoop.hdfs.protocol.DataTransferProtocol.Op"
  5166. transient="false" volatile="false"
  5167. static="true" final="true" visibility="public"
  5168. deprecated="not deprecated">
  5169. </field>
  5170. <field name="COPY_BLOCK" type="org.apache.hadoop.hdfs.protocol.DataTransferProtocol.Op"
  5171. transient="false" volatile="false"
  5172. static="true" final="true" visibility="public"
  5173. deprecated="not deprecated">
  5174. </field>
  5175. <field name="BLOCK_CHECKSUM" type="org.apache.hadoop.hdfs.protocol.DataTransferProtocol.Op"
  5176. transient="false" volatile="false"
  5177. static="true" final="true" visibility="public"
  5178. deprecated="not deprecated">
  5179. </field>
  5180. <field name="code" type="byte"
  5181. transient="false" volatile="false"
  5182. static="false" final="true" visibility="public"
  5183. deprecated="not deprecated">
  5184. <doc>
  5185. <![CDATA[The code for this operation.]]>
  5186. </doc>
  5187. </field>
  5188. <doc>
  5189. <![CDATA[Operation]]>
  5190. </doc>
  5191. </class>
  5192. <!-- end class org.apache.hadoop.hdfs.protocol.DataTransferProtocol.Op -->
  5193. <!-- start class org.apache.hadoop.hdfs.protocol.DataTransferProtocol.PipelineAck -->
  5194. <class name="DataTransferProtocol.PipelineAck" extends="java.lang.Object"
  5195. abstract="false"
  5196. static="true" final="false" visibility="public"
  5197. deprecated="not deprecated">
  5198. <implements name="org.apache.hadoop.io.Writable"/>
  5199. <constructor name="DataTransferProtocol.PipelineAck"
  5200. static="false" final="false" visibility="public"
  5201. deprecated="not deprecated">
  5202. <doc>
  5203. <![CDATA[default constructor]]>
  5204. </doc>
  5205. </constructor>
  5206. <constructor name="DataTransferProtocol.PipelineAck" type="long, org.apache.hadoop.hdfs.protocol.DataTransferProtocol.Status[]"
  5207. static="false" final="false" visibility="public"
  5208. deprecated="not deprecated">
  5209. <doc>
  5210. <![CDATA[Constructor
  5211. @param seqno sequence number
  5212. @param replies an array of replies]]>
  5213. </doc>
  5214. </constructor>
  5215. <method name="getSeqno" return="long"
  5216. abstract="false" native="false" synchronized="false"
  5217. static="false" final="false" visibility="public"
  5218. deprecated="not deprecated">
  5219. <doc>
  5220. <![CDATA[Get the sequence number
  5221. @return the sequence number]]>
  5222. </doc>
  5223. </method>
  5224. <method name="getNumOfReplies" return="short"
  5225. abstract="false" native="false" synchronized="false"
  5226. static="false" final="false" visibility="public"
  5227. deprecated="not deprecated">
  5228. <doc>
  5229. <![CDATA[Get the number of replies
  5230. @return the number of replies]]>
  5231. </doc>
  5232. </method>
  5233. <method name="getReply" return="org.apache.hadoop.hdfs.protocol.DataTransferProtocol.Status"
  5234. abstract="false" native="false" synchronized="false"
  5235. static="false" final="false" visibility="public"
  5236. deprecated="not deprecated">
  5237. <param name="i" type="int"/>
  5238. <doc>
  5239. <![CDATA[get the ith reply
  5240. @return the the ith reply]]>
  5241. </doc>
  5242. </method>
  5243. <method name="isSuccess" return="boolean"
  5244. abstract="false" native="false" synchronized="false"
  5245. static="false" final="false" visibility="public"
  5246. deprecated="not deprecated">
  5247. <doc>
  5248. <![CDATA[Check if this ack contains error status
  5249. @return true if all statuses are SUCCESS]]>
  5250. </doc>
  5251. </method>
  5252. <method name="readFields"
  5253. abstract="false" native="false" synchronized="false"
  5254. static="false" final="false" visibility="public"
  5255. deprecated="not deprecated">
  5256. <param name="in" type="java.io.DataInput"/>
  5257. <exception name="IOException" type="java.io.IOException"/>
  5258. <doc>
  5259. <![CDATA[Writable interface]]>
  5260. </doc>
  5261. </method>
  5262. <method name="write"
  5263. abstract="false" native="false" synchronized="false"
  5264. static="false" final="false" visibility="public"
  5265. deprecated="not deprecated">
  5266. <param name="out" type="java.io.DataOutput"/>
  5267. <exception name="IOException" type="java.io.IOException"/>
  5268. </method>
  5269. <method name="toString" return="java.lang.String"
  5270. abstract="false" native="false" synchronized="false"
  5271. static="false" final="false" visibility="public"
  5272. deprecated="not deprecated">
  5273. </method>
  5274. <field name="UNKOWN_SEQNO" type="long"
  5275. transient="false" volatile="false"
  5276. static="true" final="true" visibility="public"
  5277. deprecated="not deprecated">
  5278. </field>
  5279. <doc>
  5280. <![CDATA[reply]]>
  5281. </doc>
  5282. </class>
  5283. <!-- end class org.apache.hadoop.hdfs.protocol.DataTransferProtocol.PipelineAck -->
  5284. <!-- start class org.apache.hadoop.hdfs.protocol.DataTransferProtocol.Receiver -->
  5285. <class name="DataTransferProtocol.Receiver" extends="java.lang.Object"
  5286. abstract="true"
  5287. static="true" final="false" visibility="public"
  5288. deprecated="not deprecated">
  5289. <constructor name="DataTransferProtocol.Receiver"
  5290. static="false" final="false" visibility="public"
  5291. deprecated="not deprecated">
  5292. </constructor>
  5293. <method name="readOp" return="org.apache.hadoop.hdfs.protocol.DataTransferProtocol.Op"
  5294. abstract="false" native="false" synchronized="false"
  5295. static="false" final="true" visibility="protected"
  5296. deprecated="not deprecated">
  5297. <param name="in" type="java.io.DataInputStream"/>
  5298. <exception name="IOException" type="java.io.IOException"/>
  5299. <doc>
  5300. <![CDATA[Read an Op. It also checks protocol version.]]>
  5301. </doc>
  5302. </method>
  5303. <method name="processOp"
  5304. abstract="false" native="false" synchronized="false"
  5305. static="false" final="true" visibility="protected"
  5306. deprecated="not deprecated">
  5307. <param name="op" type="org.apache.hadoop.hdfs.protocol.DataTransferProtocol.Op"/>
  5308. <param name="in" type="java.io.DataInputStream"/>
  5309. <exception name="IOException" type="java.io.IOException"/>
  5310. <doc>
  5311. <![CDATA[Process op by the corresponding method.]]>
  5312. </doc>
  5313. </method>
  5314. <method name="opReadBlock"
  5315. abstract="true" native="false" synchronized="false"
  5316. static="false" final="false" visibility="protected"
  5317. deprecated="not deprecated">
  5318. <param name="in" type="java.io.DataInputStream"/>
  5319. <param name="blockId" type="long"/>
  5320. <param name="blockGs" type="long"/>
  5321. <param name="offset" type="long"/>
  5322. <param name="length" type="long"/>
  5323. <param name="client" type="java.lang.String"/>
  5324. <param name="accesstoken" type="org.apache.hadoop.hdfs.security.BlockAccessToken"/>
  5325. <exception name="IOException" type="java.io.IOException"/>
  5326. <doc>
  5327. <![CDATA[Abstract OP_READ_BLOCK method.
  5328. Read a block.]]>
  5329. </doc>
  5330. </method>
  5331. <method name="opWriteBlock"
  5332. abstract="true" native="false" synchronized="false"
  5333. static="false" final="false" visibility="protected"
  5334. deprecated="not deprecated">
  5335. <param name="in" type="java.io.DataInputStream"/>
  5336. <param name="blockId" type="long"/>
  5337. <param name="blockGs" type="long"/>
  5338. <param name="pipelineSize" type="int"/>
  5339. <param name="stage" type="org.apache.hadoop.hdfs.protocol.DataTransferProtocol.BlockConstructionStage"/>
  5340. <param name="newGs" type="long"/>
  5341. <param name="minBytesRcvd" type="long"/>
  5342. <param name="maxBytesRcvd" type="long"/>
  5343. <param name="client" type="java.lang.String"/>
  5344. <param name="src" type="org.apache.hadoop.hdfs.protocol.DatanodeInfo"/>
  5345. <param name="targets" type="org.apache.hadoop.hdfs.protocol.DatanodeInfo[]"/>
  5346. <param name="accesstoken" type="org.apache.hadoop.hdfs.security.BlockAccessToken"/>
  5347. <exception name="IOException" type="java.io.IOException"/>
  5348. <doc>
  5349. <![CDATA[Abstract OP_WRITE_BLOCK method.
  5350. Write a block.]]>
  5351. </doc>
  5352. </method>
  5353. <method name="opReplaceBlock"
  5354. abstract="true" native="false" synchronized="false"
  5355. static="false" final="false" visibility="protected"
  5356. deprecated="not deprecated">
  5357. <param name="in" type="java.io.DataInputStream"/>
  5358. <param name="blockId" type="long"/>
  5359. <param name="blockGs" type="long"/>
  5360. <param name="sourceId" type="java.lang.String"/>
  5361. <param name="src" type="org.apache.hadoop.hdfs.protocol.DatanodeInfo"/>
  5362. <param name="accesstoken" type="org.apache.hadoop.hdfs.security.BlockAccessToken"/>
  5363. <exception name="IOException" type="java.io.IOException"/>
  5364. <doc>
  5365. <![CDATA[Abstract OP_REPLACE_BLOCK method.
  5366. It is used for balancing purpose; send to a destination]]>
  5367. </doc>
  5368. </method>
  5369. <method name="opCopyBlock"
  5370. abstract="true" native="false" synchronized="false"
  5371. static="false" final="false" visibility="protected"
  5372. deprecated="not deprecated">
  5373. <param name="in" type="java.io.DataInputStream"/>
  5374. <param name="blockId" type="long"/>
  5375. <param name="blockGs" type="long"/>
  5376. <param name="accesstoken" type="org.apache.hadoop.hdfs.security.BlockAccessToken"/>
  5377. <exception name="IOException" type="java.io.IOException"/>
  5378. <doc>
  5379. <![CDATA[Abstract OP_COPY_BLOCK method.
  5380. It is used for balancing purpose; send to a proxy source.]]>
  5381. </doc>
  5382. </method>
  5383. <method name="opBlockChecksum"
  5384. abstract="true" native="false" synchronized="false"
  5385. static="false" final="false" visibility="protected"
  5386. deprecated="not deprecated">
  5387. <param name="in" type="java.io.DataInputStream"/>
  5388. <param name="blockId" type="long"/>
  5389. <param name="blockGs" type="long"/>
  5390. <param name="accesstoken" type="org.apache.hadoop.hdfs.security.BlockAccessToken"/>
  5391. <exception name="IOException" type="java.io.IOException"/>
  5392. <doc>
  5393. <![CDATA[Abstract OP_BLOCK_CHECKSUM method.
  5394. Get the checksum of a block]]>
  5395. </doc>
  5396. </method>
  5397. <doc>
  5398. <![CDATA[Receiver]]>
  5399. </doc>
  5400. </class>
  5401. <!-- end class org.apache.hadoop.hdfs.protocol.DataTransferProtocol.Receiver -->
  5402. <!-- start class org.apache.hadoop.hdfs.protocol.DataTransferProtocol.Sender -->
  5403. <class name="DataTransferProtocol.Sender" extends="java.lang.Object"
  5404. abstract="false"
  5405. static="true" final="false" visibility="public"
  5406. deprecated="not deprecated">
  5407. <constructor name="DataTransferProtocol.Sender"
  5408. static="false" final="false" visibility="public"
  5409. deprecated="not deprecated">
  5410. </constructor>
  5411. <method name="op"
  5412. abstract="false" native="false" synchronized="false"
  5413. static="true" final="false" visibility="public"
  5414. deprecated="not deprecated">
  5415. <param name="out" type="java.io.DataOutputStream"/>
  5416. <param name="op" type="org.apache.hadoop.hdfs.protocol.DataTransferProtocol.Op"/>
  5417. <exception name="IOException" type="java.io.IOException"/>
  5418. <doc>
  5419. <![CDATA[Initialize a operation.]]>
  5420. </doc>
  5421. </method>
  5422. <method name="opReadBlock"
  5423. abstract="false" native="false" synchronized="false"
  5424. static="true" final="false" visibility="public"
  5425. deprecated="not deprecated">
  5426. <param name="out" type="java.io.DataOutputStream"/>
  5427. <param name="blockId" type="long"/>
  5428. <param name="blockGs" type="long"/>
  5429. <param name="blockOffset" type="long"/>
  5430. <param name="blockLen" type="long"/>
  5431. <param name="clientName" type="java.lang.String"/>
  5432. <param name="accessToken" type="org.apache.hadoop.hdfs.security.BlockAccessToken"/>
  5433. <exception name="IOException" type="java.io.IOException"/>
  5434. <doc>
  5435. <![CDATA[Send OP_READ_BLOCK]]>
  5436. </doc>
  5437. </method>
  5438. <method name="opWriteBlock"
  5439. abstract="false" native="false" synchronized="false"
  5440. static="true" final="false" visibility="public"
  5441. deprecated="not deprecated">
  5442. <param name="out" type="java.io.DataOutputStream"/>
  5443. <param name="blockId" type="long"/>
  5444. <param name="blockGs" type="long"/>
  5445. <param name="pipelineSize" type="int"/>
  5446. <param name="stage" type="org.apache.hadoop.hdfs.protocol.DataTransferProtocol.BlockConstructionStage"/>
  5447. <param name="newGs" type="long"/>
  5448. <param name="minBytesRcvd" type="long"/>
  5449. <param name="maxBytesRcvd" type="long"/>
  5450. <param name="client" type="java.lang.String"/>
  5451. <param name="src" type="org.apache.hadoop.hdfs.protocol.DatanodeInfo"/>
  5452. <param name="targets" type="org.apache.hadoop.hdfs.protocol.DatanodeInfo[]"/>
  5453. <param name="accesstoken" type="org.apache.hadoop.hdfs.security.BlockAccessToken"/>
  5454. <exception name="IOException" type="java.io.IOException"/>
  5455. <doc>
  5456. <![CDATA[Send OP_WRITE_BLOCK]]>
  5457. </doc>
  5458. </method>
  5459. <method name="opReplaceBlock"
  5460. abstract="false" native="false" synchronized="false"
  5461. static="true" final="false" visibility="public"
  5462. deprecated="not deprecated">
  5463. <param name="out" type="java.io.DataOutputStream"/>
  5464. <param name="blockId" type="long"/>
  5465. <param name="blockGs" type="long"/>
  5466. <param name="storageId" type="java.lang.String"/>
  5467. <param name="src" type="org.apache.hadoop.hdfs.protocol.DatanodeInfo"/>
  5468. <param name="accesstoken" type="org.apache.hadoop.hdfs.security.BlockAccessToken"/>
  5469. <exception name="IOException" type="java.io.IOException"/>
  5470. <doc>
  5471. <![CDATA[Send OP_REPLACE_BLOCK]]>
  5472. </doc>
  5473. </method>
  5474. <method name="opCopyBlock"
  5475. abstract="false" native="false" synchronized="false"
  5476. static="true" final="false" visibility="public"
  5477. deprecated="not deprecated">
  5478. <param name="out" type="java.io.DataOutputStream"/>
  5479. <param name="blockId" type="long"/>
  5480. <param name="blockGs" type="long"/>
  5481. <param name="accesstoken" type="org.apache.hadoop.hdfs.security.BlockAccessToken"/>
  5482. <exception name="IOException" type="java.io.IOException"/>
  5483. <doc>
  5484. <![CDATA[Send OP_COPY_BLOCK]]>
  5485. </doc>
  5486. </method>
  5487. <method name="opBlockChecksum"
  5488. abstract="false" native="false" synchronized="false"
  5489. static="true" final="false" visibility="public"
  5490. deprecated="not deprecated">
  5491. <param name="out" type="java.io.DataOutputStream"/>
  5492. <param name="blockId" type="long"/>
  5493. <param name="blockGs" type="long"/>
  5494. <param name="accesstoken" type="org.apache.hadoop.hdfs.security.BlockAccessToken"/>
  5495. <exception name="IOException" type="java.io.IOException"/>
  5496. <doc>
  5497. <![CDATA[Send OP_BLOCK_CHECKSUM]]>
  5498. </doc>
  5499. </method>
  5500. <doc>
  5501. <![CDATA[Sender]]>
  5502. </doc>
  5503. </class>
  5504. <!-- end class org.apache.hadoop.hdfs.protocol.DataTransferProtocol.Sender -->
  5505. <!-- start class org.apache.hadoop.hdfs.protocol.DataTransferProtocol.Status -->
  5506. <class name="DataTransferProtocol.Status" extends="java.lang.Enum"
  5507. abstract="false"
  5508. static="true" final="true" visibility="public"
  5509. deprecated="not deprecated">
  5510. <method name="values" return="org.apache.hadoop.hdfs.protocol.DataTransferProtocol.Status[]"
  5511. abstract="false" native="false" synchronized="false"
  5512. static="true" final="false" visibility="public"
  5513. deprecated="not deprecated">
  5514. </method>
  5515. <method name="valueOf" return="org.apache.hadoop.hdfs.protocol.DataTransferProtocol.Status"
  5516. abstract="false" native="false" synchronized="false"
  5517. static="true" final="false" visibility="public"
  5518. deprecated="not deprecated">
  5519. <param name="name" type="java.lang.String"/>
  5520. </method>
  5521. <method name="read" return="org.apache.hadoop.hdfs.protocol.DataTransferProtocol.Status"
  5522. abstract="false" native="false" synchronized="false"
  5523. static="true" final="false" visibility="public"
  5524. deprecated="not deprecated">
  5525. <param name="in" type="java.io.DataInput"/>
  5526. <exception name="IOException" type="java.io.IOException"/>
  5527. <doc>
  5528. <![CDATA[Read from in]]>
  5529. </doc>
  5530. </method>
  5531. <method name="write"
  5532. abstract="false" native="false" synchronized="false"
  5533. static="false" final="false" visibility="public"
  5534. deprecated="not deprecated">
  5535. <param name="out" type="java.io.DataOutput"/>
  5536. <exception name="IOException" type="java.io.IOException"/>
  5537. <doc>
  5538. <![CDATA[Write to out]]>
  5539. </doc>
  5540. </method>
  5541. <method name="writeOutputStream"
  5542. abstract="false" native="false" synchronized="false"
  5543. static="false" final="false" visibility="public"
  5544. deprecated="not deprecated">
  5545. <param name="out" type="java.io.OutputStream"/>
  5546. <exception name="IOException" type="java.io.IOException"/>
  5547. <doc>
  5548. <![CDATA[Write to out]]>
  5549. </doc>
  5550. </method>
  5551. <field name="SUCCESS" type="org.apache.hadoop.hdfs.protocol.DataTransferProtocol.Status"
  5552. transient="false" volatile="false"
  5553. static="true" final="true" visibility="public"
  5554. deprecated="not deprecated">
  5555. </field>
  5556. <field name="ERROR" type="org.apache.hadoop.hdfs.protocol.DataTransferProtocol.Status"
  5557. transient="false" volatile="false"
  5558. static="true" final="true" visibility="public"
  5559. deprecated="not deprecated">
  5560. </field>
  5561. <field name="ERROR_CHECKSUM" type="org.apache.hadoop.hdfs.protocol.DataTransferProtocol.Status"
  5562. transient="false" volatile="false"
  5563. static="true" final="true" visibility="public"
  5564. deprecated="not deprecated">
  5565. </field>
  5566. <field name="ERROR_INVALID" type="org.apache.hadoop.hdfs.protocol.DataTransferProtocol.Status"
  5567. transient="false" volatile="false"
  5568. static="true" final="true" visibility="public"
  5569. deprecated="not deprecated">
  5570. </field>
  5571. <field name="ERROR_EXISTS" type="org.apache.hadoop.hdfs.protocol.DataTransferProtocol.Status"
  5572. transient="false" volatile="false"
  5573. static="true" final="true" visibility="public"
  5574. deprecated="not deprecated">
  5575. </field>
  5576. <field name="ERROR_ACCESS_TOKEN" type="org.apache.hadoop.hdfs.protocol.DataTransferProtocol.Status"
  5577. transient="false" volatile="false"
  5578. static="true" final="true" visibility="public"
  5579. deprecated="not deprecated">
  5580. </field>
  5581. <field name="CHECKSUM_OK" type="org.apache.hadoop.hdfs.protocol.DataTransferProtocol.Status"
  5582. transient="false" volatile="false"
  5583. static="true" final="true" visibility="public"
  5584. deprecated="not deprecated">
  5585. </field>
  5586. <doc>
  5587. <![CDATA[Status]]>
  5588. </doc>
  5589. </class>
  5590. <!-- end class org.apache.hadoop.hdfs.protocol.DataTransferProtocol.Status -->
  5591. <!-- start class org.apache.hadoop.hdfs.protocol.DirectoryListing -->
  5592. <class name="DirectoryListing" extends="java.lang.Object"
  5593. abstract="false"
  5594. static="false" final="false" visibility="public"
  5595. deprecated="not deprecated">
  5596. <implements name="org.apache.hadoop.io.Writable"/>
  5597. <constructor name="DirectoryListing"
  5598. static="false" final="false" visibility="public"
  5599. deprecated="not deprecated">
  5600. <doc>
  5601. <![CDATA[default constructor]]>
  5602. </doc>
  5603. </constructor>
  5604. <constructor name="DirectoryListing" type="org.apache.hadoop.hdfs.protocol.HdfsFileStatus[], int"
  5605. static="false" final="false" visibility="public"
  5606. deprecated="not deprecated">
  5607. <doc>
  5608. <![CDATA[constructor
  5609. @param partialListing a partial listing of a directory
  5610. @param remainingEntries number of entries that are left to be listed]]>
  5611. </doc>
  5612. </constructor>
  5613. <method name="getPartialListing" return="org.apache.hadoop.hdfs.protocol.HdfsFileStatus[]"
  5614. abstract="false" native="false" synchronized="false"
  5615. static="false" final="false" visibility="public"
  5616. deprecated="not deprecated">
  5617. <doc>
  5618. <![CDATA[Get the partial listing of file status
  5619. @return the partial listing of file status]]>
  5620. </doc>
  5621. </method>
  5622. <method name="getRemainingEntries" return="int"
  5623. abstract="false" native="false" synchronized="false"
  5624. static="false" final="false" visibility="public"
  5625. deprecated="not deprecated">
  5626. <doc>
  5627. <![CDATA[Get the number of remaining entries that are left to be listed
  5628. @return the number of remaining entries that are left to be listed]]>
  5629. </doc>
  5630. </method>
  5631. <method name="hasMore" return="boolean"
  5632. abstract="false" native="false" synchronized="false"
  5633. static="false" final="false" visibility="public"
  5634. deprecated="not deprecated">
  5635. <doc>
  5636. <![CDATA[Check if there are more entries that are left to be listed
  5637. @return true if there are more entries that are left to be listed;
  5638. return false otherwise.]]>
  5639. </doc>
  5640. </method>
  5641. <method name="getLastName" return="byte[]"
  5642. abstract="false" native="false" synchronized="false"
  5643. static="false" final="false" visibility="public"
  5644. deprecated="not deprecated">
  5645. <doc>
  5646. <![CDATA[Get the last name in this list
  5647. @return the last name in the list if it is not empty; otherwise return null]]>
  5648. </doc>
  5649. </method>
  5650. <method name="readFields"
  5651. abstract="false" native="false" synchronized="false"
  5652. static="false" final="false" visibility="public"
  5653. deprecated="not deprecated">
  5654. <param name="in" type="java.io.DataInput"/>
  5655. <exception name="IOException" type="java.io.IOException"/>
  5656. </method>
  5657. <method name="write"
  5658. abstract="false" native="false" synchronized="false"
  5659. static="false" final="false" visibility="public"
  5660. deprecated="not deprecated">
  5661. <param name="out" type="java.io.DataOutput"/>
  5662. <exception name="IOException" type="java.io.IOException"/>
  5663. </method>
  5664. <doc>
  5665. <![CDATA[This class defines a partial listing of a directory to support
  5666. iterative directory listing.]]>
  5667. </doc>
  5668. </class>
  5669. <!-- end class org.apache.hadoop.hdfs.protocol.DirectoryListing -->
  5670. <!-- start class org.apache.hadoop.hdfs.protocol.DSQuotaExceededException -->
  5671. <class name="DSQuotaExceededException" extends="org.apache.hadoop.hdfs.protocol.QuotaExceededException"
  5672. abstract="false"
  5673. static="false" final="false" visibility="public"
  5674. deprecated="not deprecated">
  5675. <constructor name="DSQuotaExceededException"
  5676. static="false" final="false" visibility="public"
  5677. deprecated="not deprecated">
  5678. </constructor>
  5679. <constructor name="DSQuotaExceededException" type="java.lang.String"
  5680. static="false" final="false" visibility="public"
  5681. deprecated="not deprecated">
  5682. </constructor>
  5683. <constructor name="DSQuotaExceededException" type="long, long"
  5684. static="false" final="false" visibility="public"
  5685. deprecated="not deprecated">
  5686. </constructor>
  5687. <method name="getMessage" return="java.lang.String"
  5688. abstract="false" native="false" synchronized="false"
  5689. static="false" final="false" visibility="public"
  5690. deprecated="not deprecated">
  5691. </method>
  5692. <field name="serialVersionUID" type="long"
  5693. transient="false" volatile="false"
  5694. static="true" final="true" visibility="protected"
  5695. deprecated="not deprecated">
  5696. </field>
  5697. </class>
  5698. <!-- end class org.apache.hadoop.hdfs.protocol.DSQuotaExceededException -->
  5699. <!-- start interface org.apache.hadoop.hdfs.protocol.FSConstants -->
  5700. <interface name="FSConstants" abstract="true"
  5701. static="false" final="false" visibility="public"
  5702. deprecated="not deprecated">
  5703. <field name="MIN_BLOCKS_FOR_WRITE" type="int"
  5704. transient="false" volatile="false"
  5705. static="true" final="true" visibility="public"
  5706. deprecated="not deprecated">
  5707. </field>
  5708. <field name="BLOCK_INVALIDATE_CHUNK" type="int"
  5709. transient="false" volatile="false"
  5710. static="true" final="true" visibility="public"
  5711. deprecated="not deprecated">
  5712. </field>
  5713. <field name="QUOTA_DONT_SET" type="long"
  5714. transient="false" volatile="false"
  5715. static="true" final="true" visibility="public"
  5716. deprecated="not deprecated">
  5717. </field>
  5718. <field name="QUOTA_RESET" type="long"
  5719. transient="false" volatile="false"
  5720. static="true" final="true" visibility="public"
  5721. deprecated="not deprecated">
  5722. </field>
  5723. <field name="HEARTBEAT_INTERVAL" type="long"
  5724. transient="false" volatile="false"
  5725. static="true" final="true" visibility="public"
  5726. deprecated="not deprecated">
  5727. </field>
  5728. <field name="BLOCKREPORT_INTERVAL" type="long"
  5729. transient="false" volatile="false"
  5730. static="true" final="true" visibility="public"
  5731. deprecated="not deprecated">
  5732. </field>
  5733. <field name="BLOCKREPORT_INITIAL_DELAY" type="long"
  5734. transient="false" volatile="false"
  5735. static="true" final="true" visibility="public"
  5736. deprecated="not deprecated">
  5737. </field>
  5738. <field name="LEASE_SOFTLIMIT_PERIOD" type="long"
  5739. transient="false" volatile="false"
  5740. static="true" final="true" visibility="public"
  5741. deprecated="not deprecated">
  5742. </field>
  5743. <field name="LEASE_HARDLIMIT_PERIOD" type="long"
  5744. transient="false" volatile="false"
  5745. static="true" final="true" visibility="public"
  5746. deprecated="not deprecated">
  5747. </field>
  5748. <field name="LEASE_RECOVER_PERIOD" type="long"
  5749. transient="false" volatile="false"
  5750. static="true" final="true" visibility="public"
  5751. deprecated="not deprecated">
  5752. </field>
  5753. <field name="MAX_PATH_LENGTH" type="int"
  5754. transient="false" volatile="false"
  5755. static="true" final="true" visibility="public"
  5756. deprecated="not deprecated">
  5757. </field>
  5758. <field name="MAX_PATH_DEPTH" type="int"
  5759. transient="false" volatile="false"
  5760. static="true" final="true" visibility="public"
  5761. deprecated="not deprecated">
  5762. </field>
  5763. <field name="BUFFER_SIZE" type="int"
  5764. transient="false" volatile="false"
  5765. static="true" final="true" visibility="public"
  5766. deprecated="not deprecated">
  5767. </field>
  5768. <field name="SMALL_BUFFER_SIZE" type="int"
  5769. transient="false" volatile="false"
  5770. static="true" final="true" visibility="public"
  5771. deprecated="not deprecated">
  5772. </field>
  5773. <field name="DEFAULT_BLOCK_SIZE" type="long"
  5774. transient="false" volatile="false"
  5775. static="true" final="true" visibility="public"
  5776. deprecated="not deprecated">
  5777. </field>
  5778. <field name="DEFAULT_BYTES_PER_CHECKSUM" type="int"
  5779. transient="false" volatile="false"
  5780. static="true" final="true" visibility="public"
  5781. deprecated="not deprecated">
  5782. </field>
  5783. <field name="DEFAULT_WRITE_PACKET_SIZE" type="int"
  5784. transient="false" volatile="false"
  5785. static="true" final="true" visibility="public"
  5786. deprecated="not deprecated">
  5787. </field>
  5788. <field name="DEFAULT_REPLICATION_FACTOR" type="short"
  5789. transient="false" volatile="false"
  5790. static="true" final="true" visibility="public"
  5791. deprecated="not deprecated">
  5792. </field>
  5793. <field name="DEFAULT_FILE_BUFFER_SIZE" type="int"
  5794. transient="false" volatile="false"
  5795. static="true" final="true" visibility="public"
  5796. deprecated="not deprecated">
  5797. </field>
  5798. <field name="DEFAULT_DATA_SOCKET_SIZE" type="int"
  5799. transient="false" volatile="false"
  5800. static="true" final="true" visibility="public"
  5801. deprecated="not deprecated">
  5802. </field>
  5803. <field name="SIZE_OF_INTEGER" type="int"
  5804. transient="false" volatile="false"
  5805. static="true" final="true" visibility="public"
  5806. deprecated="not deprecated">
  5807. </field>
  5808. <field name="HDFS_URI_SCHEME" type="java.lang.String"
  5809. transient="false" volatile="false"
  5810. static="true" final="true" visibility="public"
  5811. deprecated="not deprecated">
  5812. <doc>
  5813. <![CDATA[URI Scheme for hdfs://namenode/ URIs.]]>
  5814. </doc>
  5815. </field>
  5816. <field name="LAYOUT_VERSION" type="int"
  5817. transient="false" volatile="false"
  5818. static="true" final="true" visibility="public"
  5819. deprecated="not deprecated">
  5820. </field>
  5821. <doc>
  5822. <![CDATA[Some handy constants]]>
  5823. </doc>
  5824. </interface>
  5825. <!-- end interface org.apache.hadoop.hdfs.protocol.FSConstants -->
  5826. <!-- start class org.apache.hadoop.hdfs.protocol.FSConstants.DatanodeReportType -->
  5827. <class name="FSConstants.DatanodeReportType" extends="java.lang.Enum"
  5828. abstract="false"
  5829. static="true" final="true" visibility="public"
  5830. deprecated="not deprecated">
  5831. <method name="values" return="org.apache.hadoop.hdfs.protocol.FSConstants.DatanodeReportType[]"
  5832. abstract="false" native="false" synchronized="false"
  5833. static="true" final="false" visibility="public"
  5834. deprecated="not deprecated">
  5835. </method>
  5836. <method name="valueOf" return="org.apache.hadoop.hdfs.protocol.FSConstants.DatanodeReportType"
  5837. abstract="false" native="false" synchronized="false"
  5838. static="true" final="false" visibility="public"
  5839. deprecated="not deprecated">
  5840. <param name="name" type="java.lang.String"/>
  5841. </method>
  5842. <field name="ALL" type="org.apache.hadoop.hdfs.protocol.FSConstants.DatanodeReportType"
  5843. transient="false" volatile="false"
  5844. static="true" final="true" visibility="public"
  5845. deprecated="not deprecated">
  5846. </field>
  5847. <field name="LIVE" type="org.apache.hadoop.hdfs.protocol.FSConstants.DatanodeReportType"
  5848. transient="false" volatile="false"
  5849. static="true" final="true" visibility="public"
  5850. deprecated="not deprecated">
  5851. </field>
  5852. <field name="DEAD" type="org.apache.hadoop.hdfs.protocol.FSConstants.DatanodeReportType"
  5853. transient="false" volatile="false"
  5854. static="true" final="true" visibility="public"
  5855. deprecated="not deprecated">
  5856. </field>
  5857. </class>
  5858. <!-- end class org.apache.hadoop.hdfs.protocol.FSConstants.DatanodeReportType -->
  5859. <!-- start class org.apache.hadoop.hdfs.protocol.FSConstants.SafeModeAction -->
  5860. <class name="FSConstants.SafeModeAction" extends="java.lang.Enum"
  5861. abstract="false"
  5862. static="true" final="true" visibility="public"
  5863. deprecated="not deprecated">
  5864. <method name="values" return="org.apache.hadoop.hdfs.protocol.FSConstants.SafeModeAction[]"
  5865. abstract="false" native="false" synchronized="false"
  5866. static="true" final="false" visibility="public"
  5867. deprecated="not deprecated">
  5868. </method>
  5869. <method name="valueOf" return="org.apache.hadoop.hdfs.protocol.FSConstants.SafeModeAction"
  5870. abstract="false" native="false" synchronized="false"
  5871. static="true" final="false" visibility="public"
  5872. deprecated="not deprecated">
  5873. <param name="name" type="java.lang.String"/>
  5874. </method>
  5875. <field name="SAFEMODE_LEAVE" type="org.apache.hadoop.hdfs.protocol.FSConstants.SafeModeAction"
  5876. transient="false" volatile="false"
  5877. static="true" final="true" visibility="public"
  5878. deprecated="not deprecated">
  5879. </field>
  5880. <field name="SAFEMODE_ENTER" type="org.apache.hadoop.hdfs.protocol.FSConstants.SafeModeAction"
  5881. transient="false" volatile="false"
  5882. static="true" final="true" visibility="public"
  5883. deprecated="not deprecated">
  5884. </field>
  5885. <field name="SAFEMODE_GET" type="org.apache.hadoop.hdfs.protocol.FSConstants.SafeModeAction"
  5886. transient="false" volatile="false"
  5887. static="true" final="true" visibility="public"
  5888. deprecated="not deprecated">
  5889. </field>
  5890. </class>
  5891. <!-- end class org.apache.hadoop.hdfs.protocol.FSConstants.SafeModeAction -->
  5892. <!-- start class org.apache.hadoop.hdfs.protocol.FSConstants.UpgradeAction -->
  5893. <class name="FSConstants.UpgradeAction" extends="java.lang.Enum"
  5894. abstract="false"
  5895. static="true" final="true" visibility="public"
  5896. deprecated="not deprecated">
  5897. <method name="values" return="org.apache.hadoop.hdfs.protocol.FSConstants.UpgradeAction[]"
  5898. abstract="false" native="false" synchronized="false"
  5899. static="true" final="false" visibility="public"
  5900. deprecated="not deprecated">
  5901. </method>
  5902. <method name="valueOf" return="org.apache.hadoop.hdfs.protocol.FSConstants.UpgradeAction"
  5903. abstract="false" native="false" synchronized="false"
  5904. static="true" final="false" visibility="public"
  5905. deprecated="not deprecated">
  5906. <param name="name" type="java.lang.String"/>
  5907. </method>
  5908. <field name="GET_STATUS" type="org.apache.hadoop.hdfs.protocol.FSConstants.UpgradeAction"
  5909. transient="false" volatile="false"
  5910. static="true" final="true" visibility="public"
  5911. deprecated="not deprecated">
  5912. </field>
  5913. <field name="DETAILED_STATUS" type="org.apache.hadoop.hdfs.protocol.FSConstants.UpgradeAction"
  5914. transient="false" volatile="false"
  5915. static="true" final="true" visibility="public"
  5916. deprecated="not deprecated">
  5917. </field>
  5918. <field name="FORCE_PROCEED" type="org.apache.hadoop.hdfs.protocol.FSConstants.UpgradeAction"
  5919. transient="false" volatile="false"
  5920. static="true" final="true" visibility="public"
  5921. deprecated="not deprecated">
  5922. </field>
  5923. <doc>
  5924. <![CDATA[Distributed upgrade actions:
  5925. 1. Get upgrade status.
  5926. 2. Get detailed upgrade status.
  5927. 3. Proceed with the upgrade if it is stuck, no matter what the status is.]]>
  5928. </doc>
  5929. </class>
  5930. <!-- end class org.apache.hadoop.hdfs.protocol.FSConstants.UpgradeAction -->
  5931. <!-- start class org.apache.hadoop.hdfs.protocol.HdfsFileStatus -->
  5932. <class name="HdfsFileStatus" extends="java.lang.Object"
  5933. abstract="false"
  5934. static="false" final="false" visibility="public"
  5935. deprecated="not deprecated">
  5936. <implements name="org.apache.hadoop.io.Writable"/>
  5937. <constructor name="HdfsFileStatus"
  5938. static="false" final="false" visibility="public"
  5939. deprecated="not deprecated">
  5940. <doc>
  5941. <![CDATA[default constructor]]>
  5942. </doc>
  5943. </constructor>
  5944. <constructor name="HdfsFileStatus" type="long, boolean, int, long, long, long, org.apache.hadoop.fs.permission.FsPermission, java.lang.String, java.lang.String, byte[], byte[]"
  5945. static="false" final="false" visibility="public"
  5946. deprecated="not deprecated">
  5947. <doc>
  5948. <![CDATA[Constructor
  5949. @param length the number of bytes the file has
  5950. @param isdir if the path is a directory
  5951. @param block_replication the replication factor
  5952. @param blocksize the block size
  5953. @param modification_time modification time
  5954. @param access_time access time
  5955. @param permission permission
  5956. @param owner the owner of the path
  5957. @param group the group of the path
  5958. @param path the local name in java UTF8 encoding the same as that in-memory]]>
  5959. </doc>
  5960. </constructor>
  5961. <method name="getLen" return="long"
  5962. abstract="false" native="false" synchronized="false"
  5963. static="false" final="true" visibility="public"
  5964. deprecated="not deprecated">
  5965. <doc>
  5966. <![CDATA[Get the length of this file, in bytes.
  5967. @return the length of this file, in bytes.]]>
  5968. </doc>
  5969. </method>
  5970. <method name="isDir" return="boolean"
  5971. abstract="false" native="false" synchronized="false"
  5972. static="false" final="true" visibility="public"
  5973. deprecated="not deprecated">
  5974. <doc>
  5975. <![CDATA[Is this a directory?
  5976. @return true if this is a directory]]>
  5977. </doc>
  5978. </method>
  5979. <method name="isSymlink" return="boolean"
  5980. abstract="false" native="false" synchronized="false"
  5981. static="false" final="false" visibility="public"
  5982. deprecated="not deprecated">
  5983. <doc>
  5984. <![CDATA[Is this a symbolic link?
  5985. @return true if this is a symbolic link]]>
  5986. </doc>
  5987. </method>
  5988. <method name="getBlockSize" return="long"
  5989. abstract="false" native="false" synchronized="false"
  5990. static="false" final="true" visibility="public"
  5991. deprecated="not deprecated">
  5992. <doc>
  5993. <![CDATA[Get the block size of the file.
  5994. @return the number of bytes]]>
  5995. </doc>
  5996. </method>
  5997. <method name="getReplication" return="short"
  5998. abstract="false" native="false" synchronized="false"
  5999. static="false" final="true" visibility="public"
  6000. deprecated="not deprecated">
  6001. <doc>
  6002. <![CDATA[Get the replication factor of a file.
  6003. @return the replication factor of a file.]]>
  6004. </doc>
  6005. </method>
  6006. <method name="getModificationTime" return="long"
  6007. abstract="false" native="false" synchronized="false"
  6008. static="false" final="true" visibility="public"
  6009. deprecated="not deprecated">
  6010. <doc>
  6011. <![CDATA[Get the modification time of the file.
  6012. @return the modification time of file in milliseconds since January 1, 1970 UTC.]]>
  6013. </doc>
  6014. </method>
  6015. <method name="getAccessTime" return="long"
  6016. abstract="false" native="false" synchronized="false"
  6017. static="false" final="true" visibility="public"
  6018. deprecated="not deprecated">
  6019. <doc>
  6020. <![CDATA[Get the access time of the file.
  6021. @return the access time of file in milliseconds since January 1, 1970 UTC.]]>
  6022. </doc>
  6023. </method>
  6024. <method name="getPermission" return="org.apache.hadoop.fs.permission.FsPermission"
  6025. abstract="false" native="false" synchronized="false"
  6026. static="false" final="true" visibility="public"
  6027. deprecated="not deprecated">
  6028. <doc>
  6029. <![CDATA[Get FsPermission associated with the file.
  6030. @return permssion]]>
  6031. </doc>
  6032. </method>
  6033. <method name="getOwner" return="java.lang.String"
  6034. abstract="false" native="false" synchronized="false"
  6035. static="false" final="true" visibility="public"
  6036. deprecated="not deprecated">
  6037. <doc>
  6038. <![CDATA[Get the owner of the file.
  6039. @return owner of the file]]>
  6040. </doc>
  6041. </method>
  6042. <method name="getGroup" return="java.lang.String"
  6043. abstract="false" native="false" synchronized="false"
  6044. static="false" final="true" visibility="public"
  6045. deprecated="not deprecated">
  6046. <doc>
  6047. <![CDATA[Get the group associated with the file.
  6048. @return group for the file.]]>
  6049. </doc>
  6050. </method>
  6051. <method name="isEmptyLocalName" return="boolean"
  6052. abstract="false" native="false" synchronized="false"
  6053. static="false" final="true" visibility="public"
  6054. deprecated="not deprecated">
  6055. <doc>
  6056. <![CDATA[Check if the local name is empty
  6057. @return true if the name is empty]]>
  6058. </doc>
  6059. </method>
  6060. <method name="getLocalName" return="java.lang.String"
  6061. abstract="false" native="false" synchronized="false"
  6062. static="false" final="true" visibility="public"
  6063. deprecated="not deprecated">
  6064. <doc>
  6065. <![CDATA[Get the string representation of the local name
  6066. @return the local name in string]]>
  6067. </doc>
  6068. </method>
  6069. <method name="getLocalNameInBytes" return="byte[]"
  6070. abstract="false" native="false" synchronized="false"
  6071. static="false" final="true" visibility="public"
  6072. deprecated="not deprecated">
  6073. <doc>
  6074. <![CDATA[Get the Java UTF8 representation of the local name
  6075. @return the local name in java UTF8]]>
  6076. </doc>
  6077. </method>
  6078. <method name="getFullName" return="java.lang.String"
  6079. abstract="false" native="false" synchronized="false"
  6080. static="false" final="true" visibility="public"
  6081. deprecated="not deprecated">
  6082. <param name="parent" type="java.lang.String"/>
  6083. <doc>
  6084. <![CDATA[Get the string representation of the full path name
  6085. @param parent the parent path
  6086. @return the full path in string]]>
  6087. </doc>
  6088. </method>
  6089. <method name="getFullPath" return="org.apache.hadoop.fs.Path"
  6090. abstract="false" native="false" synchronized="false"
  6091. static="false" final="true" visibility="public"
  6092. deprecated="not deprecated">
  6093. <param name="parent" type="org.apache.hadoop.fs.Path"/>
  6094. <doc>
  6095. <![CDATA[Get the full path
  6096. @param parent the parent path
  6097. @return the full path]]>
  6098. </doc>
  6099. </method>
  6100. <method name="getSymlink" return="java.lang.String"
  6101. abstract="false" native="false" synchronized="false"
  6102. static="false" final="true" visibility="public"
  6103. deprecated="not deprecated">
  6104. <doc>
  6105. <![CDATA[Get the string representation of the symlink.
  6106. @return the symlink as a string.]]>
  6107. </doc>
  6108. </method>
  6109. <method name="write"
  6110. abstract="false" native="false" synchronized="false"
  6111. static="false" final="false" visibility="public"
  6112. deprecated="not deprecated">
  6113. <param name="out" type="java.io.DataOutput"/>
  6114. <exception name="IOException" type="java.io.IOException"/>
  6115. </method>
  6116. <method name="readFields"
  6117. abstract="false" native="false" synchronized="false"
  6118. static="false" final="false" visibility="public"
  6119. deprecated="not deprecated">
  6120. <param name="in" type="java.io.DataInput"/>
  6121. <exception name="IOException" type="java.io.IOException"/>
  6122. </method>
  6123. <field name="EMPTY_NAME" type="byte[]"
  6124. transient="false" volatile="false"
  6125. static="true" final="true" visibility="public"
  6126. deprecated="not deprecated">
  6127. </field>
  6128. <doc>
  6129. <![CDATA[Interface that represents the over the wire information for a file.]]>
  6130. </doc>
  6131. </class>
  6132. <!-- end class org.apache.hadoop.hdfs.protocol.HdfsFileStatus -->
  6133. <!-- start class org.apache.hadoop.hdfs.protocol.LocatedBlock -->
  6134. <class name="LocatedBlock" extends="java.lang.Object"
  6135. abstract="false"
  6136. static="false" final="false" visibility="public"
  6137. deprecated="not deprecated">
  6138. <implements name="org.apache.hadoop.io.Writable"/>
  6139. <constructor name="LocatedBlock"
  6140. static="false" final="false" visibility="public"
  6141. deprecated="not deprecated">
  6142. </constructor>
  6143. <constructor name="LocatedBlock" type="org.apache.hadoop.hdfs.protocol.Block, org.apache.hadoop.hdfs.protocol.DatanodeInfo[]"
  6144. static="false" final="false" visibility="public"
  6145. deprecated="not deprecated">
  6146. </constructor>
  6147. <constructor name="LocatedBlock" type="org.apache.hadoop.hdfs.protocol.Block, org.apache.hadoop.hdfs.protocol.DatanodeInfo[], long"
  6148. static="false" final="false" visibility="public"
  6149. deprecated="not deprecated">
  6150. </constructor>
  6151. <constructor name="LocatedBlock" type="org.apache.hadoop.hdfs.protocol.Block, org.apache.hadoop.hdfs.protocol.DatanodeInfo[], long, boolean"
  6152. static="false" final="false" visibility="public"
  6153. deprecated="not deprecated">
  6154. </constructor>
  6155. <method name="getAccessToken" return="org.apache.hadoop.hdfs.security.BlockAccessToken"
  6156. abstract="false" native="false" synchronized="false"
  6157. static="false" final="false" visibility="public"
  6158. deprecated="not deprecated">
  6159. </method>
  6160. <method name="setAccessToken"
  6161. abstract="false" native="false" synchronized="false"
  6162. static="false" final="false" visibility="public"
  6163. deprecated="not deprecated">
  6164. <param name="token" type="org.apache.hadoop.hdfs.security.BlockAccessToken"/>
  6165. </method>
  6166. <method name="getBlock" return="org.apache.hadoop.hdfs.protocol.Block"
  6167. abstract="false" native="false" synchronized="false"
  6168. static="false" final="false" visibility="public"
  6169. deprecated="not deprecated">
  6170. </method>
  6171. <method name="getLocations" return="org.apache.hadoop.hdfs.protocol.DatanodeInfo[]"
  6172. abstract="false" native="false" synchronized="false"
  6173. static="false" final="false" visibility="public"
  6174. deprecated="not deprecated">
  6175. </method>
  6176. <method name="getStartOffset" return="long"
  6177. abstract="false" native="false" synchronized="false"
  6178. static="false" final="false" visibility="public"
  6179. deprecated="not deprecated">
  6180. </method>
  6181. <method name="getBlockSize" return="long"
  6182. abstract="false" native="false" synchronized="false"
  6183. static="false" final="false" visibility="public"
  6184. deprecated="not deprecated">
  6185. </method>
  6186. <method name="isCorrupt" return="boolean"
  6187. abstract="false" native="false" synchronized="false"
  6188. static="false" final="false" visibility="public"
  6189. deprecated="not deprecated">
  6190. </method>
  6191. <method name="write"
  6192. abstract="false" native="false" synchronized="false"
  6193. static="false" final="false" visibility="public"
  6194. deprecated="not deprecated">
  6195. <param name="out" type="java.io.DataOutput"/>
  6196. <exception name="IOException" type="java.io.IOException"/>
  6197. </method>
  6198. <method name="readFields"
  6199. abstract="false" native="false" synchronized="false"
  6200. static="false" final="false" visibility="public"
  6201. deprecated="not deprecated">
  6202. <param name="in" type="java.io.DataInput"/>
  6203. <exception name="IOException" type="java.io.IOException"/>
  6204. </method>
  6205. <method name="read" return="org.apache.hadoop.hdfs.protocol.LocatedBlock"
  6206. abstract="false" native="false" synchronized="false"
  6207. static="true" final="false" visibility="public"
  6208. deprecated="not deprecated">
  6209. <param name="in" type="java.io.DataInput"/>
  6210. <exception name="IOException" type="java.io.IOException"/>
  6211. <doc>
  6212. <![CDATA[Read LocatedBlock from in.]]>
  6213. </doc>
  6214. </method>
  6215. <method name="toString" return="java.lang.String"
  6216. abstract="false" native="false" synchronized="false"
  6217. static="false" final="false" visibility="public"
  6218. deprecated="not deprecated">
  6219. <doc>
  6220. <![CDATA[{@inheritDoc}]]>
  6221. </doc>
  6222. </method>
  6223. <doc>
  6224. <![CDATA[A LocatedBlock is a pair of Block, DatanodeInfo[]
  6225. objects. It tells where to find a Block.]]>
  6226. </doc>
  6227. </class>
  6228. <!-- end class org.apache.hadoop.hdfs.protocol.LocatedBlock -->
  6229. <!-- start class org.apache.hadoop.hdfs.protocol.LocatedBlocks -->
  6230. <class name="LocatedBlocks" extends="java.lang.Object"
  6231. abstract="false"
  6232. static="false" final="false" visibility="public"
  6233. deprecated="not deprecated">
  6234. <implements name="org.apache.hadoop.io.Writable"/>
  6235. <constructor name="LocatedBlocks" type="long, boolean, java.util.List, org.apache.hadoop.hdfs.protocol.LocatedBlock, boolean"
  6236. static="false" final="false" visibility="public"
  6237. deprecated="not deprecated">
  6238. <doc>
  6239. <![CDATA[public Constructor]]>
  6240. </doc>
  6241. </constructor>
  6242. <method name="getLocatedBlocks" return="java.util.List"
  6243. abstract="false" native="false" synchronized="false"
  6244. static="false" final="false" visibility="public"
  6245. deprecated="not deprecated">
  6246. <doc>
  6247. <![CDATA[Get located blocks.]]>
  6248. </doc>
  6249. </method>
  6250. <method name="getLastLocatedBlock" return="org.apache.hadoop.hdfs.protocol.LocatedBlock"
  6251. abstract="false" native="false" synchronized="false"
  6252. static="false" final="false" visibility="public"
  6253. deprecated="not deprecated">
  6254. <doc>
  6255. <![CDATA[Get the last located block.]]>
  6256. </doc>
  6257. </method>
  6258. <method name="isLastBlockComplete" return="boolean"
  6259. abstract="false" native="false" synchronized="false"
  6260. static="false" final="false" visibility="public"
  6261. deprecated="not deprecated">
  6262. <doc>
  6263. <![CDATA[Is the last block completed?]]>
  6264. </doc>
  6265. </method>
  6266. <method name="get" return="org.apache.hadoop.hdfs.protocol.LocatedBlock"
  6267. abstract="false" native="false" synchronized="false"
  6268. static="false" final="false" visibility="public"
  6269. deprecated="not deprecated">
  6270. <param name="index" type="int"/>
  6271. <doc>
  6272. <![CDATA[Get located block.]]>
  6273. </doc>
  6274. </method>
  6275. <method name="locatedBlockCount" return="int"
  6276. abstract="false" native="false" synchronized="false"
  6277. static="false" final="false" visibility="public"
  6278. deprecated="not deprecated">
  6279. <doc>
  6280. <![CDATA[Get number of located blocks.]]>
  6281. </doc>
  6282. </method>
  6283. <method name="getFileLength" return="long"
  6284. abstract="false" native="false" synchronized="false"
  6285. static="false" final="false" visibility="public"
  6286. deprecated="not deprecated">
  6287. </method>
  6288. <method name="isUnderConstruction" return="boolean"
  6289. abstract="false" native="false" synchronized="false"
  6290. static="false" final="false" visibility="public"
  6291. deprecated="not deprecated">
  6292. <doc>
  6293. <![CDATA[Return ture if file was under construction when
  6294. this LocatedBlocks was constructed, false otherwise.]]>
  6295. </doc>
  6296. </method>
  6297. <method name="findBlock" return="int"
  6298. abstract="false" native="false" synchronized="false"
  6299. static="false" final="false" visibility="public"
  6300. deprecated="not deprecated">
  6301. <param name="offset" type="long"/>
  6302. <doc>
  6303. <![CDATA[Find block containing specified offset.
  6304. @return block if found, or null otherwise.]]>
  6305. </doc>
  6306. </method>
  6307. <method name="insertRange"
  6308. abstract="false" native="false" synchronized="false"
  6309. static="false" final="false" visibility="public"
  6310. deprecated="not deprecated">
  6311. <param name="blockIdx" type="int"/>
  6312. <param name="newBlocks" type="java.util.List"/>
  6313. </method>
  6314. <method name="getInsertIndex" return="int"
  6315. abstract="false" native="false" synchronized="false"
  6316. static="true" final="false" visibility="public"
  6317. deprecated="not deprecated">
  6318. <param name="binSearchResult" type="int"/>
  6319. </method>
  6320. <method name="write"
  6321. abstract="false" native="false" synchronized="false"
  6322. static="false" final="false" visibility="public"
  6323. deprecated="not deprecated">
  6324. <param name="out" type="java.io.DataOutput"/>
  6325. <exception name="IOException" type="java.io.IOException"/>
  6326. </method>
  6327. <method name="readFields"
  6328. abstract="false" native="false" synchronized="false"
  6329. static="false" final="false" visibility="public"
  6330. deprecated="not deprecated">
  6331. <param name="in" type="java.io.DataInput"/>
  6332. <exception name="IOException" type="java.io.IOException"/>
  6333. </method>
  6334. <method name="toString" return="java.lang.String"
  6335. abstract="false" native="false" synchronized="false"
  6336. static="false" final="false" visibility="public"
  6337. deprecated="not deprecated">
  6338. <doc>
  6339. <![CDATA[{@inheritDoc}]]>
  6340. </doc>
  6341. </method>
  6342. <doc>
  6343. <![CDATA[Collection of blocks with their locations and the file length.]]>
  6344. </doc>
  6345. </class>
  6346. <!-- end class org.apache.hadoop.hdfs.protocol.LocatedBlocks -->
  6347. <!-- start class org.apache.hadoop.hdfs.protocol.NSQuotaExceededException -->
  6348. <class name="NSQuotaExceededException" extends="org.apache.hadoop.hdfs.protocol.QuotaExceededException"
  6349. abstract="false"
  6350. static="false" final="true" visibility="public"
  6351. deprecated="not deprecated">
  6352. <constructor name="NSQuotaExceededException"
  6353. static="false" final="false" visibility="public"
  6354. deprecated="not deprecated">
  6355. </constructor>
  6356. <constructor name="NSQuotaExceededException" type="java.lang.String"
  6357. static="false" final="false" visibility="public"
  6358. deprecated="not deprecated">
  6359. </constructor>
  6360. <constructor name="NSQuotaExceededException" type="long, long"
  6361. static="false" final="false" visibility="public"
  6362. deprecated="not deprecated">
  6363. </constructor>
  6364. <method name="getMessage" return="java.lang.String"
  6365. abstract="false" native="false" synchronized="false"
  6366. static="false" final="false" visibility="public"
  6367. deprecated="not deprecated">
  6368. </method>
  6369. <field name="serialVersionUID" type="long"
  6370. transient="false" volatile="false"
  6371. static="true" final="true" visibility="protected"
  6372. deprecated="not deprecated">
  6373. </field>
  6374. </class>
  6375. <!-- end class org.apache.hadoop.hdfs.protocol.NSQuotaExceededException -->
  6376. <!-- start class org.apache.hadoop.hdfs.protocol.QuotaExceededException -->
  6377. <class name="QuotaExceededException" extends="java.io.IOException"
  6378. abstract="false"
  6379. static="false" final="false" visibility="public"
  6380. deprecated="not deprecated">
  6381. <constructor name="QuotaExceededException"
  6382. static="false" final="false" visibility="protected"
  6383. deprecated="not deprecated">
  6384. </constructor>
  6385. <constructor name="QuotaExceededException" type="java.lang.String"
  6386. static="false" final="false" visibility="protected"
  6387. deprecated="not deprecated">
  6388. </constructor>
  6389. <constructor name="QuotaExceededException" type="long, long"
  6390. static="false" final="false" visibility="protected"
  6391. deprecated="not deprecated">
  6392. </constructor>
  6393. <method name="setPathName"
  6394. abstract="false" native="false" synchronized="false"
  6395. static="false" final="false" visibility="public"
  6396. deprecated="not deprecated">
  6397. <param name="path" type="java.lang.String"/>
  6398. </method>
  6399. <method name="getMessage" return="java.lang.String"
  6400. abstract="false" native="false" synchronized="false"
  6401. static="false" final="false" visibility="public"
  6402. deprecated="not deprecated">
  6403. </method>
  6404. <field name="serialVersionUID" type="long"
  6405. transient="false" volatile="false"
  6406. static="true" final="true" visibility="protected"
  6407. deprecated="not deprecated">
  6408. </field>
  6409. <field name="pathName" type="java.lang.String"
  6410. transient="false" volatile="false"
  6411. static="false" final="false" visibility="protected"
  6412. deprecated="not deprecated">
  6413. </field>
  6414. <field name="quota" type="long"
  6415. transient="false" volatile="false"
  6416. static="false" final="false" visibility="protected"
  6417. deprecated="not deprecated">
  6418. </field>
  6419. <field name="count" type="long"
  6420. transient="false" volatile="false"
  6421. static="false" final="false" visibility="protected"
  6422. deprecated="not deprecated">
  6423. </field>
  6424. <doc>
  6425. <![CDATA[This exception is thrown when modification to HDFS results in violation
  6426. of a directory quota. A directory quota might be namespace quota (limit
  6427. on number of files and directories) or a diskspace quota (limit on space
  6428. taken by all the file under the directory tree). <br> <br>
  6429. The message for the exception specifies the directory where the quota
  6430. was violated and actual quotas. Specific message is generated in the
  6431. corresponding Exception class:
  6432. DSQuotaExceededException or
  6433. NSQuotaExceededException]]>
  6434. </doc>
  6435. </class>
  6436. <!-- end class org.apache.hadoop.hdfs.protocol.QuotaExceededException -->
  6437. <!-- start class org.apache.hadoop.hdfs.protocol.RecoveryInProgressException -->
  6438. <class name="RecoveryInProgressException" extends="java.io.IOException"
  6439. abstract="false"
  6440. static="false" final="false" visibility="public"
  6441. deprecated="not deprecated">
  6442. <constructor name="RecoveryInProgressException" type="java.lang.String"
  6443. static="false" final="false" visibility="public"
  6444. deprecated="not deprecated">
  6445. </constructor>
  6446. <doc>
  6447. <![CDATA[Exception indicating that a replica is already being recovery.]]>
  6448. </doc>
  6449. </class>
  6450. <!-- end class org.apache.hadoop.hdfs.protocol.RecoveryInProgressException -->
  6451. <!-- start class org.apache.hadoop.hdfs.protocol.UnregisteredNodeException -->
  6452. <class name="UnregisteredNodeException" extends="java.io.IOException"
  6453. abstract="false"
  6454. static="false" final="false" visibility="public"
  6455. deprecated="not deprecated">
  6456. <constructor name="UnregisteredNodeException" type="org.apache.hadoop.hdfs.server.protocol.NodeRegistration"
  6457. static="false" final="false" visibility="public"
  6458. deprecated="not deprecated">
  6459. </constructor>
  6460. <constructor name="UnregisteredNodeException" type="org.apache.hadoop.hdfs.protocol.DatanodeID, org.apache.hadoop.hdfs.protocol.DatanodeInfo"
  6461. static="false" final="false" visibility="public"
  6462. deprecated="not deprecated">
  6463. <doc>
  6464. <![CDATA[The exception is thrown if a different data-node claims the same
  6465. storage id as the existing one.
  6466. @param nodeID unregistered data-node
  6467. @param storedNode data-node stored in the system with this storage id]]>
  6468. </doc>
  6469. </constructor>
  6470. <doc>
  6471. <![CDATA[This exception is thrown when a node that has not previously
  6472. registered is trying to access the name node.]]>
  6473. </doc>
  6474. </class>
  6475. <!-- end class org.apache.hadoop.hdfs.protocol.UnregisteredNodeException -->
  6476. <!-- start class org.apache.hadoop.hdfs.protocol.UnresolvedPathException -->
  6477. <class name="UnresolvedPathException" extends="org.apache.hadoop.fs.UnresolvedLinkException"
  6478. abstract="false"
  6479. static="false" final="true" visibility="public"
  6480. deprecated="not deprecated">
  6481. <constructor name="UnresolvedPathException" type="java.lang.String"
  6482. static="false" final="false" visibility="public"
  6483. deprecated="not deprecated">
  6484. <doc>
  6485. <![CDATA[Used by RemoteException to instantiate an UnresolvedPathException.]]>
  6486. </doc>
  6487. </constructor>
  6488. <constructor name="UnresolvedPathException" type="java.lang.String, java.lang.String, java.lang.String"
  6489. static="false" final="false" visibility="public"
  6490. deprecated="not deprecated">
  6491. </constructor>
  6492. <method name="getUnresolvedPath" return="org.apache.hadoop.fs.Path"
  6493. abstract="false" native="false" synchronized="false"
  6494. static="false" final="false" visibility="public"
  6495. deprecated="not deprecated">
  6496. <exception name="IOException" type="java.io.IOException"/>
  6497. </method>
  6498. <method name="getResolvedPath" return="org.apache.hadoop.fs.Path"
  6499. abstract="false" native="false" synchronized="false"
  6500. static="false" final="false" visibility="public"
  6501. deprecated="not deprecated">
  6502. <exception name="IOException" type="java.io.IOException"/>
  6503. </method>
  6504. <method name="getMessage" return="java.lang.String"
  6505. abstract="false" native="false" synchronized="false"
  6506. static="false" final="false" visibility="public"
  6507. deprecated="not deprecated">
  6508. </method>
  6509. <doc>
  6510. <![CDATA[Thrown when a symbolic link is encountered in a path.]]>
  6511. </doc>
  6512. </class>
  6513. <!-- end class org.apache.hadoop.hdfs.protocol.UnresolvedPathException -->
  6514. </package>
  6515. <package name="org.apache.hadoop.hdfs.security">
  6516. <!-- start class org.apache.hadoop.hdfs.security.AccessTokenHandler -->
  6517. <class name="AccessTokenHandler" extends="java.lang.Object"
  6518. abstract="false"
  6519. static="false" final="false" visibility="public"
  6520. deprecated="not deprecated">
  6521. <constructor name="AccessTokenHandler" type="boolean, long, long"
  6522. static="false" final="false" visibility="public"
  6523. deprecated="not deprecated">
  6524. <exception name="IOException" type="java.io.IOException"/>
  6525. <doc>
  6526. <![CDATA[Constructor
  6527. @param isMaster
  6528. @param keyUpdateInterval
  6529. @param tokenLifetime
  6530. @throws IOException]]>
  6531. </doc>
  6532. </constructor>
  6533. <method name="exportKeys" return="org.apache.hadoop.hdfs.security.ExportedAccessKeys"
  6534. abstract="false" native="false" synchronized="true"
  6535. static="false" final="false" visibility="public"
  6536. deprecated="not deprecated">
  6537. <doc>
  6538. <![CDATA[Export access keys, only to be used in master mode]]>
  6539. </doc>
  6540. </method>
  6541. <method name="setKeys"
  6542. abstract="false" native="false" synchronized="true"
  6543. static="false" final="false" visibility="public"
  6544. deprecated="not deprecated">
  6545. <param name="exportedKeys" type="org.apache.hadoop.hdfs.security.ExportedAccessKeys"/>
  6546. <exception name="IOException" type="java.io.IOException"/>
  6547. <doc>
  6548. <![CDATA[Set access keys, only to be used in slave mode]]>
  6549. </doc>
  6550. </method>
  6551. <method name="updateKeys"
  6552. abstract="false" native="false" synchronized="true"
  6553. static="false" final="false" visibility="public"
  6554. deprecated="not deprecated">
  6555. <exception name="IOException" type="java.io.IOException"/>
  6556. <doc>
  6557. <![CDATA[Update access keys, only to be used in master mode]]>
  6558. </doc>
  6559. </method>
  6560. <method name="generateToken" return="org.apache.hadoop.hdfs.security.BlockAccessToken"
  6561. abstract="false" native="false" synchronized="false"
  6562. static="false" final="false" visibility="public"
  6563. deprecated="not deprecated">
  6564. <param name="blockID" type="long"/>
  6565. <param name="modes" type="java.util.EnumSet"/>
  6566. <exception name="IOException" type="java.io.IOException"/>
  6567. <doc>
  6568. <![CDATA[Generate an access token for current user]]>
  6569. </doc>
  6570. </method>
  6571. <method name="generateToken" return="org.apache.hadoop.hdfs.security.BlockAccessToken"
  6572. abstract="false" native="false" synchronized="true"
  6573. static="false" final="false" visibility="public"
  6574. deprecated="not deprecated">
  6575. <param name="userID" type="java.lang.String"/>
  6576. <param name="blockID" type="long"/>
  6577. <param name="modes" type="java.util.EnumSet"/>
  6578. <exception name="IOException" type="java.io.IOException"/>
  6579. <doc>
  6580. <![CDATA[Generate an access token for a specified user]]>
  6581. </doc>
  6582. </method>
  6583. <method name="checkAccess" return="boolean"
  6584. abstract="false" native="false" synchronized="false"
  6585. static="false" final="false" visibility="public"
  6586. deprecated="not deprecated">
  6587. <param name="token" type="org.apache.hadoop.hdfs.security.BlockAccessToken"/>
  6588. <param name="userID" type="java.lang.String"/>
  6589. <param name="blockID" type="long"/>
  6590. <param name="mode" type="org.apache.hadoop.hdfs.security.AccessTokenHandler.AccessMode"/>
  6591. <exception name="IOException" type="java.io.IOException"/>
  6592. <doc>
  6593. <![CDATA[Check if access should be allowed. userID is not checked if null]]>
  6594. </doc>
  6595. </method>
  6596. <doc>
  6597. <![CDATA[AccessTokenHandler can be instantiated in 2 modes, master mode and slave
  6598. mode. Master can generate new access keys and export access keys to slaves,
  6599. while slaves can only import and use access keys received from master. Both
  6600. master and slave can generate and verify access tokens. Typically, master
  6601. mode is used by NN and slave mode is used by DN.]]>
  6602. </doc>
  6603. </class>
  6604. <!-- end class org.apache.hadoop.hdfs.security.AccessTokenHandler -->
  6605. <!-- start class org.apache.hadoop.hdfs.security.AccessTokenHandler.AccessMode -->
  6606. <class name="AccessTokenHandler.AccessMode" extends="java.lang.Enum"
  6607. abstract="false"
  6608. static="true" final="true" visibility="public"
  6609. deprecated="not deprecated">
  6610. <method name="values" return="org.apache.hadoop.hdfs.security.AccessTokenHandler.AccessMode[]"
  6611. abstract="false" native="false" synchronized="false"
  6612. static="true" final="false" visibility="public"
  6613. deprecated="not deprecated">
  6614. </method>
  6615. <method name="valueOf" return="org.apache.hadoop.hdfs.security.AccessTokenHandler.AccessMode"
  6616. abstract="false" native="false" synchronized="false"
  6617. static="true" final="false" visibility="public"
  6618. deprecated="not deprecated">
  6619. <param name="name" type="java.lang.String"/>
  6620. </method>
  6621. <field name="READ" type="org.apache.hadoop.hdfs.security.AccessTokenHandler.AccessMode"
  6622. transient="false" volatile="false"
  6623. static="true" final="true" visibility="public"
  6624. deprecated="not deprecated">
  6625. </field>
  6626. <field name="WRITE" type="org.apache.hadoop.hdfs.security.AccessTokenHandler.AccessMode"
  6627. transient="false" volatile="false"
  6628. static="true" final="true" visibility="public"
  6629. deprecated="not deprecated">
  6630. </field>
  6631. <field name="COPY" type="org.apache.hadoop.hdfs.security.AccessTokenHandler.AccessMode"
  6632. transient="false" volatile="false"
  6633. static="true" final="true" visibility="public"
  6634. deprecated="not deprecated">
  6635. </field>
  6636. <field name="REPLACE" type="org.apache.hadoop.hdfs.security.AccessTokenHandler.AccessMode"
  6637. transient="false" volatile="false"
  6638. static="true" final="true" visibility="public"
  6639. deprecated="not deprecated">
  6640. </field>
  6641. </class>
  6642. <!-- end class org.apache.hadoop.hdfs.security.AccessTokenHandler.AccessMode -->
  6643. <!-- start class org.apache.hadoop.hdfs.security.BlockAccessKey -->
  6644. <class name="BlockAccessKey" extends="java.lang.Object"
  6645. abstract="false"
  6646. static="false" final="false" visibility="public"
  6647. deprecated="not deprecated">
  6648. <implements name="org.apache.hadoop.io.Writable"/>
  6649. <constructor name="BlockAccessKey"
  6650. static="false" final="false" visibility="public"
  6651. deprecated="not deprecated">
  6652. </constructor>
  6653. <constructor name="BlockAccessKey" type="long, org.apache.hadoop.io.Text, long"
  6654. static="false" final="false" visibility="public"
  6655. deprecated="not deprecated">
  6656. </constructor>
  6657. <method name="getKeyID" return="long"
  6658. abstract="false" native="false" synchronized="false"
  6659. static="false" final="false" visibility="public"
  6660. deprecated="not deprecated">
  6661. </method>
  6662. <method name="getKey" return="org.apache.hadoop.io.Text"
  6663. abstract="false" native="false" synchronized="false"
  6664. static="false" final="false" visibility="public"
  6665. deprecated="not deprecated">
  6666. </method>
  6667. <method name="getExpiryDate" return="long"
  6668. abstract="false" native="false" synchronized="false"
  6669. static="false" final="false" visibility="public"
  6670. deprecated="not deprecated">
  6671. </method>
  6672. <method name="getMac" return="javax.crypto.Mac"
  6673. abstract="false" native="false" synchronized="false"
  6674. static="false" final="false" visibility="public"
  6675. deprecated="not deprecated">
  6676. </method>
  6677. <method name="setMac"
  6678. abstract="false" native="false" synchronized="false"
  6679. static="false" final="false" visibility="public"
  6680. deprecated="not deprecated">
  6681. <param name="mac" type="javax.crypto.Mac"/>
  6682. </method>
  6683. <method name="equals" return="boolean"
  6684. abstract="false" native="false" synchronized="false"
  6685. static="false" final="false" visibility="public"
  6686. deprecated="not deprecated">
  6687. <param name="obj" type="java.lang.Object"/>
  6688. <doc>
  6689. <![CDATA[{@inheritDoc}]]>
  6690. </doc>
  6691. </method>
  6692. <method name="hashCode" return="int"
  6693. abstract="false" native="false" synchronized="false"
  6694. static="false" final="false" visibility="public"
  6695. deprecated="not deprecated">
  6696. <doc>
  6697. <![CDATA[{@inheritDoc}]]>
  6698. </doc>
  6699. </method>
  6700. <method name="write"
  6701. abstract="false" native="false" synchronized="false"
  6702. static="false" final="false" visibility="public"
  6703. deprecated="not deprecated">
  6704. <param name="out" type="java.io.DataOutput"/>
  6705. <exception name="IOException" type="java.io.IOException"/>
  6706. </method>
  6707. <method name="readFields"
  6708. abstract="false" native="false" synchronized="false"
  6709. static="false" final="false" visibility="public"
  6710. deprecated="not deprecated">
  6711. <param name="in" type="java.io.DataInput"/>
  6712. <exception name="IOException" type="java.io.IOException"/>
  6713. </method>
  6714. <doc>
  6715. <![CDATA[Key used for generating and verifying access tokens]]>
  6716. </doc>
  6717. </class>
  6718. <!-- end class org.apache.hadoop.hdfs.security.BlockAccessKey -->
  6719. <!-- start class org.apache.hadoop.hdfs.security.BlockAccessToken -->
  6720. <class name="BlockAccessToken" extends="java.lang.Object"
  6721. abstract="false"
  6722. static="false" final="false" visibility="public"
  6723. deprecated="not deprecated">
  6724. <implements name="org.apache.hadoop.io.Writable"/>
  6725. <constructor name="BlockAccessToken"
  6726. static="false" final="false" visibility="public"
  6727. deprecated="not deprecated">
  6728. </constructor>
  6729. <constructor name="BlockAccessToken" type="org.apache.hadoop.io.Text, org.apache.hadoop.io.Text"
  6730. static="false" final="false" visibility="public"
  6731. deprecated="not deprecated">
  6732. </constructor>
  6733. <method name="getTokenID" return="org.apache.hadoop.io.Text"
  6734. abstract="false" native="false" synchronized="false"
  6735. static="false" final="false" visibility="public"
  6736. deprecated="not deprecated">
  6737. </method>
  6738. <method name="getTokenAuthenticator" return="org.apache.hadoop.io.Text"
  6739. abstract="false" native="false" synchronized="false"
  6740. static="false" final="false" visibility="public"
  6741. deprecated="not deprecated">
  6742. </method>
  6743. <method name="equals" return="boolean"
  6744. abstract="false" native="false" synchronized="false"
  6745. static="false" final="false" visibility="public"
  6746. deprecated="not deprecated">
  6747. <param name="obj" type="java.lang.Object"/>
  6748. <doc>
  6749. <![CDATA[{@inheritDoc}]]>
  6750. </doc>
  6751. </method>
  6752. <method name="hashCode" return="int"
  6753. abstract="false" native="false" synchronized="false"
  6754. static="false" final="false" visibility="public"
  6755. deprecated="not deprecated">
  6756. <doc>
  6757. <![CDATA[{@inheritDoc}]]>
  6758. </doc>
  6759. </method>
  6760. <method name="write"
  6761. abstract="false" native="false" synchronized="false"
  6762. static="false" final="false" visibility="public"
  6763. deprecated="not deprecated">
  6764. <param name="out" type="java.io.DataOutput"/>
  6765. <exception name="IOException" type="java.io.IOException"/>
  6766. </method>
  6767. <method name="readFields"
  6768. abstract="false" native="false" synchronized="false"
  6769. static="false" final="false" visibility="public"
  6770. deprecated="not deprecated">
  6771. <param name="in" type="java.io.DataInput"/>
  6772. <exception name="IOException" type="java.io.IOException"/>
  6773. </method>
  6774. <field name="DUMMY_TOKEN" type="org.apache.hadoop.hdfs.security.BlockAccessToken"
  6775. transient="false" volatile="false"
  6776. static="true" final="true" visibility="public"
  6777. deprecated="not deprecated">
  6778. </field>
  6779. </class>
  6780. <!-- end class org.apache.hadoop.hdfs.security.BlockAccessToken -->
  6781. <!-- start class org.apache.hadoop.hdfs.security.ExportedAccessKeys -->
  6782. <class name="ExportedAccessKeys" extends="java.lang.Object"
  6783. abstract="false"
  6784. static="false" final="false" visibility="public"
  6785. deprecated="not deprecated">
  6786. <implements name="org.apache.hadoop.io.Writable"/>
  6787. <constructor name="ExportedAccessKeys"
  6788. static="false" final="false" visibility="public"
  6789. deprecated="not deprecated">
  6790. </constructor>
  6791. <method name="isAccessTokenEnabled" return="boolean"
  6792. abstract="false" native="false" synchronized="false"
  6793. static="false" final="false" visibility="public"
  6794. deprecated="not deprecated">
  6795. </method>
  6796. <method name="getKeyUpdateInterval" return="long"
  6797. abstract="false" native="false" synchronized="false"
  6798. static="false" final="false" visibility="public"
  6799. deprecated="not deprecated">
  6800. </method>
  6801. <method name="getTokenLifetime" return="long"
  6802. abstract="false" native="false" synchronized="false"
  6803. static="false" final="false" visibility="public"
  6804. deprecated="not deprecated">
  6805. </method>
  6806. <method name="getCurrentKey" return="org.apache.hadoop.hdfs.security.BlockAccessKey"
  6807. abstract="false" native="false" synchronized="false"
  6808. static="false" final="false" visibility="public"
  6809. deprecated="not deprecated">
  6810. </method>
  6811. <method name="getAllKeys" return="org.apache.hadoop.hdfs.security.BlockAccessKey[]"
  6812. abstract="false" native="false" synchronized="false"
  6813. static="false" final="false" visibility="public"
  6814. deprecated="not deprecated">
  6815. </method>
  6816. <method name="equals" return="boolean"
  6817. abstract="false" native="false" synchronized="false"
  6818. static="false" final="false" visibility="public"
  6819. deprecated="not deprecated">
  6820. <param name="obj" type="java.lang.Object"/>
  6821. <doc>
  6822. <![CDATA[{@inheritDoc}]]>
  6823. </doc>
  6824. </method>
  6825. <method name="hashCode" return="int"
  6826. abstract="false" native="false" synchronized="false"
  6827. static="false" final="false" visibility="public"
  6828. deprecated="not deprecated">
  6829. <doc>
  6830. <![CDATA[{@inheritDoc}]]>
  6831. </doc>
  6832. </method>
  6833. <method name="write"
  6834. abstract="false" native="false" synchronized="false"
  6835. static="false" final="false" visibility="public"
  6836. deprecated="not deprecated">
  6837. <param name="out" type="java.io.DataOutput"/>
  6838. <exception name="IOException" type="java.io.IOException"/>
  6839. </method>
  6840. <method name="readFields"
  6841. abstract="false" native="false" synchronized="false"
  6842. static="false" final="false" visibility="public"
  6843. deprecated="not deprecated">
  6844. <param name="in" type="java.io.DataInput"/>
  6845. <exception name="IOException" type="java.io.IOException"/>
  6846. </method>
  6847. <field name="DUMMY_KEYS" type="org.apache.hadoop.hdfs.security.ExportedAccessKeys"
  6848. transient="false" volatile="false"
  6849. static="true" final="true" visibility="public"
  6850. deprecated="not deprecated">
  6851. </field>
  6852. <doc>
  6853. <![CDATA[Object for passing access keys]]>
  6854. </doc>
  6855. </class>
  6856. <!-- end class org.apache.hadoop.hdfs.security.ExportedAccessKeys -->
  6857. <!-- start class org.apache.hadoop.hdfs.security.InvalidAccessTokenException -->
  6858. <class name="InvalidAccessTokenException" extends="java.io.IOException"
  6859. abstract="false"
  6860. static="false" final="false" visibility="public"
  6861. deprecated="not deprecated">
  6862. <constructor name="InvalidAccessTokenException"
  6863. static="false" final="false" visibility="public"
  6864. deprecated="not deprecated">
  6865. </constructor>
  6866. <constructor name="InvalidAccessTokenException" type="java.lang.String"
  6867. static="false" final="false" visibility="public"
  6868. deprecated="not deprecated">
  6869. </constructor>
  6870. <doc>
  6871. <![CDATA[Access token verification failed.]]>
  6872. </doc>
  6873. </class>
  6874. <!-- end class org.apache.hadoop.hdfs.security.InvalidAccessTokenException -->
  6875. </package>
  6876. <package name="org.apache.hadoop.hdfs.security.token.delegation">
  6877. <!-- start class org.apache.hadoop.hdfs.security.token.delegation.DelegationTokenIdentifier -->
  6878. <class name="DelegationTokenIdentifier" extends="org.apache.hadoop.security.token.delegation.AbstractDelegationTokenIdentifier"
  6879. abstract="false"
  6880. static="false" final="false" visibility="public"
  6881. deprecated="not deprecated">
  6882. <constructor name="DelegationTokenIdentifier"
  6883. static="false" final="false" visibility="public"
  6884. deprecated="not deprecated">
  6885. <doc>
  6886. <![CDATA[Create an empty delegation token identifier for reading into.]]>
  6887. </doc>
  6888. </constructor>
  6889. <constructor name="DelegationTokenIdentifier" type="org.apache.hadoop.io.Text, org.apache.hadoop.io.Text, org.apache.hadoop.io.Text"
  6890. static="false" final="false" visibility="public"
  6891. deprecated="not deprecated">
  6892. <doc>
  6893. <![CDATA[Create a new delegation token identifier
  6894. @param owner the effective username of the token owner
  6895. @param renewer the username of the renewer
  6896. @param realUser the real username of the token owner]]>
  6897. </doc>
  6898. </constructor>
  6899. <method name="getKind" return="org.apache.hadoop.io.Text"
  6900. abstract="false" native="false" synchronized="false"
  6901. static="false" final="false" visibility="public"
  6902. deprecated="not deprecated">
  6903. </method>
  6904. <field name="HDFS_DELEGATION_KIND" type="org.apache.hadoop.io.Text"
  6905. transient="false" volatile="false"
  6906. static="true" final="true" visibility="public"
  6907. deprecated="not deprecated">
  6908. </field>
  6909. <doc>
  6910. <![CDATA[A delegation token identifier that is specific to HDFS.]]>
  6911. </doc>
  6912. </class>
  6913. <!-- end class org.apache.hadoop.hdfs.security.token.delegation.DelegationTokenIdentifier -->
  6914. <!-- start class org.apache.hadoop.hdfs.security.token.delegation.DelegationTokenSecretManager -->
  6915. <class name="DelegationTokenSecretManager" extends="org.apache.hadoop.security.token.delegation.AbstractDelegationTokenSecretManager"
  6916. abstract="false"
  6917. static="false" final="false" visibility="public"
  6918. deprecated="not deprecated">
  6919. <constructor name="DelegationTokenSecretManager" type="long, long, long, long, org.apache.hadoop.hdfs.server.namenode.FSNamesystem"
  6920. static="false" final="false" visibility="public"
  6921. deprecated="not deprecated">
  6922. <doc>
  6923. <![CDATA[Create a secret manager
  6924. @param delegationKeyUpdateInterval the number of seconds for rolling new
  6925. secret keys.
  6926. @param delegationTokenMaxLifetime the maximum lifetime of the delegation
  6927. tokens
  6928. @param delegationTokenRenewInterval how often the tokens must be renewed
  6929. @param delegationTokenRemoverScanInterval how often the tokens are scanned
  6930. for expired tokens]]>
  6931. </doc>
  6932. </constructor>
  6933. <method name="createIdentifier" return="org.apache.hadoop.hdfs.security.token.delegation.DelegationTokenIdentifier"
  6934. abstract="false" native="false" synchronized="false"
  6935. static="false" final="false" visibility="public"
  6936. deprecated="not deprecated">
  6937. </method>
  6938. <method name="getTokenExpiryTime" return="long"
  6939. abstract="false" native="false" synchronized="true"
  6940. static="false" final="false" visibility="public"
  6941. deprecated="not deprecated">
  6942. <param name="dtId" type="org.apache.hadoop.hdfs.security.token.delegation.DelegationTokenIdentifier"/>
  6943. <exception name="IOException" type="java.io.IOException"/>
  6944. <doc>
  6945. <![CDATA[Returns expiry time of a token given its identifier.
  6946. @param dtId DelegationTokenIdentifier of a token
  6947. @return Expiry time of the token
  6948. @throws IOException]]>
  6949. </doc>
  6950. </method>
  6951. <method name="loadSecretManagerState"
  6952. abstract="false" native="false" synchronized="true"
  6953. static="false" final="false" visibility="public"
  6954. deprecated="not deprecated">
  6955. <param name="in" type="java.io.DataInputStream"/>
  6956. <exception name="IOException" type="java.io.IOException"/>
  6957. <doc>
  6958. <![CDATA[Load SecretManager state from fsimage.
  6959. @param in input stream to read fsimage
  6960. @throws IOException]]>
  6961. </doc>
  6962. </method>
  6963. <method name="saveSecretManagerState"
  6964. abstract="false" native="false" synchronized="true"
  6965. static="false" final="false" visibility="public"
  6966. deprecated="not deprecated">
  6967. <param name="out" type="java.io.DataOutputStream"/>
  6968. <exception name="IOException" type="java.io.IOException"/>
  6969. <doc>
  6970. <![CDATA[Store the current state of the SecretManager for persistence
  6971. @param out Output stream for writing into fsimage.
  6972. @throws IOException]]>
  6973. </doc>
  6974. </method>
  6975. <method name="addPersistedDelegationToken"
  6976. abstract="false" native="false" synchronized="true"
  6977. static="false" final="false" visibility="public"
  6978. deprecated="not deprecated">
  6979. <param name="identifier" type="org.apache.hadoop.hdfs.security.token.delegation.DelegationTokenIdentifier"/>
  6980. <param name="expiryTime" type="long"/>
  6981. <exception name="IOException" type="java.io.IOException"/>
  6982. <doc>
  6983. <![CDATA[This method is intended to be used only while reading edit logs.
  6984. @param identifier DelegationTokenIdentifier read from the edit logs or
  6985. fsimage
  6986. @param expiryTime token expiry time
  6987. @throws IOException]]>
  6988. </doc>
  6989. </method>
  6990. <method name="updatePersistedMasterKey"
  6991. abstract="false" native="false" synchronized="true"
  6992. static="false" final="false" visibility="public"
  6993. deprecated="not deprecated">
  6994. <param name="key" type="org.apache.hadoop.security.token.delegation.DelegationKey"/>
  6995. <exception name="IOException" type="java.io.IOException"/>
  6996. <doc>
  6997. <![CDATA[Add a MasterKey to the list of keys.
  6998. @param key DelegationKey
  6999. @throws IOException]]>
  7000. </doc>
  7001. </method>
  7002. <method name="updatePersistedTokenRenewal"
  7003. abstract="false" native="false" synchronized="true"
  7004. static="false" final="false" visibility="public"
  7005. deprecated="not deprecated">
  7006. <param name="identifier" type="org.apache.hadoop.hdfs.security.token.delegation.DelegationTokenIdentifier"/>
  7007. <param name="expiryTime" type="long"/>
  7008. <exception name="IOException" type="java.io.IOException"/>
  7009. <doc>
  7010. <![CDATA[Update the token cache with renewal record in edit logs.
  7011. @param identifier DelegationTokenIdentifier of the renewed token
  7012. @param expiryTime
  7013. @throws IOException]]>
  7014. </doc>
  7015. </method>
  7016. <method name="updatePersistedTokenCancellation"
  7017. abstract="false" native="false" synchronized="true"
  7018. static="false" final="false" visibility="public"
  7019. deprecated="not deprecated">
  7020. <param name="identifier" type="org.apache.hadoop.hdfs.security.token.delegation.DelegationTokenIdentifier"/>
  7021. <exception name="IOException" type="java.io.IOException"/>
  7022. <doc>
  7023. <![CDATA[Update the token cache with the cancel record in edit logs
  7024. @param identifier DelegationTokenIdentifier of the canceled token
  7025. @throws IOException]]>
  7026. </doc>
  7027. </method>
  7028. <method name="getNumberOfKeys" return="int"
  7029. abstract="false" native="false" synchronized="true"
  7030. static="false" final="false" visibility="public"
  7031. deprecated="not deprecated">
  7032. <doc>
  7033. <![CDATA[Returns the number of delegation keys currently stored.
  7034. @return number of delegation keys]]>
  7035. </doc>
  7036. </method>
  7037. <method name="logUpdateMasterKey"
  7038. abstract="false" native="false" synchronized="false"
  7039. static="false" final="false" visibility="protected"
  7040. deprecated="not deprecated">
  7041. <param name="key" type="org.apache.hadoop.security.token.delegation.DelegationKey"/>
  7042. <exception name="IOException" type="java.io.IOException"/>
  7043. <doc>
  7044. <![CDATA[Call namesystem to update editlogs for new master key.]]>
  7045. </doc>
  7046. </method>
  7047. <doc>
  7048. <![CDATA[A HDFS specific delegation token secret manager.
  7049. The secret manager is responsible for generating and accepting the password
  7050. for each token.]]>
  7051. </doc>
  7052. </class>
  7053. <!-- end class org.apache.hadoop.hdfs.security.token.delegation.DelegationTokenSecretManager -->
  7054. <!-- start class org.apache.hadoop.hdfs.security.token.delegation.DelegationTokenSelector -->
  7055. <class name="DelegationTokenSelector" extends="org.apache.hadoop.security.token.delegation.AbstractDelegationTokenSelector"
  7056. abstract="false"
  7057. static="false" final="false" visibility="public"
  7058. deprecated="not deprecated">
  7059. <constructor name="DelegationTokenSelector"
  7060. static="false" final="false" visibility="public"
  7061. deprecated="not deprecated">
  7062. </constructor>
  7063. <doc>
  7064. <![CDATA[A delegation token that is specialized for HDFS]]>
  7065. </doc>
  7066. </class>
  7067. <!-- end class org.apache.hadoop.hdfs.security.token.delegation.DelegationTokenSelector -->
  7068. </package>
  7069. <package name="org.apache.hadoop.hdfs.server.balancer">
  7070. <!-- start class org.apache.hadoop.hdfs.server.balancer.Balancer -->
  7071. <class name="Balancer" extends="java.lang.Object"
  7072. abstract="false"
  7073. static="false" final="false" visibility="public"
  7074. deprecated="not deprecated">
  7075. <implements name="org.apache.hadoop.util.Tool"/>
  7076. <method name="main"
  7077. abstract="false" native="false" synchronized="false"
  7078. static="true" final="false" visibility="public"
  7079. deprecated="not deprecated">
  7080. <param name="args" type="java.lang.String[]"/>
  7081. <doc>
  7082. <![CDATA[Run a balancer
  7083. @param args]]>
  7084. </doc>
  7085. </method>
  7086. <method name="run" return="int"
  7087. abstract="false" native="false" synchronized="false"
  7088. static="false" final="false" visibility="public"
  7089. deprecated="not deprecated">
  7090. <param name="args" type="java.lang.String[]"/>
  7091. <exception name="Exception" type="java.lang.Exception"/>
  7092. <doc>
  7093. <![CDATA[main method of Balancer
  7094. @param args arguments to a Balancer
  7095. @exception any exception occurs during datanode balancing]]>
  7096. </doc>
  7097. </method>
  7098. <method name="getConf" return="org.apache.hadoop.conf.Configuration"
  7099. abstract="false" native="false" synchronized="false"
  7100. static="false" final="false" visibility="public"
  7101. deprecated="not deprecated">
  7102. <doc>
  7103. <![CDATA[return this balancer's configuration]]>
  7104. </doc>
  7105. </method>
  7106. <method name="setConf"
  7107. abstract="false" native="false" synchronized="false"
  7108. static="false" final="false" visibility="public"
  7109. deprecated="not deprecated">
  7110. <param name="conf" type="org.apache.hadoop.conf.Configuration"/>
  7111. <doc>
  7112. <![CDATA[set this balancer's configuration]]>
  7113. </doc>
  7114. </method>
  7115. <field name="MAX_NUM_CONCURRENT_MOVES" type="int"
  7116. transient="false" volatile="false"
  7117. static="true" final="true" visibility="public"
  7118. deprecated="not deprecated">
  7119. <doc>
  7120. <![CDATA[The maximum number of concurrent blocks moves for
  7121. balancing purpose at a datanode]]>
  7122. </doc>
  7123. </field>
  7124. <field name="SUCCESS" type="int"
  7125. transient="false" volatile="false"
  7126. static="true" final="true" visibility="public"
  7127. deprecated="not deprecated">
  7128. </field>
  7129. <field name="ALREADY_RUNNING" type="int"
  7130. transient="false" volatile="false"
  7131. static="true" final="true" visibility="public"
  7132. deprecated="not deprecated">
  7133. </field>
  7134. <field name="NO_MOVE_BLOCK" type="int"
  7135. transient="false" volatile="false"
  7136. static="true" final="true" visibility="public"
  7137. deprecated="not deprecated">
  7138. </field>
  7139. <field name="NO_MOVE_PROGRESS" type="int"
  7140. transient="false" volatile="false"
  7141. static="true" final="true" visibility="public"
  7142. deprecated="not deprecated">
  7143. </field>
  7144. <field name="IO_EXCEPTION" type="int"
  7145. transient="false" volatile="false"
  7146. static="true" final="true" visibility="public"
  7147. deprecated="not deprecated">
  7148. </field>
  7149. <field name="ILLEGAL_ARGS" type="int"
  7150. transient="false" volatile="false"
  7151. static="true" final="true" visibility="public"
  7152. deprecated="not deprecated">
  7153. </field>
  7154. <doc>
  7155. <![CDATA[<p>The balancer is a tool that balances disk space usage on an HDFS cluster
  7156. when some datanodes become full or when new empty nodes join the cluster.
  7157. The tool is deployed as an application program that can be run by the
  7158. cluster administrator on a live HDFS cluster while applications
  7159. adding and deleting files.
  7160. <p>SYNOPSIS
  7161. <pre>
  7162. To start:
  7163. bin/start-balancer.sh [-threshold <threshold>]
  7164. Example: bin/ start-balancer.sh
  7165. start the balancer with a default threshold of 10%
  7166. bin/ start-balancer.sh -threshold 5
  7167. start the balancer with a threshold of 5%
  7168. To stop:
  7169. bin/ stop-balancer.sh
  7170. </pre>
  7171. <p>DESCRIPTION
  7172. <p>The threshold parameter is a fraction in the range of (0%, 100%) with a
  7173. default value of 10%. The threshold sets a target for whether the cluster
  7174. is balanced. A cluster is balanced if for each datanode, the utilization
  7175. of the node (ratio of used space at the node to total capacity of the node)
  7176. differs from the utilization of the (ratio of used space in the cluster
  7177. to total capacity of the cluster) by no more than the threshold value.
  7178. The smaller the threshold, the more balanced a cluster will become.
  7179. It takes more time to run the balancer for small threshold values.
  7180. Also for a very small threshold the cluster may not be able to reach the
  7181. balanced state when applications write and delete files concurrently.
  7182. <p>The tool moves blocks from highly utilized datanodes to poorly
  7183. utilized datanodes iteratively. In each iteration a datanode moves or
  7184. receives no more than the lesser of 10G bytes or the threshold fraction
  7185. of its capacity. Each iteration runs no more than 20 minutes.
  7186. At the end of each iteration, the balancer obtains updated datanodes
  7187. information from the namenode.
  7188. <p>A system property that limits the balancer's use of bandwidth is
  7189. defined in the default configuration file:
  7190. <pre>
  7191. <property>
  7192. <name>dfs.balance.bandwidthPerSec</name>
  7193. <value>1048576</value>
  7194. <description> Specifies the maximum bandwidth that each datanode
  7195. can utilize for the balancing purpose in term of the number of bytes
  7196. per second. </description>
  7197. </property>
  7198. </pre>
  7199. <p>This property determines the maximum speed at which a block will be
  7200. moved from one datanode to another. The default value is 1MB/s. The higher
  7201. the bandwidth, the faster a cluster can reach the balanced state,
  7202. but with greater competition with application processes. If an
  7203. administrator changes the value of this property in the configuration
  7204. file, the change is observed when HDFS is next restarted.
  7205. <p>MONITERING BALANCER PROGRESS
  7206. <p>After the balancer is started, an output file name where the balancer
  7207. progress will be recorded is printed on the screen. The administrator
  7208. can monitor the running of the balancer by reading the output file.
  7209. The output shows the balancer's status iteration by iteration. In each
  7210. iteration it prints the starting time, the iteration number, the total
  7211. number of bytes that have been moved in the previous iterations,
  7212. the total number of bytes that are left to move in order for the cluster
  7213. to be balanced, and the number of bytes that are being moved in this
  7214. iteration. Normally "Bytes Already Moved" is increasing while "Bytes Left
  7215. To Move" is decreasing.
  7216. <p>Running multiple instances of the balancer in an HDFS cluster is
  7217. prohibited by the tool.
  7218. <p>The balancer automatically exits when any of the following five
  7219. conditions is satisfied:
  7220. <ol>
  7221. <li>The cluster is balanced;
  7222. <li>No block can be moved;
  7223. <li>No block has been moved for five consecutive iterations;
  7224. <li>An IOException occurs while communicating with the namenode;
  7225. <li>Another balancer is running.
  7226. </ol>
  7227. <p>Upon exit, a balancer returns an exit code and prints one of the
  7228. following messages to the output file in corresponding to the above exit
  7229. reasons:
  7230. <ol>
  7231. <li>The cluster is balanced. Exiting
  7232. <li>No block can be moved. Exiting...
  7233. <li>No block has been moved for 3 iterations. Exiting...
  7234. <li>Received an IO exception: failure reason. Exiting...
  7235. <li>Another balancer is running. Exiting...
  7236. </ol>
  7237. <p>The administrator can interrupt the execution of the balancer at any
  7238. time by running the command "stop-balancer.sh" on the machine where the
  7239. balancer is running.]]>
  7240. </doc>
  7241. </class>
  7242. <!-- end class org.apache.hadoop.hdfs.server.balancer.Balancer -->
  7243. </package>
  7244. <package name="org.apache.hadoop.hdfs.server.common">
  7245. <!-- start class org.apache.hadoop.hdfs.server.common.GenerationStamp -->
  7246. <class name="GenerationStamp" extends="java.lang.Object"
  7247. abstract="false"
  7248. static="false" final="false" visibility="public"
  7249. deprecated="not deprecated">
  7250. <implements name="java.lang.Comparable"/>
  7251. <constructor name="GenerationStamp"
  7252. static="false" final="false" visibility="public"
  7253. deprecated="not deprecated">
  7254. <doc>
  7255. <![CDATA[Create a new instance, initialized to FIRST_VALID_STAMP.]]>
  7256. </doc>
  7257. </constructor>
  7258. <method name="getStamp" return="long"
  7259. abstract="false" native="false" synchronized="false"
  7260. static="false" final="false" visibility="public"
  7261. deprecated="not deprecated">
  7262. <doc>
  7263. <![CDATA[Returns the current generation stamp]]>
  7264. </doc>
  7265. </method>
  7266. <method name="setStamp"
  7267. abstract="false" native="false" synchronized="false"
  7268. static="false" final="false" visibility="public"
  7269. deprecated="not deprecated">
  7270. <param name="stamp" type="long"/>
  7271. <doc>
  7272. <![CDATA[Sets the current generation stamp]]>
  7273. </doc>
  7274. </method>
  7275. <method name="nextStamp" return="long"
  7276. abstract="false" native="false" synchronized="true"
  7277. static="false" final="false" visibility="public"
  7278. deprecated="not deprecated">
  7279. <doc>
  7280. <![CDATA[First increments the counter and then returns the stamp]]>
  7281. </doc>
  7282. </method>
  7283. <method name="compareTo" return="int"
  7284. abstract="false" native="false" synchronized="false"
  7285. static="false" final="false" visibility="public"
  7286. deprecated="not deprecated">
  7287. <param name="that" type="org.apache.hadoop.hdfs.server.common.GenerationStamp"/>
  7288. </method>
  7289. <method name="equals" return="boolean"
  7290. abstract="false" native="false" synchronized="false"
  7291. static="false" final="false" visibility="public"
  7292. deprecated="not deprecated">
  7293. <param name="o" type="java.lang.Object"/>
  7294. </method>
  7295. <method name="hashCode" return="int"
  7296. abstract="false" native="false" synchronized="false"
  7297. static="false" final="false" visibility="public"
  7298. deprecated="not deprecated">
  7299. </method>
  7300. <field name="FIRST_VALID_STAMP" type="long"
  7301. transient="false" volatile="false"
  7302. static="true" final="true" visibility="public"
  7303. deprecated="not deprecated">
  7304. <doc>
  7305. <![CDATA[The first valid generation stamp.]]>
  7306. </doc>
  7307. </field>
  7308. <field name="GRANDFATHER_GENERATION_STAMP" type="long"
  7309. transient="false" volatile="false"
  7310. static="true" final="true" visibility="public"
  7311. deprecated="not deprecated">
  7312. <doc>
  7313. <![CDATA[Generation stamp of blocks that pre-date the introduction
  7314. of a generation stamp.]]>
  7315. </doc>
  7316. </field>
  7317. <doc>
  7318. <![CDATA[A GenerationStamp is a Hadoop FS primitive, identified by a long.]]>
  7319. </doc>
  7320. </class>
  7321. <!-- end class org.apache.hadoop.hdfs.server.common.GenerationStamp -->
  7322. <!-- start interface org.apache.hadoop.hdfs.server.common.HdfsConstants -->
  7323. <interface name="HdfsConstants" abstract="true"
  7324. static="false" final="false" visibility="public"
  7325. deprecated="not deprecated">
  7326. <field name="READ_TIMEOUT" type="int"
  7327. transient="false" volatile="false"
  7328. static="true" final="true" visibility="public"
  7329. deprecated="not deprecated">
  7330. </field>
  7331. <field name="READ_TIMEOUT_EXTENSION" type="int"
  7332. transient="false" volatile="false"
  7333. static="true" final="true" visibility="public"
  7334. deprecated="not deprecated">
  7335. </field>
  7336. <field name="WRITE_TIMEOUT" type="int"
  7337. transient="false" volatile="false"
  7338. static="true" final="true" visibility="public"
  7339. deprecated="not deprecated">
  7340. </field>
  7341. <field name="WRITE_TIMEOUT_EXTENSION" type="int"
  7342. transient="false" volatile="false"
  7343. static="true" final="true" visibility="public"
  7344. deprecated="not deprecated">
  7345. </field>
  7346. <doc>
  7347. <![CDATA[Some handy internal HDFS constants]]>
  7348. </doc>
  7349. </interface>
  7350. <!-- end interface org.apache.hadoop.hdfs.server.common.HdfsConstants -->
  7351. <!-- start class org.apache.hadoop.hdfs.server.common.HdfsConstants.BlockUCState -->
  7352. <class name="HdfsConstants.BlockUCState" extends="java.lang.Enum"
  7353. abstract="false"
  7354. static="true" final="true" visibility="public"
  7355. deprecated="not deprecated">
  7356. <method name="values" return="org.apache.hadoop.hdfs.server.common.HdfsConstants.BlockUCState[]"
  7357. abstract="false" native="false" synchronized="false"
  7358. static="true" final="false" visibility="public"
  7359. deprecated="not deprecated">
  7360. </method>
  7361. <method name="valueOf" return="org.apache.hadoop.hdfs.server.common.HdfsConstants.BlockUCState"
  7362. abstract="false" native="false" synchronized="false"
  7363. static="true" final="false" visibility="public"
  7364. deprecated="not deprecated">
  7365. <param name="name" type="java.lang.String"/>
  7366. </method>
  7367. <field name="COMPLETE" type="org.apache.hadoop.hdfs.server.common.HdfsConstants.BlockUCState"
  7368. transient="false" volatile="false"
  7369. static="true" final="true" visibility="public"
  7370. deprecated="not deprecated">
  7371. <doc>
  7372. <![CDATA[Block construction completed.<br>
  7373. The block has at least one {@link ReplicaState#FINALIZED} replica,
  7374. and is not going to be modified.]]>
  7375. </doc>
  7376. </field>
  7377. <field name="UNDER_CONSTRUCTION" type="org.apache.hadoop.hdfs.server.common.HdfsConstants.BlockUCState"
  7378. transient="false" volatile="false"
  7379. static="true" final="true" visibility="public"
  7380. deprecated="not deprecated">
  7381. <doc>
  7382. <![CDATA[The block is under construction.<br>
  7383. It has been recently allocated for write or append.]]>
  7384. </doc>
  7385. </field>
  7386. <field name="UNDER_RECOVERY" type="org.apache.hadoop.hdfs.server.common.HdfsConstants.BlockUCState"
  7387. transient="false" volatile="false"
  7388. static="true" final="true" visibility="public"
  7389. deprecated="not deprecated">
  7390. <doc>
  7391. <![CDATA[The block is under recovery.<br>
  7392. When a file lease expires its last block may not be {@link #COMPLETE}
  7393. and needs to go through a recovery procedure,
  7394. which synchronizes the existing replicas contents.]]>
  7395. </doc>
  7396. </field>
  7397. <field name="COMMITTED" type="org.apache.hadoop.hdfs.server.common.HdfsConstants.BlockUCState"
  7398. transient="false" volatile="false"
  7399. static="true" final="true" visibility="public"
  7400. deprecated="not deprecated">
  7401. <doc>
  7402. <![CDATA[The block is committed.<br>
  7403. The client reported that all bytes are written to data-nodes
  7404. with the given generation stamp and block length, but no
  7405. {@link ReplicaState#FINALIZED}
  7406. replicas has yet been reported by data-nodes themselves.]]>
  7407. </doc>
  7408. </field>
  7409. <doc>
  7410. <![CDATA[States, which a block can go through while it is under construction.]]>
  7411. </doc>
  7412. </class>
  7413. <!-- end class org.apache.hadoop.hdfs.server.common.HdfsConstants.BlockUCState -->
  7414. <!-- start class org.apache.hadoop.hdfs.server.common.HdfsConstants.NamenodeRole -->
  7415. <class name="HdfsConstants.NamenodeRole" extends="java.lang.Enum"
  7416. abstract="false"
  7417. static="true" final="true" visibility="public"
  7418. deprecated="not deprecated">
  7419. <method name="values" return="org.apache.hadoop.hdfs.server.common.HdfsConstants.NamenodeRole[]"
  7420. abstract="false" native="false" synchronized="false"
  7421. static="true" final="false" visibility="public"
  7422. deprecated="not deprecated">
  7423. </method>
  7424. <method name="valueOf" return="org.apache.hadoop.hdfs.server.common.HdfsConstants.NamenodeRole"
  7425. abstract="false" native="false" synchronized="false"
  7426. static="true" final="false" visibility="public"
  7427. deprecated="not deprecated">
  7428. <param name="name" type="java.lang.String"/>
  7429. </method>
  7430. <method name="toString" return="java.lang.String"
  7431. abstract="false" native="false" synchronized="false"
  7432. static="false" final="false" visibility="public"
  7433. deprecated="not deprecated">
  7434. </method>
  7435. <field name="ACTIVE" type="org.apache.hadoop.hdfs.server.common.HdfsConstants.NamenodeRole"
  7436. transient="false" volatile="false"
  7437. static="true" final="true" visibility="public"
  7438. deprecated="not deprecated">
  7439. </field>
  7440. <field name="BACKUP" type="org.apache.hadoop.hdfs.server.common.HdfsConstants.NamenodeRole"
  7441. transient="false" volatile="false"
  7442. static="true" final="true" visibility="public"
  7443. deprecated="not deprecated">
  7444. </field>
  7445. <field name="CHECKPOINT" type="org.apache.hadoop.hdfs.server.common.HdfsConstants.NamenodeRole"
  7446. transient="false" volatile="false"
  7447. static="true" final="true" visibility="public"
  7448. deprecated="not deprecated">
  7449. </field>
  7450. <field name="STANDBY" type="org.apache.hadoop.hdfs.server.common.HdfsConstants.NamenodeRole"
  7451. transient="false" volatile="false"
  7452. static="true" final="true" visibility="public"
  7453. deprecated="not deprecated">
  7454. </field>
  7455. <doc>
  7456. <![CDATA[Defines the NameNode role.]]>
  7457. </doc>
  7458. </class>
  7459. <!-- end class org.apache.hadoop.hdfs.server.common.HdfsConstants.NamenodeRole -->
  7460. <!-- start class org.apache.hadoop.hdfs.server.common.HdfsConstants.NodeType -->
  7461. <class name="HdfsConstants.NodeType" extends="java.lang.Enum"
  7462. abstract="false"
  7463. static="true" final="true" visibility="public"
  7464. deprecated="not deprecated">
  7465. <method name="values" return="org.apache.hadoop.hdfs.server.common.HdfsConstants.NodeType[]"
  7466. abstract="false" native="false" synchronized="false"
  7467. static="true" final="false" visibility="public"
  7468. deprecated="not deprecated">
  7469. </method>
  7470. <method name="valueOf" return="org.apache.hadoop.hdfs.server.common.HdfsConstants.NodeType"
  7471. abstract="false" native="false" synchronized="false"
  7472. static="true" final="false" visibility="public"
  7473. deprecated="not deprecated">
  7474. <param name="name" type="java.lang.String"/>
  7475. </method>
  7476. <field name="NAME_NODE" type="org.apache.hadoop.hdfs.server.common.HdfsConstants.NodeType"
  7477. transient="false" volatile="false"
  7478. static="true" final="true" visibility="public"
  7479. deprecated="not deprecated">
  7480. </field>
  7481. <field name="DATA_NODE" type="org.apache.hadoop.hdfs.server.common.HdfsConstants.NodeType"
  7482. transient="false" volatile="false"
  7483. static="true" final="true" visibility="public"
  7484. deprecated="not deprecated">
  7485. </field>
  7486. <doc>
  7487. <![CDATA[Type of the node]]>
  7488. </doc>
  7489. </class>
  7490. <!-- end class org.apache.hadoop.hdfs.server.common.HdfsConstants.NodeType -->
  7491. <!-- start class org.apache.hadoop.hdfs.server.common.HdfsConstants.ReplicaState -->
  7492. <class name="HdfsConstants.ReplicaState" extends="java.lang.Enum"
  7493. abstract="false"
  7494. static="true" final="true" visibility="public"
  7495. deprecated="not deprecated">
  7496. <method name="values" return="org.apache.hadoop.hdfs.server.common.HdfsConstants.ReplicaState[]"
  7497. abstract="false" native="false" synchronized="false"
  7498. static="true" final="false" visibility="public"
  7499. deprecated="not deprecated">
  7500. </method>
  7501. <method name="valueOf" return="org.apache.hadoop.hdfs.server.common.HdfsConstants.ReplicaState"
  7502. abstract="false" native="false" synchronized="false"
  7503. static="true" final="false" visibility="public"
  7504. deprecated="not deprecated">
  7505. <param name="name" type="java.lang.String"/>
  7506. </method>
  7507. <method name="getValue" return="int"
  7508. abstract="false" native="false" synchronized="false"
  7509. static="false" final="false" visibility="public"
  7510. deprecated="not deprecated">
  7511. </method>
  7512. <method name="getState" return="org.apache.hadoop.hdfs.server.common.HdfsConstants.ReplicaState"
  7513. abstract="false" native="false" synchronized="false"
  7514. static="true" final="false" visibility="public"
  7515. deprecated="not deprecated">
  7516. <param name="v" type="int"/>
  7517. </method>
  7518. <method name="read" return="org.apache.hadoop.hdfs.server.common.HdfsConstants.ReplicaState"
  7519. abstract="false" native="false" synchronized="false"
  7520. static="true" final="false" visibility="public"
  7521. deprecated="not deprecated">
  7522. <param name="in" type="java.io.DataInput"/>
  7523. <exception name="IOException" type="java.io.IOException"/>
  7524. <doc>
  7525. <![CDATA[Read from in]]>
  7526. </doc>
  7527. </method>
  7528. <method name="write"
  7529. abstract="false" native="false" synchronized="false"
  7530. static="false" final="false" visibility="public"
  7531. deprecated="not deprecated">
  7532. <param name="out" type="java.io.DataOutput"/>
  7533. <exception name="IOException" type="java.io.IOException"/>
  7534. <doc>
  7535. <![CDATA[Write to out]]>
  7536. </doc>
  7537. </method>
  7538. <field name="FINALIZED" type="org.apache.hadoop.hdfs.server.common.HdfsConstants.ReplicaState"
  7539. transient="false" volatile="false"
  7540. static="true" final="true" visibility="public"
  7541. deprecated="not deprecated">
  7542. <doc>
  7543. <![CDATA[Replica is finalized. The state when replica is not modified.]]>
  7544. </doc>
  7545. </field>
  7546. <field name="RBW" type="org.apache.hadoop.hdfs.server.common.HdfsConstants.ReplicaState"
  7547. transient="false" volatile="false"
  7548. static="true" final="true" visibility="public"
  7549. deprecated="not deprecated">
  7550. <doc>
  7551. <![CDATA[Replica is being written to.]]>
  7552. </doc>
  7553. </field>
  7554. <field name="RWR" type="org.apache.hadoop.hdfs.server.common.HdfsConstants.ReplicaState"
  7555. transient="false" volatile="false"
  7556. static="true" final="true" visibility="public"
  7557. deprecated="not deprecated">
  7558. <doc>
  7559. <![CDATA[Replica is waiting to be recovered.]]>
  7560. </doc>
  7561. </field>
  7562. <field name="RUR" type="org.apache.hadoop.hdfs.server.common.HdfsConstants.ReplicaState"
  7563. transient="false" volatile="false"
  7564. static="true" final="true" visibility="public"
  7565. deprecated="not deprecated">
  7566. <doc>
  7567. <![CDATA[Replica is under recovery.]]>
  7568. </doc>
  7569. </field>
  7570. <field name="TEMPORARY" type="org.apache.hadoop.hdfs.server.common.HdfsConstants.ReplicaState"
  7571. transient="false" volatile="false"
  7572. static="true" final="true" visibility="public"
  7573. deprecated="not deprecated">
  7574. <doc>
  7575. <![CDATA[Temporary replica: created for replication and relocation only.]]>
  7576. </doc>
  7577. </field>
  7578. <doc>
  7579. <![CDATA[Block replica states, which it can go through while being constructed.]]>
  7580. </doc>
  7581. </class>
  7582. <!-- end class org.apache.hadoop.hdfs.server.common.HdfsConstants.ReplicaState -->
  7583. <!-- start class org.apache.hadoop.hdfs.server.common.HdfsConstants.StartupOption -->
  7584. <class name="HdfsConstants.StartupOption" extends="java.lang.Enum"
  7585. abstract="false"
  7586. static="true" final="true" visibility="public"
  7587. deprecated="not deprecated">
  7588. <method name="values" return="org.apache.hadoop.hdfs.server.common.HdfsConstants.StartupOption[]"
  7589. abstract="false" native="false" synchronized="false"
  7590. static="true" final="false" visibility="public"
  7591. deprecated="not deprecated">
  7592. </method>
  7593. <method name="valueOf" return="org.apache.hadoop.hdfs.server.common.HdfsConstants.StartupOption"
  7594. abstract="false" native="false" synchronized="false"
  7595. static="true" final="false" visibility="public"
  7596. deprecated="not deprecated">
  7597. <param name="name" type="java.lang.String"/>
  7598. </method>
  7599. <method name="getName" return="java.lang.String"
  7600. abstract="false" native="false" synchronized="false"
  7601. static="false" final="false" visibility="public"
  7602. deprecated="not deprecated">
  7603. </method>
  7604. <method name="toNodeRole" return="org.apache.hadoop.hdfs.server.common.HdfsConstants.NamenodeRole"
  7605. abstract="false" native="false" synchronized="false"
  7606. static="false" final="false" visibility="public"
  7607. deprecated="not deprecated">
  7608. </method>
  7609. <field name="FORMAT" type="org.apache.hadoop.hdfs.server.common.HdfsConstants.StartupOption"
  7610. transient="false" volatile="false"
  7611. static="true" final="true" visibility="public"
  7612. deprecated="not deprecated">
  7613. </field>
  7614. <field name="REGULAR" type="org.apache.hadoop.hdfs.server.common.HdfsConstants.StartupOption"
  7615. transient="false" volatile="false"
  7616. static="true" final="true" visibility="public"
  7617. deprecated="not deprecated">
  7618. </field>
  7619. <field name="BACKUP" type="org.apache.hadoop.hdfs.server.common.HdfsConstants.StartupOption"
  7620. transient="false" volatile="false"
  7621. static="true" final="true" visibility="public"
  7622. deprecated="not deprecated">
  7623. </field>
  7624. <field name="CHECKPOINT" type="org.apache.hadoop.hdfs.server.common.HdfsConstants.StartupOption"
  7625. transient="false" volatile="false"
  7626. static="true" final="true" visibility="public"
  7627. deprecated="not deprecated">
  7628. </field>
  7629. <field name="UPGRADE" type="org.apache.hadoop.hdfs.server.common.HdfsConstants.StartupOption"
  7630. transient="false" volatile="false"
  7631. static="true" final="true" visibility="public"
  7632. deprecated="not deprecated">
  7633. </field>
  7634. <field name="ROLLBACK" type="org.apache.hadoop.hdfs.server.common.HdfsConstants.StartupOption"
  7635. transient="false" volatile="false"
  7636. static="true" final="true" visibility="public"
  7637. deprecated="not deprecated">
  7638. </field>
  7639. <field name="FINALIZE" type="org.apache.hadoop.hdfs.server.common.HdfsConstants.StartupOption"
  7640. transient="false" volatile="false"
  7641. static="true" final="true" visibility="public"
  7642. deprecated="not deprecated">
  7643. </field>
  7644. <field name="IMPORT" type="org.apache.hadoop.hdfs.server.common.HdfsConstants.StartupOption"
  7645. transient="false" volatile="false"
  7646. static="true" final="true" visibility="public"
  7647. deprecated="not deprecated">
  7648. </field>
  7649. <doc>
  7650. <![CDATA[Startup options]]>
  7651. </doc>
  7652. </class>
  7653. <!-- end class org.apache.hadoop.hdfs.server.common.HdfsConstants.StartupOption -->
  7654. <!-- start class org.apache.hadoop.hdfs.server.common.InconsistentFSStateException -->
  7655. <class name="InconsistentFSStateException" extends="java.io.IOException"
  7656. abstract="false"
  7657. static="false" final="false" visibility="public"
  7658. deprecated="not deprecated">
  7659. <constructor name="InconsistentFSStateException" type="java.io.File, java.lang.String"
  7660. static="false" final="false" visibility="public"
  7661. deprecated="not deprecated">
  7662. </constructor>
  7663. <constructor name="InconsistentFSStateException" type="java.io.File, java.lang.String, java.lang.Throwable"
  7664. static="false" final="false" visibility="public"
  7665. deprecated="not deprecated">
  7666. </constructor>
  7667. <doc>
  7668. <![CDATA[The exception is thrown when file system state is inconsistent
  7669. and is not recoverable.]]>
  7670. </doc>
  7671. </class>
  7672. <!-- end class org.apache.hadoop.hdfs.server.common.InconsistentFSStateException -->
  7673. <!-- start class org.apache.hadoop.hdfs.server.common.IncorrectVersionException -->
  7674. <class name="IncorrectVersionException" extends="java.io.IOException"
  7675. abstract="false"
  7676. static="false" final="false" visibility="public"
  7677. deprecated="not deprecated">
  7678. <constructor name="IncorrectVersionException" type="int, java.lang.String"
  7679. static="false" final="false" visibility="public"
  7680. deprecated="not deprecated">
  7681. </constructor>
  7682. <constructor name="IncorrectVersionException" type="int, java.lang.String, int"
  7683. static="false" final="false" visibility="public"
  7684. deprecated="not deprecated">
  7685. </constructor>
  7686. <doc>
  7687. <![CDATA[The exception is thrown when external version does not match
  7688. current version of the application.]]>
  7689. </doc>
  7690. </class>
  7691. <!-- end class org.apache.hadoop.hdfs.server.common.IncorrectVersionException -->
  7692. <!-- start class org.apache.hadoop.hdfs.server.common.JspHelper -->
  7693. <class name="JspHelper" extends="java.lang.Object"
  7694. abstract="false"
  7695. static="false" final="false" visibility="public"
  7696. deprecated="not deprecated">
  7697. <method name="bestNode" return="org.apache.hadoop.hdfs.protocol.DatanodeInfo"
  7698. abstract="false" native="false" synchronized="false"
  7699. static="true" final="false" visibility="public"
  7700. deprecated="not deprecated">
  7701. <param name="blk" type="org.apache.hadoop.hdfs.protocol.LocatedBlock"/>
  7702. <exception name="IOException" type="java.io.IOException"/>
  7703. </method>
  7704. <method name="streamBlockInAscii"
  7705. abstract="false" native="false" synchronized="false"
  7706. static="true" final="false" visibility="public"
  7707. deprecated="not deprecated">
  7708. <param name="addr" type="java.net.InetSocketAddress"/>
  7709. <param name="blockId" type="long"/>
  7710. <param name="accessToken" type="org.apache.hadoop.hdfs.security.BlockAccessToken"/>
  7711. <param name="genStamp" type="long"/>
  7712. <param name="blockSize" type="long"/>
  7713. <param name="offsetIntoBlock" type="long"/>
  7714. <param name="chunkSizeToView" type="long"/>
  7715. <param name="out" type="javax.servlet.jsp.JspWriter"/>
  7716. <param name="conf" type="org.apache.hadoop.conf.Configuration"/>
  7717. <exception name="IOException" type="java.io.IOException"/>
  7718. </method>
  7719. <method name="addTableHeader"
  7720. abstract="false" native="false" synchronized="false"
  7721. static="true" final="false" visibility="public"
  7722. deprecated="not deprecated">
  7723. <param name="out" type="javax.servlet.jsp.JspWriter"/>
  7724. <exception name="IOException" type="java.io.IOException"/>
  7725. </method>
  7726. <method name="addTableRow"
  7727. abstract="false" native="false" synchronized="false"
  7728. static="true" final="false" visibility="public"
  7729. deprecated="not deprecated">
  7730. <param name="out" type="javax.servlet.jsp.JspWriter"/>
  7731. <param name="columns" type="java.lang.String[]"/>
  7732. <exception name="IOException" type="java.io.IOException"/>
  7733. </method>
  7734. <method name="addTableRow"
  7735. abstract="false" native="false" synchronized="false"
  7736. static="true" final="false" visibility="public"
  7737. deprecated="not deprecated">
  7738. <param name="out" type="javax.servlet.jsp.JspWriter"/>
  7739. <param name="columns" type="java.lang.String[]"/>
  7740. <param name="row" type="int"/>
  7741. <exception name="IOException" type="java.io.IOException"/>
  7742. </method>
  7743. <method name="addTableFooter"
  7744. abstract="false" native="false" synchronized="false"
  7745. static="true" final="false" visibility="public"
  7746. deprecated="not deprecated">
  7747. <param name="out" type="javax.servlet.jsp.JspWriter"/>
  7748. <exception name="IOException" type="java.io.IOException"/>
  7749. </method>
  7750. <method name="sortNodeList"
  7751. abstract="false" native="false" synchronized="false"
  7752. static="true" final="false" visibility="public"
  7753. deprecated="not deprecated">
  7754. <param name="nodes" type="java.util.ArrayList"/>
  7755. <param name="field" type="java.lang.String"/>
  7756. <param name="order" type="java.lang.String"/>
  7757. </method>
  7758. <method name="printPathWithLinks"
  7759. abstract="false" native="false" synchronized="false"
  7760. static="true" final="false" visibility="public"
  7761. deprecated="not deprecated">
  7762. <param name="dir" type="java.lang.String"/>
  7763. <param name="out" type="javax.servlet.jsp.JspWriter"/>
  7764. <param name="namenodeInfoPort" type="int"/>
  7765. <param name="tokenString" type="java.lang.String"/>
  7766. <exception name="IOException" type="java.io.IOException"/>
  7767. </method>
  7768. <method name="printGotoForm"
  7769. abstract="false" native="false" synchronized="false"
  7770. static="true" final="false" visibility="public"
  7771. deprecated="not deprecated">
  7772. <param name="out" type="javax.servlet.jsp.JspWriter"/>
  7773. <param name="namenodeInfoPort" type="int"/>
  7774. <param name="tokenString" type="java.lang.String"/>
  7775. <param name="file" type="java.lang.String"/>
  7776. <exception name="IOException" type="java.io.IOException"/>
  7777. </method>
  7778. <method name="createTitle"
  7779. abstract="false" native="false" synchronized="false"
  7780. static="true" final="false" visibility="public"
  7781. deprecated="not deprecated">
  7782. <param name="out" type="javax.servlet.jsp.JspWriter"/>
  7783. <param name="req" type="javax.servlet.http.HttpServletRequest"/>
  7784. <param name="file" type="java.lang.String"/>
  7785. <exception name="IOException" type="java.io.IOException"/>
  7786. </method>
  7787. <method name="string2ChunkSizeToView" return="int"
  7788. abstract="false" native="false" synchronized="false"
  7789. static="true" final="false" visibility="public"
  7790. deprecated="not deprecated">
  7791. <param name="s" type="java.lang.String"/>
  7792. <param name="defaultValue" type="int"/>
  7793. <doc>
  7794. <![CDATA[Convert a String to chunk-size-to-view.]]>
  7795. </doc>
  7796. </method>
  7797. <method name="getVersionTable" return="java.lang.String"
  7798. abstract="false" native="false" synchronized="false"
  7799. static="true" final="false" visibility="public"
  7800. deprecated="not deprecated">
  7801. <doc>
  7802. <![CDATA[Return a table containing version information.]]>
  7803. </doc>
  7804. </method>
  7805. <method name="validatePath" return="java.lang.String"
  7806. abstract="false" native="false" synchronized="false"
  7807. static="true" final="false" visibility="public"
  7808. deprecated="not deprecated">
  7809. <param name="p" type="java.lang.String"/>
  7810. <doc>
  7811. <![CDATA[Validate filename.
  7812. @return null if the filename is invalid.
  7813. Otherwise, return the validated filename.]]>
  7814. </doc>
  7815. </method>
  7816. <method name="validateLong" return="java.lang.Long"
  7817. abstract="false" native="false" synchronized="false"
  7818. static="true" final="false" visibility="public"
  7819. deprecated="not deprecated">
  7820. <param name="value" type="java.lang.String"/>
  7821. <doc>
  7822. <![CDATA[Validate a long value.
  7823. @return null if the value is invalid.
  7824. Otherwise, return the validated Long object.]]>
  7825. </doc>
  7826. </method>
  7827. <method name="validateURL" return="java.lang.String"
  7828. abstract="false" native="false" synchronized="false"
  7829. static="true" final="false" visibility="public"
  7830. deprecated="not deprecated">
  7831. <param name="value" type="java.lang.String"/>
  7832. <doc>
  7833. <![CDATA[Validate a URL.
  7834. @return null if the value is invalid.
  7835. Otherwise, return the validated URL String.]]>
  7836. </doc>
  7837. </method>
  7838. <method name="getDefaultWebUser" return="org.apache.hadoop.security.UserGroupInformation"
  7839. abstract="false" native="false" synchronized="false"
  7840. static="true" final="false" visibility="public"
  7841. deprecated="not deprecated">
  7842. <param name="conf" type="org.apache.hadoop.conf.Configuration"/>
  7843. <exception name="IOException" type="java.io.IOException"/>
  7844. <doc>
  7845. <![CDATA[If security is turned off, what is the default web user?
  7846. @param conf the configuration to look in
  7847. @return the remote user that was configuration]]>
  7848. </doc>
  7849. </method>
  7850. <method name="getUGI" return="org.apache.hadoop.security.UserGroupInformation"
  7851. abstract="false" native="false" synchronized="false"
  7852. static="true" final="false" visibility="public"
  7853. deprecated="not deprecated">
  7854. <param name="request" type="javax.servlet.http.HttpServletRequest"/>
  7855. <param name="conf" type="org.apache.hadoop.conf.Configuration"/>
  7856. <exception name="IOException" type="java.io.IOException"/>
  7857. <doc>
  7858. <![CDATA[Get {@link UserGroupInformation} and possibly the delegation token out of
  7859. the request.
  7860. @param request the http request
  7861. @return a new user from the request
  7862. @throws AccessControlException if the request has no token]]>
  7863. </doc>
  7864. </method>
  7865. <field name="WEB_UGI_PROPERTY_NAME" type="java.lang.String"
  7866. transient="false" volatile="false"
  7867. static="true" final="true" visibility="public"
  7868. deprecated="not deprecated">
  7869. </field>
  7870. <field name="DELEGATION_PARAMETER_NAME" type="java.lang.String"
  7871. transient="false" volatile="false"
  7872. static="true" final="true" visibility="public"
  7873. deprecated="not deprecated">
  7874. </field>
  7875. <field name="SET_DELEGATION" type="java.lang.String"
  7876. transient="false" volatile="false"
  7877. static="true" final="true" visibility="public"
  7878. deprecated="not deprecated">
  7879. </field>
  7880. </class>
  7881. <!-- end class org.apache.hadoop.hdfs.server.common.JspHelper -->
  7882. <!-- start class org.apache.hadoop.hdfs.server.common.Storage -->
  7883. <class name="Storage" extends="org.apache.hadoop.hdfs.server.common.StorageInfo"
  7884. abstract="true"
  7885. static="false" final="false" visibility="public"
  7886. deprecated="not deprecated">
  7887. <constructor name="Storage" type="org.apache.hadoop.hdfs.server.common.HdfsConstants.NodeType"
  7888. static="false" final="false" visibility="protected"
  7889. deprecated="not deprecated">
  7890. <doc>
  7891. <![CDATA[Create empty storage info of the specified type]]>
  7892. </doc>
  7893. </constructor>
  7894. <constructor name="Storage" type="org.apache.hadoop.hdfs.server.common.HdfsConstants.NodeType, int, long"
  7895. static="false" final="false" visibility="protected"
  7896. deprecated="not deprecated">
  7897. </constructor>
  7898. <constructor name="Storage" type="org.apache.hadoop.hdfs.server.common.HdfsConstants.NodeType, org.apache.hadoop.hdfs.server.common.StorageInfo"
  7899. static="false" final="false" visibility="protected"
  7900. deprecated="not deprecated">
  7901. </constructor>
  7902. <method name="dirIterator" return="java.util.Iterator"
  7903. abstract="false" native="false" synchronized="false"
  7904. static="false" final="false" visibility="public"
  7905. deprecated="not deprecated">
  7906. <doc>
  7907. <![CDATA[Return default iterator
  7908. This iterator returns all entries in storageDirs]]>
  7909. </doc>
  7910. </method>
  7911. <method name="dirIterator" return="java.util.Iterator"
  7912. abstract="false" native="false" synchronized="false"
  7913. static="false" final="false" visibility="public"
  7914. deprecated="not deprecated">
  7915. <param name="dirType" type="org.apache.hadoop.hdfs.server.common.Storage.StorageDirType"/>
  7916. <doc>
  7917. <![CDATA[Return iterator based on Storage Directory Type
  7918. This iterator selects entries in storageDirs of type dirType and returns
  7919. them via the Iterator]]>
  7920. </doc>
  7921. </method>
  7922. <method name="listStorageDirectories" return="java.lang.String"
  7923. abstract="false" native="false" synchronized="false"
  7924. static="false" final="false" visibility="public"
  7925. deprecated="not deprecated">
  7926. <doc>
  7927. <![CDATA[generate storage list (debug line)]]>
  7928. </doc>
  7929. </method>
  7930. <method name="getNumStorageDirs" return="int"
  7931. abstract="false" native="false" synchronized="false"
  7932. static="false" final="false" visibility="public"
  7933. deprecated="not deprecated">
  7934. </method>
  7935. <method name="getStorageDir" return="org.apache.hadoop.hdfs.server.common.Storage.StorageDirectory"
  7936. abstract="false" native="false" synchronized="false"
  7937. static="false" final="false" visibility="public"
  7938. deprecated="not deprecated">
  7939. <param name="idx" type="int"/>
  7940. </method>
  7941. <method name="addStorageDir"
  7942. abstract="false" native="false" synchronized="false"
  7943. static="false" final="false" visibility="protected"
  7944. deprecated="not deprecated">
  7945. <param name="sd" type="org.apache.hadoop.hdfs.server.common.Storage.StorageDirectory"/>
  7946. </method>
  7947. <method name="isConversionNeeded" return="boolean"
  7948. abstract="true" native="false" synchronized="false"
  7949. static="false" final="false" visibility="public"
  7950. deprecated="not deprecated">
  7951. <param name="sd" type="org.apache.hadoop.hdfs.server.common.Storage.StorageDirectory"/>
  7952. <exception name="IOException" type="java.io.IOException"/>
  7953. </method>
  7954. <method name="checkVersionUpgradable"
  7955. abstract="false" native="false" synchronized="false"
  7956. static="true" final="false" visibility="protected"
  7957. deprecated="not deprecated">
  7958. <param name="oldVersion" type="int"/>
  7959. <exception name="IOException" type="java.io.IOException"/>
  7960. <doc>
  7961. <![CDATA[Checks if the upgrade from the given old version is supported. If
  7962. no upgrade is supported, it throws IncorrectVersionException.
  7963. @param oldVersion]]>
  7964. </doc>
  7965. </method>
  7966. <method name="getFields"
  7967. abstract="false" native="false" synchronized="false"
  7968. static="false" final="false" visibility="protected"
  7969. deprecated="not deprecated">
  7970. <param name="props" type="java.util.Properties"/>
  7971. <param name="sd" type="org.apache.hadoop.hdfs.server.common.Storage.StorageDirectory"/>
  7972. <exception name="IOException" type="java.io.IOException"/>
  7973. <doc>
  7974. <![CDATA[Get common storage fields.
  7975. Should be overloaded if additional fields need to be get.
  7976. @param props
  7977. @throws IOException]]>
  7978. </doc>
  7979. </method>
  7980. <method name="setFields"
  7981. abstract="false" native="false" synchronized="false"
  7982. static="false" final="false" visibility="protected"
  7983. deprecated="not deprecated">
  7984. <param name="props" type="java.util.Properties"/>
  7985. <param name="sd" type="org.apache.hadoop.hdfs.server.common.Storage.StorageDirectory"/>
  7986. <exception name="IOException" type="java.io.IOException"/>
  7987. <doc>
  7988. <![CDATA[Set common storage fields.
  7989. Should be overloaded if additional fields need to be set.
  7990. @param props
  7991. @throws IOException]]>
  7992. </doc>
  7993. </method>
  7994. <method name="rename"
  7995. abstract="false" native="false" synchronized="false"
  7996. static="true" final="false" visibility="public"
  7997. deprecated="not deprecated">
  7998. <param name="from" type="java.io.File"/>
  7999. <param name="to" type="java.io.File"/>
  8000. <exception name="IOException" type="java.io.IOException"/>
  8001. </method>
  8002. <method name="deleteDir"
  8003. abstract="false" native="false" synchronized="false"
  8004. static="true" final="false" visibility="protected"
  8005. deprecated="not deprecated">
  8006. <param name="dir" type="java.io.File"/>
  8007. <exception name="IOException" type="java.io.IOException"/>
  8008. </method>
  8009. <method name="writeAll"
  8010. abstract="false" native="false" synchronized="false"
  8011. static="false" final="false" visibility="public"
  8012. deprecated="not deprecated">
  8013. <exception name="IOException" type="java.io.IOException"/>
  8014. <doc>
  8015. <![CDATA[Write all data storage files.
  8016. @throws IOException]]>
  8017. </doc>
  8018. </method>
  8019. <method name="unlockAll"
  8020. abstract="false" native="false" synchronized="false"
  8021. static="false" final="false" visibility="public"
  8022. deprecated="not deprecated">
  8023. <exception name="IOException" type="java.io.IOException"/>
  8024. <doc>
  8025. <![CDATA[Unlock all storage directories.
  8026. @throws IOException]]>
  8027. </doc>
  8028. </method>
  8029. <method name="isLockSupported" return="boolean"
  8030. abstract="false" native="false" synchronized="false"
  8031. static="false" final="false" visibility="public"
  8032. deprecated="not deprecated">
  8033. <param name="idx" type="int"/>
  8034. <exception name="IOException" type="java.io.IOException"/>
  8035. <doc>
  8036. <![CDATA[Check whether underlying file system supports file locking.
  8037. @return <code>true</code> if exclusive locks are supported or
  8038. <code>false</code> otherwise.
  8039. @throws IOException
  8040. @see StorageDirectory#lock()]]>
  8041. </doc>
  8042. </method>
  8043. <method name="getBuildVersion" return="java.lang.String"
  8044. abstract="false" native="false" synchronized="false"
  8045. static="true" final="false" visibility="public"
  8046. deprecated="not deprecated">
  8047. </method>
  8048. <method name="getRegistrationID" return="java.lang.String"
  8049. abstract="false" native="false" synchronized="false"
  8050. static="true" final="false" visibility="public"
  8051. deprecated="not deprecated">
  8052. <param name="storage" type="org.apache.hadoop.hdfs.server.common.StorageInfo"/>
  8053. </method>
  8054. <method name="corruptPreUpgradeStorage"
  8055. abstract="true" native="false" synchronized="false"
  8056. static="false" final="false" visibility="protected"
  8057. deprecated="not deprecated">
  8058. <param name="rootDir" type="java.io.File"/>
  8059. <exception name="IOException" type="java.io.IOException"/>
  8060. </method>
  8061. <method name="writeCorruptedData"
  8062. abstract="false" native="false" synchronized="false"
  8063. static="false" final="false" visibility="protected"
  8064. deprecated="not deprecated">
  8065. <param name="file" type="java.io.RandomAccessFile"/>
  8066. <exception name="IOException" type="java.io.IOException"/>
  8067. </method>
  8068. <field name="LOG" type="org.apache.commons.logging.Log"
  8069. transient="false" volatile="false"
  8070. static="true" final="true" visibility="public"
  8071. deprecated="not deprecated">
  8072. </field>
  8073. <field name="LAST_PRE_UPGRADE_LAYOUT_VERSION" type="int"
  8074. transient="false" volatile="false"
  8075. static="true" final="true" visibility="protected"
  8076. deprecated="not deprecated">
  8077. </field>
  8078. <field name="LAST_UPGRADABLE_LAYOUT_VERSION" type="int"
  8079. transient="false" volatile="false"
  8080. static="true" final="true" visibility="public"
  8081. deprecated="not deprecated">
  8082. </field>
  8083. <field name="LAST_UPGRADABLE_HADOOP_VERSION" type="java.lang.String"
  8084. transient="false" volatile="false"
  8085. static="true" final="true" visibility="protected"
  8086. deprecated="not deprecated">
  8087. </field>
  8088. <field name="PRE_GENERATIONSTAMP_LAYOUT_VERSION" type="int"
  8089. transient="false" volatile="false"
  8090. static="true" final="true" visibility="public"
  8091. deprecated="not deprecated">
  8092. </field>
  8093. <field name="PRE_RBW_LAYOUT_VERSION" type="int"
  8094. transient="false" volatile="false"
  8095. static="true" final="true" visibility="public"
  8096. deprecated="not deprecated">
  8097. </field>
  8098. <field name="STORAGE_FILE_VERSION" type="java.lang.String"
  8099. transient="false" volatile="false"
  8100. static="true" final="true" visibility="protected"
  8101. deprecated="not deprecated">
  8102. </field>
  8103. <field name="STORAGE_DIR_CURRENT" type="java.lang.String"
  8104. transient="false" volatile="false"
  8105. static="true" final="true" visibility="public"
  8106. deprecated="not deprecated">
  8107. </field>
  8108. <field name="storageDirs" type="java.util.List"
  8109. transient="false" volatile="false"
  8110. static="false" final="false" visibility="protected"
  8111. deprecated="not deprecated">
  8112. </field>
  8113. <doc>
  8114. <![CDATA[Storage information file.
  8115. <p>
  8116. Local storage information is stored in a separate file VERSION.
  8117. It contains type of the node,
  8118. the storage layout version, the namespace id, and
  8119. the fs state creation time.
  8120. <p>
  8121. Local storage can reside in multiple directories.
  8122. Each directory should contain the same VERSION file as the others.
  8123. During startup Hadoop servers (name-node and data-nodes) read their local
  8124. storage information from them.
  8125. <p>
  8126. The servers hold a lock for each storage directory while they run so that
  8127. other nodes were not able to startup sharing the same storage.
  8128. The locks are released when the servers stop (normally or abnormally).]]>
  8129. </doc>
  8130. </class>
  8131. <!-- end class org.apache.hadoop.hdfs.server.common.Storage -->
  8132. <!-- start class org.apache.hadoop.hdfs.server.common.Storage.StorageDirectory -->
  8133. <class name="Storage.StorageDirectory" extends="java.lang.Object"
  8134. abstract="false"
  8135. static="false" final="false" visibility="public"
  8136. deprecated="not deprecated">
  8137. <constructor name="Storage.StorageDirectory" type="java.io.File"
  8138. static="false" final="false" visibility="public"
  8139. deprecated="not deprecated">
  8140. </constructor>
  8141. <constructor name="Storage.StorageDirectory" type="java.io.File, org.apache.hadoop.hdfs.server.common.Storage.StorageDirType"
  8142. static="false" final="false" visibility="public"
  8143. deprecated="not deprecated">
  8144. </constructor>
  8145. <method name="getRoot" return="java.io.File"
  8146. abstract="false" native="false" synchronized="false"
  8147. static="false" final="false" visibility="public"
  8148. deprecated="not deprecated">
  8149. <doc>
  8150. <![CDATA[Get root directory of this storage]]>
  8151. </doc>
  8152. </method>
  8153. <method name="getStorageDirType" return="org.apache.hadoop.hdfs.server.common.Storage.StorageDirType"
  8154. abstract="false" native="false" synchronized="false"
  8155. static="false" final="false" visibility="public"
  8156. deprecated="not deprecated">
  8157. <doc>
  8158. <![CDATA[Get storage directory type]]>
  8159. </doc>
  8160. </method>
  8161. <method name="read"
  8162. abstract="false" native="false" synchronized="false"
  8163. static="false" final="false" visibility="public"
  8164. deprecated="not deprecated">
  8165. <exception name="IOException" type="java.io.IOException"/>
  8166. <doc>
  8167. <![CDATA[Read version file.
  8168. @throws IOException if file cannot be read or contains inconsistent data]]>
  8169. </doc>
  8170. </method>
  8171. <method name="read"
  8172. abstract="false" native="false" synchronized="false"
  8173. static="false" final="false" visibility="public"
  8174. deprecated="not deprecated">
  8175. <param name="from" type="java.io.File"/>
  8176. <exception name="IOException" type="java.io.IOException"/>
  8177. </method>
  8178. <method name="write"
  8179. abstract="false" native="false" synchronized="false"
  8180. static="false" final="false" visibility="public"
  8181. deprecated="not deprecated">
  8182. <exception name="IOException" type="java.io.IOException"/>
  8183. <doc>
  8184. <![CDATA[Write version file.
  8185. @throws IOException]]>
  8186. </doc>
  8187. </method>
  8188. <method name="write"
  8189. abstract="false" native="false" synchronized="false"
  8190. static="false" final="false" visibility="public"
  8191. deprecated="not deprecated">
  8192. <param name="to" type="java.io.File"/>
  8193. <exception name="IOException" type="java.io.IOException"/>
  8194. </method>
  8195. <method name="clearDirectory"
  8196. abstract="false" native="false" synchronized="false"
  8197. static="false" final="false" visibility="public"
  8198. deprecated="not deprecated">
  8199. <exception name="IOException" type="java.io.IOException"/>
  8200. <doc>
  8201. <![CDATA[Clear and re-create storage directory.
  8202. <p>
  8203. Removes contents of the current directory and creates an empty directory.
  8204. This does not fully format storage directory.
  8205. It cannot write the version file since it should be written last after
  8206. all other storage type dependent files are written.
  8207. Derived storage is responsible for setting specific storage values and
  8208. writing the version file to disk.
  8209. @throws IOException]]>
  8210. </doc>
  8211. </method>
  8212. <method name="getCurrentDir" return="java.io.File"
  8213. abstract="false" native="false" synchronized="false"
  8214. static="false" final="false" visibility="public"
  8215. deprecated="not deprecated">
  8216. <doc>
  8217. <![CDATA[Directory {@code current} contains latest files defining
  8218. the file system meta-data.
  8219. @return the directory path]]>
  8220. </doc>
  8221. </method>
  8222. <method name="getVersionFile" return="java.io.File"
  8223. abstract="false" native="false" synchronized="false"
  8224. static="false" final="false" visibility="public"
  8225. deprecated="not deprecated">
  8226. <doc>
  8227. <![CDATA[File {@code VERSION} contains the following fields:
  8228. <ol>
  8229. <li>node type</li>
  8230. <li>layout version</li>
  8231. <li>namespaceID</li>
  8232. <li>fs state creation time</li>
  8233. <li>other fields specific for this node type</li>
  8234. </ol>
  8235. The version file is always written last during storage directory updates.
  8236. The existence of the version file indicates that all other files have
  8237. been successfully written in the storage directory, the storage is valid
  8238. and does not need to be recovered.
  8239. @return the version file path]]>
  8240. </doc>
  8241. </method>
  8242. <method name="getPreviousVersionFile" return="java.io.File"
  8243. abstract="false" native="false" synchronized="false"
  8244. static="false" final="false" visibility="public"
  8245. deprecated="not deprecated">
  8246. <doc>
  8247. <![CDATA[File {@code VERSION} from the {@code previous} directory.
  8248. @return the previous version file path]]>
  8249. </doc>
  8250. </method>
  8251. <method name="getPreviousDir" return="java.io.File"
  8252. abstract="false" native="false" synchronized="false"
  8253. static="false" final="false" visibility="public"
  8254. deprecated="not deprecated">
  8255. <doc>
  8256. <![CDATA[Directory {@code previous} contains the previous file system state,
  8257. which the system can be rolled back to.
  8258. @return the directory path]]>
  8259. </doc>
  8260. </method>
  8261. <method name="getPreviousTmp" return="java.io.File"
  8262. abstract="false" native="false" synchronized="false"
  8263. static="false" final="false" visibility="public"
  8264. deprecated="not deprecated">
  8265. <doc>
  8266. <![CDATA[{@code previous.tmp} is a transient directory, which holds
  8267. current file system state while the new state is saved into the new
  8268. {@code current} during upgrade.
  8269. If the saving succeeds {@code previous.tmp} will be moved to
  8270. {@code previous}, otherwise it will be renamed back to
  8271. {@code current} by the recovery procedure during startup.
  8272. @return the directory path]]>
  8273. </doc>
  8274. </method>
  8275. <method name="getRemovedTmp" return="java.io.File"
  8276. abstract="false" native="false" synchronized="false"
  8277. static="false" final="false" visibility="public"
  8278. deprecated="not deprecated">
  8279. <doc>
  8280. <![CDATA[{@code removed.tmp} is a transient directory, which holds
  8281. current file system state while the previous state is moved into
  8282. {@code current} during rollback.
  8283. If the moving succeeds {@code removed.tmp} will be removed,
  8284. otherwise it will be renamed back to
  8285. {@code current} by the recovery procedure during startup.
  8286. @return the directory path]]>
  8287. </doc>
  8288. </method>
  8289. <method name="getFinalizedTmp" return="java.io.File"
  8290. abstract="false" native="false" synchronized="false"
  8291. static="false" final="false" visibility="public"
  8292. deprecated="not deprecated">
  8293. <doc>
  8294. <![CDATA[{@code finalized.tmp} is a transient directory, which holds
  8295. the {@code previous} file system state while it is being removed
  8296. in response to the finalize request.
  8297. Finalize operation will remove {@code finalized.tmp} when completed,
  8298. otherwise the removal will resume upon the system startup.
  8299. @return the directory path]]>
  8300. </doc>
  8301. </method>
  8302. <method name="getLastCheckpointTmp" return="java.io.File"
  8303. abstract="false" native="false" synchronized="false"
  8304. static="false" final="false" visibility="public"
  8305. deprecated="not deprecated">
  8306. <doc>
  8307. <![CDATA[{@code lastcheckpoint.tmp} is a transient directory, which holds
  8308. current file system state while the new state is saved into the new
  8309. {@code current} during regular namespace updates.
  8310. If the saving succeeds {@code lastcheckpoint.tmp} will be moved to
  8311. {@code previous.checkpoint}, otherwise it will be renamed back to
  8312. {@code current} by the recovery procedure during startup.
  8313. @return the directory path]]>
  8314. </doc>
  8315. </method>
  8316. <method name="getPreviousCheckpoint" return="java.io.File"
  8317. abstract="false" native="false" synchronized="false"
  8318. static="false" final="false" visibility="public"
  8319. deprecated="not deprecated">
  8320. <doc>
  8321. <![CDATA[{@code previous.checkpoint} is a directory, which holds the previous
  8322. (before the last save) state of the storage directory.
  8323. The directory is created as a reference only, it does not play role
  8324. in state recovery procedures, and is recycled automatically,
  8325. but it may be useful for manual recovery of a stale state of the system.
  8326. @return the directory path]]>
  8327. </doc>
  8328. </method>
  8329. <method name="analyzeStorage" return="org.apache.hadoop.hdfs.server.common.Storage.StorageState"
  8330. abstract="false" native="false" synchronized="false"
  8331. static="false" final="false" visibility="public"
  8332. deprecated="not deprecated">
  8333. <param name="startOpt" type="org.apache.hadoop.hdfs.server.common.HdfsConstants.StartupOption"/>
  8334. <exception name="IOException" type="java.io.IOException"/>
  8335. <doc>
  8336. <![CDATA[Check consistency of the storage directory
  8337. @param startOpt a startup option.
  8338. @return state {@link StorageState} of the storage directory
  8339. @throws InconsistentFSStateException if directory state is not
  8340. consistent and cannot be recovered.
  8341. @throws IOException]]>
  8342. </doc>
  8343. </method>
  8344. <method name="doRecover"
  8345. abstract="false" native="false" synchronized="false"
  8346. static="false" final="false" visibility="public"
  8347. deprecated="not deprecated">
  8348. <param name="curState" type="org.apache.hadoop.hdfs.server.common.Storage.StorageState"/>
  8349. <exception name="IOException" type="java.io.IOException"/>
  8350. <doc>
  8351. <![CDATA[Complete or recover storage state from previously failed transition.
  8352. @param curState specifies what/how the state should be recovered
  8353. @throws IOException]]>
  8354. </doc>
  8355. </method>
  8356. <method name="lock"
  8357. abstract="false" native="false" synchronized="false"
  8358. static="false" final="false" visibility="public"
  8359. deprecated="not deprecated">
  8360. <exception name="IOException" type="java.io.IOException"/>
  8361. <doc>
  8362. <![CDATA[Lock storage to provide exclusive access.
  8363. <p> Locking is not supported by all file systems.
  8364. E.g., NFS does not consistently support exclusive locks.
  8365. <p> If locking is supported we guarantee exculsive access to the
  8366. storage directory. Otherwise, no guarantee is given.
  8367. @throws IOException if locking fails]]>
  8368. </doc>
  8369. </method>
  8370. <method name="unlock"
  8371. abstract="false" native="false" synchronized="false"
  8372. static="false" final="false" visibility="public"
  8373. deprecated="not deprecated">
  8374. <exception name="IOException" type="java.io.IOException"/>
  8375. <doc>
  8376. <![CDATA[Unlock storage.
  8377. @throws IOException]]>
  8378. </doc>
  8379. </method>
  8380. <doc>
  8381. <![CDATA[One of the storage directories.]]>
  8382. </doc>
  8383. </class>
  8384. <!-- end class org.apache.hadoop.hdfs.server.common.Storage.StorageDirectory -->
  8385. <!-- start interface org.apache.hadoop.hdfs.server.common.Storage.StorageDirType -->
  8386. <interface name="Storage.StorageDirType" abstract="true"
  8387. static="true" final="false" visibility="public"
  8388. deprecated="not deprecated">
  8389. <method name="getStorageDirType" return="org.apache.hadoop.hdfs.server.common.Storage.StorageDirType"
  8390. abstract="false" native="false" synchronized="false"
  8391. static="false" final="false" visibility="public"
  8392. deprecated="not deprecated">
  8393. </method>
  8394. <method name="isOfType" return="boolean"
  8395. abstract="false" native="false" synchronized="false"
  8396. static="false" final="false" visibility="public"
  8397. deprecated="not deprecated">
  8398. <param name="type" type="org.apache.hadoop.hdfs.server.common.Storage.StorageDirType"/>
  8399. </method>
  8400. <doc>
  8401. <![CDATA[An interface to denote storage directory type
  8402. Implementations can define a type for storage directory by implementing
  8403. this interface.]]>
  8404. </doc>
  8405. </interface>
  8406. <!-- end interface org.apache.hadoop.hdfs.server.common.Storage.StorageDirType -->
  8407. <!-- start class org.apache.hadoop.hdfs.server.common.Storage.StorageState -->
  8408. <class name="Storage.StorageState" extends="java.lang.Enum"
  8409. abstract="false"
  8410. static="true" final="true" visibility="public"
  8411. deprecated="not deprecated">
  8412. <method name="values" return="org.apache.hadoop.hdfs.server.common.Storage.StorageState[]"
  8413. abstract="false" native="false" synchronized="false"
  8414. static="true" final="false" visibility="public"
  8415. deprecated="not deprecated">
  8416. </method>
  8417. <method name="valueOf" return="org.apache.hadoop.hdfs.server.common.Storage.StorageState"
  8418. abstract="false" native="false" synchronized="false"
  8419. static="true" final="false" visibility="public"
  8420. deprecated="not deprecated">
  8421. <param name="name" type="java.lang.String"/>
  8422. </method>
  8423. <field name="NON_EXISTENT" type="org.apache.hadoop.hdfs.server.common.Storage.StorageState"
  8424. transient="false" volatile="false"
  8425. static="true" final="true" visibility="public"
  8426. deprecated="not deprecated">
  8427. </field>
  8428. <field name="NOT_FORMATTED" type="org.apache.hadoop.hdfs.server.common.Storage.StorageState"
  8429. transient="false" volatile="false"
  8430. static="true" final="true" visibility="public"
  8431. deprecated="not deprecated">
  8432. </field>
  8433. <field name="COMPLETE_UPGRADE" type="org.apache.hadoop.hdfs.server.common.Storage.StorageState"
  8434. transient="false" volatile="false"
  8435. static="true" final="true" visibility="public"
  8436. deprecated="not deprecated">
  8437. </field>
  8438. <field name="RECOVER_UPGRADE" type="org.apache.hadoop.hdfs.server.common.Storage.StorageState"
  8439. transient="false" volatile="false"
  8440. static="true" final="true" visibility="public"
  8441. deprecated="not deprecated">
  8442. </field>
  8443. <field name="COMPLETE_FINALIZE" type="org.apache.hadoop.hdfs.server.common.Storage.StorageState"
  8444. transient="false" volatile="false"
  8445. static="true" final="true" visibility="public"
  8446. deprecated="not deprecated">
  8447. </field>
  8448. <field name="COMPLETE_ROLLBACK" type="org.apache.hadoop.hdfs.server.common.Storage.StorageState"
  8449. transient="false" volatile="false"
  8450. static="true" final="true" visibility="public"
  8451. deprecated="not deprecated">
  8452. </field>
  8453. <field name="RECOVER_ROLLBACK" type="org.apache.hadoop.hdfs.server.common.Storage.StorageState"
  8454. transient="false" volatile="false"
  8455. static="true" final="true" visibility="public"
  8456. deprecated="not deprecated">
  8457. </field>
  8458. <field name="COMPLETE_CHECKPOINT" type="org.apache.hadoop.hdfs.server.common.Storage.StorageState"
  8459. transient="false" volatile="false"
  8460. static="true" final="true" visibility="public"
  8461. deprecated="not deprecated">
  8462. </field>
  8463. <field name="RECOVER_CHECKPOINT" type="org.apache.hadoop.hdfs.server.common.Storage.StorageState"
  8464. transient="false" volatile="false"
  8465. static="true" final="true" visibility="public"
  8466. deprecated="not deprecated">
  8467. </field>
  8468. <field name="NORMAL" type="org.apache.hadoop.hdfs.server.common.Storage.StorageState"
  8469. transient="false" volatile="false"
  8470. static="true" final="true" visibility="public"
  8471. deprecated="not deprecated">
  8472. </field>
  8473. </class>
  8474. <!-- end class org.apache.hadoop.hdfs.server.common.Storage.StorageState -->
  8475. <!-- start class org.apache.hadoop.hdfs.server.common.StorageInfo -->
  8476. <class name="StorageInfo" extends="java.lang.Object"
  8477. abstract="false"
  8478. static="false" final="false" visibility="public"
  8479. deprecated="not deprecated">
  8480. <implements name="org.apache.hadoop.io.Writable"/>
  8481. <constructor name="StorageInfo"
  8482. static="false" final="false" visibility="public"
  8483. deprecated="not deprecated">
  8484. </constructor>
  8485. <constructor name="StorageInfo" type="int, int, long"
  8486. static="false" final="false" visibility="public"
  8487. deprecated="not deprecated">
  8488. </constructor>
  8489. <constructor name="StorageInfo" type="org.apache.hadoop.hdfs.server.common.StorageInfo"
  8490. static="false" final="false" visibility="public"
  8491. deprecated="not deprecated">
  8492. </constructor>
  8493. <method name="getLayoutVersion" return="int"
  8494. abstract="false" native="false" synchronized="false"
  8495. static="false" final="false" visibility="public"
  8496. deprecated="not deprecated">
  8497. <doc>
  8498. <![CDATA[Layout version of the storage data.]]>
  8499. </doc>
  8500. </method>
  8501. <method name="getNamespaceID" return="int"
  8502. abstract="false" native="false" synchronized="false"
  8503. static="false" final="false" visibility="public"
  8504. deprecated="not deprecated">
  8505. <doc>
  8506. <![CDATA[Namespace id of the file system.<p>
  8507. Assigned to the file system at formatting and never changes after that.
  8508. Shared by all file system components.]]>
  8509. </doc>
  8510. </method>
  8511. <method name="getCTime" return="long"
  8512. abstract="false" native="false" synchronized="false"
  8513. static="false" final="false" visibility="public"
  8514. deprecated="not deprecated">
  8515. <doc>
  8516. <![CDATA[Creation time of the file system state.<p>
  8517. Modified during upgrades.]]>
  8518. </doc>
  8519. </method>
  8520. <method name="setStorageInfo"
  8521. abstract="false" native="false" synchronized="false"
  8522. static="false" final="false" visibility="public"
  8523. deprecated="not deprecated">
  8524. <param name="from" type="org.apache.hadoop.hdfs.server.common.StorageInfo"/>
  8525. </method>
  8526. <method name="write"
  8527. abstract="false" native="false" synchronized="false"
  8528. static="false" final="false" visibility="public"
  8529. deprecated="not deprecated">
  8530. <param name="out" type="java.io.DataOutput"/>
  8531. <exception name="IOException" type="java.io.IOException"/>
  8532. </method>
  8533. <method name="readFields"
  8534. abstract="false" native="false" synchronized="false"
  8535. static="false" final="false" visibility="public"
  8536. deprecated="not deprecated">
  8537. <param name="in" type="java.io.DataInput"/>
  8538. <exception name="IOException" type="java.io.IOException"/>
  8539. </method>
  8540. <field name="layoutVersion" type="int"
  8541. transient="false" volatile="false"
  8542. static="false" final="false" visibility="public"
  8543. deprecated="not deprecated">
  8544. </field>
  8545. <field name="namespaceID" type="int"
  8546. transient="false" volatile="false"
  8547. static="false" final="false" visibility="public"
  8548. deprecated="not deprecated">
  8549. </field>
  8550. <field name="cTime" type="long"
  8551. transient="false" volatile="false"
  8552. static="false" final="false" visibility="public"
  8553. deprecated="not deprecated">
  8554. </field>
  8555. <doc>
  8556. <![CDATA[Common class for storage information.
  8557. TODO namespaceID should be long and computed as hash(address + port)]]>
  8558. </doc>
  8559. </class>
  8560. <!-- end class org.apache.hadoop.hdfs.server.common.StorageInfo -->
  8561. <!-- start interface org.apache.hadoop.hdfs.server.common.Upgradeable -->
  8562. <interface name="Upgradeable" abstract="true"
  8563. static="false" final="false" visibility="public"
  8564. deprecated="not deprecated">
  8565. <implements name="java.lang.Comparable"/>
  8566. <method name="getVersion" return="int"
  8567. abstract="false" native="false" synchronized="false"
  8568. static="false" final="false" visibility="public"
  8569. deprecated="not deprecated">
  8570. <doc>
  8571. <![CDATA[Get the layout version of the upgrade object.
  8572. @return layout version]]>
  8573. </doc>
  8574. </method>
  8575. <method name="getType" return="org.apache.hadoop.hdfs.server.common.HdfsConstants.NodeType"
  8576. abstract="false" native="false" synchronized="false"
  8577. static="false" final="false" visibility="public"
  8578. deprecated="not deprecated">
  8579. <doc>
  8580. <![CDATA[Get the type of the software component, which this object is upgrading.
  8581. @return type]]>
  8582. </doc>
  8583. </method>
  8584. <method name="getDescription" return="java.lang.String"
  8585. abstract="false" native="false" synchronized="false"
  8586. static="false" final="false" visibility="public"
  8587. deprecated="not deprecated">
  8588. <doc>
  8589. <![CDATA[Description of the upgrade object for displaying.
  8590. @return description]]>
  8591. </doc>
  8592. </method>
  8593. <method name="getUpgradeStatus" return="short"
  8594. abstract="false" native="false" synchronized="false"
  8595. static="false" final="false" visibility="public"
  8596. deprecated="not deprecated">
  8597. <doc>
  8598. <![CDATA[Upgrade status determines a percentage of the work done out of the total
  8599. amount required by the upgrade.
  8600. 100% means that the upgrade is completed.
  8601. Any value < 100 means it is not complete.
  8602. The return value should provide at least 2 values, e.g. 0 and 100.
  8603. @return integer value in the range [0, 100].]]>
  8604. </doc>
  8605. </method>
  8606. <method name="startUpgrade" return="org.apache.hadoop.hdfs.server.protocol.UpgradeCommand"
  8607. abstract="false" native="false" synchronized="false"
  8608. static="false" final="false" visibility="public"
  8609. deprecated="not deprecated">
  8610. <exception name="IOException" type="java.io.IOException"/>
  8611. <doc>
  8612. <![CDATA[Prepare for the upgrade.
  8613. E.g. initialize upgrade data structures and set status to 0.
  8614. Returns an upgrade command that is used for broadcasting to other cluster
  8615. components.
  8616. E.g. name-node informs data-nodes that they must perform a distributed upgrade.
  8617. @return an UpgradeCommand for broadcasting.
  8618. @throws IOException]]>
  8619. </doc>
  8620. </method>
  8621. <method name="completeUpgrade" return="org.apache.hadoop.hdfs.server.protocol.UpgradeCommand"
  8622. abstract="false" native="false" synchronized="false"
  8623. static="false" final="false" visibility="public"
  8624. deprecated="not deprecated">
  8625. <exception name="IOException" type="java.io.IOException"/>
  8626. <doc>
  8627. <![CDATA[Complete upgrade.
  8628. E.g. cleanup upgrade data structures or write metadata to disk.
  8629. Returns an upgrade command that is used for broadcasting to other cluster
  8630. components.
  8631. E.g. data-nodes inform the name-node that they completed the upgrade
  8632. while other data-nodes are still upgrading.
  8633. @throws IOException]]>
  8634. </doc>
  8635. </method>
  8636. <method name="getUpgradeStatusReport" return="org.apache.hadoop.hdfs.server.common.UpgradeStatusReport"
  8637. abstract="false" native="false" synchronized="false"
  8638. static="false" final="false" visibility="public"
  8639. deprecated="not deprecated">
  8640. <param name="details" type="boolean"/>
  8641. <exception name="IOException" type="java.io.IOException"/>
  8642. <doc>
  8643. <![CDATA[Get status report for the upgrade.
  8644. @param details true if upgradeStatus details need to be included,
  8645. false otherwise
  8646. @return {@link UpgradeStatusReport}
  8647. @throws IOException]]>
  8648. </doc>
  8649. </method>
  8650. <doc>
  8651. <![CDATA[Common interface for distributed upgrade objects.
  8652. Each upgrade object corresponds to a layout version,
  8653. which is the latest version that should be upgraded using this object.
  8654. That is all components whose layout version is greater or equal to the
  8655. one returned by {@link #getVersion()} must be upgraded with this object.]]>
  8656. </doc>
  8657. </interface>
  8658. <!-- end interface org.apache.hadoop.hdfs.server.common.Upgradeable -->
  8659. <!-- start class org.apache.hadoop.hdfs.server.common.UpgradeManager -->
  8660. <class name="UpgradeManager" extends="java.lang.Object"
  8661. abstract="true"
  8662. static="false" final="false" visibility="public"
  8663. deprecated="not deprecated">
  8664. <constructor name="UpgradeManager"
  8665. static="false" final="false" visibility="public"
  8666. deprecated="not deprecated">
  8667. </constructor>
  8668. <method name="getBroadcastCommand" return="org.apache.hadoop.hdfs.server.protocol.UpgradeCommand"
  8669. abstract="false" native="false" synchronized="true"
  8670. static="false" final="false" visibility="public"
  8671. deprecated="not deprecated">
  8672. </method>
  8673. <method name="getUpgradeState" return="boolean"
  8674. abstract="false" native="false" synchronized="true"
  8675. static="false" final="false" visibility="public"
  8676. deprecated="not deprecated">
  8677. </method>
  8678. <method name="getUpgradeVersion" return="int"
  8679. abstract="false" native="false" synchronized="true"
  8680. static="false" final="false" visibility="public"
  8681. deprecated="not deprecated">
  8682. </method>
  8683. <method name="setUpgradeState"
  8684. abstract="false" native="false" synchronized="true"
  8685. static="false" final="false" visibility="public"
  8686. deprecated="not deprecated">
  8687. <param name="uState" type="boolean"/>
  8688. <param name="uVersion" type="int"/>
  8689. </method>
  8690. <method name="getDistributedUpgrades" return="java.util.SortedSet"
  8691. abstract="false" native="false" synchronized="false"
  8692. static="false" final="false" visibility="public"
  8693. deprecated="not deprecated">
  8694. <exception name="IOException" type="java.io.IOException"/>
  8695. </method>
  8696. <method name="getUpgradeStatus" return="short"
  8697. abstract="false" native="false" synchronized="true"
  8698. static="false" final="false" visibility="public"
  8699. deprecated="not deprecated">
  8700. </method>
  8701. <method name="initializeUpgrade" return="boolean"
  8702. abstract="false" native="false" synchronized="true"
  8703. static="false" final="false" visibility="public"
  8704. deprecated="not deprecated">
  8705. <exception name="IOException" type="java.io.IOException"/>
  8706. </method>
  8707. <method name="isUpgradeCompleted" return="boolean"
  8708. abstract="false" native="false" synchronized="true"
  8709. static="false" final="false" visibility="public"
  8710. deprecated="not deprecated">
  8711. </method>
  8712. <method name="getType" return="org.apache.hadoop.hdfs.server.common.HdfsConstants.NodeType"
  8713. abstract="true" native="false" synchronized="false"
  8714. static="false" final="false" visibility="public"
  8715. deprecated="not deprecated">
  8716. </method>
  8717. <method name="startUpgrade" return="boolean"
  8718. abstract="true" native="false" synchronized="false"
  8719. static="false" final="false" visibility="public"
  8720. deprecated="not deprecated">
  8721. <exception name="IOException" type="java.io.IOException"/>
  8722. </method>
  8723. <method name="completeUpgrade"
  8724. abstract="true" native="false" synchronized="false"
  8725. static="false" final="false" visibility="public"
  8726. deprecated="not deprecated">
  8727. <exception name="IOException" type="java.io.IOException"/>
  8728. </method>
  8729. <field name="currentUpgrades" type="java.util.SortedSet"
  8730. transient="false" volatile="false"
  8731. static="false" final="false" visibility="protected"
  8732. deprecated="not deprecated">
  8733. </field>
  8734. <field name="upgradeState" type="boolean"
  8735. transient="false" volatile="false"
  8736. static="false" final="false" visibility="protected"
  8737. deprecated="not deprecated">
  8738. </field>
  8739. <field name="upgradeVersion" type="int"
  8740. transient="false" volatile="false"
  8741. static="false" final="false" visibility="protected"
  8742. deprecated="not deprecated">
  8743. </field>
  8744. <field name="broadcastCommand" type="org.apache.hadoop.hdfs.server.protocol.UpgradeCommand"
  8745. transient="false" volatile="false"
  8746. static="false" final="false" visibility="protected"
  8747. deprecated="not deprecated">
  8748. </field>
  8749. <doc>
  8750. <![CDATA[Generic upgrade manager.
  8751. {@link #broadcastCommand} is the command that should be]]>
  8752. </doc>
  8753. </class>
  8754. <!-- end class org.apache.hadoop.hdfs.server.common.UpgradeManager -->
  8755. <!-- start class org.apache.hadoop.hdfs.server.common.UpgradeObject -->
  8756. <class name="UpgradeObject" extends="java.lang.Object"
  8757. abstract="true"
  8758. static="false" final="false" visibility="public"
  8759. deprecated="not deprecated">
  8760. <implements name="org.apache.hadoop.hdfs.server.common.Upgradeable"/>
  8761. <constructor name="UpgradeObject"
  8762. static="false" final="false" visibility="public"
  8763. deprecated="not deprecated">
  8764. </constructor>
  8765. <method name="getUpgradeStatus" return="short"
  8766. abstract="false" native="false" synchronized="false"
  8767. static="false" final="false" visibility="public"
  8768. deprecated="not deprecated">
  8769. </method>
  8770. <method name="getDescription" return="java.lang.String"
  8771. abstract="false" native="false" synchronized="false"
  8772. static="false" final="false" visibility="public"
  8773. deprecated="not deprecated">
  8774. </method>
  8775. <method name="getUpgradeStatusReport" return="org.apache.hadoop.hdfs.server.common.UpgradeStatusReport"
  8776. abstract="false" native="false" synchronized="false"
  8777. static="false" final="false" visibility="public"
  8778. deprecated="not deprecated">
  8779. <param name="details" type="boolean"/>
  8780. <exception name="IOException" type="java.io.IOException"/>
  8781. </method>
  8782. <method name="compareTo" return="int"
  8783. abstract="false" native="false" synchronized="false"
  8784. static="false" final="false" visibility="public"
  8785. deprecated="not deprecated">
  8786. <param name="o" type="org.apache.hadoop.hdfs.server.common.Upgradeable"/>
  8787. </method>
  8788. <method name="equals" return="boolean"
  8789. abstract="false" native="false" synchronized="false"
  8790. static="false" final="false" visibility="public"
  8791. deprecated="not deprecated">
  8792. <param name="o" type="java.lang.Object"/>
  8793. </method>
  8794. <method name="hashCode" return="int"
  8795. abstract="false" native="false" synchronized="false"
  8796. static="false" final="false" visibility="public"
  8797. deprecated="not deprecated">
  8798. </method>
  8799. <field name="status" type="short"
  8800. transient="false" volatile="false"
  8801. static="false" final="false" visibility="protected"
  8802. deprecated="not deprecated">
  8803. </field>
  8804. <doc>
  8805. <![CDATA[Abstract upgrade object.
  8806. Contains default implementation of common methods of {@link Upgradeable}
  8807. interface.]]>
  8808. </doc>
  8809. </class>
  8810. <!-- end class org.apache.hadoop.hdfs.server.common.UpgradeObject -->
  8811. <!-- start class org.apache.hadoop.hdfs.server.common.UpgradeObjectCollection -->
  8812. <class name="UpgradeObjectCollection" extends="java.lang.Object"
  8813. abstract="false"
  8814. static="false" final="false" visibility="public"
  8815. deprecated="not deprecated">
  8816. <constructor name="UpgradeObjectCollection"
  8817. static="false" final="false" visibility="public"
  8818. deprecated="not deprecated">
  8819. </constructor>
  8820. <method name="getDistributedUpgrades" return="java.util.SortedSet"
  8821. abstract="false" native="false" synchronized="false"
  8822. static="true" final="false" visibility="public"
  8823. deprecated="not deprecated">
  8824. <param name="versionFrom" type="int"/>
  8825. <param name="type" type="org.apache.hadoop.hdfs.server.common.HdfsConstants.NodeType"/>
  8826. <exception name="IOException" type="java.io.IOException"/>
  8827. </method>
  8828. <doc>
  8829. <![CDATA[Collection of upgrade objects.
  8830. Upgrade objects should be registered here before they can be used.]]>
  8831. </doc>
  8832. </class>
  8833. <!-- end class org.apache.hadoop.hdfs.server.common.UpgradeObjectCollection -->
  8834. <!-- start class org.apache.hadoop.hdfs.server.common.UpgradeStatusReport -->
  8835. <class name="UpgradeStatusReport" extends="java.lang.Object"
  8836. abstract="false"
  8837. static="false" final="false" visibility="public"
  8838. deprecated="not deprecated">
  8839. <implements name="org.apache.hadoop.io.Writable"/>
  8840. <constructor name="UpgradeStatusReport"
  8841. static="false" final="false" visibility="public"
  8842. deprecated="not deprecated">
  8843. </constructor>
  8844. <constructor name="UpgradeStatusReport" type="int, short, boolean"
  8845. static="false" final="false" visibility="public"
  8846. deprecated="not deprecated">
  8847. </constructor>
  8848. <method name="getVersion" return="int"
  8849. abstract="false" native="false" synchronized="false"
  8850. static="false" final="false" visibility="public"
  8851. deprecated="not deprecated">
  8852. <doc>
  8853. <![CDATA[Get the layout version of the currently running upgrade.
  8854. @return layout version]]>
  8855. </doc>
  8856. </method>
  8857. <method name="getUpgradeStatus" return="short"
  8858. abstract="false" native="false" synchronized="false"
  8859. static="false" final="false" visibility="public"
  8860. deprecated="not deprecated">
  8861. <doc>
  8862. <![CDATA[Get upgrade upgradeStatus as a percentage of the total upgrade done.
  8863. @see Upgradeable#getUpgradeStatus()]]>
  8864. </doc>
  8865. </method>
  8866. <method name="isFinalized" return="boolean"
  8867. abstract="false" native="false" synchronized="false"
  8868. static="false" final="false" visibility="public"
  8869. deprecated="not deprecated">
  8870. <doc>
  8871. <![CDATA[Is current upgrade finalized.
  8872. @return true if finalized or false otherwise.]]>
  8873. </doc>
  8874. </method>
  8875. <method name="getStatusText" return="java.lang.String"
  8876. abstract="false" native="false" synchronized="false"
  8877. static="false" final="false" visibility="public"
  8878. deprecated="not deprecated">
  8879. <param name="details" type="boolean"/>
  8880. <doc>
  8881. <![CDATA[Get upgradeStatus data as a text for reporting.
  8882. Should be overloaded for a particular upgrade specific upgradeStatus data.
  8883. @param details true if upgradeStatus details need to be included,
  8884. false otherwise
  8885. @return text]]>
  8886. </doc>
  8887. </method>
  8888. <method name="toString" return="java.lang.String"
  8889. abstract="false" native="false" synchronized="false"
  8890. static="false" final="false" visibility="public"
  8891. deprecated="not deprecated">
  8892. <doc>
  8893. <![CDATA[Print basic upgradeStatus details.]]>
  8894. </doc>
  8895. </method>
  8896. <method name="write"
  8897. abstract="false" native="false" synchronized="false"
  8898. static="false" final="false" visibility="public"
  8899. deprecated="not deprecated">
  8900. <param name="out" type="java.io.DataOutput"/>
  8901. <exception name="IOException" type="java.io.IOException"/>
  8902. </method>
  8903. <method name="readFields"
  8904. abstract="false" native="false" synchronized="false"
  8905. static="false" final="false" visibility="public"
  8906. deprecated="not deprecated">
  8907. <param name="in" type="java.io.DataInput"/>
  8908. <exception name="IOException" type="java.io.IOException"/>
  8909. </method>
  8910. <field name="version" type="int"
  8911. transient="false" volatile="false"
  8912. static="false" final="false" visibility="protected"
  8913. deprecated="not deprecated">
  8914. </field>
  8915. <field name="upgradeStatus" type="short"
  8916. transient="false" volatile="false"
  8917. static="false" final="false" visibility="protected"
  8918. deprecated="not deprecated">
  8919. </field>
  8920. <field name="finalized" type="boolean"
  8921. transient="false" volatile="false"
  8922. static="false" final="false" visibility="protected"
  8923. deprecated="not deprecated">
  8924. </field>
  8925. <doc>
  8926. <![CDATA[Base upgrade upgradeStatus class.
  8927. Overload this class if specific status fields need to be reported.
  8928. Describes status of current upgrade.]]>
  8929. </doc>
  8930. </class>
  8931. <!-- end class org.apache.hadoop.hdfs.server.common.UpgradeStatusReport -->
  8932. <!-- start class org.apache.hadoop.hdfs.server.common.Util -->
  8933. <class name="Util" extends="java.lang.Object"
  8934. abstract="false"
  8935. static="false" final="true" visibility="public"
  8936. deprecated="not deprecated">
  8937. <constructor name="Util"
  8938. static="false" final="false" visibility="public"
  8939. deprecated="not deprecated">
  8940. </constructor>
  8941. <method name="now" return="long"
  8942. abstract="false" native="false" synchronized="false"
  8943. static="true" final="false" visibility="public"
  8944. deprecated="not deprecated">
  8945. <doc>
  8946. <![CDATA[Current system time.
  8947. @return current time in msec.]]>
  8948. </doc>
  8949. </method>
  8950. <method name="stringAsURI" return="java.net.URI"
  8951. abstract="false" native="false" synchronized="false"
  8952. static="true" final="false" visibility="public"
  8953. deprecated="not deprecated">
  8954. <param name="s" type="java.lang.String"/>
  8955. <exception name="IOException" type="java.io.IOException"/>
  8956. <doc>
  8957. <![CDATA[Interprets the passed string as a URI. In case of error it
  8958. assumes the specified string is a file.
  8959. @param s the string to interpret
  8960. @return the resulting URI
  8961. @throws IOException]]>
  8962. </doc>
  8963. </method>
  8964. <method name="fileAsURI" return="java.net.URI"
  8965. abstract="false" native="false" synchronized="false"
  8966. static="true" final="false" visibility="public"
  8967. deprecated="not deprecated">
  8968. <param name="f" type="java.io.File"/>
  8969. <exception name="IOException" type="java.io.IOException"/>
  8970. <doc>
  8971. <![CDATA[Converts the passed File to a URI.
  8972. @param f the file to convert
  8973. @return the resulting URI
  8974. @throws IOException]]>
  8975. </doc>
  8976. </method>
  8977. <method name="stringCollectionAsURIs" return="java.util.Collection"
  8978. abstract="false" native="false" synchronized="false"
  8979. static="true" final="false" visibility="public"
  8980. deprecated="not deprecated">
  8981. <param name="names" type="java.util.Collection"/>
  8982. <doc>
  8983. <![CDATA[Converts a collection of strings into a collection of URIs.
  8984. @param names collection of strings to convert to URIs
  8985. @return collection of URIs]]>
  8986. </doc>
  8987. </method>
  8988. </class>
  8989. <!-- end class org.apache.hadoop.hdfs.server.common.Util -->
  8990. </package>
  8991. <package name="org.apache.hadoop.hdfs.server.datanode">
  8992. <!-- start class org.apache.hadoop.hdfs.server.datanode.DataNode -->
  8993. <class name="DataNode" extends="org.apache.hadoop.conf.Configured"
  8994. abstract="false"
  8995. static="false" final="false" visibility="public"
  8996. deprecated="not deprecated">
  8997. <implements name="org.apache.hadoop.hdfs.server.protocol.InterDatanodeProtocol"/>
  8998. <implements name="org.apache.hadoop.hdfs.protocol.ClientDatanodeProtocol"/>
  8999. <implements name="org.apache.hadoop.hdfs.protocol.FSConstants"/>
  9000. <implements name="java.lang.Runnable"/>
  9001. <method name="createSocketAddr" return="java.net.InetSocketAddress"
  9002. abstract="false" native="false" synchronized="false"
  9003. static="true" final="false" visibility="public"
  9004. deprecated="not deprecated">
  9005. <param name="target" type="java.lang.String"/>
  9006. <exception name="IOException" type="java.io.IOException"/>
  9007. <doc>
  9008. <![CDATA[Use {@link NetUtils#createSocketAddr(String)} instead.]]>
  9009. </doc>
  9010. </method>
  9011. <method name="newSocket" return="java.net.Socket"
  9012. abstract="false" native="false" synchronized="false"
  9013. static="false" final="false" visibility="protected"
  9014. deprecated="not deprecated">
  9015. <exception name="IOException" type="java.io.IOException"/>
  9016. <doc>
  9017. <![CDATA[Creates either NIO or regular depending on socketWriteTimeout.]]>
  9018. </doc>
  9019. </method>
  9020. <method name="getDataNode" return="org.apache.hadoop.hdfs.server.datanode.DataNode"
  9021. abstract="false" native="false" synchronized="false"
  9022. static="true" final="false" visibility="public"
  9023. deprecated="not deprecated">
  9024. <doc>
  9025. <![CDATA[Return the DataNode object]]>
  9026. </doc>
  9027. </method>
  9028. <method name="createInterDataNodeProtocolProxy" return="org.apache.hadoop.hdfs.server.protocol.InterDatanodeProtocol"
  9029. abstract="false" native="false" synchronized="false"
  9030. static="true" final="false" visibility="public"
  9031. deprecated="not deprecated">
  9032. <param name="datanodeid" type="org.apache.hadoop.hdfs.protocol.DatanodeID"/>
  9033. <param name="conf" type="org.apache.hadoop.conf.Configuration"/>
  9034. <exception name="IOException" type="java.io.IOException"/>
  9035. </method>
  9036. <method name="getNameNodeAddr" return="java.net.InetSocketAddress"
  9037. abstract="false" native="false" synchronized="false"
  9038. static="false" final="false" visibility="public"
  9039. deprecated="not deprecated">
  9040. </method>
  9041. <method name="getSelfAddr" return="java.net.InetSocketAddress"
  9042. abstract="false" native="false" synchronized="false"
  9043. static="false" final="false" visibility="public"
  9044. deprecated="not deprecated">
  9045. </method>
  9046. <method name="getDatanodeRegistration" return="org.apache.hadoop.hdfs.server.protocol.DatanodeRegistration"
  9047. abstract="false" native="false" synchronized="false"
  9048. static="false" final="false" visibility="public"
  9049. deprecated="not deprecated">
  9050. <doc>
  9051. <![CDATA[Return DatanodeRegistration]]>
  9052. </doc>
  9053. </method>
  9054. <method name="getNamenode" return="java.lang.String"
  9055. abstract="false" native="false" synchronized="false"
  9056. static="false" final="false" visibility="public"
  9057. deprecated="not deprecated">
  9058. <doc>
  9059. <![CDATA[Return the namenode's identifier]]>
  9060. </doc>
  9061. </method>
  9062. <method name="setNewStorageID"
  9063. abstract="false" native="false" synchronized="false"
  9064. static="true" final="false" visibility="public"
  9065. deprecated="not deprecated">
  9066. <param name="dnReg" type="org.apache.hadoop.hdfs.server.protocol.DatanodeRegistration"/>
  9067. </method>
  9068. <method name="shutdown"
  9069. abstract="false" native="false" synchronized="false"
  9070. static="false" final="false" visibility="public"
  9071. deprecated="not deprecated">
  9072. <doc>
  9073. <![CDATA[Shut down this instance of the datanode.
  9074. Returns only after shutdown is complete.
  9075. This method can only be called by the offerService thread.
  9076. Otherwise, deadlock might occur.]]>
  9077. </doc>
  9078. </method>
  9079. <method name="checkDiskError"
  9080. abstract="false" native="false" synchronized="false"
  9081. static="false" final="false" visibility="protected"
  9082. deprecated="not deprecated">
  9083. <param name="e" type="java.lang.Exception"/>
  9084. <exception name="IOException" type="java.io.IOException"/>
  9085. <doc>
  9086. <![CDATA[Check if there is no space in disk
  9087. @param e that caused this checkDiskError call]]>
  9088. </doc>
  9089. </method>
  9090. <method name="checkDiskError"
  9091. abstract="false" native="false" synchronized="false"
  9092. static="false" final="false" visibility="protected"
  9093. deprecated="not deprecated">
  9094. <doc>
  9095. <![CDATA[Check if there is a disk failure and if so, handle the error]]>
  9096. </doc>
  9097. </method>
  9098. <method name="offerService"
  9099. abstract="false" native="false" synchronized="false"
  9100. static="false" final="false" visibility="public"
  9101. deprecated="not deprecated">
  9102. <exception name="Exception" type="java.lang.Exception"/>
  9103. <doc>
  9104. <![CDATA[Main loop for the DataNode. Runs until shutdown,
  9105. forever calling remote NameNode functions.]]>
  9106. </doc>
  9107. </method>
  9108. <method name="notifyNamenodeReceivedBlock"
  9109. abstract="false" native="false" synchronized="false"
  9110. static="false" final="false" visibility="protected"
  9111. deprecated="not deprecated">
  9112. <param name="block" type="org.apache.hadoop.hdfs.protocol.Block"/>
  9113. <param name="delHint" type="java.lang.String"/>
  9114. </method>
  9115. <method name="run"
  9116. abstract="false" native="false" synchronized="false"
  9117. static="false" final="false" visibility="public"
  9118. deprecated="not deprecated">
  9119. <doc>
  9120. <![CDATA[No matter what kind of exception we get, keep retrying to offerService().
  9121. That's the loop that connects to the NameNode and provides basic DataNode
  9122. functionality.
  9123. Only stop when "shouldRun" is turned off (which can only happen at shutdown).]]>
  9124. </doc>
  9125. </method>
  9126. <method name="runDatanodeDaemon"
  9127. abstract="false" native="false" synchronized="false"
  9128. static="true" final="false" visibility="public"
  9129. deprecated="not deprecated">
  9130. <param name="dn" type="org.apache.hadoop.hdfs.server.datanode.DataNode"/>
  9131. <exception name="IOException" type="java.io.IOException"/>
  9132. <doc>
  9133. <![CDATA[Start a single datanode daemon and wait for it to finish.
  9134. If this thread is specifically interrupted, it will stop waiting.]]>
  9135. </doc>
  9136. </method>
  9137. <method name="instantiateDataNode" return="org.apache.hadoop.hdfs.server.datanode.DataNode"
  9138. abstract="false" native="false" synchronized="false"
  9139. static="true" final="false" visibility="public"
  9140. deprecated="not deprecated">
  9141. <param name="args" type="java.lang.String[]"/>
  9142. <param name="conf" type="org.apache.hadoop.conf.Configuration"/>
  9143. <exception name="IOException" type="java.io.IOException"/>
  9144. <doc>
  9145. <![CDATA[Instantiate a single datanode object. This must be run by invoking
  9146. {@link DataNode#runDatanodeDaemon(DataNode)} subsequently.]]>
  9147. </doc>
  9148. </method>
  9149. <method name="createDataNode" return="org.apache.hadoop.hdfs.server.datanode.DataNode"
  9150. abstract="false" native="false" synchronized="false"
  9151. static="true" final="false" visibility="public"
  9152. deprecated="not deprecated">
  9153. <param name="args" type="java.lang.String[]"/>
  9154. <param name="conf" type="org.apache.hadoop.conf.Configuration"/>
  9155. <exception name="IOException" type="java.io.IOException"/>
  9156. <doc>
  9157. <![CDATA[Instantiate & Start a single datanode daemon and wait for it to finish.
  9158. If this thread is specifically interrupted, it will stop waiting.]]>
  9159. </doc>
  9160. </method>
  9161. <method name="toString" return="java.lang.String"
  9162. abstract="false" native="false" synchronized="false"
  9163. static="false" final="false" visibility="public"
  9164. deprecated="not deprecated">
  9165. </method>
  9166. <method name="scheduleBlockReport"
  9167. abstract="false" native="false" synchronized="false"
  9168. static="false" final="false" visibility="public"
  9169. deprecated="not deprecated">
  9170. <param name="delay" type="long"/>
  9171. <doc>
  9172. <![CDATA[This methods arranges for the data node to send the block report at the next heartbeat.]]>
  9173. </doc>
  9174. </method>
  9175. <method name="getFSDataset" return="org.apache.hadoop.hdfs.server.datanode.FSDatasetInterface"
  9176. abstract="false" native="false" synchronized="false"
  9177. static="false" final="false" visibility="public"
  9178. deprecated="not deprecated">
  9179. <doc>
  9180. <![CDATA[This method is used for testing.
  9181. Examples are adding and deleting blocks directly.
  9182. The most common usage will be when the data node's storage is similated.
  9183. @return the fsdataset that stores the blocks]]>
  9184. </doc>
  9185. </method>
  9186. <method name="main"
  9187. abstract="false" native="false" synchronized="false"
  9188. static="true" final="false" visibility="public"
  9189. deprecated="not deprecated">
  9190. <param name="args" type="java.lang.String[]"/>
  9191. </method>
  9192. <method name="recoverBlocks" return="org.apache.hadoop.util.Daemon"
  9193. abstract="false" native="false" synchronized="false"
  9194. static="false" final="false" visibility="public"
  9195. deprecated="not deprecated">
  9196. <param name="blocks" type="java.util.Collection"/>
  9197. </method>
  9198. <method name="initReplicaRecovery" return="org.apache.hadoop.hdfs.server.protocol.ReplicaRecoveryInfo"
  9199. abstract="false" native="false" synchronized="false"
  9200. static="false" final="false" visibility="public"
  9201. deprecated="not deprecated">
  9202. <param name="rBlock" type="org.apache.hadoop.hdfs.server.protocol.BlockRecoveryCommand.RecoveringBlock"/>
  9203. <exception name="IOException" type="java.io.IOException"/>
  9204. </method>
  9205. <method name="updateReplicaUnderRecovery" return="org.apache.hadoop.hdfs.protocol.Block"
  9206. abstract="false" native="false" synchronized="false"
  9207. static="false" final="false" visibility="public"
  9208. deprecated="not deprecated">
  9209. <param name="oldBlock" type="org.apache.hadoop.hdfs.protocol.Block"/>
  9210. <param name="recoveryId" type="long"/>
  9211. <param name="newLength" type="long"/>
  9212. <exception name="IOException" type="java.io.IOException"/>
  9213. <doc>
  9214. <![CDATA[Update replica with the new generation stamp and length.]]>
  9215. </doc>
  9216. </method>
  9217. <method name="getProtocolVersion" return="long"
  9218. abstract="false" native="false" synchronized="false"
  9219. static="false" final="false" visibility="public"
  9220. deprecated="not deprecated">
  9221. <param name="protocol" type="java.lang.String"/>
  9222. <param name="clientVersion" type="long"/>
  9223. <exception name="IOException" type="java.io.IOException"/>
  9224. <doc>
  9225. <![CDATA[{@inheritDoc}]]>
  9226. </doc>
  9227. </method>
  9228. <method name="getReplicaVisibleLength" return="long"
  9229. abstract="false" native="false" synchronized="false"
  9230. static="false" final="false" visibility="public"
  9231. deprecated="not deprecated">
  9232. <param name="block" type="org.apache.hadoop.hdfs.protocol.Block"/>
  9233. <exception name="IOException" type="java.io.IOException"/>
  9234. <doc>
  9235. <![CDATA[{@inheritDoc}]]>
  9236. </doc>
  9237. </method>
  9238. <field name="LOG" type="org.apache.commons.logging.Log"
  9239. transient="false" volatile="false"
  9240. static="true" final="true" visibility="public"
  9241. deprecated="not deprecated">
  9242. </field>
  9243. <field name="DN_CLIENTTRACE_FORMAT" type="java.lang.String"
  9244. transient="false" volatile="false"
  9245. static="true" final="true" visibility="public"
  9246. deprecated="not deprecated">
  9247. </field>
  9248. <field name="namenode" type="org.apache.hadoop.hdfs.server.protocol.DatanodeProtocol"
  9249. transient="false" volatile="false"
  9250. static="false" final="false" visibility="public"
  9251. deprecated="not deprecated">
  9252. </field>
  9253. <field name="data" type="org.apache.hadoop.hdfs.server.datanode.FSDatasetInterface"
  9254. transient="false" volatile="false"
  9255. static="false" final="false" visibility="public"
  9256. deprecated="not deprecated">
  9257. </field>
  9258. <field name="dnRegistration" type="org.apache.hadoop.hdfs.server.protocol.DatanodeRegistration"
  9259. transient="false" volatile="false"
  9260. static="false" final="false" visibility="public"
  9261. deprecated="not deprecated">
  9262. </field>
  9263. <field name="EMPTY_DEL_HINT" type="java.lang.String"
  9264. transient="false" volatile="false"
  9265. static="true" final="true" visibility="public"
  9266. deprecated="not deprecated">
  9267. </field>
  9268. <field name="blockScanner" type="org.apache.hadoop.hdfs.server.datanode.DataBlockScanner"
  9269. transient="false" volatile="false"
  9270. static="false" final="false" visibility="public"
  9271. deprecated="not deprecated">
  9272. </field>
  9273. <field name="blockScannerThread" type="org.apache.hadoop.util.Daemon"
  9274. transient="false" volatile="false"
  9275. static="false" final="false" visibility="public"
  9276. deprecated="not deprecated">
  9277. </field>
  9278. <field name="ipcServer" type="org.apache.hadoop.ipc.Server"
  9279. transient="false" volatile="false"
  9280. static="false" final="false" visibility="public"
  9281. deprecated="not deprecated">
  9282. </field>
  9283. <field name="PKT_HEADER_LEN" type="int"
  9284. transient="false" volatile="false"
  9285. static="true" final="true" visibility="public"
  9286. deprecated="not deprecated">
  9287. <doc>
  9288. <![CDATA[Header size for a packet]]>
  9289. </doc>
  9290. </field>
  9291. <doc>
  9292. <![CDATA[DataNode is a class (and program) that stores a set of
  9293. blocks for a DFS deployment. A single deployment can
  9294. have one or many DataNodes. Each DataNode communicates
  9295. regularly with a single NameNode. It also communicates
  9296. with client code and other DataNodes from time to time.
  9297. DataNodes store a series of named blocks. The DataNode
  9298. allows client code to read these blocks, or to write new
  9299. block data. The DataNode may also, in response to instructions
  9300. from its NameNode, delete blocks or copy blocks to/from other
  9301. DataNodes.
  9302. The DataNode maintains just one critical table:
  9303. block-> stream of bytes (of BLOCK_SIZE or less)
  9304. This info is stored on a local disk. The DataNode
  9305. reports the table's contents to the NameNode upon startup
  9306. and every so often afterwards.
  9307. DataNodes spend their lives in an endless loop of asking
  9308. the NameNode for something to do. A NameNode cannot connect
  9309. to a DataNode directly; a NameNode simply returns values from
  9310. functions invoked by a DataNode.
  9311. DataNodes maintain an open server socket so that client code
  9312. or other DataNodes can read/write data. The host/port for
  9313. this server is reported to the NameNode, which then sends that
  9314. information to clients or other DataNodes that might be interested.]]>
  9315. </doc>
  9316. </class>
  9317. <!-- end class org.apache.hadoop.hdfs.server.datanode.DataNode -->
  9318. <!-- start class org.apache.hadoop.hdfs.server.datanode.DatanodeJspHelper -->
  9319. <class name="DatanodeJspHelper" extends="java.lang.Object"
  9320. abstract="false"
  9321. static="false" final="false" visibility="public"
  9322. deprecated="not deprecated">
  9323. <constructor name="DatanodeJspHelper"
  9324. static="false" final="false" visibility="public"
  9325. deprecated="not deprecated">
  9326. </constructor>
  9327. </class>
  9328. <!-- end class org.apache.hadoop.hdfs.server.datanode.DatanodeJspHelper -->
  9329. <!-- start class org.apache.hadoop.hdfs.server.datanode.DataStorage -->
  9330. <class name="DataStorage" extends="org.apache.hadoop.hdfs.server.common.Storage"
  9331. abstract="false"
  9332. static="false" final="false" visibility="public"
  9333. deprecated="not deprecated">
  9334. <constructor name="DataStorage" type="org.apache.hadoop.hdfs.server.common.StorageInfo, java.lang.String"
  9335. static="false" final="false" visibility="public"
  9336. deprecated="not deprecated">
  9337. </constructor>
  9338. <method name="getStorageID" return="java.lang.String"
  9339. abstract="false" native="false" synchronized="false"
  9340. static="false" final="false" visibility="public"
  9341. deprecated="not deprecated">
  9342. </method>
  9343. <method name="setFields"
  9344. abstract="false" native="false" synchronized="false"
  9345. static="false" final="false" visibility="protected"
  9346. deprecated="not deprecated">
  9347. <param name="props" type="java.util.Properties"/>
  9348. <param name="sd" type="org.apache.hadoop.hdfs.server.common.Storage.StorageDirectory"/>
  9349. <exception name="IOException" type="java.io.IOException"/>
  9350. </method>
  9351. <method name="getFields"
  9352. abstract="false" native="false" synchronized="false"
  9353. static="false" final="false" visibility="protected"
  9354. deprecated="not deprecated">
  9355. <param name="props" type="java.util.Properties"/>
  9356. <param name="sd" type="org.apache.hadoop.hdfs.server.common.Storage.StorageDirectory"/>
  9357. <exception name="IOException" type="java.io.IOException"/>
  9358. </method>
  9359. <method name="isConversionNeeded" return="boolean"
  9360. abstract="false" native="false" synchronized="false"
  9361. static="false" final="false" visibility="public"
  9362. deprecated="not deprecated">
  9363. <param name="sd" type="org.apache.hadoop.hdfs.server.common.Storage.StorageDirectory"/>
  9364. <exception name="IOException" type="java.io.IOException"/>
  9365. </method>
  9366. <method name="corruptPreUpgradeStorage"
  9367. abstract="false" native="false" synchronized="false"
  9368. static="false" final="false" visibility="protected"
  9369. deprecated="not deprecated">
  9370. <param name="rootDir" type="java.io.File"/>
  9371. <exception name="IOException" type="java.io.IOException"/>
  9372. </method>
  9373. <doc>
  9374. <![CDATA[Data storage information file.
  9375. <p>
  9376. @see Storage]]>
  9377. </doc>
  9378. </class>
  9379. <!-- end class org.apache.hadoop.hdfs.server.datanode.DataStorage -->
  9380. <!-- start class org.apache.hadoop.hdfs.server.datanode.DirectoryScanner -->
  9381. <class name="DirectoryScanner" extends="java.lang.Object"
  9382. abstract="false"
  9383. static="false" final="false" visibility="public"
  9384. deprecated="not deprecated">
  9385. <doc>
  9386. <![CDATA[Periodically scans the data directories for block and block metadata files.
  9387. Reconciles the differences with block information maintained in
  9388. {@link FSDataset}]]>
  9389. </doc>
  9390. </class>
  9391. <!-- end class org.apache.hadoop.hdfs.server.datanode.DirectoryScanner -->
  9392. <!-- start class org.apache.hadoop.hdfs.server.datanode.FSDataset -->
  9393. <class name="FSDataset" extends="java.lang.Object"
  9394. abstract="false"
  9395. static="false" final="false" visibility="public"
  9396. deprecated="not deprecated">
  9397. <implements name="org.apache.hadoop.hdfs.protocol.FSConstants"/>
  9398. <implements name="org.apache.hadoop.hdfs.server.datanode.FSDatasetInterface"/>
  9399. <constructor name="FSDataset" type="org.apache.hadoop.hdfs.server.datanode.DataStorage, org.apache.hadoop.conf.Configuration"
  9400. static="false" final="false" visibility="public"
  9401. deprecated="not deprecated">
  9402. <exception name="IOException" type="java.io.IOException"/>
  9403. <doc>
  9404. <![CDATA[An FSDataset has a directory where it loads its data files.]]>
  9405. </doc>
  9406. </constructor>
  9407. <method name="getMetaFile" return="java.io.File"
  9408. abstract="false" native="false" synchronized="false"
  9409. static="false" final="false" visibility="protected"
  9410. deprecated="not deprecated">
  9411. <param name="b" type="org.apache.hadoop.hdfs.protocol.Block"/>
  9412. <exception name="IOException" type="java.io.IOException"/>
  9413. </method>
  9414. <method name="findBlockFile" return="java.io.File"
  9415. abstract="false" native="false" synchronized="false"
  9416. static="false" final="false" visibility="public"
  9417. deprecated="not deprecated">
  9418. <param name="blockId" type="long"/>
  9419. <doc>
  9420. <![CDATA[Return the block file for the given ID]]>
  9421. </doc>
  9422. </method>
  9423. <method name="getStoredBlock" return="org.apache.hadoop.hdfs.protocol.Block"
  9424. abstract="false" native="false" synchronized="true"
  9425. static="false" final="false" visibility="public"
  9426. deprecated="not deprecated">
  9427. <param name="blkid" type="long"/>
  9428. <exception name="IOException" type="java.io.IOException"/>
  9429. <doc>
  9430. <![CDATA[{@inheritDoc}]]>
  9431. </doc>
  9432. </method>
  9433. <method name="metaFileExists" return="boolean"
  9434. abstract="false" native="false" synchronized="false"
  9435. static="false" final="false" visibility="public"
  9436. deprecated="not deprecated">
  9437. <param name="b" type="org.apache.hadoop.hdfs.protocol.Block"/>
  9438. <exception name="IOException" type="java.io.IOException"/>
  9439. </method>
  9440. <method name="getMetaDataLength" return="long"
  9441. abstract="false" native="false" synchronized="false"
  9442. static="false" final="false" visibility="public"
  9443. deprecated="not deprecated">
  9444. <param name="b" type="org.apache.hadoop.hdfs.protocol.Block"/>
  9445. <exception name="IOException" type="java.io.IOException"/>
  9446. </method>
  9447. <method name="getMetaDataInputStream" return="org.apache.hadoop.hdfs.server.datanode.FSDatasetInterface.MetaDataInputStream"
  9448. abstract="false" native="false" synchronized="false"
  9449. static="false" final="false" visibility="public"
  9450. deprecated="not deprecated">
  9451. <param name="b" type="org.apache.hadoop.hdfs.protocol.Block"/>
  9452. <exception name="IOException" type="java.io.IOException"/>
  9453. </method>
  9454. <method name="getDfsUsed" return="long"
  9455. abstract="false" native="false" synchronized="false"
  9456. static="false" final="false" visibility="public"
  9457. deprecated="not deprecated">
  9458. <exception name="IOException" type="java.io.IOException"/>
  9459. <doc>
  9460. <![CDATA[Return the total space used by dfs datanode]]>
  9461. </doc>
  9462. </method>
  9463. <method name="hasEnoughResource" return="boolean"
  9464. abstract="false" native="false" synchronized="false"
  9465. static="false" final="false" visibility="public"
  9466. deprecated="not deprecated">
  9467. <doc>
  9468. <![CDATA[Return true - if there are still valid volumes on the DataNode.]]>
  9469. </doc>
  9470. </method>
  9471. <method name="getCapacity" return="long"
  9472. abstract="false" native="false" synchronized="false"
  9473. static="false" final="false" visibility="public"
  9474. deprecated="not deprecated">
  9475. <exception name="IOException" type="java.io.IOException"/>
  9476. <doc>
  9477. <![CDATA[Return total capacity, used and unused]]>
  9478. </doc>
  9479. </method>
  9480. <method name="getRemaining" return="long"
  9481. abstract="false" native="false" synchronized="false"
  9482. static="false" final="false" visibility="public"
  9483. deprecated="not deprecated">
  9484. <exception name="IOException" type="java.io.IOException"/>
  9485. <doc>
  9486. <![CDATA[Return how many bytes can still be stored in the FSDataset]]>
  9487. </doc>
  9488. </method>
  9489. <method name="getLength" return="long"
  9490. abstract="false" native="false" synchronized="false"
  9491. static="false" final="false" visibility="public"
  9492. deprecated="not deprecated">
  9493. <param name="b" type="org.apache.hadoop.hdfs.protocol.Block"/>
  9494. <exception name="IOException" type="java.io.IOException"/>
  9495. <doc>
  9496. <![CDATA[Find the block's on-disk length]]>
  9497. </doc>
  9498. </method>
  9499. <method name="getBlockFile" return="java.io.File"
  9500. abstract="false" native="false" synchronized="true"
  9501. static="false" final="false" visibility="public"
  9502. deprecated="not deprecated">
  9503. <param name="b" type="org.apache.hadoop.hdfs.protocol.Block"/>
  9504. <exception name="IOException" type="java.io.IOException"/>
  9505. <doc>
  9506. <![CDATA[Get File name for a given block.]]>
  9507. </doc>
  9508. </method>
  9509. <method name="getBlockInputStream" return="java.io.InputStream"
  9510. abstract="false" native="false" synchronized="true"
  9511. static="false" final="false" visibility="public"
  9512. deprecated="not deprecated">
  9513. <param name="b" type="org.apache.hadoop.hdfs.protocol.Block"/>
  9514. <exception name="IOException" type="java.io.IOException"/>
  9515. </method>
  9516. <method name="getBlockInputStream" return="java.io.InputStream"
  9517. abstract="false" native="false" synchronized="true"
  9518. static="false" final="false" visibility="public"
  9519. deprecated="not deprecated">
  9520. <param name="b" type="org.apache.hadoop.hdfs.protocol.Block"/>
  9521. <param name="seekOffset" type="long"/>
  9522. <exception name="IOException" type="java.io.IOException"/>
  9523. </method>
  9524. <method name="getTmpInputStreams" return="org.apache.hadoop.hdfs.server.datanode.FSDatasetInterface.BlockInputStreams"
  9525. abstract="false" native="false" synchronized="true"
  9526. static="false" final="false" visibility="public"
  9527. deprecated="not deprecated">
  9528. <param name="b" type="org.apache.hadoop.hdfs.protocol.Block"/>
  9529. <param name="blkOffset" type="long"/>
  9530. <param name="ckoff" type="long"/>
  9531. <exception name="IOException" type="java.io.IOException"/>
  9532. <doc>
  9533. <![CDATA[Returns handles to the block file and its metadata file]]>
  9534. </doc>
  9535. </method>
  9536. <method name="unlinkBlock" return="boolean"
  9537. abstract="false" native="false" synchronized="false"
  9538. static="false" final="false" visibility="public"
  9539. deprecated="not deprecated">
  9540. <param name="block" type="org.apache.hadoop.hdfs.protocol.Block"/>
  9541. <param name="numLinks" type="int"/>
  9542. <exception name="IOException" type="java.io.IOException"/>
  9543. <doc>
  9544. <![CDATA[Make a copy of the block if this block is linked to an existing
  9545. snapshot. This ensures that modifying this block does not modify
  9546. data in any existing snapshots.
  9547. @param block Block
  9548. @param numLinks Unlink if the number of links exceed this value
  9549. @throws IOException
  9550. @return - true if the specified block was unlinked or the block
  9551. is not in any snapshot.]]>
  9552. </doc>
  9553. </method>
  9554. <method name="append" return="org.apache.hadoop.hdfs.server.datanode.ReplicaInPipelineInterface"
  9555. abstract="false" native="false" synchronized="true"
  9556. static="false" final="false" visibility="public"
  9557. deprecated="not deprecated">
  9558. <param name="b" type="org.apache.hadoop.hdfs.protocol.Block"/>
  9559. <param name="newGS" type="long"/>
  9560. <param name="expectedBlockLen" type="long"/>
  9561. <exception name="IOException" type="java.io.IOException"/>
  9562. </method>
  9563. <method name="recoverAppend" return="org.apache.hadoop.hdfs.server.datanode.ReplicaInPipelineInterface"
  9564. abstract="false" native="false" synchronized="true"
  9565. static="false" final="false" visibility="public"
  9566. deprecated="not deprecated">
  9567. <param name="b" type="org.apache.hadoop.hdfs.protocol.Block"/>
  9568. <param name="newGS" type="long"/>
  9569. <param name="expectedBlockLen" type="long"/>
  9570. <exception name="IOException" type="java.io.IOException"/>
  9571. </method>
  9572. <method name="recoverClose"
  9573. abstract="false" native="false" synchronized="false"
  9574. static="false" final="false" visibility="public"
  9575. deprecated="not deprecated">
  9576. <param name="b" type="org.apache.hadoop.hdfs.protocol.Block"/>
  9577. <param name="newGS" type="long"/>
  9578. <param name="expectedBlockLen" type="long"/>
  9579. <exception name="IOException" type="java.io.IOException"/>
  9580. </method>
  9581. <method name="createRbw" return="org.apache.hadoop.hdfs.server.datanode.ReplicaInPipelineInterface"
  9582. abstract="false" native="false" synchronized="true"
  9583. static="false" final="false" visibility="public"
  9584. deprecated="not deprecated">
  9585. <param name="b" type="org.apache.hadoop.hdfs.protocol.Block"/>
  9586. <exception name="IOException" type="java.io.IOException"/>
  9587. </method>
  9588. <method name="recoverRbw" return="org.apache.hadoop.hdfs.server.datanode.ReplicaInPipelineInterface"
  9589. abstract="false" native="false" synchronized="true"
  9590. static="false" final="false" visibility="public"
  9591. deprecated="not deprecated">
  9592. <param name="b" type="org.apache.hadoop.hdfs.protocol.Block"/>
  9593. <param name="newGS" type="long"/>
  9594. <param name="minBytesRcvd" type="long"/>
  9595. <param name="maxBytesRcvd" type="long"/>
  9596. <exception name="IOException" type="java.io.IOException"/>
  9597. </method>
  9598. <method name="createTemporary" return="org.apache.hadoop.hdfs.server.datanode.ReplicaInPipelineInterface"
  9599. abstract="false" native="false" synchronized="true"
  9600. static="false" final="false" visibility="public"
  9601. deprecated="not deprecated">
  9602. <param name="b" type="org.apache.hadoop.hdfs.protocol.Block"/>
  9603. <exception name="IOException" type="java.io.IOException"/>
  9604. </method>
  9605. <method name="adjustCrcChannelPosition"
  9606. abstract="false" native="false" synchronized="false"
  9607. static="false" final="false" visibility="public"
  9608. deprecated="not deprecated">
  9609. <param name="b" type="org.apache.hadoop.hdfs.protocol.Block"/>
  9610. <param name="streams" type="org.apache.hadoop.hdfs.server.datanode.FSDatasetInterface.BlockWriteStreams"/>
  9611. <param name="checksumSize" type="int"/>
  9612. <exception name="IOException" type="java.io.IOException"/>
  9613. <doc>
  9614. <![CDATA[Sets the offset in the meta file so that the
  9615. last checksum will be overwritten.]]>
  9616. </doc>
  9617. </method>
  9618. <method name="finalizeBlock"
  9619. abstract="false" native="false" synchronized="true"
  9620. static="false" final="false" visibility="public"
  9621. deprecated="not deprecated">
  9622. <param name="b" type="org.apache.hadoop.hdfs.protocol.Block"/>
  9623. <exception name="IOException" type="java.io.IOException"/>
  9624. <doc>
  9625. <![CDATA[Complete the block write!]]>
  9626. </doc>
  9627. </method>
  9628. <method name="unfinalizeBlock"
  9629. abstract="false" native="false" synchronized="true"
  9630. static="false" final="false" visibility="public"
  9631. deprecated="not deprecated">
  9632. <param name="b" type="org.apache.hadoop.hdfs.protocol.Block"/>
  9633. <exception name="IOException" type="java.io.IOException"/>
  9634. <doc>
  9635. <![CDATA[Remove the temporary block file (if any)]]>
  9636. </doc>
  9637. </method>
  9638. <method name="getBlockReport" return="org.apache.hadoop.hdfs.protocol.BlockListAsLongs"
  9639. abstract="false" native="false" synchronized="false"
  9640. static="false" final="false" visibility="public"
  9641. deprecated="not deprecated">
  9642. <doc>
  9643. <![CDATA[Generates a block report from the in-memory block map.]]>
  9644. </doc>
  9645. </method>
  9646. <method name="isValidBlock" return="boolean"
  9647. abstract="false" native="false" synchronized="false"
  9648. static="false" final="false" visibility="public"
  9649. deprecated="not deprecated">
  9650. <param name="b" type="org.apache.hadoop.hdfs.protocol.Block"/>
  9651. <doc>
  9652. <![CDATA[Check whether the given block is a valid one.
  9653. valid means finalized]]>
  9654. </doc>
  9655. </method>
  9656. <method name="invalidate"
  9657. abstract="false" native="false" synchronized="false"
  9658. static="false" final="false" visibility="public"
  9659. deprecated="not deprecated">
  9660. <param name="invalidBlks" type="org.apache.hadoop.hdfs.protocol.Block[]"/>
  9661. <exception name="IOException" type="java.io.IOException"/>
  9662. <doc>
  9663. <![CDATA[We're informed that a block is no longer valid. We
  9664. could lazily garbage-collect the block, but why bother?
  9665. just get rid of it.]]>
  9666. </doc>
  9667. </method>
  9668. <method name="getFile" return="java.io.File"
  9669. abstract="false" native="false" synchronized="true"
  9670. static="false" final="false" visibility="public"
  9671. deprecated="not deprecated">
  9672. <param name="b" type="org.apache.hadoop.hdfs.protocol.Block"/>
  9673. <doc>
  9674. <![CDATA[Turn the block identifier into a filename; ignore generation stamp!!!]]>
  9675. </doc>
  9676. </method>
  9677. <method name="checkDataDir"
  9678. abstract="false" native="false" synchronized="false"
  9679. static="false" final="false" visibility="public"
  9680. deprecated="not deprecated">
  9681. <exception name="DiskChecker.DiskErrorException" type="org.apache.hadoop.util.DiskChecker.DiskErrorException"/>
  9682. <doc>
  9683. <![CDATA[check if a data directory is healthy
  9684. if some volumes failed - make sure to remove all the blocks that belong
  9685. to these volumes
  9686. @throws DiskErrorException]]>
  9687. </doc>
  9688. </method>
  9689. <method name="toString" return="java.lang.String"
  9690. abstract="false" native="false" synchronized="false"
  9691. static="false" final="false" visibility="public"
  9692. deprecated="not deprecated">
  9693. </method>
  9694. <method name="shutdown"
  9695. abstract="false" native="false" synchronized="false"
  9696. static="false" final="false" visibility="public"
  9697. deprecated="not deprecated">
  9698. </method>
  9699. <method name="getStorageInfo" return="java.lang.String"
  9700. abstract="false" native="false" synchronized="false"
  9701. static="false" final="false" visibility="public"
  9702. deprecated="not deprecated">
  9703. </method>
  9704. <method name="checkAndUpdate"
  9705. abstract="false" native="false" synchronized="false"
  9706. static="false" final="false" visibility="public"
  9707. deprecated="not deprecated">
  9708. <param name="blockId" type="long"/>
  9709. <param name="diskFile" type="java.io.File"/>
  9710. <param name="diskMetaFile" type="java.io.File"/>
  9711. <param name="vol" type="org.apache.hadoop.hdfs.server.datanode.FSDataset.FSVolume"/>
  9712. <doc>
  9713. <![CDATA[Reconcile the difference between blocks on the disk and blocks in
  9714. volumeMap
  9715. Check the given block for inconsistencies. Look at the
  9716. current state of the block and reconcile the differences as follows:
  9717. <ul>
  9718. <li>If the block file is missing, delete the block from volumeMap</li>
  9719. <li>If the block file exists and the block is missing in volumeMap,
  9720. add the block to volumeMap <li>
  9721. <li>If generation stamp does not match, then update the block with right
  9722. generation stamp</li>
  9723. <li>If the block length in memory does not match the actual block file length
  9724. then mark the block as corrupt and update the block length in memory</li>
  9725. <li>If the file in {@link ReplicaInfo} does not match the file on
  9726. the disk, update {@link ReplicaInfo} with the correct file</li>
  9727. </ul>
  9728. @param blockId Block that differs
  9729. @param diskFile Block file on the disk
  9730. @param diskMetaFile Metadata file from on the disk
  9731. @param vol Volume of the block file]]>
  9732. </doc>
  9733. </method>
  9734. <method name="getReplica" return="org.apache.hadoop.hdfs.server.datanode.ReplicaInfo"
  9735. abstract="false" native="false" synchronized="false"
  9736. static="false" final="false" visibility="public"
  9737. deprecated="use {@link #fetchReplicaInfo(long)} instead.">
  9738. <param name="blockId" type="long"/>
  9739. <doc>
  9740. <![CDATA[@deprecated use {@link #fetchReplicaInfo(long)} instead.]]>
  9741. </doc>
  9742. </method>
  9743. <method name="initReplicaRecovery" return="org.apache.hadoop.hdfs.server.protocol.ReplicaRecoveryInfo"
  9744. abstract="false" native="false" synchronized="true"
  9745. static="false" final="false" visibility="public"
  9746. deprecated="not deprecated">
  9747. <param name="rBlock" type="org.apache.hadoop.hdfs.server.protocol.BlockRecoveryCommand.RecoveringBlock"/>
  9748. <exception name="IOException" type="java.io.IOException"/>
  9749. </method>
  9750. <method name="updateReplicaUnderRecovery" return="org.apache.hadoop.hdfs.server.datanode.ReplicaInfo"
  9751. abstract="false" native="false" synchronized="true"
  9752. static="false" final="false" visibility="public"
  9753. deprecated="not deprecated">
  9754. <param name="oldBlock" type="org.apache.hadoop.hdfs.protocol.Block"/>
  9755. <param name="recoveryId" type="long"/>
  9756. <param name="newlength" type="long"/>
  9757. <exception name="IOException" type="java.io.IOException"/>
  9758. </method>
  9759. <method name="getReplicaVisibleLength" return="long"
  9760. abstract="false" native="false" synchronized="true"
  9761. static="false" final="false" visibility="public"
  9762. deprecated="not deprecated">
  9763. <param name="block" type="org.apache.hadoop.hdfs.protocol.Block"/>
  9764. <exception name="IOException" type="java.io.IOException"/>
  9765. </method>
  9766. <field name="METADATA_EXTENSION" type="java.lang.String"
  9767. transient="false" volatile="false"
  9768. static="true" final="true" visibility="public"
  9769. deprecated="not deprecated">
  9770. </field>
  9771. <field name="METADATA_VERSION" type="short"
  9772. transient="false" volatile="false"
  9773. static="true" final="true" visibility="public"
  9774. deprecated="not deprecated">
  9775. </field>
  9776. <doc>
  9777. <![CDATA[FSDataset manages a set of data blocks. Each block
  9778. has a unique name and an extent on disk.]]>
  9779. </doc>
  9780. </class>
  9781. <!-- end class org.apache.hadoop.hdfs.server.datanode.FSDataset -->
  9782. <!-- start interface org.apache.hadoop.hdfs.server.datanode.FSDatasetInterface -->
  9783. <interface name="FSDatasetInterface" abstract="true"
  9784. static="false" final="false" visibility="public"
  9785. deprecated="not deprecated">
  9786. <implements name="org.apache.hadoop.hdfs.server.datanode.metrics.FSDatasetMBean"/>
  9787. <method name="getMetaDataLength" return="long"
  9788. abstract="false" native="false" synchronized="false"
  9789. static="false" final="false" visibility="public"
  9790. deprecated="not deprecated">
  9791. <param name="b" type="org.apache.hadoop.hdfs.protocol.Block"/>
  9792. <exception name="IOException" type="java.io.IOException"/>
  9793. <doc>
  9794. <![CDATA[Returns the length of the metadata file of the specified block
  9795. @param b - the block for which the metadata length is desired
  9796. @return the length of the metadata file for the specified block.
  9797. @throws IOException]]>
  9798. </doc>
  9799. </method>
  9800. <method name="getMetaDataInputStream" return="org.apache.hadoop.hdfs.server.datanode.FSDatasetInterface.MetaDataInputStream"
  9801. abstract="false" native="false" synchronized="false"
  9802. static="false" final="false" visibility="public"
  9803. deprecated="not deprecated">
  9804. <param name="b" type="org.apache.hadoop.hdfs.protocol.Block"/>
  9805. <exception name="IOException" type="java.io.IOException"/>
  9806. <doc>
  9807. <![CDATA[Returns metaData of block b as an input stream (and its length)
  9808. @param b - the block
  9809. @return the metadata input stream;
  9810. @throws IOException]]>
  9811. </doc>
  9812. </method>
  9813. <method name="metaFileExists" return="boolean"
  9814. abstract="false" native="false" synchronized="false"
  9815. static="false" final="false" visibility="public"
  9816. deprecated="not deprecated">
  9817. <param name="b" type="org.apache.hadoop.hdfs.protocol.Block"/>
  9818. <exception name="IOException" type="java.io.IOException"/>
  9819. <doc>
  9820. <![CDATA[Does the meta file exist for this block?
  9821. @param b - the block
  9822. @return true of the metafile for specified block exits
  9823. @throws IOException]]>
  9824. </doc>
  9825. </method>
  9826. <method name="getLength" return="long"
  9827. abstract="false" native="false" synchronized="false"
  9828. static="false" final="false" visibility="public"
  9829. deprecated="not deprecated">
  9830. <param name="b" type="org.apache.hadoop.hdfs.protocol.Block"/>
  9831. <exception name="IOException" type="java.io.IOException"/>
  9832. <doc>
  9833. <![CDATA[Returns the specified block's on-disk length (excluding metadata)
  9834. @param b
  9835. @return the specified block's on-disk length (excluding metadta)
  9836. @throws IOException]]>
  9837. </doc>
  9838. </method>
  9839. <method name="getReplica" return="org.apache.hadoop.hdfs.server.datanode.Replica"
  9840. abstract="false" native="false" synchronized="false"
  9841. static="false" final="false" visibility="public"
  9842. deprecated="not deprecated">
  9843. <param name="blockId" type="long"/>
  9844. <doc>
  9845. <![CDATA[Get reference to the replica meta info in the replicasMap.
  9846. To be called from methods that are synchronized on {@link FSDataset}
  9847. @param blockId
  9848. @return replica from the replicas map]]>
  9849. </doc>
  9850. </method>
  9851. <method name="getStoredBlock" return="org.apache.hadoop.hdfs.protocol.Block"
  9852. abstract="false" native="false" synchronized="false"
  9853. static="false" final="false" visibility="public"
  9854. deprecated="not deprecated">
  9855. <param name="blkid" type="long"/>
  9856. <exception name="IOException" type="java.io.IOException"/>
  9857. <doc>
  9858. <![CDATA[@return the generation stamp stored with the block.]]>
  9859. </doc>
  9860. </method>
  9861. <method name="getBlockInputStream" return="java.io.InputStream"
  9862. abstract="false" native="false" synchronized="false"
  9863. static="false" final="false" visibility="public"
  9864. deprecated="not deprecated">
  9865. <param name="b" type="org.apache.hadoop.hdfs.protocol.Block"/>
  9866. <exception name="IOException" type="java.io.IOException"/>
  9867. <doc>
  9868. <![CDATA[Returns an input stream to read the contents of the specified block
  9869. @param b
  9870. @return an input stream to read the contents of the specified block
  9871. @throws IOException]]>
  9872. </doc>
  9873. </method>
  9874. <method name="getBlockInputStream" return="java.io.InputStream"
  9875. abstract="false" native="false" synchronized="false"
  9876. static="false" final="false" visibility="public"
  9877. deprecated="not deprecated">
  9878. <param name="b" type="org.apache.hadoop.hdfs.protocol.Block"/>
  9879. <param name="seekOffset" type="long"/>
  9880. <exception name="IOException" type="java.io.IOException"/>
  9881. <doc>
  9882. <![CDATA[Returns an input stream at specified offset of the specified block
  9883. @param b
  9884. @param seekOffset
  9885. @return an input stream to read the contents of the specified block,
  9886. starting at the offset
  9887. @throws IOException]]>
  9888. </doc>
  9889. </method>
  9890. <method name="getTmpInputStreams" return="org.apache.hadoop.hdfs.server.datanode.FSDatasetInterface.BlockInputStreams"
  9891. abstract="false" native="false" synchronized="false"
  9892. static="false" final="false" visibility="public"
  9893. deprecated="not deprecated">
  9894. <param name="b" type="org.apache.hadoop.hdfs.protocol.Block"/>
  9895. <param name="blkoff" type="long"/>
  9896. <param name="ckoff" type="long"/>
  9897. <exception name="IOException" type="java.io.IOException"/>
  9898. <doc>
  9899. <![CDATA[Returns an input stream at specified offset of the specified block
  9900. The block is still in the tmp directory and is not finalized
  9901. @param b
  9902. @param blkoff
  9903. @param ckoff
  9904. @return an input stream to read the contents of the specified block,
  9905. starting at the offset
  9906. @throws IOException]]>
  9907. </doc>
  9908. </method>
  9909. <method name="createTemporary" return="org.apache.hadoop.hdfs.server.datanode.ReplicaInPipelineInterface"
  9910. abstract="false" native="false" synchronized="false"
  9911. static="false" final="false" visibility="public"
  9912. deprecated="not deprecated">
  9913. <param name="b" type="org.apache.hadoop.hdfs.protocol.Block"/>
  9914. <exception name="IOException" type="java.io.IOException"/>
  9915. <doc>
  9916. <![CDATA[Creates a temporary replica and returns the meta information of the replica
  9917. @param b block
  9918. @return the meta info of the replica which is being written to
  9919. @throws IOException if an error occurs]]>
  9920. </doc>
  9921. </method>
  9922. <method name="createRbw" return="org.apache.hadoop.hdfs.server.datanode.ReplicaInPipelineInterface"
  9923. abstract="false" native="false" synchronized="false"
  9924. static="false" final="false" visibility="public"
  9925. deprecated="not deprecated">
  9926. <param name="b" type="org.apache.hadoop.hdfs.protocol.Block"/>
  9927. <exception name="IOException" type="java.io.IOException"/>
  9928. <doc>
  9929. <![CDATA[Creates a RBW replica and returns the meta info of the replica
  9930. @param b block
  9931. @return the meta info of the replica which is being written to
  9932. @throws IOException if an error occurs]]>
  9933. </doc>
  9934. </method>
  9935. <method name="recoverRbw" return="org.apache.hadoop.hdfs.server.datanode.ReplicaInPipelineInterface"
  9936. abstract="false" native="false" synchronized="false"
  9937. static="false" final="false" visibility="public"
  9938. deprecated="not deprecated">
  9939. <param name="b" type="org.apache.hadoop.hdfs.protocol.Block"/>
  9940. <param name="newGS" type="long"/>
  9941. <param name="minBytesRcvd" type="long"/>
  9942. <param name="maxBytesRcvd" type="long"/>
  9943. <exception name="IOException" type="java.io.IOException"/>
  9944. <doc>
  9945. <![CDATA[Recovers a RBW replica and returns the meta info of the replica
  9946. @param b block
  9947. @param newGS the new generation stamp for the replica
  9948. @param minBytesRcvd the minimum number of bytes that the replica could have
  9949. @param maxBytesRcvd the maximum number of bytes that the replica could have
  9950. @return the meta info of the replica which is being written to
  9951. @throws IOException if an error occurs]]>
  9952. </doc>
  9953. </method>
  9954. <method name="append" return="org.apache.hadoop.hdfs.server.datanode.ReplicaInPipelineInterface"
  9955. abstract="false" native="false" synchronized="false"
  9956. static="false" final="false" visibility="public"
  9957. deprecated="not deprecated">
  9958. <param name="b" type="org.apache.hadoop.hdfs.protocol.Block"/>
  9959. <param name="newGS" type="long"/>
  9960. <param name="expectedBlockLen" type="long"/>
  9961. <exception name="IOException" type="java.io.IOException"/>
  9962. <doc>
  9963. <![CDATA[Append to a finalized replica and returns the meta info of the replica
  9964. @param b block
  9965. @param newGS the new generation stamp for the replica
  9966. @param expectedBlockLen the number of bytes the replica is expected to have
  9967. @return the meata info of the replica which is being written to
  9968. @throws IOException]]>
  9969. </doc>
  9970. </method>
  9971. <method name="recoverAppend" return="org.apache.hadoop.hdfs.server.datanode.ReplicaInPipelineInterface"
  9972. abstract="false" native="false" synchronized="false"
  9973. static="false" final="false" visibility="public"
  9974. deprecated="not deprecated">
  9975. <param name="b" type="org.apache.hadoop.hdfs.protocol.Block"/>
  9976. <param name="newGS" type="long"/>
  9977. <param name="expectedBlockLen" type="long"/>
  9978. <exception name="IOException" type="java.io.IOException"/>
  9979. <doc>
  9980. <![CDATA[Recover a failed append to a finalized replica
  9981. and returns the meta info of the replica
  9982. @param b block
  9983. @param newGS the new generation stamp for the replica
  9984. @param expectedBlockLen the number of bytes the replica is expected to have
  9985. @return the meta info of the replica which is being written to
  9986. @throws IOException]]>
  9987. </doc>
  9988. </method>
  9989. <method name="recoverClose"
  9990. abstract="false" native="false" synchronized="false"
  9991. static="false" final="false" visibility="public"
  9992. deprecated="not deprecated">
  9993. <param name="b" type="org.apache.hadoop.hdfs.protocol.Block"/>
  9994. <param name="newGS" type="long"/>
  9995. <param name="expectedBlockLen" type="long"/>
  9996. <exception name="IOException" type="java.io.IOException"/>
  9997. <doc>
  9998. <![CDATA[Recover a failed pipeline close
  9999. It bumps the replica's generation stamp and finalize it if RBW replica
  10000. @param b block
  10001. @param newGS the new generation stamp for the replica
  10002. @param expectedBlockLen the number of bytes the replica is expected to have
  10003. @throws IOException]]>
  10004. </doc>
  10005. </method>
  10006. <method name="finalizeBlock"
  10007. abstract="false" native="false" synchronized="false"
  10008. static="false" final="false" visibility="public"
  10009. deprecated="not deprecated">
  10010. <param name="b" type="org.apache.hadoop.hdfs.protocol.Block"/>
  10011. <exception name="IOException" type="java.io.IOException"/>
  10012. <doc>
  10013. <![CDATA[Finalizes the block previously opened for writing using writeToBlock.
  10014. The block size is what is in the parameter b and it must match the amount
  10015. of data written
  10016. @param b
  10017. @throws IOException]]>
  10018. </doc>
  10019. </method>
  10020. <method name="unfinalizeBlock"
  10021. abstract="false" native="false" synchronized="false"
  10022. static="false" final="false" visibility="public"
  10023. deprecated="not deprecated">
  10024. <param name="b" type="org.apache.hadoop.hdfs.protocol.Block"/>
  10025. <exception name="IOException" type="java.io.IOException"/>
  10026. <doc>
  10027. <![CDATA[Unfinalizes the block previously opened for writing using writeToBlock.
  10028. The temporary file associated with this block is deleted.
  10029. @param b
  10030. @throws IOException]]>
  10031. </doc>
  10032. </method>
  10033. <method name="getBlockReport" return="org.apache.hadoop.hdfs.protocol.BlockListAsLongs"
  10034. abstract="false" native="false" synchronized="false"
  10035. static="false" final="false" visibility="public"
  10036. deprecated="not deprecated">
  10037. <doc>
  10038. <![CDATA[Returns the block report - the full list of blocks stored
  10039. @return - the block report - the full list of blocks stored]]>
  10040. </doc>
  10041. </method>
  10042. <method name="isValidBlock" return="boolean"
  10043. abstract="false" native="false" synchronized="false"
  10044. static="false" final="false" visibility="public"
  10045. deprecated="not deprecated">
  10046. <param name="b" type="org.apache.hadoop.hdfs.protocol.Block"/>
  10047. <doc>
  10048. <![CDATA[Is the block valid?
  10049. @param b
  10050. @return - true if the specified block is valid]]>
  10051. </doc>
  10052. </method>
  10053. <method name="invalidate"
  10054. abstract="false" native="false" synchronized="false"
  10055. static="false" final="false" visibility="public"
  10056. deprecated="not deprecated">
  10057. <param name="invalidBlks" type="org.apache.hadoop.hdfs.protocol.Block[]"/>
  10058. <exception name="IOException" type="java.io.IOException"/>
  10059. <doc>
  10060. <![CDATA[Invalidates the specified blocks
  10061. @param invalidBlks - the blocks to be invalidated
  10062. @throws IOException]]>
  10063. </doc>
  10064. </method>
  10065. <method name="checkDataDir"
  10066. abstract="false" native="false" synchronized="false"
  10067. static="false" final="false" visibility="public"
  10068. deprecated="not deprecated">
  10069. <exception name="DiskChecker.DiskErrorException" type="org.apache.hadoop.util.DiskChecker.DiskErrorException"/>
  10070. <doc>
  10071. <![CDATA[Check if all the data directories are healthy
  10072. @throws DiskErrorException]]>
  10073. </doc>
  10074. </method>
  10075. <method name="toString" return="java.lang.String"
  10076. abstract="false" native="false" synchronized="false"
  10077. static="false" final="false" visibility="public"
  10078. deprecated="not deprecated">
  10079. <doc>
  10080. <![CDATA[Stringifies the name of the storage]]>
  10081. </doc>
  10082. </method>
  10083. <method name="shutdown"
  10084. abstract="false" native="false" synchronized="false"
  10085. static="false" final="false" visibility="public"
  10086. deprecated="not deprecated">
  10087. <doc>
  10088. <![CDATA[Shutdown the FSDataset]]>
  10089. </doc>
  10090. </method>
  10091. <method name="adjustCrcChannelPosition"
  10092. abstract="false" native="false" synchronized="false"
  10093. static="false" final="false" visibility="public"
  10094. deprecated="not deprecated">
  10095. <param name="b" type="org.apache.hadoop.hdfs.protocol.Block"/>
  10096. <param name="stream" type="org.apache.hadoop.hdfs.server.datanode.FSDatasetInterface.BlockWriteStreams"/>
  10097. <param name="checksumSize" type="int"/>
  10098. <exception name="IOException" type="java.io.IOException"/>
  10099. <doc>
  10100. <![CDATA[Sets the file pointer of the checksum stream so that the last checksum
  10101. will be overwritten
  10102. @param b block
  10103. @param stream The stream for the data file and checksum file
  10104. @param checksumSize number of bytes each checksum has
  10105. @throws IOException]]>
  10106. </doc>
  10107. </method>
  10108. <method name="hasEnoughResource" return="boolean"
  10109. abstract="false" native="false" synchronized="false"
  10110. static="false" final="false" visibility="public"
  10111. deprecated="not deprecated">
  10112. <doc>
  10113. <![CDATA[checks how many valid storage volumes are there in the DataNode
  10114. @return true if more then minimum valid volumes left in the FSDataSet]]>
  10115. </doc>
  10116. </method>
  10117. <method name="getReplicaVisibleLength" return="long"
  10118. abstract="false" native="false" synchronized="false"
  10119. static="false" final="false" visibility="public"
  10120. deprecated="not deprecated">
  10121. <param name="block" type="org.apache.hadoop.hdfs.protocol.Block"/>
  10122. <exception name="IOException" type="java.io.IOException"/>
  10123. <doc>
  10124. <![CDATA[Get visible length of the specified replica.]]>
  10125. </doc>
  10126. </method>
  10127. <method name="initReplicaRecovery" return="org.apache.hadoop.hdfs.server.protocol.ReplicaRecoveryInfo"
  10128. abstract="false" native="false" synchronized="false"
  10129. static="false" final="false" visibility="public"
  10130. deprecated="not deprecated">
  10131. <param name="rBlock" type="org.apache.hadoop.hdfs.server.protocol.BlockRecoveryCommand.RecoveringBlock"/>
  10132. <exception name="IOException" type="java.io.IOException"/>
  10133. <doc>
  10134. <![CDATA[Initialize a replica recovery.
  10135. @return actual state of the replica on this data-node or
  10136. null if data-node does not have the replica.]]>
  10137. </doc>
  10138. </method>
  10139. <method name="updateReplicaUnderRecovery" return="org.apache.hadoop.hdfs.server.datanode.ReplicaInfo"
  10140. abstract="false" native="false" synchronized="false"
  10141. static="false" final="false" visibility="public"
  10142. deprecated="not deprecated">
  10143. <param name="oldBlock" type="org.apache.hadoop.hdfs.protocol.Block"/>
  10144. <param name="recoveryId" type="long"/>
  10145. <param name="newLength" type="long"/>
  10146. <exception name="IOException" type="java.io.IOException"/>
  10147. <doc>
  10148. <![CDATA[Update replica's generation stamp and length and finalize it.]]>
  10149. </doc>
  10150. </method>
  10151. <doc>
  10152. <![CDATA[This is an interface for the underlying storage that stores blocks for
  10153. a data node.
  10154. Examples are the FSDataset (which stores blocks on dirs) and
  10155. SimulatedFSDataset (which simulates data).]]>
  10156. </doc>
  10157. </interface>
  10158. <!-- end interface org.apache.hadoop.hdfs.server.datanode.FSDatasetInterface -->
  10159. <!-- start class org.apache.hadoop.hdfs.server.datanode.FSDatasetInterface.BlockInputStreams -->
  10160. <class name="FSDatasetInterface.BlockInputStreams" extends="java.lang.Object"
  10161. abstract="false"
  10162. static="true" final="false" visibility="public"
  10163. deprecated="not deprecated">
  10164. <implements name="java.io.Closeable"/>
  10165. <method name="close"
  10166. abstract="false" native="false" synchronized="false"
  10167. static="false" final="false" visibility="public"
  10168. deprecated="not deprecated">
  10169. <doc>
  10170. <![CDATA[{@inheritDoc}]]>
  10171. </doc>
  10172. </method>
  10173. <doc>
  10174. <![CDATA[This class contains the input streams for the data and checksum
  10175. of a block]]>
  10176. </doc>
  10177. </class>
  10178. <!-- end class org.apache.hadoop.hdfs.server.datanode.FSDatasetInterface.BlockInputStreams -->
  10179. <!-- start class org.apache.hadoop.hdfs.server.datanode.FSDatasetInterface.BlockWriteStreams -->
  10180. <class name="FSDatasetInterface.BlockWriteStreams" extends="java.lang.Object"
  10181. abstract="false"
  10182. static="true" final="false" visibility="public"
  10183. deprecated="not deprecated">
  10184. <doc>
  10185. <![CDATA[This class contains the output streams for the data and checksum
  10186. of a block]]>
  10187. </doc>
  10188. </class>
  10189. <!-- end class org.apache.hadoop.hdfs.server.datanode.FSDatasetInterface.BlockWriteStreams -->
  10190. <!-- start class org.apache.hadoop.hdfs.server.datanode.FSDatasetInterface.MetaDataInputStream -->
  10191. <class name="FSDatasetInterface.MetaDataInputStream" extends="java.io.FilterInputStream"
  10192. abstract="false"
  10193. static="true" final="false" visibility="public"
  10194. deprecated="not deprecated">
  10195. <method name="getLength" return="long"
  10196. abstract="false" native="false" synchronized="false"
  10197. static="false" final="false" visibility="public"
  10198. deprecated="not deprecated">
  10199. </method>
  10200. <doc>
  10201. <![CDATA[This class provides the input stream and length of the metadata
  10202. of a block]]>
  10203. </doc>
  10204. </class>
  10205. <!-- end class org.apache.hadoop.hdfs.server.datanode.FSDatasetInterface.MetaDataInputStream -->
  10206. <!-- start interface org.apache.hadoop.hdfs.server.datanode.Replica -->
  10207. <interface name="Replica" abstract="true"
  10208. static="false" final="false" visibility="public"
  10209. deprecated="not deprecated">
  10210. <method name="getBlockId" return="long"
  10211. abstract="false" native="false" synchronized="false"
  10212. static="false" final="false" visibility="public"
  10213. deprecated="not deprecated">
  10214. <doc>
  10215. <![CDATA[get block ID]]>
  10216. </doc>
  10217. </method>
  10218. <method name="getGenerationStamp" return="long"
  10219. abstract="false" native="false" synchronized="false"
  10220. static="false" final="false" visibility="public"
  10221. deprecated="not deprecated">
  10222. <doc>
  10223. <![CDATA[get generation stamp]]>
  10224. </doc>
  10225. </method>
  10226. <method name="getState" return="org.apache.hadoop.hdfs.server.common.HdfsConstants.ReplicaState"
  10227. abstract="false" native="false" synchronized="false"
  10228. static="false" final="false" visibility="public"
  10229. deprecated="not deprecated">
  10230. <doc>
  10231. <![CDATA[Get the replica state
  10232. @return the replica state]]>
  10233. </doc>
  10234. </method>
  10235. <method name="getNumBytes" return="long"
  10236. abstract="false" native="false" synchronized="false"
  10237. static="false" final="false" visibility="public"
  10238. deprecated="not deprecated">
  10239. <doc>
  10240. <![CDATA[Get the number of bytes received
  10241. @return the number of bytes that have been received]]>
  10242. </doc>
  10243. </method>
  10244. <method name="getBytesOnDisk" return="long"
  10245. abstract="false" native="false" synchronized="false"
  10246. static="false" final="false" visibility="public"
  10247. deprecated="not deprecated">
  10248. <doc>
  10249. <![CDATA[Get the number of bytes that have written to disk
  10250. @return the number of bytes that have written to disk]]>
  10251. </doc>
  10252. </method>
  10253. <method name="getVisibleLength" return="long"
  10254. abstract="false" native="false" synchronized="false"
  10255. static="false" final="false" visibility="public"
  10256. deprecated="not deprecated">
  10257. <doc>
  10258. <![CDATA[Get the number of bytes that are visible to readers
  10259. @return the number of bytes that are visible to readers]]>
  10260. </doc>
  10261. </method>
  10262. <doc>
  10263. <![CDATA[This represents block replicas which stored in DataNode.]]>
  10264. </doc>
  10265. </interface>
  10266. <!-- end interface org.apache.hadoop.hdfs.server.datanode.Replica -->
  10267. <!-- start class org.apache.hadoop.hdfs.server.datanode.ReplicaInfo -->
  10268. <class name="ReplicaInfo" extends="org.apache.hadoop.hdfs.protocol.Block"
  10269. abstract="true"
  10270. static="false" final="false" visibility="public"
  10271. deprecated="not deprecated">
  10272. <implements name="org.apache.hadoop.hdfs.server.datanode.Replica"/>
  10273. <method name="toString" return="java.lang.String"
  10274. abstract="false" native="false" synchronized="false"
  10275. static="false" final="false" visibility="public"
  10276. deprecated="not deprecated">
  10277. </method>
  10278. <doc>
  10279. <![CDATA[This class is used by datanodes to maintain meta data of its replicas.
  10280. It provides a general interface for meta information of a replica.]]>
  10281. </doc>
  10282. </class>
  10283. <!-- end class org.apache.hadoop.hdfs.server.datanode.ReplicaInfo -->
  10284. <!-- start class org.apache.hadoop.hdfs.server.datanode.ReplicaNotFoundException -->
  10285. <class name="ReplicaNotFoundException" extends="java.io.IOException"
  10286. abstract="false"
  10287. static="false" final="false" visibility="public"
  10288. deprecated="not deprecated">
  10289. <constructor name="ReplicaNotFoundException"
  10290. static="false" final="false" visibility="public"
  10291. deprecated="not deprecated">
  10292. </constructor>
  10293. <constructor name="ReplicaNotFoundException" type="java.lang.String"
  10294. static="false" final="false" visibility="public"
  10295. deprecated="not deprecated">
  10296. </constructor>
  10297. <doc>
  10298. <![CDATA[Exception indicating that DataNode does not have a replica
  10299. that matches the target block.]]>
  10300. </doc>
  10301. </class>
  10302. <!-- end class org.apache.hadoop.hdfs.server.datanode.ReplicaNotFoundException -->
  10303. <!-- start class org.apache.hadoop.hdfs.server.datanode.UpgradeObjectDatanode -->
  10304. <class name="UpgradeObjectDatanode" extends="org.apache.hadoop.hdfs.server.common.UpgradeObject"
  10305. abstract="true"
  10306. static="false" final="false" visibility="public"
  10307. deprecated="not deprecated">
  10308. <implements name="java.lang.Runnable"/>
  10309. <constructor name="UpgradeObjectDatanode"
  10310. static="false" final="false" visibility="public"
  10311. deprecated="not deprecated">
  10312. </constructor>
  10313. <method name="getType" return="org.apache.hadoop.hdfs.server.common.HdfsConstants.NodeType"
  10314. abstract="false" native="false" synchronized="false"
  10315. static="false" final="false" visibility="public"
  10316. deprecated="not deprecated">
  10317. </method>
  10318. <method name="getDatanode" return="org.apache.hadoop.hdfs.server.datanode.DataNode"
  10319. abstract="false" native="false" synchronized="false"
  10320. static="false" final="false" visibility="protected"
  10321. deprecated="not deprecated">
  10322. </method>
  10323. <method name="doUpgrade"
  10324. abstract="true" native="false" synchronized="false"
  10325. static="false" final="false" visibility="public"
  10326. deprecated="not deprecated">
  10327. <exception name="IOException" type="java.io.IOException"/>
  10328. <doc>
  10329. <![CDATA[Specifies how the upgrade is performed.
  10330. @throws IOException]]>
  10331. </doc>
  10332. </method>
  10333. <method name="run"
  10334. abstract="false" native="false" synchronized="false"
  10335. static="false" final="false" visibility="public"
  10336. deprecated="not deprecated">
  10337. </method>
  10338. <method name="completeUpgrade" return="org.apache.hadoop.hdfs.server.protocol.UpgradeCommand"
  10339. abstract="false" native="false" synchronized="false"
  10340. static="false" final="false" visibility="public"
  10341. deprecated="not deprecated">
  10342. <exception name="IOException" type="java.io.IOException"/>
  10343. <doc>
  10344. <![CDATA[Complete upgrade and return a status complete command for broadcasting.
  10345. Data-nodes finish upgrade at different times.
  10346. The data-node needs to re-confirm with the name-node that the upgrade
  10347. is complete while other nodes are still upgrading.]]>
  10348. </doc>
  10349. </method>
  10350. <doc>
  10351. <![CDATA[Base class for data-node upgrade objects.
  10352. Data-node upgrades are run in separate threads.]]>
  10353. </doc>
  10354. </class>
  10355. <!-- end class org.apache.hadoop.hdfs.server.datanode.UpgradeObjectDatanode -->
  10356. </package>
  10357. <package name="org.apache.hadoop.hdfs.server.datanode.metrics">
  10358. <!-- start class org.apache.hadoop.hdfs.server.datanode.metrics.DataNodeActivityMBean -->
  10359. <class name="DataNodeActivityMBean" extends="org.apache.hadoop.metrics.util.MetricsDynamicMBeanBase"
  10360. abstract="false"
  10361. static="false" final="false" visibility="public"
  10362. deprecated="not deprecated">
  10363. <constructor name="DataNodeActivityMBean" type="org.apache.hadoop.metrics.util.MetricsRegistry, java.lang.String"
  10364. static="false" final="false" visibility="public"
  10365. deprecated="not deprecated">
  10366. </constructor>
  10367. <method name="shutdown"
  10368. abstract="false" native="false" synchronized="false"
  10369. static="false" final="false" visibility="public"
  10370. deprecated="not deprecated">
  10371. </method>
  10372. <doc>
  10373. <![CDATA[This is the JMX MBean for reporting the DataNode Activity.
  10374. The MBean is register using the name
  10375. "hadoop:service=DataNode,name=DataNodeActivity-<hostname>-<portNumber>"
  10376. Many of the activity metrics are sampled and averaged on an interval
  10377. which can be specified in the metrics config file.
  10378. <p>
  10379. For the metrics that are sampled and averaged, one must specify
  10380. a metrics context that does periodic update calls. Most metrics contexts do.
  10381. The default Null metrics context however does NOT. So if you aren't
  10382. using any other metrics context then you can turn on the viewing and averaging
  10383. of sampled metrics by specifying the following two lines
  10384. in the hadoop-meterics.properties file:
  10385. <pre>
  10386. dfs.class=org.apache.hadoop.metrics.spi.NullContextWithUpdateThread
  10387. dfs.period=10
  10388. </pre>
  10389. <p>
  10390. Note that the metrics are collected regardless of the context used.
  10391. The context with the update thread is used to average the data periodically
  10392. Impl details: We use a dynamic mbean that gets the list of the metrics
  10393. from the metrics registry passed as an argument to the constructor]]>
  10394. </doc>
  10395. </class>
  10396. <!-- end class org.apache.hadoop.hdfs.server.datanode.metrics.DataNodeActivityMBean -->
  10397. <!-- start class org.apache.hadoop.hdfs.server.datanode.metrics.DataNodeMetrics -->
  10398. <class name="DataNodeMetrics" extends="java.lang.Object"
  10399. abstract="false"
  10400. static="false" final="false" visibility="public"
  10401. deprecated="not deprecated">
  10402. <implements name="org.apache.hadoop.metrics.Updater"/>
  10403. <constructor name="DataNodeMetrics" type="org.apache.hadoop.conf.Configuration, java.lang.String"
  10404. static="false" final="false" visibility="public"
  10405. deprecated="not deprecated">
  10406. </constructor>
  10407. <method name="shutdown"
  10408. abstract="false" native="false" synchronized="false"
  10409. static="false" final="false" visibility="public"
  10410. deprecated="not deprecated">
  10411. </method>
  10412. <method name="doUpdates"
  10413. abstract="false" native="false" synchronized="false"
  10414. static="false" final="false" visibility="public"
  10415. deprecated="not deprecated">
  10416. <param name="unused" type="org.apache.hadoop.metrics.MetricsContext"/>
  10417. <doc>
  10418. <![CDATA[Since this object is a registered updater, this method will be called
  10419. periodically, e.g. every 5 seconds.]]>
  10420. </doc>
  10421. </method>
  10422. <method name="resetAllMinMax"
  10423. abstract="false" native="false" synchronized="false"
  10424. static="false" final="false" visibility="public"
  10425. deprecated="not deprecated">
  10426. </method>
  10427. <field name="registry" type="org.apache.hadoop.metrics.util.MetricsRegistry"
  10428. transient="false" volatile="false"
  10429. static="false" final="false" visibility="public"
  10430. deprecated="not deprecated">
  10431. </field>
  10432. <field name="bytesWritten" type="org.apache.hadoop.metrics.util.MetricsTimeVaryingLong"
  10433. transient="false" volatile="false"
  10434. static="false" final="false" visibility="public"
  10435. deprecated="not deprecated">
  10436. </field>
  10437. <field name="bytesRead" type="org.apache.hadoop.metrics.util.MetricsTimeVaryingLong"
  10438. transient="false" volatile="false"
  10439. static="false" final="false" visibility="public"
  10440. deprecated="not deprecated">
  10441. </field>
  10442. <field name="blocksWritten" type="org.apache.hadoop.metrics.util.MetricsTimeVaryingInt"
  10443. transient="false" volatile="false"
  10444. static="false" final="false" visibility="public"
  10445. deprecated="not deprecated">
  10446. </field>
  10447. <field name="blocksRead" type="org.apache.hadoop.metrics.util.MetricsTimeVaryingInt"
  10448. transient="false" volatile="false"
  10449. static="false" final="false" visibility="public"
  10450. deprecated="not deprecated">
  10451. </field>
  10452. <field name="blocksReplicated" type="org.apache.hadoop.metrics.util.MetricsTimeVaryingInt"
  10453. transient="false" volatile="false"
  10454. static="false" final="false" visibility="public"
  10455. deprecated="not deprecated">
  10456. </field>
  10457. <field name="blocksRemoved" type="org.apache.hadoop.metrics.util.MetricsTimeVaryingInt"
  10458. transient="false" volatile="false"
  10459. static="false" final="false" visibility="public"
  10460. deprecated="not deprecated">
  10461. </field>
  10462. <field name="blocksVerified" type="org.apache.hadoop.metrics.util.MetricsTimeVaryingInt"
  10463. transient="false" volatile="false"
  10464. static="false" final="false" visibility="public"
  10465. deprecated="not deprecated">
  10466. </field>
  10467. <field name="blockVerificationFailures" type="org.apache.hadoop.metrics.util.MetricsTimeVaryingInt"
  10468. transient="false" volatile="false"
  10469. static="false" final="false" visibility="public"
  10470. deprecated="not deprecated">
  10471. </field>
  10472. <field name="readsFromLocalClient" type="org.apache.hadoop.metrics.util.MetricsTimeVaryingInt"
  10473. transient="false" volatile="false"
  10474. static="false" final="false" visibility="public"
  10475. deprecated="not deprecated">
  10476. </field>
  10477. <field name="readsFromRemoteClient" type="org.apache.hadoop.metrics.util.MetricsTimeVaryingInt"
  10478. transient="false" volatile="false"
  10479. static="false" final="false" visibility="public"
  10480. deprecated="not deprecated">
  10481. </field>
  10482. <field name="writesFromLocalClient" type="org.apache.hadoop.metrics.util.MetricsTimeVaryingInt"
  10483. transient="false" volatile="false"
  10484. static="false" final="false" visibility="public"
  10485. deprecated="not deprecated">
  10486. </field>
  10487. <field name="writesFromRemoteClient" type="org.apache.hadoop.metrics.util.MetricsTimeVaryingInt"
  10488. transient="false" volatile="false"
  10489. static="false" final="false" visibility="public"
  10490. deprecated="not deprecated">
  10491. </field>
  10492. <field name="readBlockOp" type="org.apache.hadoop.metrics.util.MetricsTimeVaryingRate"
  10493. transient="false" volatile="false"
  10494. static="false" final="false" visibility="public"
  10495. deprecated="not deprecated">
  10496. </field>
  10497. <field name="writeBlockOp" type="org.apache.hadoop.metrics.util.MetricsTimeVaryingRate"
  10498. transient="false" volatile="false"
  10499. static="false" final="false" visibility="public"
  10500. deprecated="not deprecated">
  10501. </field>
  10502. <field name="blockChecksumOp" type="org.apache.hadoop.metrics.util.MetricsTimeVaryingRate"
  10503. transient="false" volatile="false"
  10504. static="false" final="false" visibility="public"
  10505. deprecated="not deprecated">
  10506. </field>
  10507. <field name="copyBlockOp" type="org.apache.hadoop.metrics.util.MetricsTimeVaryingRate"
  10508. transient="false" volatile="false"
  10509. static="false" final="false" visibility="public"
  10510. deprecated="not deprecated">
  10511. </field>
  10512. <field name="replaceBlockOp" type="org.apache.hadoop.metrics.util.MetricsTimeVaryingRate"
  10513. transient="false" volatile="false"
  10514. static="false" final="false" visibility="public"
  10515. deprecated="not deprecated">
  10516. </field>
  10517. <field name="heartbeats" type="org.apache.hadoop.metrics.util.MetricsTimeVaryingRate"
  10518. transient="false" volatile="false"
  10519. static="false" final="false" visibility="public"
  10520. deprecated="not deprecated">
  10521. </field>
  10522. <field name="blockReports" type="org.apache.hadoop.metrics.util.MetricsTimeVaryingRate"
  10523. transient="false" volatile="false"
  10524. static="false" final="false" visibility="public"
  10525. deprecated="not deprecated">
  10526. </field>
  10527. <doc>
  10528. <![CDATA[This class is for maintaining the various DataNode statistics
  10529. and publishing them through the metrics interfaces.
  10530. This also registers the JMX MBean for RPC.
  10531. <p>
  10532. This class has a number of metrics variables that are publicly accessible;
  10533. these variables (objects) have methods to update their values;
  10534. for example:
  10535. <p> {@link #blocksRead}.inc()]]>
  10536. </doc>
  10537. </class>
  10538. <!-- end class org.apache.hadoop.hdfs.server.datanode.metrics.DataNodeMetrics -->
  10539. <!-- start interface org.apache.hadoop.hdfs.server.datanode.metrics.FSDatasetMBean -->
  10540. <interface name="FSDatasetMBean" abstract="true"
  10541. static="false" final="false" visibility="public"
  10542. deprecated="not deprecated">
  10543. <method name="getDfsUsed" return="long"
  10544. abstract="false" native="false" synchronized="false"
  10545. static="false" final="false" visibility="public"
  10546. deprecated="not deprecated">
  10547. <exception name="IOException" type="java.io.IOException"/>
  10548. <doc>
  10549. <![CDATA[Returns the total space (in bytes) used by dfs datanode
  10550. @return the total space used by dfs datanode
  10551. @throws IOException]]>
  10552. </doc>
  10553. </method>
  10554. <method name="getCapacity" return="long"
  10555. abstract="false" native="false" synchronized="false"
  10556. static="false" final="false" visibility="public"
  10557. deprecated="not deprecated">
  10558. <exception name="IOException" type="java.io.IOException"/>
  10559. <doc>
  10560. <![CDATA[Returns total capacity (in bytes) of storage (used and unused)
  10561. @return total capacity of storage (used and unused)
  10562. @throws IOException]]>
  10563. </doc>
  10564. </method>
  10565. <method name="getRemaining" return="long"
  10566. abstract="false" native="false" synchronized="false"
  10567. static="false" final="false" visibility="public"
  10568. deprecated="not deprecated">
  10569. <exception name="IOException" type="java.io.IOException"/>
  10570. <doc>
  10571. <![CDATA[Returns the amount of free storage space (in bytes)
  10572. @return The amount of free storage space
  10573. @throws IOException]]>
  10574. </doc>
  10575. </method>
  10576. <method name="getStorageInfo" return="java.lang.String"
  10577. abstract="false" native="false" synchronized="false"
  10578. static="false" final="false" visibility="public"
  10579. deprecated="not deprecated">
  10580. <doc>
  10581. <![CDATA[Returns the storage id of the underlying storage]]>
  10582. </doc>
  10583. </method>
  10584. <doc>
  10585. <![CDATA[This Interface defines the methods to get the status of a the FSDataset of
  10586. a data node.
  10587. It is also used for publishing via JMX (hence we follow the JMX naming
  10588. convention.)
  10589. * Note we have not used the MetricsDynamicMBeanBase to implement this
  10590. because the interface for the FSDatasetMBean is stable and should
  10591. be published as an interface.
  10592. <p>
  10593. Data Node runtime statistic info is report in another MBean
  10594. @see org.apache.hadoop.hdfs.server.datanode.metrics.DataNodeStatisticsMBean]]>
  10595. </doc>
  10596. </interface>
  10597. <!-- end interface org.apache.hadoop.hdfs.server.datanode.metrics.FSDatasetMBean -->
  10598. </package>
  10599. <package name="org.apache.hadoop.hdfs.server.namenode">
  10600. <!-- start class org.apache.hadoop.hdfs.server.namenode.BackupNode -->
  10601. <class name="BackupNode" extends="org.apache.hadoop.hdfs.server.namenode.NameNode"
  10602. abstract="false"
  10603. static="false" final="false" visibility="public"
  10604. deprecated="not deprecated">
  10605. <method name="getRpcServerAddress" return="java.net.InetSocketAddress"
  10606. abstract="false" native="false" synchronized="false"
  10607. static="false" final="false" visibility="protected"
  10608. deprecated="not deprecated">
  10609. <param name="conf" type="org.apache.hadoop.conf.Configuration"/>
  10610. <exception name="IOException" type="java.io.IOException"/>
  10611. </method>
  10612. <method name="setRpcServerAddress"
  10613. abstract="false" native="false" synchronized="false"
  10614. static="false" final="false" visibility="protected"
  10615. deprecated="not deprecated">
  10616. <param name="conf" type="org.apache.hadoop.conf.Configuration"/>
  10617. </method>
  10618. <method name="getHttpServerAddress" return="java.net.InetSocketAddress"
  10619. abstract="false" native="false" synchronized="false"
  10620. static="false" final="false" visibility="protected"
  10621. deprecated="not deprecated">
  10622. <param name="conf" type="org.apache.hadoop.conf.Configuration"/>
  10623. </method>
  10624. <method name="setHttpServerAddress"
  10625. abstract="false" native="false" synchronized="false"
  10626. static="false" final="false" visibility="protected"
  10627. deprecated="not deprecated">
  10628. <param name="conf" type="org.apache.hadoop.conf.Configuration"/>
  10629. </method>
  10630. <method name="loadNamesystem"
  10631. abstract="false" native="false" synchronized="false"
  10632. static="false" final="false" visibility="protected"
  10633. deprecated="not deprecated">
  10634. <param name="conf" type="org.apache.hadoop.conf.Configuration"/>
  10635. <exception name="IOException" type="java.io.IOException"/>
  10636. </method>
  10637. <method name="initialize"
  10638. abstract="false" native="false" synchronized="false"
  10639. static="false" final="false" visibility="protected"
  10640. deprecated="not deprecated">
  10641. <param name="conf" type="org.apache.hadoop.conf.Configuration"/>
  10642. <exception name="IOException" type="java.io.IOException"/>
  10643. </method>
  10644. <method name="stop"
  10645. abstract="false" native="false" synchronized="false"
  10646. static="false" final="false" visibility="public"
  10647. deprecated="not deprecated">
  10648. </method>
  10649. <method name="getBlocks" return="org.apache.hadoop.hdfs.server.protocol.BlocksWithLocations"
  10650. abstract="false" native="false" synchronized="false"
  10651. static="false" final="false" visibility="public"
  10652. deprecated="not deprecated">
  10653. <param name="datanode" type="org.apache.hadoop.hdfs.protocol.DatanodeInfo"/>
  10654. <param name="size" type="long"/>
  10655. <exception name="IOException" type="java.io.IOException"/>
  10656. </method>
  10657. <method name="register" return="org.apache.hadoop.hdfs.server.protocol.NamenodeRegistration"
  10658. abstract="false" native="false" synchronized="false"
  10659. static="false" final="false" visibility="public"
  10660. deprecated="not deprecated">
  10661. <param name="registration" type="org.apache.hadoop.hdfs.server.protocol.NamenodeRegistration"/>
  10662. <exception name="IOException" type="java.io.IOException"/>
  10663. </method>
  10664. <method name="startCheckpoint" return="org.apache.hadoop.hdfs.server.protocol.NamenodeCommand"
  10665. abstract="false" native="false" synchronized="false"
  10666. static="false" final="false" visibility="public"
  10667. deprecated="not deprecated">
  10668. <param name="registration" type="org.apache.hadoop.hdfs.server.protocol.NamenodeRegistration"/>
  10669. <exception name="IOException" type="java.io.IOException"/>
  10670. </method>
  10671. <method name="endCheckpoint"
  10672. abstract="false" native="false" synchronized="false"
  10673. static="false" final="false" visibility="public"
  10674. deprecated="not deprecated">
  10675. <param name="registration" type="org.apache.hadoop.hdfs.server.protocol.NamenodeRegistration"/>
  10676. <param name="sig" type="org.apache.hadoop.hdfs.server.namenode.CheckpointSignature"/>
  10677. <exception name="IOException" type="java.io.IOException"/>
  10678. </method>
  10679. <method name="journal"
  10680. abstract="false" native="false" synchronized="false"
  10681. static="false" final="false" visibility="public"
  10682. deprecated="not deprecated">
  10683. <param name="nnReg" type="org.apache.hadoop.hdfs.server.protocol.NamenodeRegistration"/>
  10684. <param name="jAction" type="int"/>
  10685. <param name="length" type="int"/>
  10686. <param name="args" type="byte[]"/>
  10687. <exception name="IOException" type="java.io.IOException"/>
  10688. </method>
  10689. <doc>
  10690. <![CDATA[BackupNode.
  10691. <p>
  10692. Backup node can play two roles.
  10693. <ol>
  10694. <li>{@link NamenodeRole#CHECKPOINT} node periodically creates checkpoints,
  10695. that is downloads image and edits from the active node, merges them, and
  10696. uploads the new image back to the active.</li>
  10697. <li>{@link NamenodeRole#BACKUP} node keeps its namespace in sync with the
  10698. active node, and periodically creates checkpoints by simply saving the
  10699. namespace image to local disk(s).</li>
  10700. </ol>]]>
  10701. </doc>
  10702. </class>
  10703. <!-- end class org.apache.hadoop.hdfs.server.namenode.BackupNode -->
  10704. <!-- start class org.apache.hadoop.hdfs.server.namenode.BackupStorage -->
  10705. <class name="BackupStorage" extends="org.apache.hadoop.hdfs.server.namenode.FSImage"
  10706. abstract="false"
  10707. static="false" final="false" visibility="public"
  10708. deprecated="not deprecated">
  10709. <method name="isConversionNeeded" return="boolean"
  10710. abstract="false" native="false" synchronized="false"
  10711. static="false" final="false" visibility="public"
  10712. deprecated="not deprecated">
  10713. <param name="sd" type="org.apache.hadoop.hdfs.server.common.Storage.StorageDirectory"/>
  10714. </method>
  10715. </class>
  10716. <!-- end class org.apache.hadoop.hdfs.server.namenode.BackupStorage -->
  10717. <!-- start class org.apache.hadoop.hdfs.server.namenode.BlockManager -->
  10718. <class name="BlockManager" extends="java.lang.Object"
  10719. abstract="false"
  10720. static="false" final="false" visibility="public"
  10721. deprecated="not deprecated">
  10722. <method name="processReport"
  10723. abstract="false" native="false" synchronized="false"
  10724. static="false" final="false" visibility="public"
  10725. deprecated="not deprecated">
  10726. <param name="node" type="org.apache.hadoop.hdfs.server.namenode.DatanodeDescriptor"/>
  10727. <param name="report" type="org.apache.hadoop.hdfs.protocol.BlockListAsLongs"/>
  10728. <exception name="IOException" type="java.io.IOException"/>
  10729. <doc>
  10730. <![CDATA[The given node is reporting all its blocks. Use this info to
  10731. update the (machine-->blocklist) and (block-->machinelist) tables.]]>
  10732. </doc>
  10733. </method>
  10734. <field name="DEFAULT_INITIAL_MAP_CAPACITY" type="int"
  10735. transient="false" volatile="false"
  10736. static="true" final="true" visibility="public"
  10737. deprecated="not deprecated">
  10738. </field>
  10739. <field name="DEFAULT_MAP_LOAD_FACTOR" type="float"
  10740. transient="false" volatile="false"
  10741. static="true" final="true" visibility="public"
  10742. deprecated="not deprecated">
  10743. </field>
  10744. <field name="DEFAULT_MAX_CORRUPT_FILES_RETURNED" type="int"
  10745. transient="false" volatile="false"
  10746. static="true" final="true" visibility="public"
  10747. deprecated="not deprecated">
  10748. </field>
  10749. <doc>
  10750. <![CDATA[Keeps information related to the blocks stored in the Hadoop cluster.
  10751. This class is a helper class for {@link FSNamesystem} and requires several
  10752. methods to be called with lock held on {@link FSNamesystem}.]]>
  10753. </doc>
  10754. </class>
  10755. <!-- end class org.apache.hadoop.hdfs.server.namenode.BlockManager -->
  10756. <!-- start class org.apache.hadoop.hdfs.server.namenode.BlockPlacementPolicy -->
  10757. <class name="BlockPlacementPolicy" extends="java.lang.Object"
  10758. abstract="true"
  10759. static="false" final="false" visibility="public"
  10760. deprecated="not deprecated">
  10761. <constructor name="BlockPlacementPolicy"
  10762. static="false" final="false" visibility="public"
  10763. deprecated="not deprecated">
  10764. </constructor>
  10765. <method name="verifyBlockPlacement" return="int"
  10766. abstract="true" native="false" synchronized="false"
  10767. static="false" final="false" visibility="public"
  10768. deprecated="not deprecated">
  10769. <param name="srcPath" type="java.lang.String"/>
  10770. <param name="lBlk" type="org.apache.hadoop.hdfs.protocol.LocatedBlock"/>
  10771. <param name="minRacks" type="int"/>
  10772. <doc>
  10773. <![CDATA[Verify that the block is replicated on at least minRacks different racks
  10774. if there is more than minRacks rack in the system.
  10775. @param srcPath the full pathname of the file to be verified
  10776. @param lBlk block with locations
  10777. @param minRacks number of racks the block should be replicated to
  10778. @return the difference between the required and the actual number of racks
  10779. the block is replicated to.]]>
  10780. </doc>
  10781. </method>
  10782. <method name="chooseReplicaToDelete" return="org.apache.hadoop.hdfs.server.namenode.DatanodeDescriptor"
  10783. abstract="true" native="false" synchronized="false"
  10784. static="false" final="false" visibility="public"
  10785. deprecated="not deprecated">
  10786. <param name="srcInode" type="org.apache.hadoop.hdfs.server.namenode.FSInodeInfo"/>
  10787. <param name="block" type="org.apache.hadoop.hdfs.protocol.Block"/>
  10788. <param name="replicationFactor" type="short"/>
  10789. <param name="existingReplicas" type="java.util.Collection"/>
  10790. <param name="moreExistingReplicas" type="java.util.Collection"/>
  10791. <doc>
  10792. <![CDATA[Decide whether deleting the specified replica of the block still makes
  10793. the block conform to the configured block placement policy.
  10794. @param srcInode The inode of the file to which the block-to-be-deleted belongs
  10795. @param block The block to be deleted
  10796. @param replicationFactor The required number of replicas for this block
  10797. @param existingReplicas The replica locations of this block that are present
  10798. on at least two unique racks.
  10799. @param moreExistingReplicas Replica locations of this block that are not
  10800. listed in the previous parameter.
  10801. @return the replica that is the best candidate for deletion]]>
  10802. </doc>
  10803. </method>
  10804. <method name="initialize"
  10805. abstract="true" native="false" synchronized="false"
  10806. static="false" final="false" visibility="protected"
  10807. deprecated="not deprecated">
  10808. <param name="conf" type="org.apache.hadoop.conf.Configuration"/>
  10809. <param name="stats" type="org.apache.hadoop.hdfs.server.namenode.FSClusterStats"/>
  10810. <param name="clusterMap" type="org.apache.hadoop.net.NetworkTopology"/>
  10811. <doc>
  10812. <![CDATA[Used to setup a BlockPlacementPolicy object. This should be defined by
  10813. all implementations of a BlockPlacementPolicy.
  10814. @param conf the configuration object
  10815. @param stats retrieve cluster status from here
  10816. @param clusterMap cluster topology]]>
  10817. </doc>
  10818. </method>
  10819. <method name="getInstance" return="org.apache.hadoop.hdfs.server.namenode.BlockPlacementPolicy"
  10820. abstract="false" native="false" synchronized="false"
  10821. static="true" final="false" visibility="public"
  10822. deprecated="not deprecated">
  10823. <param name="conf" type="org.apache.hadoop.conf.Configuration"/>
  10824. <param name="stats" type="org.apache.hadoop.hdfs.server.namenode.FSClusterStats"/>
  10825. <param name="clusterMap" type="org.apache.hadoop.net.NetworkTopology"/>
  10826. <doc>
  10827. <![CDATA[Get an instance of the configured Block Placement Policy based on the
  10828. value of the configuration paramater dfs.block.replicator.classname.
  10829. @param conf the configuration to be used
  10830. @param stats an object thatis used to retrieve the load on the cluster
  10831. @param clusterMap the network topology of the cluster
  10832. @return an instance of BlockPlacementPolicy]]>
  10833. </doc>
  10834. </method>
  10835. <doc>
  10836. <![CDATA[This interface is used for choosing the desired number of targets
  10837. for placing block replicas.]]>
  10838. </doc>
  10839. </class>
  10840. <!-- end class org.apache.hadoop.hdfs.server.namenode.BlockPlacementPolicy -->
  10841. <!-- start class org.apache.hadoop.hdfs.server.namenode.BlockPlacementPolicy.NotEnoughReplicasException -->
  10842. <class name="BlockPlacementPolicy.NotEnoughReplicasException" extends="java.lang.Exception"
  10843. abstract="false"
  10844. static="true" final="false" visibility="public"
  10845. deprecated="not deprecated">
  10846. </class>
  10847. <!-- end class org.apache.hadoop.hdfs.server.namenode.BlockPlacementPolicy.NotEnoughReplicasException -->
  10848. <!-- start class org.apache.hadoop.hdfs.server.namenode.BlockPlacementPolicyDefault -->
  10849. <class name="BlockPlacementPolicyDefault" extends="org.apache.hadoop.hdfs.server.namenode.BlockPlacementPolicy"
  10850. abstract="false"
  10851. static="false" final="false" visibility="public"
  10852. deprecated="not deprecated">
  10853. <method name="initialize"
  10854. abstract="false" native="false" synchronized="false"
  10855. static="false" final="false" visibility="public"
  10856. deprecated="not deprecated">
  10857. <param name="conf" type="org.apache.hadoop.conf.Configuration"/>
  10858. <param name="stats" type="org.apache.hadoop.hdfs.server.namenode.FSClusterStats"/>
  10859. <param name="clusterMap" type="org.apache.hadoop.net.NetworkTopology"/>
  10860. <doc>
  10861. <![CDATA[{@inheritDoc}]]>
  10862. </doc>
  10863. </method>
  10864. <method name="chooseTarget" return="org.apache.hadoop.hdfs.server.namenode.DatanodeDescriptor[]"
  10865. abstract="false" native="false" synchronized="false"
  10866. static="false" final="false" visibility="public"
  10867. deprecated="not deprecated">
  10868. <param name="srcPath" type="java.lang.String"/>
  10869. <param name="numOfReplicas" type="int"/>
  10870. <param name="writer" type="org.apache.hadoop.hdfs.server.namenode.DatanodeDescriptor"/>
  10871. <param name="chosenNodes" type="java.util.List"/>
  10872. <param name="blocksize" type="long"/>
  10873. <doc>
  10874. <![CDATA[{@inheritDoc}]]>
  10875. </doc>
  10876. </method>
  10877. <method name="chooseTarget" return="org.apache.hadoop.hdfs.server.namenode.DatanodeDescriptor[]"
  10878. abstract="false" native="false" synchronized="false"
  10879. static="false" final="false" visibility="public"
  10880. deprecated="not deprecated">
  10881. <param name="srcPath" type="java.lang.String"/>
  10882. <param name="numOfReplicas" type="int"/>
  10883. <param name="writer" type="org.apache.hadoop.hdfs.server.namenode.DatanodeDescriptor"/>
  10884. <param name="chosenNodes" type="java.util.List"/>
  10885. <param name="excludedNodes" type="java.util.HashMap"/>
  10886. <param name="blocksize" type="long"/>
  10887. <doc>
  10888. <![CDATA[{@inheritDoc}]]>
  10889. </doc>
  10890. </method>
  10891. <method name="chooseTarget" return="org.apache.hadoop.hdfs.server.namenode.DatanodeDescriptor[]"
  10892. abstract="false" native="false" synchronized="false"
  10893. static="false" final="false" visibility="public"
  10894. deprecated="not deprecated">
  10895. <param name="srcInode" type="org.apache.hadoop.hdfs.server.namenode.FSInodeInfo"/>
  10896. <param name="numOfReplicas" type="int"/>
  10897. <param name="writer" type="org.apache.hadoop.hdfs.server.namenode.DatanodeDescriptor"/>
  10898. <param name="chosenNodes" type="java.util.List"/>
  10899. <param name="blocksize" type="long"/>
  10900. <doc>
  10901. <![CDATA[{@inheritDoc}]]>
  10902. </doc>
  10903. </method>
  10904. <method name="verifyBlockPlacement" return="int"
  10905. abstract="false" native="false" synchronized="false"
  10906. static="false" final="false" visibility="public"
  10907. deprecated="not deprecated">
  10908. <param name="srcPath" type="java.lang.String"/>
  10909. <param name="lBlk" type="org.apache.hadoop.hdfs.protocol.LocatedBlock"/>
  10910. <param name="minRacks" type="int"/>
  10911. <doc>
  10912. <![CDATA[{@inheritDoc}]]>
  10913. </doc>
  10914. </method>
  10915. <method name="chooseReplicaToDelete" return="org.apache.hadoop.hdfs.server.namenode.DatanodeDescriptor"
  10916. abstract="false" native="false" synchronized="false"
  10917. static="false" final="false" visibility="public"
  10918. deprecated="not deprecated">
  10919. <param name="inode" type="org.apache.hadoop.hdfs.server.namenode.FSInodeInfo"/>
  10920. <param name="block" type="org.apache.hadoop.hdfs.protocol.Block"/>
  10921. <param name="replicationFactor" type="short"/>
  10922. <param name="first" type="java.util.Collection"/>
  10923. <param name="second" type="java.util.Collection"/>
  10924. <doc>
  10925. <![CDATA[{@inheritDoc}]]>
  10926. </doc>
  10927. </method>
  10928. <doc>
  10929. <![CDATA[The class is responsible for choosing the desired number of targets
  10930. for placing block replicas.
  10931. The replica placement strategy is that if the writer is on a datanode,
  10932. the 1st replica is placed on the local machine,
  10933. otherwise a random datanode. The 2nd replica is placed on a datanode
  10934. that is on a different rack. The 3rd replica is placed on a datanode
  10935. which is on a different node of the rack as the second replica.]]>
  10936. </doc>
  10937. </class>
  10938. <!-- end class org.apache.hadoop.hdfs.server.namenode.BlockPlacementPolicyDefault -->
  10939. <!-- start class org.apache.hadoop.hdfs.server.namenode.CheckpointSignature -->
  10940. <class name="CheckpointSignature" extends="org.apache.hadoop.hdfs.server.common.StorageInfo"
  10941. abstract="false"
  10942. static="false" final="false" visibility="public"
  10943. deprecated="not deprecated">
  10944. <implements name="org.apache.hadoop.io.WritableComparable"/>
  10945. <constructor name="CheckpointSignature"
  10946. static="false" final="false" visibility="public"
  10947. deprecated="not deprecated">
  10948. </constructor>
  10949. <method name="toString" return="java.lang.String"
  10950. abstract="false" native="false" synchronized="false"
  10951. static="false" final="false" visibility="public"
  10952. deprecated="not deprecated">
  10953. </method>
  10954. <method name="compareTo" return="int"
  10955. abstract="false" native="false" synchronized="false"
  10956. static="false" final="false" visibility="public"
  10957. deprecated="not deprecated">
  10958. <param name="o" type="org.apache.hadoop.hdfs.server.namenode.CheckpointSignature"/>
  10959. </method>
  10960. <method name="equals" return="boolean"
  10961. abstract="false" native="false" synchronized="false"
  10962. static="false" final="false" visibility="public"
  10963. deprecated="not deprecated">
  10964. <param name="o" type="java.lang.Object"/>
  10965. </method>
  10966. <method name="hashCode" return="int"
  10967. abstract="false" native="false" synchronized="false"
  10968. static="false" final="false" visibility="public"
  10969. deprecated="not deprecated">
  10970. </method>
  10971. <method name="write"
  10972. abstract="false" native="false" synchronized="false"
  10973. static="false" final="false" visibility="public"
  10974. deprecated="not deprecated">
  10975. <param name="out" type="java.io.DataOutput"/>
  10976. <exception name="IOException" type="java.io.IOException"/>
  10977. </method>
  10978. <method name="readFields"
  10979. abstract="false" native="false" synchronized="false"
  10980. static="false" final="false" visibility="public"
  10981. deprecated="not deprecated">
  10982. <param name="in" type="java.io.DataInput"/>
  10983. <exception name="IOException" type="java.io.IOException"/>
  10984. </method>
  10985. <doc>
  10986. <![CDATA[A unique signature intended to identify checkpoint transactions.]]>
  10987. </doc>
  10988. </class>
  10989. <!-- end class org.apache.hadoop.hdfs.server.namenode.CheckpointSignature -->
  10990. <!-- start class org.apache.hadoop.hdfs.server.namenode.ContentSummaryServlet -->
  10991. <class name="ContentSummaryServlet" extends="org.apache.hadoop.hdfs.server.namenode.DfsServlet"
  10992. abstract="false"
  10993. static="false" final="false" visibility="public"
  10994. deprecated="not deprecated">
  10995. <constructor name="ContentSummaryServlet"
  10996. static="false" final="false" visibility="public"
  10997. deprecated="not deprecated">
  10998. </constructor>
  10999. <method name="doGet"
  11000. abstract="false" native="false" synchronized="false"
  11001. static="false" final="false" visibility="public"
  11002. deprecated="not deprecated">
  11003. <param name="request" type="javax.servlet.http.HttpServletRequest"/>
  11004. <param name="response" type="javax.servlet.http.HttpServletResponse"/>
  11005. <exception name="ServletException" type="javax.servlet.ServletException"/>
  11006. <exception name="IOException" type="java.io.IOException"/>
  11007. <doc>
  11008. <![CDATA[{@inheritDoc}]]>
  11009. </doc>
  11010. </method>
  11011. <doc>
  11012. <![CDATA[Servlets for file checksum]]>
  11013. </doc>
  11014. </class>
  11015. <!-- end class org.apache.hadoop.hdfs.server.namenode.ContentSummaryServlet -->
  11016. <!-- start class org.apache.hadoop.hdfs.server.namenode.CorruptReplicasMap -->
  11017. <class name="CorruptReplicasMap" extends="java.lang.Object"
  11018. abstract="false"
  11019. static="false" final="false" visibility="public"
  11020. deprecated="not deprecated">
  11021. <constructor name="CorruptReplicasMap"
  11022. static="false" final="false" visibility="public"
  11023. deprecated="not deprecated">
  11024. </constructor>
  11025. <method name="addToCorruptReplicasMap"
  11026. abstract="false" native="false" synchronized="false"
  11027. static="false" final="false" visibility="public"
  11028. deprecated="not deprecated">
  11029. <param name="blk" type="org.apache.hadoop.hdfs.protocol.Block"/>
  11030. <param name="dn" type="org.apache.hadoop.hdfs.server.namenode.DatanodeDescriptor"/>
  11031. <doc>
  11032. <![CDATA[Mark the block belonging to datanode as corrupt.
  11033. @param blk Block to be added to CorruptReplicasMap
  11034. @param dn DatanodeDescriptor which holds the corrupt replica]]>
  11035. </doc>
  11036. </method>
  11037. <method name="numCorruptReplicas" return="int"
  11038. abstract="false" native="false" synchronized="false"
  11039. static="false" final="false" visibility="public"
  11040. deprecated="not deprecated">
  11041. <param name="blk" type="org.apache.hadoop.hdfs.protocol.Block"/>
  11042. </method>
  11043. <method name="size" return="int"
  11044. abstract="false" native="false" synchronized="false"
  11045. static="false" final="false" visibility="public"
  11046. deprecated="not deprecated">
  11047. </method>
  11048. <doc>
  11049. <![CDATA[Stores information about all corrupt blocks in the File System.
  11050. A Block is considered corrupt only if all of its replicas are
  11051. corrupt. While reporting replicas of a Block, we hide any corrupt
  11052. copies. These copies are removed once Block is found to have
  11053. expected number of good replicas.
  11054. Mapping: Block -> TreeSet<DatanodeDescriptor>]]>
  11055. </doc>
  11056. </class>
  11057. <!-- end class org.apache.hadoop.hdfs.server.namenode.CorruptReplicasMap -->
  11058. <!-- start class org.apache.hadoop.hdfs.server.namenode.DatanodeDescriptor -->
  11059. <class name="DatanodeDescriptor" extends="org.apache.hadoop.hdfs.protocol.DatanodeInfo"
  11060. abstract="false"
  11061. static="false" final="false" visibility="public"
  11062. deprecated="not deprecated">
  11063. <constructor name="DatanodeDescriptor"
  11064. static="false" final="false" visibility="public"
  11065. deprecated="not deprecated">
  11066. <doc>
  11067. <![CDATA[Default constructor]]>
  11068. </doc>
  11069. </constructor>
  11070. <constructor name="DatanodeDescriptor" type="org.apache.hadoop.hdfs.protocol.DatanodeID"
  11071. static="false" final="false" visibility="public"
  11072. deprecated="not deprecated">
  11073. <doc>
  11074. <![CDATA[DatanodeDescriptor constructor
  11075. @param nodeID id of the data node]]>
  11076. </doc>
  11077. </constructor>
  11078. <constructor name="DatanodeDescriptor" type="org.apache.hadoop.hdfs.protocol.DatanodeID, java.lang.String"
  11079. static="false" final="false" visibility="public"
  11080. deprecated="not deprecated">
  11081. <doc>
  11082. <![CDATA[DatanodeDescriptor constructor
  11083. @param nodeID id of the data node
  11084. @param networkLocation location of the data node in network]]>
  11085. </doc>
  11086. </constructor>
  11087. <constructor name="DatanodeDescriptor" type="org.apache.hadoop.hdfs.protocol.DatanodeID, java.lang.String, java.lang.String"
  11088. static="false" final="false" visibility="public"
  11089. deprecated="not deprecated">
  11090. <doc>
  11091. <![CDATA[DatanodeDescriptor constructor
  11092. @param nodeID id of the data node
  11093. @param networkLocation location of the data node in network
  11094. @param hostName it could be different from host specified for DatanodeID]]>
  11095. </doc>
  11096. </constructor>
  11097. <constructor name="DatanodeDescriptor" type="org.apache.hadoop.hdfs.protocol.DatanodeID, long, long, long, int"
  11098. static="false" final="false" visibility="public"
  11099. deprecated="not deprecated">
  11100. <doc>
  11101. <![CDATA[DatanodeDescriptor constructor
  11102. @param nodeID id of the data node
  11103. @param capacity capacity of the data node
  11104. @param dfsUsed space used by the data node
  11105. @param remaining remaing capacity of the data node
  11106. @param xceiverCount # of data transfers at the data node]]>
  11107. </doc>
  11108. </constructor>
  11109. <constructor name="DatanodeDescriptor" type="org.apache.hadoop.hdfs.protocol.DatanodeID, java.lang.String, java.lang.String, long, long, long, int"
  11110. static="false" final="false" visibility="public"
  11111. deprecated="not deprecated">
  11112. <doc>
  11113. <![CDATA[DatanodeDescriptor constructor
  11114. @param nodeID id of the data node
  11115. @param networkLocation location of the data node in network
  11116. @param capacity capacity of the data node, including space used by non-dfs
  11117. @param dfsUsed the used space by dfs datanode
  11118. @param remaining remaining capacity of the data node
  11119. @param xceiverCount # of data transfers at the data node]]>
  11120. </doc>
  11121. </constructor>
  11122. <method name="numBlocks" return="int"
  11123. abstract="false" native="false" synchronized="false"
  11124. static="false" final="false" visibility="public"
  11125. deprecated="not deprecated">
  11126. </method>
  11127. <method name="getBlocksScheduled" return="int"
  11128. abstract="false" native="false" synchronized="false"
  11129. static="false" final="false" visibility="public"
  11130. deprecated="not deprecated">
  11131. <doc>
  11132. <![CDATA[@return Approximate number of blocks currently scheduled to be written
  11133. to this datanode.]]>
  11134. </doc>
  11135. </method>
  11136. <method name="hashCode" return="int"
  11137. abstract="false" native="false" synchronized="false"
  11138. static="false" final="false" visibility="public"
  11139. deprecated="not deprecated">
  11140. </method>
  11141. <method name="equals" return="boolean"
  11142. abstract="false" native="false" synchronized="false"
  11143. static="false" final="false" visibility="public"
  11144. deprecated="not deprecated">
  11145. <param name="obj" type="java.lang.Object"/>
  11146. </method>
  11147. <field name="isAlive" type="boolean"
  11148. transient="false" volatile="false"
  11149. static="false" final="false" visibility="protected"
  11150. deprecated="not deprecated">
  11151. </field>
  11152. <field name="needKeyUpdate" type="boolean"
  11153. transient="false" volatile="false"
  11154. static="false" final="false" visibility="protected"
  11155. deprecated="not deprecated">
  11156. </field>
  11157. <doc>
  11158. <![CDATA[DatanodeDescriptor tracks stats on a given DataNode,
  11159. such as available storage capacity, last update time, etc.,
  11160. and maintains a set of blocks stored on the datanode.
  11161. This data structure is a data structure that is internal
  11162. to the namenode. It is *not* sent over-the-wire to the Client
  11163. or the Datnodes. Neither is it stored persistently in the
  11164. fsImage.]]>
  11165. </doc>
  11166. </class>
  11167. <!-- end class org.apache.hadoop.hdfs.server.namenode.DatanodeDescriptor -->
  11168. <!-- start class org.apache.hadoop.hdfs.server.namenode.DatanodeDescriptor.BlockTargetPair -->
  11169. <class name="DatanodeDescriptor.BlockTargetPair" extends="java.lang.Object"
  11170. abstract="false"
  11171. static="true" final="false" visibility="public"
  11172. deprecated="not deprecated">
  11173. <field name="block" type="org.apache.hadoop.hdfs.protocol.Block"
  11174. transient="false" volatile="false"
  11175. static="false" final="true" visibility="public"
  11176. deprecated="not deprecated">
  11177. </field>
  11178. <field name="targets" type="org.apache.hadoop.hdfs.server.namenode.DatanodeDescriptor[]"
  11179. transient="false" volatile="false"
  11180. static="false" final="true" visibility="public"
  11181. deprecated="not deprecated">
  11182. </field>
  11183. <doc>
  11184. <![CDATA[Block and targets pair]]>
  11185. </doc>
  11186. </class>
  11187. <!-- end class org.apache.hadoop.hdfs.server.namenode.DatanodeDescriptor.BlockTargetPair -->
  11188. <!-- start class org.apache.hadoop.hdfs.server.namenode.DelegationTokenServlet -->
  11189. <class name="DelegationTokenServlet" extends="org.apache.hadoop.hdfs.server.namenode.DfsServlet"
  11190. abstract="false"
  11191. static="false" final="false" visibility="public"
  11192. deprecated="not deprecated">
  11193. <constructor name="DelegationTokenServlet"
  11194. static="false" final="false" visibility="public"
  11195. deprecated="not deprecated">
  11196. </constructor>
  11197. <method name="doGet"
  11198. abstract="false" native="false" synchronized="false"
  11199. static="false" final="false" visibility="protected"
  11200. deprecated="not deprecated">
  11201. <param name="req" type="javax.servlet.http.HttpServletRequest"/>
  11202. <param name="resp" type="javax.servlet.http.HttpServletResponse"/>
  11203. <exception name="ServletException" type="javax.servlet.ServletException"/>
  11204. <exception name="IOException" type="java.io.IOException"/>
  11205. </method>
  11206. <field name="PATH_SPEC" type="java.lang.String"
  11207. transient="false" volatile="false"
  11208. static="true" final="true" visibility="public"
  11209. deprecated="not deprecated">
  11210. </field>
  11211. <doc>
  11212. <![CDATA[Serve delegation tokens over http for use in hftp.]]>
  11213. </doc>
  11214. </class>
  11215. <!-- end class org.apache.hadoop.hdfs.server.namenode.DelegationTokenServlet -->
  11216. <!-- start class org.apache.hadoop.hdfs.server.namenode.FileChecksumServlets -->
  11217. <class name="FileChecksumServlets" extends="java.lang.Object"
  11218. abstract="false"
  11219. static="false" final="false" visibility="public"
  11220. deprecated="not deprecated">
  11221. <constructor name="FileChecksumServlets"
  11222. static="false" final="false" visibility="public"
  11223. deprecated="not deprecated">
  11224. </constructor>
  11225. <doc>
  11226. <![CDATA[Servlets for file checksum]]>
  11227. </doc>
  11228. </class>
  11229. <!-- end class org.apache.hadoop.hdfs.server.namenode.FileChecksumServlets -->
  11230. <!-- start class org.apache.hadoop.hdfs.server.namenode.FileChecksumServlets.GetServlet -->
  11231. <class name="FileChecksumServlets.GetServlet" extends="org.apache.hadoop.hdfs.server.namenode.DfsServlet"
  11232. abstract="false"
  11233. static="true" final="false" visibility="public"
  11234. deprecated="not deprecated">
  11235. <constructor name="FileChecksumServlets.GetServlet"
  11236. static="false" final="false" visibility="public"
  11237. deprecated="not deprecated">
  11238. </constructor>
  11239. <method name="doGet"
  11240. abstract="false" native="false" synchronized="false"
  11241. static="false" final="false" visibility="public"
  11242. deprecated="not deprecated">
  11243. <param name="request" type="javax.servlet.http.HttpServletRequest"/>
  11244. <param name="response" type="javax.servlet.http.HttpServletResponse"/>
  11245. <exception name="ServletException" type="javax.servlet.ServletException"/>
  11246. <exception name="IOException" type="java.io.IOException"/>
  11247. <doc>
  11248. <![CDATA[{@inheritDoc}]]>
  11249. </doc>
  11250. </method>
  11251. <doc>
  11252. <![CDATA[Get FileChecksum]]>
  11253. </doc>
  11254. </class>
  11255. <!-- end class org.apache.hadoop.hdfs.server.namenode.FileChecksumServlets.GetServlet -->
  11256. <!-- start class org.apache.hadoop.hdfs.server.namenode.FileChecksumServlets.RedirectServlet -->
  11257. <class name="FileChecksumServlets.RedirectServlet" extends="org.apache.hadoop.hdfs.server.namenode.DfsServlet"
  11258. abstract="false"
  11259. static="true" final="false" visibility="public"
  11260. deprecated="not deprecated">
  11261. <constructor name="FileChecksumServlets.RedirectServlet"
  11262. static="false" final="false" visibility="public"
  11263. deprecated="not deprecated">
  11264. </constructor>
  11265. <method name="doGet"
  11266. abstract="false" native="false" synchronized="false"
  11267. static="false" final="false" visibility="public"
  11268. deprecated="not deprecated">
  11269. <param name="request" type="javax.servlet.http.HttpServletRequest"/>
  11270. <param name="response" type="javax.servlet.http.HttpServletResponse"/>
  11271. <exception name="ServletException" type="javax.servlet.ServletException"/>
  11272. <exception name="IOException" type="java.io.IOException"/>
  11273. <doc>
  11274. <![CDATA[{@inheritDoc}]]>
  11275. </doc>
  11276. </method>
  11277. <doc>
  11278. <![CDATA[Redirect file checksum queries to an appropriate datanode.]]>
  11279. </doc>
  11280. </class>
  11281. <!-- end class org.apache.hadoop.hdfs.server.namenode.FileChecksumServlets.RedirectServlet -->
  11282. <!-- start class org.apache.hadoop.hdfs.server.namenode.FileDataServlet -->
  11283. <class name="FileDataServlet" extends="org.apache.hadoop.hdfs.server.namenode.DfsServlet"
  11284. abstract="false"
  11285. static="false" final="false" visibility="public"
  11286. deprecated="not deprecated">
  11287. <constructor name="FileDataServlet"
  11288. static="false" final="false" visibility="public"
  11289. deprecated="not deprecated">
  11290. </constructor>
  11291. <method name="createUri" return="java.net.URI"
  11292. abstract="false" native="false" synchronized="false"
  11293. static="false" final="false" visibility="protected"
  11294. deprecated="not deprecated">
  11295. <param name="parent" type="java.lang.String"/>
  11296. <param name="i" type="org.apache.hadoop.hdfs.protocol.HdfsFileStatus"/>
  11297. <param name="ugi" type="org.apache.hadoop.security.UserGroupInformation"/>
  11298. <param name="nnproxy" type="org.apache.hadoop.hdfs.protocol.ClientProtocol"/>
  11299. <param name="request" type="javax.servlet.http.HttpServletRequest"/>
  11300. <exception name="IOException" type="java.io.IOException"/>
  11301. <exception name="URISyntaxException" type="java.net.URISyntaxException"/>
  11302. <doc>
  11303. <![CDATA[Create a redirection URI]]>
  11304. </doc>
  11305. </method>
  11306. <method name="doGet"
  11307. abstract="false" native="false" synchronized="false"
  11308. static="false" final="false" visibility="public"
  11309. deprecated="not deprecated">
  11310. <param name="request" type="javax.servlet.http.HttpServletRequest"/>
  11311. <param name="response" type="javax.servlet.http.HttpServletResponse"/>
  11312. <exception name="IOException" type="java.io.IOException"/>
  11313. <doc>
  11314. <![CDATA[Service a GET request as described below.
  11315. Request:
  11316. {@code
  11317. GET http://<nn>:<port>/data[/<path>] HTTP/1.1
  11318. }]]>
  11319. </doc>
  11320. </method>
  11321. <doc>
  11322. <![CDATA[Redirect queries about the hosted filesystem to an appropriate datanode.
  11323. @see org.apache.hadoop.hdfs.HftpFileSystem]]>
  11324. </doc>
  11325. </class>
  11326. <!-- end class org.apache.hadoop.hdfs.server.namenode.FileDataServlet -->
  11327. <!-- start class org.apache.hadoop.hdfs.server.namenode.FsckServlet -->
  11328. <class name="FsckServlet" extends="org.apache.hadoop.hdfs.server.namenode.DfsServlet"
  11329. abstract="false"
  11330. static="false" final="false" visibility="public"
  11331. deprecated="not deprecated">
  11332. <constructor name="FsckServlet"
  11333. static="false" final="false" visibility="public"
  11334. deprecated="not deprecated">
  11335. </constructor>
  11336. <method name="doGet"
  11337. abstract="false" native="false" synchronized="false"
  11338. static="false" final="false" visibility="public"
  11339. deprecated="not deprecated">
  11340. <param name="request" type="javax.servlet.http.HttpServletRequest"/>
  11341. <param name="response" type="javax.servlet.http.HttpServletResponse"/>
  11342. <exception name="IOException" type="java.io.IOException"/>
  11343. <doc>
  11344. <![CDATA[Handle fsck request]]>
  11345. </doc>
  11346. </method>
  11347. <doc>
  11348. <![CDATA[This class is used in Namesystem's web server to do fsck on namenode.]]>
  11349. </doc>
  11350. </class>
  11351. <!-- end class org.apache.hadoop.hdfs.server.namenode.FsckServlet -->
  11352. <!-- start interface org.apache.hadoop.hdfs.server.namenode.FSClusterStats -->
  11353. <interface name="FSClusterStats" abstract="true"
  11354. static="false" final="false" visibility="public"
  11355. deprecated="not deprecated">
  11356. <method name="getTotalLoad" return="int"
  11357. abstract="false" native="false" synchronized="false"
  11358. static="false" final="false" visibility="public"
  11359. deprecated="not deprecated">
  11360. <doc>
  11361. <![CDATA[an indication of the total load of the cluster.
  11362. @return a count of the total number of block transfers and block
  11363. writes that are currently occuring on the cluster.]]>
  11364. </doc>
  11365. </method>
  11366. <doc>
  11367. <![CDATA[This interface is used for retrieving the load related statistics of
  11368. the cluster.]]>
  11369. </doc>
  11370. </interface>
  11371. <!-- end interface org.apache.hadoop.hdfs.server.namenode.FSClusterStats -->
  11372. <!-- start class org.apache.hadoop.hdfs.server.namenode.FSEditLog -->
  11373. <class name="FSEditLog" extends="java.lang.Object"
  11374. abstract="false"
  11375. static="false" final="false" visibility="public"
  11376. deprecated="not deprecated">
  11377. <method name="logSync"
  11378. abstract="false" native="false" synchronized="false"
  11379. static="false" final="false" visibility="public"
  11380. deprecated="not deprecated">
  11381. <exception name="IOException" type="java.io.IOException"/>
  11382. <doc>
  11383. <![CDATA[Sync all modifications done by this thread.
  11384. The internal concurrency design of this class is as follows:
  11385. - Log items are written synchronized into an in-memory buffer,
  11386. and each assigned a transaction ID.
  11387. - When a thread (client) would like to sync all of its edits, logSync()
  11388. uses a ThreadLocal transaction ID to determine what edit number must
  11389. be synced to.
  11390. - The isSyncRunning volatile boolean tracks whether a sync is currently
  11391. under progress.
  11392. The data is double-buffered within each edit log implementation so that
  11393. in-memory writing can occur in parallel with the on-disk writing.
  11394. Each sync occurs in three steps:
  11395. 1. synchronized, it swaps the double buffer and sets the isSyncRunning
  11396. flag.
  11397. 2. unsynchronized, it flushes the data to storage
  11398. 3. synchronized, it resets the flag and notifies anyone waiting on the
  11399. sync.
  11400. The lack of synchronization on step 2 allows other threads to continue
  11401. to write into the memory buffer while the sync is in progress.
  11402. Because this step is unsynchronized, actions that need to avoid
  11403. concurrency with sync() should be synchronized and also call
  11404. waitForSyncToFinish() before assuming they are running alone.]]>
  11405. </doc>
  11406. </method>
  11407. <method name="logOpenFile"
  11408. abstract="false" native="false" synchronized="false"
  11409. static="false" final="false" visibility="public"
  11410. deprecated="not deprecated">
  11411. <param name="path" type="java.lang.String"/>
  11412. <param name="newNode" type="org.apache.hadoop.hdfs.server.namenode.INodeFileUnderConstruction"/>
  11413. <doc>
  11414. <![CDATA[Add open lease record to edit log.
  11415. Records the block locations of the last block.]]>
  11416. </doc>
  11417. </method>
  11418. <method name="logCloseFile"
  11419. abstract="false" native="false" synchronized="false"
  11420. static="false" final="false" visibility="public"
  11421. deprecated="not deprecated">
  11422. <param name="path" type="java.lang.String"/>
  11423. <param name="newNode" type="org.apache.hadoop.hdfs.server.namenode.INodeFile"/>
  11424. <doc>
  11425. <![CDATA[Add close lease record to edit log.]]>
  11426. </doc>
  11427. </method>
  11428. <method name="logMkDir"
  11429. abstract="false" native="false" synchronized="false"
  11430. static="false" final="false" visibility="public"
  11431. deprecated="not deprecated">
  11432. <param name="path" type="java.lang.String"/>
  11433. <param name="newNode" type="org.apache.hadoop.hdfs.server.namenode.INode"/>
  11434. <doc>
  11435. <![CDATA[Add create directory record to edit log]]>
  11436. </doc>
  11437. </method>
  11438. <method name="setBufferCapacity"
  11439. abstract="false" native="false" synchronized="false"
  11440. static="false" final="false" visibility="public"
  11441. deprecated="not deprecated">
  11442. <param name="size" type="int"/>
  11443. </method>
  11444. <method name="getOutputStreamIterator" return="java.util.Iterator"
  11445. abstract="false" native="false" synchronized="false"
  11446. static="false" final="false" visibility="public"
  11447. deprecated="not deprecated">
  11448. <param name="streamType" type="org.apache.hadoop.hdfs.server.namenode.JournalStream.JournalType"/>
  11449. <doc>
  11450. <![CDATA[Get stream iterator for the specified type.]]>
  11451. </doc>
  11452. </method>
  11453. <field name="OP_INVALID" type="byte"
  11454. transient="false" volatile="false"
  11455. static="true" final="true" visibility="public"
  11456. deprecated="not deprecated">
  11457. </field>
  11458. <doc>
  11459. <![CDATA[FSEditLog maintains a log of the namespace modifications.]]>
  11460. </doc>
  11461. </class>
  11462. <!-- end class org.apache.hadoop.hdfs.server.namenode.FSEditLog -->
  11463. <!-- start class org.apache.hadoop.hdfs.server.namenode.FSImage -->
  11464. <class name="FSImage" extends="org.apache.hadoop.hdfs.server.common.Storage"
  11465. abstract="false"
  11466. static="false" final="false" visibility="public"
  11467. deprecated="not deprecated">
  11468. <constructor name="FSImage" type="org.apache.hadoop.hdfs.server.common.StorageInfo"
  11469. static="false" final="false" visibility="public"
  11470. deprecated="not deprecated">
  11471. </constructor>
  11472. <method name="getFSNamesystem" return="org.apache.hadoop.hdfs.server.namenode.FSNamesystem"
  11473. abstract="false" native="false" synchronized="false"
  11474. static="false" final="false" visibility="protected"
  11475. deprecated="not deprecated">
  11476. </method>
  11477. <method name="setRestoreFailedStorage"
  11478. abstract="false" native="false" synchronized="false"
  11479. static="false" final="false" visibility="public"
  11480. deprecated="not deprecated">
  11481. <param name="val" type="boolean"/>
  11482. </method>
  11483. <method name="getRestoreFailedStorage" return="boolean"
  11484. abstract="false" native="false" synchronized="false"
  11485. static="false" final="false" visibility="public"
  11486. deprecated="not deprecated">
  11487. </method>
  11488. <method name="getFields"
  11489. abstract="false" native="false" synchronized="false"
  11490. static="false" final="false" visibility="protected"
  11491. deprecated="not deprecated">
  11492. <param name="props" type="java.util.Properties"/>
  11493. <param name="sd" type="org.apache.hadoop.hdfs.server.common.Storage.StorageDirectory"/>
  11494. <exception name="IOException" type="java.io.IOException"/>
  11495. </method>
  11496. <method name="setFields"
  11497. abstract="false" native="false" synchronized="false"
  11498. static="false" final="false" visibility="protected"
  11499. deprecated="not deprecated">
  11500. <param name="props" type="java.util.Properties"/>
  11501. <param name="sd" type="org.apache.hadoop.hdfs.server.common.Storage.StorageDirectory"/>
  11502. <exception name="IOException" type="java.io.IOException"/>
  11503. <doc>
  11504. <![CDATA[Write last checkpoint time and version file into the storage directory.
  11505. The version file should always be written last.
  11506. Missing or corrupted version file indicates that
  11507. the checkpoint is not valid.
  11508. @param sd storage directory
  11509. @throws IOException]]>
  11510. </doc>
  11511. </method>
  11512. <method name="getEditLog" return="org.apache.hadoop.hdfs.server.namenode.FSEditLog"
  11513. abstract="false" native="false" synchronized="false"
  11514. static="false" final="false" visibility="public"
  11515. deprecated="not deprecated">
  11516. </method>
  11517. <method name="isConversionNeeded" return="boolean"
  11518. abstract="false" native="false" synchronized="false"
  11519. static="false" final="false" visibility="public"
  11520. deprecated="not deprecated">
  11521. <param name="sd" type="org.apache.hadoop.hdfs.server.common.Storage.StorageDirectory"/>
  11522. <exception name="IOException" type="java.io.IOException"/>
  11523. </method>
  11524. <method name="saveCurrent"
  11525. abstract="false" native="false" synchronized="false"
  11526. static="false" final="false" visibility="protected"
  11527. deprecated="not deprecated">
  11528. <param name="sd" type="org.apache.hadoop.hdfs.server.common.Storage.StorageDirectory"/>
  11529. <exception name="IOException" type="java.io.IOException"/>
  11530. <doc>
  11531. <![CDATA[Save current image and empty journal into {@code current} directory.]]>
  11532. </doc>
  11533. </method>
  11534. <method name="moveCurrent"
  11535. abstract="false" native="false" synchronized="false"
  11536. static="false" final="false" visibility="protected"
  11537. deprecated="not deprecated">
  11538. <param name="sd" type="org.apache.hadoop.hdfs.server.common.Storage.StorageDirectory"/>
  11539. <exception name="IOException" type="java.io.IOException"/>
  11540. <doc>
  11541. <![CDATA[Move {@code current} to {@code lastcheckpoint.tmp} and
  11542. recreate empty {@code current}.
  11543. {@code current} is moved only if it is well formatted,
  11544. that is contains VERSION file.
  11545. @see org.apache.hadoop.hdfs.server.common.Storage.StorageDirectory#getLastCheckpointTmp()
  11546. @see org.apache.hadoop.hdfs.server.common.Storage.StorageDirectory#getPreviousCheckpoint()]]>
  11547. </doc>
  11548. </method>
  11549. <method name="moveLastCheckpoint"
  11550. abstract="false" native="false" synchronized="false"
  11551. static="false" final="false" visibility="protected"
  11552. deprecated="not deprecated">
  11553. <param name="sd" type="org.apache.hadoop.hdfs.server.common.Storage.StorageDirectory"/>
  11554. <exception name="IOException" type="java.io.IOException"/>
  11555. <doc>
  11556. <![CDATA[Move {@code lastcheckpoint.tmp} to {@code previous.checkpoint}
  11557. @see org.apache.hadoop.hdfs.server.common.Storage.StorageDirectory#getPreviousCheckpoint()
  11558. @see org.apache.hadoop.hdfs.server.common.Storage.StorageDirectory#getLastCheckpointTmp()]]>
  11559. </doc>
  11560. </method>
  11561. <method name="format"
  11562. abstract="false" native="false" synchronized="false"
  11563. static="false" final="false" visibility="public"
  11564. deprecated="not deprecated">
  11565. <exception name="IOException" type="java.io.IOException"/>
  11566. </method>
  11567. <method name="getFsEditName" return="java.io.File"
  11568. abstract="false" native="false" synchronized="false"
  11569. static="false" final="false" visibility="public"
  11570. deprecated="not deprecated">
  11571. <exception name="IOException" type="java.io.IOException"/>
  11572. </method>
  11573. <method name="corruptPreUpgradeStorage"
  11574. abstract="false" native="false" synchronized="false"
  11575. static="false" final="false" visibility="protected"
  11576. deprecated="not deprecated">
  11577. <param name="rootDir" type="java.io.File"/>
  11578. <exception name="IOException" type="java.io.IOException"/>
  11579. </method>
  11580. <method name="readString" return="java.lang.String"
  11581. abstract="false" native="false" synchronized="false"
  11582. static="true" final="false" visibility="public"
  11583. deprecated="not deprecated">
  11584. <param name="in" type="java.io.DataInputStream"/>
  11585. <exception name="IOException" type="java.io.IOException"/>
  11586. </method>
  11587. <method name="readBytes" return="byte[]"
  11588. abstract="false" native="false" synchronized="false"
  11589. static="true" final="false" visibility="public"
  11590. deprecated="not deprecated">
  11591. <param name="in" type="java.io.DataInputStream"/>
  11592. <exception name="IOException" type="java.io.IOException"/>
  11593. </method>
  11594. <field name="namesystem" type="org.apache.hadoop.hdfs.server.namenode.FSNamesystem"
  11595. transient="false" volatile="false"
  11596. static="false" final="false" visibility="protected"
  11597. deprecated="not deprecated">
  11598. </field>
  11599. <field name="checkpointTime" type="long"
  11600. transient="false" volatile="false"
  11601. static="false" final="false" visibility="protected"
  11602. deprecated="not deprecated">
  11603. </field>
  11604. <field name="editLog" type="org.apache.hadoop.hdfs.server.namenode.FSEditLog"
  11605. transient="false" volatile="false"
  11606. static="false" final="false" visibility="protected"
  11607. deprecated="not deprecated">
  11608. </field>
  11609. <field name="removedStorageDirs" type="java.util.List"
  11610. transient="false" volatile="false"
  11611. static="false" final="false" visibility="protected"
  11612. deprecated="not deprecated">
  11613. <doc>
  11614. <![CDATA[list of failed (and thus removed) storages]]>
  11615. </doc>
  11616. </field>
  11617. <field name="ckptState" type="org.apache.hadoop.hdfs.server.namenode.FSImage.CheckpointStates"
  11618. transient="false" volatile="true"
  11619. static="false" final="false" visibility="protected"
  11620. deprecated="not deprecated">
  11621. <doc>
  11622. <![CDATA[Can fs-image be rolled?]]>
  11623. </doc>
  11624. </field>
  11625. <doc>
  11626. <![CDATA[FSImage handles checkpointing and logging of the namespace edits.]]>
  11627. </doc>
  11628. </class>
  11629. <!-- end class org.apache.hadoop.hdfs.server.namenode.FSImage -->
  11630. <!-- start interface org.apache.hadoop.hdfs.server.namenode.FSInodeInfo -->
  11631. <interface name="FSInodeInfo" abstract="true"
  11632. static="false" final="false" visibility="public"
  11633. deprecated="not deprecated">
  11634. <method name="getFullPathName" return="java.lang.String"
  11635. abstract="false" native="false" synchronized="false"
  11636. static="false" final="false" visibility="public"
  11637. deprecated="not deprecated">
  11638. <doc>
  11639. <![CDATA[a string representation of an inode
  11640. @return the full pathname (from root) that this inode represents]]>
  11641. </doc>
  11642. </method>
  11643. <doc>
  11644. <![CDATA[This interface is used used the pluggable block placement policy
  11645. to expose a few characteristics of an Inode.]]>
  11646. </doc>
  11647. </interface>
  11648. <!-- end interface org.apache.hadoop.hdfs.server.namenode.FSInodeInfo -->
  11649. <!-- start class org.apache.hadoop.hdfs.server.namenode.FSNamesystem -->
  11650. <class name="FSNamesystem" extends="java.lang.Object"
  11651. abstract="false"
  11652. static="false" final="false" visibility="public"
  11653. deprecated="not deprecated">
  11654. <implements name="org.apache.hadoop.hdfs.protocol.FSConstants"/>
  11655. <implements name="org.apache.hadoop.hdfs.server.namenode.metrics.FSNamesystemMBean"/>
  11656. <implements name="org.apache.hadoop.hdfs.server.namenode.FSClusterStats"/>
  11657. <method name="getNamespaceDirs" return="java.util.Collection"
  11658. abstract="false" native="false" synchronized="false"
  11659. static="true" final="false" visibility="public"
  11660. deprecated="not deprecated">
  11661. <param name="conf" type="org.apache.hadoop.conf.Configuration"/>
  11662. </method>
  11663. <method name="getStorageDirs" return="java.util.Collection"
  11664. abstract="false" native="false" synchronized="false"
  11665. static="true" final="false" visibility="public"
  11666. deprecated="not deprecated">
  11667. <param name="conf" type="org.apache.hadoop.conf.Configuration"/>
  11668. <param name="propertyName" type="java.lang.String"/>
  11669. </method>
  11670. <method name="getNamespaceEditsDirs" return="java.util.Collection"
  11671. abstract="false" native="false" synchronized="false"
  11672. static="true" final="false" visibility="public"
  11673. deprecated="not deprecated">
  11674. <param name="conf" type="org.apache.hadoop.conf.Configuration"/>
  11675. </method>
  11676. <method name="getUpgradePermission" return="org.apache.hadoop.fs.permission.PermissionStatus"
  11677. abstract="false" native="false" synchronized="false"
  11678. static="false" final="false" visibility="protected"
  11679. deprecated="not deprecated">
  11680. <doc>
  11681. <![CDATA[Return the default path permission when upgrading from releases with no
  11682. permissions (<=0.15) to releases with permissions (>=0.16)]]>
  11683. </doc>
  11684. </method>
  11685. <method name="close"
  11686. abstract="false" native="false" synchronized="false"
  11687. static="false" final="false" visibility="public"
  11688. deprecated="not deprecated">
  11689. <doc>
  11690. <![CDATA[Close down this file system manager.
  11691. Causes heartbeat and lease daemons to stop; waits briefly for
  11692. them to finish, but a short timeout returns control back to caller.]]>
  11693. </doc>
  11694. </method>
  11695. <method name="setPermission"
  11696. abstract="false" native="false" synchronized="true"
  11697. static="false" final="false" visibility="public"
  11698. deprecated="not deprecated">
  11699. <param name="src" type="java.lang.String"/>
  11700. <param name="permission" type="org.apache.hadoop.fs.permission.FsPermission"/>
  11701. <exception name="IOException" type="java.io.IOException"/>
  11702. <exception name="UnresolvedLinkException" type="org.apache.hadoop.fs.UnresolvedLinkException"/>
  11703. <doc>
  11704. <![CDATA[Set permissions for an existing file.
  11705. @throws IOException]]>
  11706. </doc>
  11707. </method>
  11708. <method name="setOwner"
  11709. abstract="false" native="false" synchronized="true"
  11710. static="false" final="false" visibility="public"
  11711. deprecated="not deprecated">
  11712. <param name="src" type="java.lang.String"/>
  11713. <param name="username" type="java.lang.String"/>
  11714. <param name="group" type="java.lang.String"/>
  11715. <exception name="IOException" type="java.io.IOException"/>
  11716. <exception name="UnresolvedLinkException" type="org.apache.hadoop.fs.UnresolvedLinkException"/>
  11717. <doc>
  11718. <![CDATA[Set owner for an existing file.
  11719. @throws IOException]]>
  11720. </doc>
  11721. </method>
  11722. <method name="concat"
  11723. abstract="false" native="false" synchronized="false"
  11724. static="false" final="false" visibility="public"
  11725. deprecated="not deprecated">
  11726. <param name="target" type="java.lang.String"/>
  11727. <param name="srcs" type="java.lang.String[]"/>
  11728. <exception name="IOException" type="java.io.IOException"/>
  11729. <exception name="UnresolvedLinkException" type="org.apache.hadoop.fs.UnresolvedLinkException"/>
  11730. <doc>
  11731. <![CDATA[Moves all the blocks from srcs and appends them to trg
  11732. To avoid rollbacks we will verify validitity of ALL of the args
  11733. before we start actual move.
  11734. @param target
  11735. @param srcs
  11736. @throws IOException]]>
  11737. </doc>
  11738. </method>
  11739. <method name="setTimes"
  11740. abstract="false" native="false" synchronized="true"
  11741. static="false" final="false" visibility="public"
  11742. deprecated="not deprecated">
  11743. <param name="src" type="java.lang.String"/>
  11744. <param name="mtime" type="long"/>
  11745. <param name="atime" type="long"/>
  11746. <exception name="IOException" type="java.io.IOException"/>
  11747. <exception name="UnresolvedLinkException" type="org.apache.hadoop.fs.UnresolvedLinkException"/>
  11748. <doc>
  11749. <![CDATA[stores the modification and access time for this inode.
  11750. The access time is precise upto an hour. The transaction, if needed, is
  11751. written to the edits log but is not flushed.]]>
  11752. </doc>
  11753. </method>
  11754. <method name="createSymlink"
  11755. abstract="false" native="false" synchronized="true"
  11756. static="false" final="false" visibility="public"
  11757. deprecated="not deprecated">
  11758. <param name="target" type="java.lang.String"/>
  11759. <param name="link" type="java.lang.String"/>
  11760. <param name="dirPerms" type="org.apache.hadoop.fs.permission.PermissionStatus"/>
  11761. <param name="createParent" type="boolean"/>
  11762. <exception name="IOException" type="java.io.IOException"/>
  11763. <exception name="UnresolvedLinkException" type="org.apache.hadoop.fs.UnresolvedLinkException"/>
  11764. <doc>
  11765. <![CDATA[Create a symbolic link.]]>
  11766. </doc>
  11767. </method>
  11768. <method name="setReplication" return="boolean"
  11769. abstract="false" native="false" synchronized="false"
  11770. static="false" final="false" visibility="public"
  11771. deprecated="not deprecated">
  11772. <param name="src" type="java.lang.String"/>
  11773. <param name="replication" type="short"/>
  11774. <exception name="IOException" type="java.io.IOException"/>
  11775. <exception name="UnresolvedLinkException" type="org.apache.hadoop.fs.UnresolvedLinkException"/>
  11776. <doc>
  11777. <![CDATA[Set replication for an existing file.
  11778. The NameNode sets new replication and schedules either replication of
  11779. under-replicated data blocks or removal of the excessive block copies
  11780. if the blocks are over-replicated.
  11781. @see ClientProtocol#setReplication(String, short)
  11782. @param src file name
  11783. @param replication new replication
  11784. @return true if successful;
  11785. false if file does not exist or is a directory]]>
  11786. </doc>
  11787. </method>
  11788. <method name="getAdditionalBlock" return="org.apache.hadoop.hdfs.protocol.LocatedBlock"
  11789. abstract="false" native="false" synchronized="false"
  11790. static="false" final="false" visibility="public"
  11791. deprecated="not deprecated">
  11792. <param name="src" type="java.lang.String"/>
  11793. <param name="clientName" type="java.lang.String"/>
  11794. <param name="previous" type="org.apache.hadoop.hdfs.protocol.Block"/>
  11795. <param name="excludedNodes" type="java.util.HashMap"/>
  11796. <exception name="IOException" type="java.io.IOException"/>
  11797. <exception name="UnresolvedLinkException" type="org.apache.hadoop.fs.UnresolvedLinkException"/>
  11798. <doc>
  11799. <![CDATA[The client would like to obtain an additional block for the indicated
  11800. filename (which is being written-to). Return an array that consists
  11801. of the block, plus a set of machines. The first on this list should
  11802. be where the client writes data. Subsequent items in the list must
  11803. be provided in the connection to the first datanode.
  11804. Make sure the previous blocks have been reported by datanodes and
  11805. are replicated. Will return an empty 2-elt array if we want the
  11806. client to "try again later".]]>
  11807. </doc>
  11808. </method>
  11809. <method name="abandonBlock" return="boolean"
  11810. abstract="false" native="false" synchronized="true"
  11811. static="false" final="false" visibility="public"
  11812. deprecated="not deprecated">
  11813. <param name="b" type="org.apache.hadoop.hdfs.protocol.Block"/>
  11814. <param name="src" type="java.lang.String"/>
  11815. <param name="holder" type="java.lang.String"/>
  11816. <exception name="IOException" type="java.io.IOException"/>
  11817. <exception name="UnresolvedLinkException" type="org.apache.hadoop.fs.UnresolvedLinkException"/>
  11818. <doc>
  11819. <![CDATA[The client would like to let go of the given block]]>
  11820. </doc>
  11821. </method>
  11822. <method name="completeFile" return="org.apache.hadoop.hdfs.server.namenode.FSNamesystem.CompleteFileStatus"
  11823. abstract="false" native="false" synchronized="false"
  11824. static="false" final="false" visibility="public"
  11825. deprecated="not deprecated">
  11826. <param name="src" type="java.lang.String"/>
  11827. <param name="holder" type="java.lang.String"/>
  11828. <param name="last" type="org.apache.hadoop.hdfs.protocol.Block"/>
  11829. <exception name="IOException" type="java.io.IOException"/>
  11830. <exception name="UnresolvedLinkException" type="org.apache.hadoop.fs.UnresolvedLinkException"/>
  11831. </method>
  11832. <method name="markBlockAsCorrupt"
  11833. abstract="false" native="false" synchronized="true"
  11834. static="false" final="false" visibility="public"
  11835. deprecated="not deprecated">
  11836. <param name="blk" type="org.apache.hadoop.hdfs.protocol.Block"/>
  11837. <param name="dn" type="org.apache.hadoop.hdfs.protocol.DatanodeInfo"/>
  11838. <exception name="IOException" type="java.io.IOException"/>
  11839. <doc>
  11840. <![CDATA[Mark the block belonging to datanode as corrupt
  11841. @param blk Block to be marked as corrupt
  11842. @param dn Datanode which holds the corrupt replica]]>
  11843. </doc>
  11844. </method>
  11845. <method name="delete" return="boolean"
  11846. abstract="false" native="false" synchronized="false"
  11847. static="false" final="false" visibility="public"
  11848. deprecated="not deprecated">
  11849. <param name="src" type="java.lang.String"/>
  11850. <param name="recursive" type="boolean"/>
  11851. <exception name="IOException" type="java.io.IOException"/>
  11852. <exception name="UnresolvedLinkException" type="org.apache.hadoop.fs.UnresolvedLinkException"/>
  11853. <doc>
  11854. <![CDATA[Remove the indicated filename from namespace. If the filename
  11855. is a directory (non empty) and recursive is set to false then throw exception.]]>
  11856. </doc>
  11857. </method>
  11858. <method name="mkdirs" return="boolean"
  11859. abstract="false" native="false" synchronized="false"
  11860. static="false" final="false" visibility="public"
  11861. deprecated="not deprecated">
  11862. <param name="src" type="java.lang.String"/>
  11863. <param name="permissions" type="org.apache.hadoop.fs.permission.PermissionStatus"/>
  11864. <param name="createParent" type="boolean"/>
  11865. <exception name="IOException" type="java.io.IOException"/>
  11866. <exception name="UnresolvedLinkException" type="org.apache.hadoop.fs.UnresolvedLinkException"/>
  11867. <doc>
  11868. <![CDATA[Create all the necessary directories]]>
  11869. </doc>
  11870. </method>
  11871. <method name="getListing" return="org.apache.hadoop.hdfs.protocol.DirectoryListing"
  11872. abstract="false" native="false" synchronized="false"
  11873. static="false" final="false" visibility="public"
  11874. deprecated="not deprecated">
  11875. <param name="src" type="java.lang.String"/>
  11876. <param name="startAfter" type="byte[]"/>
  11877. <exception name="IOException" type="java.io.IOException"/>
  11878. <exception name="UnresolvedLinkException" type="org.apache.hadoop.fs.UnresolvedLinkException"/>
  11879. <doc>
  11880. <![CDATA[Get a partial listing of the indicated directory
  11881. @param src the directory name
  11882. @param startAfter the name to start after
  11883. @return a partial listing starting after startAfter]]>
  11884. </doc>
  11885. </method>
  11886. <method name="registerDatanode"
  11887. abstract="false" native="false" synchronized="true"
  11888. static="false" final="false" visibility="public"
  11889. deprecated="not deprecated">
  11890. <param name="nodeReg" type="org.apache.hadoop.hdfs.server.protocol.DatanodeRegistration"/>
  11891. <exception name="IOException" type="java.io.IOException"/>
  11892. <doc>
  11893. <![CDATA[Register Datanode.
  11894. <p>
  11895. The purpose of registration is to identify whether the new datanode
  11896. serves a new data storage, and will report new data block copies,
  11897. which the namenode was not aware of; or the datanode is a replacement
  11898. node for the data storage that was previously served by a different
  11899. or the same (in terms of host:port) datanode.
  11900. The data storages are distinguished by their storageIDs. When a new
  11901. data storage is reported the namenode issues a new unique storageID.
  11902. <p>
  11903. Finally, the namenode returns its namespaceID as the registrationID
  11904. for the datanodes.
  11905. namespaceID is a persistent attribute of the name space.
  11906. The registrationID is checked every time the datanode is communicating
  11907. with the namenode.
  11908. Datanodes with inappropriate registrationID are rejected.
  11909. If the namenode stops, and then restarts it can restore its
  11910. namespaceID and will continue serving the datanodes that has previously
  11911. registered with the namenode without restarting the whole cluster.
  11912. @see org.apache.hadoop.hdfs.server.datanode.DataNode#register()]]>
  11913. </doc>
  11914. </method>
  11915. <method name="getRegistrationID" return="java.lang.String"
  11916. abstract="false" native="false" synchronized="false"
  11917. static="false" final="false" visibility="public"
  11918. deprecated="not deprecated">
  11919. <doc>
  11920. <![CDATA[Get registrationID for datanodes based on the namespaceID.
  11921. @see #registerDatanode(DatanodeRegistration)
  11922. @see FSImage#newNamespaceID()
  11923. @return registration ID]]>
  11924. </doc>
  11925. </method>
  11926. <method name="computeDatanodeWork" return="int"
  11927. abstract="false" native="false" synchronized="false"
  11928. static="false" final="false" visibility="public"
  11929. deprecated="not deprecated">
  11930. <exception name="IOException" type="java.io.IOException"/>
  11931. <doc>
  11932. <![CDATA[Compute block replication and block invalidation work
  11933. that can be scheduled on data-nodes.
  11934. The datanode will be informed of this work at the next heartbeat.
  11935. @return number of blocks scheduled for replication or removal.]]>
  11936. </doc>
  11937. </method>
  11938. <method name="setNodeReplicationLimit"
  11939. abstract="false" native="false" synchronized="false"
  11940. static="false" final="false" visibility="public"
  11941. deprecated="not deprecated">
  11942. <param name="limit" type="int"/>
  11943. </method>
  11944. <method name="removeDatanode"
  11945. abstract="false" native="false" synchronized="true"
  11946. static="false" final="false" visibility="public"
  11947. deprecated="not deprecated">
  11948. <param name="nodeID" type="org.apache.hadoop.hdfs.protocol.DatanodeID"/>
  11949. <exception name="IOException" type="java.io.IOException"/>
  11950. <doc>
  11951. <![CDATA[remove a datanode descriptor
  11952. @param nodeID datanode ID]]>
  11953. </doc>
  11954. </method>
  11955. <method name="processReport"
  11956. abstract="false" native="false" synchronized="true"
  11957. static="false" final="false" visibility="public"
  11958. deprecated="not deprecated">
  11959. <param name="nodeID" type="org.apache.hadoop.hdfs.protocol.DatanodeID"/>
  11960. <param name="newReport" type="org.apache.hadoop.hdfs.protocol.BlockListAsLongs"/>
  11961. <exception name="IOException" type="java.io.IOException"/>
  11962. <doc>
  11963. <![CDATA[The given node is reporting all its blocks. Use this info to
  11964. update the (machine-->blocklist) and (block-->machinelist) tables.]]>
  11965. </doc>
  11966. </method>
  11967. <method name="blockReceived"
  11968. abstract="false" native="false" synchronized="true"
  11969. static="false" final="false" visibility="public"
  11970. deprecated="not deprecated">
  11971. <param name="nodeID" type="org.apache.hadoop.hdfs.protocol.DatanodeID"/>
  11972. <param name="block" type="org.apache.hadoop.hdfs.protocol.Block"/>
  11973. <param name="delHint" type="java.lang.String"/>
  11974. <exception name="IOException" type="java.io.IOException"/>
  11975. <doc>
  11976. <![CDATA[The given node is reporting that it received a certain block.]]>
  11977. </doc>
  11978. </method>
  11979. <method name="getMissingBlocksCount" return="long"
  11980. abstract="false" native="false" synchronized="false"
  11981. static="false" final="false" visibility="public"
  11982. deprecated="not deprecated">
  11983. </method>
  11984. <method name="getCapacityTotal" return="long"
  11985. abstract="false" native="false" synchronized="false"
  11986. static="false" final="false" visibility="public"
  11987. deprecated="not deprecated">
  11988. <doc>
  11989. <![CDATA[Total raw bytes including non-dfs used space.]]>
  11990. </doc>
  11991. </method>
  11992. <method name="getCapacityUsed" return="long"
  11993. abstract="false" native="false" synchronized="false"
  11994. static="false" final="false" visibility="public"
  11995. deprecated="not deprecated">
  11996. <doc>
  11997. <![CDATA[Total used space by data nodes]]>
  11998. </doc>
  11999. </method>
  12000. <method name="getCapacityUsedPercent" return="float"
  12001. abstract="false" native="false" synchronized="false"
  12002. static="false" final="false" visibility="public"
  12003. deprecated="not deprecated">
  12004. <doc>
  12005. <![CDATA[Total used space by data nodes as percentage of total capacity]]>
  12006. </doc>
  12007. </method>
  12008. <method name="getCapacityUsedNonDFS" return="long"
  12009. abstract="false" native="false" synchronized="false"
  12010. static="false" final="false" visibility="public"
  12011. deprecated="not deprecated">
  12012. <doc>
  12013. <![CDATA[Total used space by data nodes for non DFS purposes such
  12014. as storing temporary files on the local file system]]>
  12015. </doc>
  12016. </method>
  12017. <method name="getCapacityRemaining" return="long"
  12018. abstract="false" native="false" synchronized="false"
  12019. static="false" final="false" visibility="public"
  12020. deprecated="not deprecated">
  12021. <doc>
  12022. <![CDATA[Total non-used raw bytes.]]>
  12023. </doc>
  12024. </method>
  12025. <method name="getCapacityRemainingPercent" return="float"
  12026. abstract="false" native="false" synchronized="false"
  12027. static="false" final="false" visibility="public"
  12028. deprecated="not deprecated">
  12029. <doc>
  12030. <![CDATA[Total remaining space by data nodes as percentage of total capacity]]>
  12031. </doc>
  12032. </method>
  12033. <method name="getTotalLoad" return="int"
  12034. abstract="false" native="false" synchronized="false"
  12035. static="false" final="false" visibility="public"
  12036. deprecated="not deprecated">
  12037. <doc>
  12038. <![CDATA[Total number of connections.]]>
  12039. </doc>
  12040. </method>
  12041. <method name="datanodeReport" return="org.apache.hadoop.hdfs.protocol.DatanodeInfo[]"
  12042. abstract="false" native="false" synchronized="true"
  12043. static="false" final="false" visibility="public"
  12044. deprecated="not deprecated">
  12045. <param name="type" type="org.apache.hadoop.hdfs.protocol.FSConstants.DatanodeReportType"/>
  12046. <exception name="AccessControlException" type="org.apache.hadoop.security.AccessControlException"/>
  12047. </method>
  12048. <method name="DFSNodesStatus"
  12049. abstract="false" native="false" synchronized="true"
  12050. static="false" final="false" visibility="public"
  12051. deprecated="not deprecated">
  12052. <param name="live" type="java.util.ArrayList"/>
  12053. <param name="dead" type="java.util.ArrayList"/>
  12054. </method>
  12055. <method name="stopDecommission"
  12056. abstract="false" native="false" synchronized="false"
  12057. static="false" final="false" visibility="public"
  12058. deprecated="not deprecated">
  12059. <param name="node" type="org.apache.hadoop.hdfs.server.namenode.DatanodeDescriptor"/>
  12060. <exception name="IOException" type="java.io.IOException"/>
  12061. <doc>
  12062. <![CDATA[Stop decommissioning the specified datanodes.]]>
  12063. </doc>
  12064. </method>
  12065. <method name="getDataNodeInfo" return="org.apache.hadoop.hdfs.protocol.DatanodeInfo"
  12066. abstract="false" native="false" synchronized="false"
  12067. static="false" final="false" visibility="public"
  12068. deprecated="not deprecated">
  12069. <param name="name" type="java.lang.String"/>
  12070. </method>
  12071. <method name="getStartTime" return="java.util.Date"
  12072. abstract="false" native="false" synchronized="false"
  12073. static="false" final="false" visibility="public"
  12074. deprecated="not deprecated">
  12075. </method>
  12076. <method name="refreshNodes"
  12077. abstract="false" native="false" synchronized="false"
  12078. static="false" final="false" visibility="public"
  12079. deprecated="not deprecated">
  12080. <param name="conf" type="org.apache.hadoop.conf.Configuration"/>
  12081. <exception name="IOException" type="java.io.IOException"/>
  12082. <doc>
  12083. <![CDATA[Rereads the config to get hosts and exclude list file names.
  12084. Rereads the files to update the hosts and exclude lists. It
  12085. checks if any of the hosts have changed states:
  12086. 1. Added to hosts --> no further work needed here.
  12087. 2. Removed from hosts --> mark AdminState as decommissioned.
  12088. 3. Added to exclude --> start decommission.
  12089. 4. Removed from exclude --> stop decommission.]]>
  12090. </doc>
  12091. </method>
  12092. <method name="getDatanode" return="org.apache.hadoop.hdfs.server.namenode.DatanodeDescriptor"
  12093. abstract="false" native="false" synchronized="false"
  12094. static="false" final="false" visibility="public"
  12095. deprecated="not deprecated">
  12096. <param name="nodeID" type="org.apache.hadoop.hdfs.protocol.DatanodeID"/>
  12097. <exception name="IOException" type="java.io.IOException"/>
  12098. <doc>
  12099. <![CDATA[Get data node by storage ID.
  12100. @param nodeID
  12101. @return DatanodeDescriptor or null if the node is not found.
  12102. @throws IOException]]>
  12103. </doc>
  12104. </method>
  12105. <method name="getBlocksTotal" return="long"
  12106. abstract="false" native="false" synchronized="false"
  12107. static="false" final="false" visibility="public"
  12108. deprecated="not deprecated">
  12109. <doc>
  12110. <![CDATA[Get the total number of blocks in the system.]]>
  12111. </doc>
  12112. </method>
  12113. <method name="getFilesTotal" return="long"
  12114. abstract="false" native="false" synchronized="false"
  12115. static="false" final="false" visibility="public"
  12116. deprecated="not deprecated">
  12117. </method>
  12118. <method name="getPendingReplicationBlocks" return="long"
  12119. abstract="false" native="false" synchronized="false"
  12120. static="false" final="false" visibility="public"
  12121. deprecated="not deprecated">
  12122. </method>
  12123. <method name="getUnderReplicatedBlocks" return="long"
  12124. abstract="false" native="false" synchronized="false"
  12125. static="false" final="false" visibility="public"
  12126. deprecated="not deprecated">
  12127. </method>
  12128. <method name="getCorruptReplicaBlocks" return="long"
  12129. abstract="false" native="false" synchronized="false"
  12130. static="false" final="false" visibility="public"
  12131. deprecated="not deprecated">
  12132. <doc>
  12133. <![CDATA[Returns number of blocks with corrupt replicas]]>
  12134. </doc>
  12135. </method>
  12136. <method name="getScheduledReplicationBlocks" return="long"
  12137. abstract="false" native="false" synchronized="false"
  12138. static="false" final="false" visibility="public"
  12139. deprecated="not deprecated">
  12140. </method>
  12141. <method name="getPendingDeletionBlocks" return="long"
  12142. abstract="false" native="false" synchronized="false"
  12143. static="false" final="false" visibility="public"
  12144. deprecated="not deprecated">
  12145. </method>
  12146. <method name="getExcessBlocks" return="long"
  12147. abstract="false" native="false" synchronized="false"
  12148. static="false" final="false" visibility="public"
  12149. deprecated="not deprecated">
  12150. </method>
  12151. <method name="getBlockCapacity" return="int"
  12152. abstract="false" native="false" synchronized="false"
  12153. static="false" final="false" visibility="public"
  12154. deprecated="not deprecated">
  12155. </method>
  12156. <method name="getFSState" return="java.lang.String"
  12157. abstract="false" native="false" synchronized="false"
  12158. static="false" final="false" visibility="public"
  12159. deprecated="not deprecated">
  12160. </method>
  12161. <method name="getFSNamesystemMetrics" return="org.apache.hadoop.hdfs.server.namenode.metrics.FSNamesystemMetrics"
  12162. abstract="false" native="false" synchronized="false"
  12163. static="false" final="false" visibility="public"
  12164. deprecated="not deprecated">
  12165. <doc>
  12166. <![CDATA[get FSNamesystemMetrics]]>
  12167. </doc>
  12168. </method>
  12169. <method name="shutdown"
  12170. abstract="false" native="false" synchronized="false"
  12171. static="false" final="false" visibility="public"
  12172. deprecated="not deprecated">
  12173. <doc>
  12174. <![CDATA[shutdown FSNamesystem]]>
  12175. </doc>
  12176. </method>
  12177. <method name="getNumLiveDataNodes" return="int"
  12178. abstract="false" native="false" synchronized="false"
  12179. static="false" final="false" visibility="public"
  12180. deprecated="not deprecated">
  12181. <doc>
  12182. <![CDATA[Number of live data nodes
  12183. @return Number of live data nodes]]>
  12184. </doc>
  12185. </method>
  12186. <method name="getNumDeadDataNodes" return="int"
  12187. abstract="false" native="false" synchronized="false"
  12188. static="false" final="false" visibility="public"
  12189. deprecated="not deprecated">
  12190. <doc>
  12191. <![CDATA[Number of dead data nodes
  12192. @return Number of dead data nodes]]>
  12193. </doc>
  12194. </method>
  12195. <method name="setGenerationStamp"
  12196. abstract="false" native="false" synchronized="false"
  12197. static="false" final="false" visibility="public"
  12198. deprecated="not deprecated">
  12199. <param name="stamp" type="long"/>
  12200. <doc>
  12201. <![CDATA[Sets the generation stamp for this filesystem]]>
  12202. </doc>
  12203. </method>
  12204. <method name="getGenerationStamp" return="long"
  12205. abstract="false" native="false" synchronized="false"
  12206. static="false" final="false" visibility="public"
  12207. deprecated="not deprecated">
  12208. <doc>
  12209. <![CDATA[Gets the generation stamp for this filesystem]]>
  12210. </doc>
  12211. </method>
  12212. <method name="numCorruptReplicas" return="int"
  12213. abstract="false" native="false" synchronized="false"
  12214. static="false" final="false" visibility="public"
  12215. deprecated="not deprecated">
  12216. <param name="blk" type="org.apache.hadoop.hdfs.protocol.Block"/>
  12217. </method>
  12218. <method name="getDecommissioningNodes" return="java.util.ArrayList"
  12219. abstract="false" native="false" synchronized="true"
  12220. static="false" final="false" visibility="public"
  12221. deprecated="not deprecated">
  12222. </method>
  12223. <method name="getDelegationTokenSecretManager" return="org.apache.hadoop.hdfs.security.token.delegation.DelegationTokenSecretManager"
  12224. abstract="false" native="false" synchronized="false"
  12225. static="false" final="false" visibility="public"
  12226. deprecated="not deprecated">
  12227. </method>
  12228. <method name="getDelegationToken" return="org.apache.hadoop.security.token.Token"
  12229. abstract="false" native="false" synchronized="false"
  12230. static="false" final="false" visibility="public"
  12231. deprecated="not deprecated">
  12232. <param name="renewer" type="org.apache.hadoop.io.Text"/>
  12233. <exception name="IOException" type="java.io.IOException"/>
  12234. <doc>
  12235. <![CDATA[@param renewer
  12236. @return Token<DelegationTokenIdentifier>
  12237. @throws IOException]]>
  12238. </doc>
  12239. </method>
  12240. <method name="renewDelegationToken" return="long"
  12241. abstract="false" native="false" synchronized="false"
  12242. static="false" final="false" visibility="public"
  12243. deprecated="not deprecated">
  12244. <param name="token" type="org.apache.hadoop.security.token.Token"/>
  12245. <exception name="SecretManager.InvalidToken" type="org.apache.hadoop.security.token.SecretManager.InvalidToken"/>
  12246. <exception name="IOException" type="java.io.IOException"/>
  12247. <doc>
  12248. <![CDATA[@param token
  12249. @return New expiryTime of the token
  12250. @throws InvalidToken
  12251. @throws IOException]]>
  12252. </doc>
  12253. </method>
  12254. <method name="cancelDelegationToken"
  12255. abstract="false" native="false" synchronized="false"
  12256. static="false" final="false" visibility="public"
  12257. deprecated="not deprecated">
  12258. <param name="token" type="org.apache.hadoop.security.token.Token"/>
  12259. <exception name="IOException" type="java.io.IOException"/>
  12260. <doc>
  12261. <![CDATA[@param token
  12262. @throws IOException]]>
  12263. </doc>
  12264. </method>
  12265. <method name="logUpdateMasterKey"
  12266. abstract="false" native="false" synchronized="false"
  12267. static="false" final="false" visibility="public"
  12268. deprecated="not deprecated">
  12269. <param name="key" type="org.apache.hadoop.security.token.delegation.DelegationKey"/>
  12270. <exception name="IOException" type="java.io.IOException"/>
  12271. <doc>
  12272. <![CDATA[Log the updateMasterKey operation to edit logs
  12273. @param key new delegation key.]]>
  12274. </doc>
  12275. </method>
  12276. <field name="LOG" type="org.apache.commons.logging.Log"
  12277. transient="false" volatile="false"
  12278. static="true" final="true" visibility="public"
  12279. deprecated="not deprecated">
  12280. </field>
  12281. <field name="auditLog" type="org.apache.commons.logging.Log"
  12282. transient="false" volatile="false"
  12283. static="true" final="true" visibility="public"
  12284. deprecated="not deprecated">
  12285. <doc>
  12286. <![CDATA[Logger for audit events, noting successful FSNamesystem operations. Emits
  12287. to FSNamesystem.audit at INFO. Each event causes a set of tab-separated
  12288. <code>key=value</code> pairs to be written for the following properties:
  12289. <code>
  12290. ugi=&lt;ugi in RPC&gt;
  12291. ip=&lt;remote IP&gt;
  12292. cmd=&lt;command&gt;
  12293. src=&lt;src path&gt;
  12294. dst=&lt;dst path (optional)&gt;
  12295. perm=&lt;permissions (optional)&gt;
  12296. </code>]]>
  12297. </doc>
  12298. </field>
  12299. <field name="dir" type="org.apache.hadoop.hdfs.server.namenode.FSDirectory"
  12300. transient="false" volatile="false"
  12301. static="false" final="false" visibility="public"
  12302. deprecated="not deprecated">
  12303. </field>
  12304. <field name="leaseManager" type="org.apache.hadoop.hdfs.server.namenode.LeaseManager"
  12305. transient="false" volatile="false"
  12306. static="false" final="false" visibility="public"
  12307. deprecated="not deprecated">
  12308. </field>
  12309. <field name="lmthread" type="org.apache.hadoop.util.Daemon"
  12310. transient="false" volatile="false"
  12311. static="false" final="false" visibility="public"
  12312. deprecated="not deprecated">
  12313. </field>
  12314. <field name="replthread" type="org.apache.hadoop.util.Daemon"
  12315. transient="false" volatile="false"
  12316. static="false" final="false" visibility="public"
  12317. deprecated="not deprecated">
  12318. </field>
  12319. <doc>
  12320. <![CDATA[FSNamesystem does the actual bookkeeping work for the
  12321. DataNode.
  12322. It tracks several important tables.
  12323. 1) valid fsname --> blocklist (kept on disk, logged)
  12324. 2) Set of all valid blocks (inverted #1)
  12325. 3) block --> machinelist (kept in memory, rebuilt dynamically from reports)
  12326. 4) machine --> blocklist (inverted #2)
  12327. 5) LRU cache of updated-heartbeat machines]]>
  12328. </doc>
  12329. </class>
  12330. <!-- end class org.apache.hadoop.hdfs.server.namenode.FSNamesystem -->
  12331. <!-- start class org.apache.hadoop.hdfs.server.namenode.GetImageServlet -->
  12332. <class name="GetImageServlet" extends="javax.servlet.http.HttpServlet"
  12333. abstract="false"
  12334. static="false" final="false" visibility="public"
  12335. deprecated="not deprecated">
  12336. <constructor name="GetImageServlet"
  12337. static="false" final="false" visibility="public"
  12338. deprecated="not deprecated">
  12339. </constructor>
  12340. <method name="doGet"
  12341. abstract="false" native="false" synchronized="false"
  12342. static="false" final="false" visibility="public"
  12343. deprecated="not deprecated">
  12344. <param name="request" type="javax.servlet.http.HttpServletRequest"/>
  12345. <param name="response" type="javax.servlet.http.HttpServletResponse"/>
  12346. <exception name="ServletException" type="javax.servlet.ServletException"/>
  12347. <exception name="IOException" type="java.io.IOException"/>
  12348. </method>
  12349. <doc>
  12350. <![CDATA[This class is used in Namesystem's jetty to retrieve a file.
  12351. Typically used by the Secondary NameNode to retrieve image and
  12352. edit file for periodic checkpointing.]]>
  12353. </doc>
  12354. </class>
  12355. <!-- end class org.apache.hadoop.hdfs.server.namenode.GetImageServlet -->
  12356. <!-- start class org.apache.hadoop.hdfs.server.namenode.INodeSymlink -->
  12357. <class name="INodeSymlink" extends="org.apache.hadoop.hdfs.server.namenode.INode"
  12358. abstract="false"
  12359. static="false" final="false" visibility="public"
  12360. deprecated="not deprecated">
  12361. <method name="isLink" return="boolean"
  12362. abstract="false" native="false" synchronized="false"
  12363. static="false" final="false" visibility="public"
  12364. deprecated="not deprecated">
  12365. </method>
  12366. <method name="getLinkValue" return="java.lang.String"
  12367. abstract="false" native="false" synchronized="false"
  12368. static="false" final="false" visibility="public"
  12369. deprecated="not deprecated">
  12370. </method>
  12371. <method name="getSymlink" return="byte[]"
  12372. abstract="false" native="false" synchronized="false"
  12373. static="false" final="false" visibility="public"
  12374. deprecated="not deprecated">
  12375. </method>
  12376. <method name="isDirectory" return="boolean"
  12377. abstract="false" native="false" synchronized="false"
  12378. static="false" final="false" visibility="public"
  12379. deprecated="not deprecated">
  12380. </method>
  12381. <doc>
  12382. <![CDATA[An INode representing a symbolic link.]]>
  12383. </doc>
  12384. </class>
  12385. <!-- end class org.apache.hadoop.hdfs.server.namenode.INodeSymlink -->
  12386. <!-- start class org.apache.hadoop.hdfs.server.namenode.LeaseExpiredException -->
  12387. <class name="LeaseExpiredException" extends="java.io.IOException"
  12388. abstract="false"
  12389. static="false" final="false" visibility="public"
  12390. deprecated="not deprecated">
  12391. <constructor name="LeaseExpiredException" type="java.lang.String"
  12392. static="false" final="false" visibility="public"
  12393. deprecated="not deprecated">
  12394. </constructor>
  12395. <doc>
  12396. <![CDATA[The lease that was being used to create this file has expired.]]>
  12397. </doc>
  12398. </class>
  12399. <!-- end class org.apache.hadoop.hdfs.server.namenode.LeaseExpiredException -->
  12400. <!-- start class org.apache.hadoop.hdfs.server.namenode.LeaseManager -->
  12401. <class name="LeaseManager" extends="java.lang.Object"
  12402. abstract="false"
  12403. static="false" final="false" visibility="public"
  12404. deprecated="not deprecated">
  12405. <method name="getLeaseByPath" return="org.apache.hadoop.hdfs.server.namenode.LeaseManager.Lease"
  12406. abstract="false" native="false" synchronized="false"
  12407. static="false" final="false" visibility="public"
  12408. deprecated="not deprecated">
  12409. <param name="src" type="java.lang.String"/>
  12410. <doc>
  12411. <![CDATA[@return the lease containing src]]>
  12412. </doc>
  12413. </method>
  12414. <method name="countLease" return="int"
  12415. abstract="false" native="false" synchronized="true"
  12416. static="false" final="false" visibility="public"
  12417. deprecated="not deprecated">
  12418. <doc>
  12419. <![CDATA[@return the number of leases currently in the system]]>
  12420. </doc>
  12421. </method>
  12422. <method name="setLeasePeriod"
  12423. abstract="false" native="false" synchronized="false"
  12424. static="false" final="false" visibility="public"
  12425. deprecated="not deprecated">
  12426. <param name="softLimit" type="long"/>
  12427. <param name="hardLimit" type="long"/>
  12428. </method>
  12429. <method name="toString" return="java.lang.String"
  12430. abstract="false" native="false" synchronized="true"
  12431. static="false" final="false" visibility="public"
  12432. deprecated="not deprecated">
  12433. <doc>
  12434. <![CDATA[{@inheritDoc}]]>
  12435. </doc>
  12436. </method>
  12437. <field name="LOG" type="org.apache.commons.logging.Log"
  12438. transient="false" volatile="false"
  12439. static="true" final="true" visibility="public"
  12440. deprecated="not deprecated">
  12441. </field>
  12442. <doc>
  12443. <![CDATA[LeaseManager does the lease housekeeping for writing on files.
  12444. This class also provides useful static methods for lease recovery.
  12445. Lease Recovery Algorithm
  12446. 1) Namenode retrieves lease information
  12447. 2) For each file f in the lease, consider the last block b of f
  12448. 2.1) Get the datanodes which contains b
  12449. 2.2) Assign one of the datanodes as the primary datanode p
  12450. 2.3) p obtains a new generation stamp form the namenode
  12451. 2.4) p get the block info from each datanode
  12452. 2.5) p computes the minimum block length
  12453. 2.6) p updates the datanodes, which have a valid generation stamp,
  12454. with the new generation stamp and the minimum block length
  12455. 2.7) p acknowledges the namenode the update results
  12456. 2.8) Namenode updates the BlockInfo
  12457. 2.9) Namenode removes f from the lease
  12458. and removes the lease once all files have been removed
  12459. 2.10) Namenode commit changes to edit log]]>
  12460. </doc>
  12461. </class>
  12462. <!-- end class org.apache.hadoop.hdfs.server.namenode.LeaseManager -->
  12463. <!-- start class org.apache.hadoop.hdfs.server.namenode.ListPathsServlet -->
  12464. <class name="ListPathsServlet" extends="org.apache.hadoop.hdfs.server.namenode.DfsServlet"
  12465. abstract="false"
  12466. static="false" final="false" visibility="public"
  12467. deprecated="not deprecated">
  12468. <constructor name="ListPathsServlet"
  12469. static="false" final="false" visibility="public"
  12470. deprecated="not deprecated">
  12471. </constructor>
  12472. <method name="buildRoot" return="java.util.Map"
  12473. abstract="false" native="false" synchronized="false"
  12474. static="false" final="false" visibility="protected"
  12475. deprecated="not deprecated">
  12476. <param name="request" type="javax.servlet.http.HttpServletRequest"/>
  12477. <param name="doc" type="org.znerd.xmlenc.XMLOutputter"/>
  12478. <doc>
  12479. <![CDATA[Build a map from the query string, setting values and defaults.]]>
  12480. </doc>
  12481. </method>
  12482. <method name="doGet"
  12483. abstract="false" native="false" synchronized="false"
  12484. static="false" final="false" visibility="public"
  12485. deprecated="not deprecated">
  12486. <param name="request" type="javax.servlet.http.HttpServletRequest"/>
  12487. <param name="response" type="javax.servlet.http.HttpServletResponse"/>
  12488. <exception name="ServletException" type="javax.servlet.ServletException"/>
  12489. <exception name="IOException" type="java.io.IOException"/>
  12490. <doc>
  12491. <![CDATA[Service a GET request as described below.
  12492. Request:
  12493. {@code
  12494. GET http://<nn>:<port>/listPaths[/<path>][<?option>[&option]*] HTTP/1.1
  12495. }
  12496. Where <i>option</i> (default) in:
  12497. recursive (&quot;no&quot;)
  12498. filter (&quot;.*&quot;)
  12499. exclude (&quot;\..*\.crc&quot;)
  12500. Response: A flat list of files/directories in the following format:
  12501. {@code
  12502. <listing path="..." recursive="(yes|no)" filter="..."
  12503. time="yyyy-MM-dd hh:mm:ss UTC" version="...">
  12504. <directory path="..." modified="yyyy-MM-dd hh:mm:ss"/>
  12505. <file path="..." modified="yyyy-MM-dd'T'hh:mm:ssZ" accesstime="yyyy-MM-dd'T'hh:mm:ssZ"
  12506. blocksize="..."
  12507. replication="..." size="..."/>
  12508. </listing>
  12509. }]]>
  12510. </doc>
  12511. </method>
  12512. <field name="df" type="java.lang.ThreadLocal"
  12513. transient="false" volatile="false"
  12514. static="true" final="true" visibility="public"
  12515. deprecated="not deprecated">
  12516. </field>
  12517. <doc>
  12518. <![CDATA[Obtain meta-information about a filesystem.
  12519. @see org.apache.hadoop.hdfs.HftpFileSystem]]>
  12520. </doc>
  12521. </class>
  12522. <!-- end class org.apache.hadoop.hdfs.server.namenode.ListPathsServlet -->
  12523. <!-- start class org.apache.hadoop.hdfs.server.namenode.NameNode -->
  12524. <class name="NameNode" extends="java.lang.Object"
  12525. abstract="false"
  12526. static="false" final="false" visibility="public"
  12527. deprecated="not deprecated">
  12528. <implements name="org.apache.hadoop.hdfs.server.protocol.NamenodeProtocols"/>
  12529. <implements name="org.apache.hadoop.hdfs.protocol.FSConstants"/>
  12530. <constructor name="NameNode" type="org.apache.hadoop.conf.Configuration"
  12531. static="false" final="false" visibility="public"
  12532. deprecated="not deprecated">
  12533. <exception name="IOException" type="java.io.IOException"/>
  12534. <doc>
  12535. <![CDATA[Start NameNode.
  12536. <p>
  12537. The name-node can be started with one of the following startup options:
  12538. <ul>
  12539. <li>{@link StartupOption#REGULAR REGULAR} - normal name node startup</li>
  12540. <li>{@link StartupOption#FORMAT FORMAT} - format name node</li>
  12541. <li>{@link StartupOption#BACKUP BACKUP} - start backup node</li>
  12542. <li>{@link StartupOption#CHECKPOINT CHECKPOINT} - start checkpoint node</li>
  12543. <li>{@link StartupOption#UPGRADE UPGRADE} - start the cluster
  12544. upgrade and create a snapshot of the current file system state</li>
  12545. <li>{@link StartupOption#ROLLBACK ROLLBACK} - roll the
  12546. cluster back to the previous state</li>
  12547. <li>{@link StartupOption#FINALIZE FINALIZE} - finalize
  12548. previous upgrade</li>
  12549. <li>{@link StartupOption#IMPORT IMPORT} - import checkpoint</li>
  12550. </ul>
  12551. The option is passed via configuration field:
  12552. <tt>dfs.namenode.startup</tt>
  12553. The conf will be modified to reflect the actual ports on which
  12554. the NameNode is up and running if the user passes the port as
  12555. <code>zero</code> in the conf.
  12556. @param conf confirguration
  12557. @throws IOException]]>
  12558. </doc>
  12559. </constructor>
  12560. <constructor name="NameNode" type="org.apache.hadoop.conf.Configuration, org.apache.hadoop.hdfs.server.common.HdfsConstants.NamenodeRole"
  12561. static="false" final="false" visibility="protected"
  12562. deprecated="not deprecated">
  12563. <exception name="IOException" type="java.io.IOException"/>
  12564. </constructor>
  12565. <method name="getProtocolVersion" return="long"
  12566. abstract="false" native="false" synchronized="false"
  12567. static="false" final="false" visibility="public"
  12568. deprecated="not deprecated">
  12569. <param name="protocol" type="java.lang.String"/>
  12570. <param name="clientVersion" type="long"/>
  12571. <exception name="IOException" type="java.io.IOException"/>
  12572. </method>
  12573. <method name="format"
  12574. abstract="false" native="false" synchronized="false"
  12575. static="true" final="false" visibility="public"
  12576. deprecated="not deprecated">
  12577. <param name="conf" type="org.apache.hadoop.conf.Configuration"/>
  12578. <exception name="IOException" type="java.io.IOException"/>
  12579. <doc>
  12580. <![CDATA[Format a new filesystem. Destroys any filesystem that may already
  12581. exist at this location.]]>
  12582. </doc>
  12583. </method>
  12584. <method name="getNameNodeMetrics" return="org.apache.hadoop.hdfs.server.namenode.metrics.NameNodeMetrics"
  12585. abstract="false" native="false" synchronized="false"
  12586. static="true" final="false" visibility="public"
  12587. deprecated="not deprecated">
  12588. </method>
  12589. <method name="getAddress" return="java.net.InetSocketAddress"
  12590. abstract="false" native="false" synchronized="false"
  12591. static="true" final="false" visibility="public"
  12592. deprecated="not deprecated">
  12593. <param name="address" type="java.lang.String"/>
  12594. </method>
  12595. <method name="getAddress" return="java.net.InetSocketAddress"
  12596. abstract="false" native="false" synchronized="false"
  12597. static="true" final="false" visibility="public"
  12598. deprecated="not deprecated">
  12599. <param name="conf" type="org.apache.hadoop.conf.Configuration"/>
  12600. </method>
  12601. <method name="getUri" return="java.net.URI"
  12602. abstract="false" native="false" synchronized="false"
  12603. static="true" final="false" visibility="public"
  12604. deprecated="not deprecated">
  12605. <param name="namenode" type="java.net.InetSocketAddress"/>
  12606. </method>
  12607. <method name="getHostPortString" return="java.lang.String"
  12608. abstract="false" native="false" synchronized="false"
  12609. static="true" final="false" visibility="public"
  12610. deprecated="not deprecated">
  12611. <param name="addr" type="java.net.InetSocketAddress"/>
  12612. <doc>
  12613. <![CDATA[Compose a "host:port" string from the address.]]>
  12614. </doc>
  12615. </method>
  12616. <method name="getRole" return="org.apache.hadoop.hdfs.server.common.HdfsConstants.NamenodeRole"
  12617. abstract="false" native="false" synchronized="false"
  12618. static="false" final="false" visibility="public"
  12619. deprecated="not deprecated">
  12620. </method>
  12621. <method name="getRpcServerAddress" return="java.net.InetSocketAddress"
  12622. abstract="false" native="false" synchronized="false"
  12623. static="false" final="false" visibility="protected"
  12624. deprecated="not deprecated">
  12625. <param name="conf" type="org.apache.hadoop.conf.Configuration"/>
  12626. <exception name="IOException" type="java.io.IOException"/>
  12627. </method>
  12628. <method name="setRpcServerAddress"
  12629. abstract="false" native="false" synchronized="false"
  12630. static="false" final="false" visibility="protected"
  12631. deprecated="not deprecated">
  12632. <param name="conf" type="org.apache.hadoop.conf.Configuration"/>
  12633. </method>
  12634. <method name="getHttpServerAddress" return="java.net.InetSocketAddress"
  12635. abstract="false" native="false" synchronized="false"
  12636. static="false" final="false" visibility="protected"
  12637. deprecated="not deprecated">
  12638. <param name="conf" type="org.apache.hadoop.conf.Configuration"/>
  12639. </method>
  12640. <method name="setHttpServerAddress"
  12641. abstract="false" native="false" synchronized="false"
  12642. static="false" final="false" visibility="protected"
  12643. deprecated="not deprecated">
  12644. <param name="conf" type="org.apache.hadoop.conf.Configuration"/>
  12645. </method>
  12646. <method name="loadNamesystem"
  12647. abstract="false" native="false" synchronized="false"
  12648. static="false" final="false" visibility="protected"
  12649. deprecated="not deprecated">
  12650. <param name="conf" type="org.apache.hadoop.conf.Configuration"/>
  12651. <exception name="IOException" type="java.io.IOException"/>
  12652. </method>
  12653. <method name="initialize"
  12654. abstract="false" native="false" synchronized="false"
  12655. static="false" final="false" visibility="protected"
  12656. deprecated="not deprecated">
  12657. <param name="conf" type="org.apache.hadoop.conf.Configuration"/>
  12658. <exception name="IOException" type="java.io.IOException"/>
  12659. <doc>
  12660. <![CDATA[Initialize name-node.
  12661. @param conf the configuration]]>
  12662. </doc>
  12663. </method>
  12664. <method name="join"
  12665. abstract="false" native="false" synchronized="false"
  12666. static="false" final="false" visibility="public"
  12667. deprecated="not deprecated">
  12668. <doc>
  12669. <![CDATA[Wait for service to finish.
  12670. (Normally, it runs forever.)]]>
  12671. </doc>
  12672. </method>
  12673. <method name="stop"
  12674. abstract="false" native="false" synchronized="false"
  12675. static="false" final="false" visibility="public"
  12676. deprecated="not deprecated">
  12677. <doc>
  12678. <![CDATA[Stop all NameNode threads and wait for all to finish.]]>
  12679. </doc>
  12680. </method>
  12681. <method name="getBlocks" return="org.apache.hadoop.hdfs.server.protocol.BlocksWithLocations"
  12682. abstract="false" native="false" synchronized="false"
  12683. static="false" final="false" visibility="public"
  12684. deprecated="not deprecated">
  12685. <param name="datanode" type="org.apache.hadoop.hdfs.protocol.DatanodeInfo"/>
  12686. <param name="size" type="long"/>
  12687. <exception name="IOException" type="java.io.IOException"/>
  12688. </method>
  12689. <method name="getAccessKeys" return="org.apache.hadoop.hdfs.security.ExportedAccessKeys"
  12690. abstract="false" native="false" synchronized="false"
  12691. static="false" final="false" visibility="public"
  12692. deprecated="not deprecated">
  12693. <exception name="IOException" type="java.io.IOException"/>
  12694. <doc>
  12695. <![CDATA[{@inheritDoc}]]>
  12696. </doc>
  12697. </method>
  12698. <method name="errorReport"
  12699. abstract="false" native="false" synchronized="false"
  12700. static="false" final="false" visibility="public"
  12701. deprecated="not deprecated">
  12702. <param name="registration" type="org.apache.hadoop.hdfs.server.protocol.NamenodeRegistration"/>
  12703. <param name="errorCode" type="int"/>
  12704. <param name="msg" type="java.lang.String"/>
  12705. <exception name="IOException" type="java.io.IOException"/>
  12706. </method>
  12707. <method name="register" return="org.apache.hadoop.hdfs.server.protocol.NamenodeRegistration"
  12708. abstract="false" native="false" synchronized="false"
  12709. static="false" final="false" visibility="public"
  12710. deprecated="not deprecated">
  12711. <param name="registration" type="org.apache.hadoop.hdfs.server.protocol.NamenodeRegistration"/>
  12712. <exception name="IOException" type="java.io.IOException"/>
  12713. </method>
  12714. <method name="startCheckpoint" return="org.apache.hadoop.hdfs.server.protocol.NamenodeCommand"
  12715. abstract="false" native="false" synchronized="false"
  12716. static="false" final="false" visibility="public"
  12717. deprecated="not deprecated">
  12718. <param name="registration" type="org.apache.hadoop.hdfs.server.protocol.NamenodeRegistration"/>
  12719. <exception name="IOException" type="java.io.IOException"/>
  12720. </method>
  12721. <method name="endCheckpoint"
  12722. abstract="false" native="false" synchronized="false"
  12723. static="false" final="false" visibility="public"
  12724. deprecated="not deprecated">
  12725. <param name="registration" type="org.apache.hadoop.hdfs.server.protocol.NamenodeRegistration"/>
  12726. <param name="sig" type="org.apache.hadoop.hdfs.server.namenode.CheckpointSignature"/>
  12727. <exception name="IOException" type="java.io.IOException"/>
  12728. </method>
  12729. <method name="journalSize" return="long"
  12730. abstract="false" native="false" synchronized="false"
  12731. static="false" final="false" visibility="public"
  12732. deprecated="not deprecated">
  12733. <param name="registration" type="org.apache.hadoop.hdfs.server.protocol.NamenodeRegistration"/>
  12734. <exception name="IOException" type="java.io.IOException"/>
  12735. </method>
  12736. <method name="journal"
  12737. abstract="false" native="false" synchronized="false"
  12738. static="false" final="false" visibility="public"
  12739. deprecated="not deprecated">
  12740. <param name="registration" type="org.apache.hadoop.hdfs.server.protocol.NamenodeRegistration"/>
  12741. <param name="jAction" type="int"/>
  12742. <param name="length" type="int"/>
  12743. <param name="args" type="byte[]"/>
  12744. <exception name="IOException" type="java.io.IOException"/>
  12745. </method>
  12746. <method name="getDelegationToken" return="org.apache.hadoop.security.token.Token"
  12747. abstract="false" native="false" synchronized="false"
  12748. static="false" final="false" visibility="public"
  12749. deprecated="not deprecated">
  12750. <param name="renewer" type="org.apache.hadoop.io.Text"/>
  12751. <exception name="IOException" type="java.io.IOException"/>
  12752. </method>
  12753. <method name="renewDelegationToken" return="long"
  12754. abstract="false" native="false" synchronized="false"
  12755. static="false" final="false" visibility="public"
  12756. deprecated="not deprecated">
  12757. <param name="token" type="org.apache.hadoop.security.token.Token"/>
  12758. <exception name="SecretManager.InvalidToken" type="org.apache.hadoop.security.token.SecretManager.InvalidToken"/>
  12759. <exception name="IOException" type="java.io.IOException"/>
  12760. </method>
  12761. <method name="cancelDelegationToken"
  12762. abstract="false" native="false" synchronized="false"
  12763. static="false" final="false" visibility="public"
  12764. deprecated="not deprecated">
  12765. <param name="token" type="org.apache.hadoop.security.token.Token"/>
  12766. <exception name="IOException" type="java.io.IOException"/>
  12767. </method>
  12768. <method name="getBlockLocations" return="org.apache.hadoop.hdfs.protocol.LocatedBlocks"
  12769. abstract="false" native="false" synchronized="false"
  12770. static="false" final="false" visibility="public"
  12771. deprecated="not deprecated">
  12772. <param name="src" type="java.lang.String"/>
  12773. <param name="offset" type="long"/>
  12774. <param name="length" type="long"/>
  12775. <exception name="IOException" type="java.io.IOException"/>
  12776. <doc>
  12777. <![CDATA[{@inheritDoc}]]>
  12778. </doc>
  12779. </method>
  12780. <method name="getServerDefaults" return="org.apache.hadoop.fs.FsServerDefaults"
  12781. abstract="false" native="false" synchronized="false"
  12782. static="false" final="false" visibility="public"
  12783. deprecated="not deprecated">
  12784. <exception name="IOException" type="java.io.IOException"/>
  12785. <doc>
  12786. <![CDATA[{@inheritDoc}]]>
  12787. </doc>
  12788. </method>
  12789. <method name="create"
  12790. abstract="false" native="false" synchronized="false"
  12791. static="false" final="false" visibility="public"
  12792. deprecated="not deprecated">
  12793. <param name="src" type="java.lang.String"/>
  12794. <param name="masked" type="org.apache.hadoop.fs.permission.FsPermission"/>
  12795. <param name="clientName" type="java.lang.String"/>
  12796. <param name="flag" type="org.apache.hadoop.io.EnumSetWritable"/>
  12797. <param name="createParent" type="boolean"/>
  12798. <param name="replication" type="short"/>
  12799. <param name="blockSize" type="long"/>
  12800. <exception name="IOException" type="java.io.IOException"/>
  12801. <doc>
  12802. <![CDATA[{@inheritDoc}]]>
  12803. </doc>
  12804. </method>
  12805. <method name="append" return="org.apache.hadoop.hdfs.protocol.LocatedBlock"
  12806. abstract="false" native="false" synchronized="false"
  12807. static="false" final="false" visibility="public"
  12808. deprecated="not deprecated">
  12809. <param name="src" type="java.lang.String"/>
  12810. <param name="clientName" type="java.lang.String"/>
  12811. <exception name="IOException" type="java.io.IOException"/>
  12812. <doc>
  12813. <![CDATA[{@inheritDoc}]]>
  12814. </doc>
  12815. </method>
  12816. <method name="setReplication" return="boolean"
  12817. abstract="false" native="false" synchronized="false"
  12818. static="false" final="false" visibility="public"
  12819. deprecated="not deprecated">
  12820. <param name="src" type="java.lang.String"/>
  12821. <param name="replication" type="short"/>
  12822. <exception name="IOException" type="java.io.IOException"/>
  12823. <doc>
  12824. <![CDATA[{@inheritDoc}]]>
  12825. </doc>
  12826. </method>
  12827. <method name="setPermission"
  12828. abstract="false" native="false" synchronized="false"
  12829. static="false" final="false" visibility="public"
  12830. deprecated="not deprecated">
  12831. <param name="src" type="java.lang.String"/>
  12832. <param name="permissions" type="org.apache.hadoop.fs.permission.FsPermission"/>
  12833. <exception name="IOException" type="java.io.IOException"/>
  12834. <doc>
  12835. <![CDATA[{@inheritDoc}]]>
  12836. </doc>
  12837. </method>
  12838. <method name="setOwner"
  12839. abstract="false" native="false" synchronized="false"
  12840. static="false" final="false" visibility="public"
  12841. deprecated="not deprecated">
  12842. <param name="src" type="java.lang.String"/>
  12843. <param name="username" type="java.lang.String"/>
  12844. <param name="groupname" type="java.lang.String"/>
  12845. <exception name="IOException" type="java.io.IOException"/>
  12846. <doc>
  12847. <![CDATA[{@inheritDoc}]]>
  12848. </doc>
  12849. </method>
  12850. <method name="addBlock" return="org.apache.hadoop.hdfs.protocol.LocatedBlock"
  12851. abstract="false" native="false" synchronized="false"
  12852. static="false" final="false" visibility="public"
  12853. deprecated="not deprecated">
  12854. <param name="src" type="java.lang.String"/>
  12855. <param name="clientName" type="java.lang.String"/>
  12856. <param name="previous" type="org.apache.hadoop.hdfs.protocol.Block"/>
  12857. <param name="excludedNodes" type="org.apache.hadoop.hdfs.protocol.DatanodeInfo[]"/>
  12858. <exception name="IOException" type="java.io.IOException"/>
  12859. </method>
  12860. <method name="abandonBlock"
  12861. abstract="false" native="false" synchronized="false"
  12862. static="false" final="false" visibility="public"
  12863. deprecated="not deprecated">
  12864. <param name="b" type="org.apache.hadoop.hdfs.protocol.Block"/>
  12865. <param name="src" type="java.lang.String"/>
  12866. <param name="holder" type="java.lang.String"/>
  12867. <exception name="IOException" type="java.io.IOException"/>
  12868. <doc>
  12869. <![CDATA[The client needs to give up on the block.]]>
  12870. </doc>
  12871. </method>
  12872. <method name="complete" return="boolean"
  12873. abstract="false" native="false" synchronized="false"
  12874. static="false" final="false" visibility="public"
  12875. deprecated="not deprecated">
  12876. <param name="src" type="java.lang.String"/>
  12877. <param name="clientName" type="java.lang.String"/>
  12878. <param name="last" type="org.apache.hadoop.hdfs.protocol.Block"/>
  12879. <exception name="IOException" type="java.io.IOException"/>
  12880. <doc>
  12881. <![CDATA[{@inheritDoc}]]>
  12882. </doc>
  12883. </method>
  12884. <method name="reportBadBlocks"
  12885. abstract="false" native="false" synchronized="false"
  12886. static="false" final="false" visibility="public"
  12887. deprecated="not deprecated">
  12888. <param name="blocks" type="org.apache.hadoop.hdfs.protocol.LocatedBlock[]"/>
  12889. <exception name="IOException" type="java.io.IOException"/>
  12890. <doc>
  12891. <![CDATA[The client has detected an error on the specified located blocks
  12892. and is reporting them to the server. For now, the namenode will
  12893. mark the block as corrupt. In the future we might
  12894. check the blocks are actually corrupt.]]>
  12895. </doc>
  12896. </method>
  12897. <method name="updateBlockForPipeline" return="org.apache.hadoop.hdfs.protocol.LocatedBlock"
  12898. abstract="false" native="false" synchronized="false"
  12899. static="false" final="false" visibility="public"
  12900. deprecated="not deprecated">
  12901. <param name="block" type="org.apache.hadoop.hdfs.protocol.Block"/>
  12902. <param name="clientName" type="java.lang.String"/>
  12903. <exception name="IOException" type="java.io.IOException"/>
  12904. <doc>
  12905. <![CDATA[{@inheritDoc}]]>
  12906. </doc>
  12907. </method>
  12908. <method name="updatePipeline"
  12909. abstract="false" native="false" synchronized="false"
  12910. static="false" final="false" visibility="public"
  12911. deprecated="not deprecated">
  12912. <param name="clientName" type="java.lang.String"/>
  12913. <param name="oldBlock" type="org.apache.hadoop.hdfs.protocol.Block"/>
  12914. <param name="newBlock" type="org.apache.hadoop.hdfs.protocol.Block"/>
  12915. <param name="newNodes" type="org.apache.hadoop.hdfs.protocol.DatanodeID[]"/>
  12916. <exception name="IOException" type="java.io.IOException"/>
  12917. </method>
  12918. <method name="commitBlockSynchronization"
  12919. abstract="false" native="false" synchronized="false"
  12920. static="false" final="false" visibility="public"
  12921. deprecated="not deprecated">
  12922. <param name="block" type="org.apache.hadoop.hdfs.protocol.Block"/>
  12923. <param name="newgenerationstamp" type="long"/>
  12924. <param name="newlength" type="long"/>
  12925. <param name="closeFile" type="boolean"/>
  12926. <param name="deleteblock" type="boolean"/>
  12927. <param name="newtargets" type="org.apache.hadoop.hdfs.protocol.DatanodeID[]"/>
  12928. <exception name="IOException" type="java.io.IOException"/>
  12929. <doc>
  12930. <![CDATA[{@inheritDoc}]]>
  12931. </doc>
  12932. </method>
  12933. <method name="getPreferredBlockSize" return="long"
  12934. abstract="false" native="false" synchronized="false"
  12935. static="false" final="false" visibility="public"
  12936. deprecated="not deprecated">
  12937. <param name="filename" type="java.lang.String"/>
  12938. <exception name="IOException" type="java.io.IOException"/>
  12939. </method>
  12940. <method name="rename" return="boolean"
  12941. abstract="false" native="false" synchronized="false"
  12942. static="false" final="false" visibility="public"
  12943. deprecated="not deprecated">
  12944. <param name="src" type="java.lang.String"/>
  12945. <param name="dst" type="java.lang.String"/>
  12946. <exception name="IOException" type="java.io.IOException"/>
  12947. <doc>
  12948. <![CDATA[{@inheritDoc}]]>
  12949. </doc>
  12950. </method>
  12951. <method name="concat"
  12952. abstract="false" native="false" synchronized="false"
  12953. static="false" final="false" visibility="public"
  12954. deprecated="not deprecated">
  12955. <param name="trg" type="java.lang.String"/>
  12956. <param name="src" type="java.lang.String[]"/>
  12957. <exception name="IOException" type="java.io.IOException"/>
  12958. <doc>
  12959. <![CDATA[{@inheritDoc}]]>
  12960. </doc>
  12961. </method>
  12962. <method name="rename"
  12963. abstract="false" native="false" synchronized="false"
  12964. static="false" final="false" visibility="public"
  12965. deprecated="not deprecated">
  12966. <param name="src" type="java.lang.String"/>
  12967. <param name="dst" type="java.lang.String"/>
  12968. <param name="options" type="org.apache.hadoop.fs.Options.Rename[]"/>
  12969. <exception name="IOException" type="java.io.IOException"/>
  12970. <doc>
  12971. <![CDATA[{@inheritDoc}]]>
  12972. </doc>
  12973. </method>
  12974. <method name="delete" return="boolean"
  12975. abstract="false" native="false" synchronized="false"
  12976. static="false" final="false" visibility="public"
  12977. deprecated="not deprecated">
  12978. <param name="src" type="java.lang.String"/>
  12979. <exception name="IOException" type="java.io.IOException"/>
  12980. </method>
  12981. <method name="delete" return="boolean"
  12982. abstract="false" native="false" synchronized="false"
  12983. static="false" final="false" visibility="public"
  12984. deprecated="not deprecated">
  12985. <param name="src" type="java.lang.String"/>
  12986. <param name="recursive" type="boolean"/>
  12987. <exception name="IOException" type="java.io.IOException"/>
  12988. <doc>
  12989. <![CDATA[{@inheritDoc}]]>
  12990. </doc>
  12991. </method>
  12992. <method name="mkdirs" return="boolean"
  12993. abstract="false" native="false" synchronized="false"
  12994. static="false" final="false" visibility="public"
  12995. deprecated="not deprecated">
  12996. <param name="src" type="java.lang.String"/>
  12997. <param name="masked" type="org.apache.hadoop.fs.permission.FsPermission"/>
  12998. <param name="createParent" type="boolean"/>
  12999. <exception name="IOException" type="java.io.IOException"/>
  13000. <doc>
  13001. <![CDATA[{@inheritDoc}]]>
  13002. </doc>
  13003. </method>
  13004. <method name="renewLease"
  13005. abstract="false" native="false" synchronized="false"
  13006. static="false" final="false" visibility="public"
  13007. deprecated="not deprecated">
  13008. <param name="clientName" type="java.lang.String"/>
  13009. <exception name="IOException" type="java.io.IOException"/>
  13010. </method>
  13011. <method name="getListing" return="org.apache.hadoop.hdfs.protocol.DirectoryListing"
  13012. abstract="false" native="false" synchronized="false"
  13013. static="false" final="false" visibility="public"
  13014. deprecated="not deprecated">
  13015. <param name="src" type="java.lang.String"/>
  13016. <param name="startAfter" type="byte[]"/>
  13017. <exception name="IOException" type="java.io.IOException"/>
  13018. </method>
  13019. <method name="getFileInfo" return="org.apache.hadoop.hdfs.protocol.HdfsFileStatus"
  13020. abstract="false" native="false" synchronized="false"
  13021. static="false" final="false" visibility="public"
  13022. deprecated="not deprecated">
  13023. <param name="src" type="java.lang.String"/>
  13024. <exception name="IOException" type="java.io.IOException"/>
  13025. <doc>
  13026. <![CDATA[Get the file info for a specific file.
  13027. @param src The string representation of the path to the file
  13028. @return object containing information regarding the file
  13029. or null if file not found]]>
  13030. </doc>
  13031. </method>
  13032. <method name="getFileLinkInfo" return="org.apache.hadoop.hdfs.protocol.HdfsFileStatus"
  13033. abstract="false" native="false" synchronized="false"
  13034. static="false" final="false" visibility="public"
  13035. deprecated="not deprecated">
  13036. <param name="src" type="java.lang.String"/>
  13037. <exception name="IOException" type="java.io.IOException"/>
  13038. <doc>
  13039. <![CDATA[Get the file info for a specific file. If the path refers to a
  13040. symlink then the FileStatus of the symlink is returned.
  13041. @param src The string representation of the path to the file
  13042. @return object containing information regarding the file
  13043. or null if file not found]]>
  13044. </doc>
  13045. </method>
  13046. <method name="getStats" return="long[]"
  13047. abstract="false" native="false" synchronized="false"
  13048. static="false" final="false" visibility="public"
  13049. deprecated="not deprecated">
  13050. <doc>
  13051. <![CDATA[@inheritDoc]]>
  13052. </doc>
  13053. </method>
  13054. <method name="getDatanodeReport" return="org.apache.hadoop.hdfs.protocol.DatanodeInfo[]"
  13055. abstract="false" native="false" synchronized="false"
  13056. static="false" final="false" visibility="public"
  13057. deprecated="not deprecated">
  13058. <param name="type" type="org.apache.hadoop.hdfs.protocol.FSConstants.DatanodeReportType"/>
  13059. <exception name="IOException" type="java.io.IOException"/>
  13060. </method>
  13061. <method name="setSafeMode" return="boolean"
  13062. abstract="false" native="false" synchronized="false"
  13063. static="false" final="false" visibility="public"
  13064. deprecated="not deprecated">
  13065. <param name="action" type="org.apache.hadoop.hdfs.protocol.FSConstants.SafeModeAction"/>
  13066. <exception name="IOException" type="java.io.IOException"/>
  13067. <doc>
  13068. <![CDATA[@inheritDoc]]>
  13069. </doc>
  13070. </method>
  13071. <method name="isInSafeMode" return="boolean"
  13072. abstract="false" native="false" synchronized="false"
  13073. static="false" final="false" visibility="public"
  13074. deprecated="not deprecated">
  13075. <doc>
  13076. <![CDATA[Is the cluster currently in safe mode?]]>
  13077. </doc>
  13078. </method>
  13079. <method name="restoreFailedStorage" return="boolean"
  13080. abstract="false" native="false" synchronized="false"
  13081. static="false" final="false" visibility="public"
  13082. deprecated="not deprecated">
  13083. <param name="arg" type="java.lang.String"/>
  13084. <exception name="AccessControlException" type="org.apache.hadoop.security.AccessControlException"/>
  13085. <doc>
  13086. <![CDATA[@throws AccessControlException
  13087. @inheritDoc]]>
  13088. </doc>
  13089. </method>
  13090. <method name="saveNamespace"
  13091. abstract="false" native="false" synchronized="false"
  13092. static="false" final="false" visibility="public"
  13093. deprecated="not deprecated">
  13094. <exception name="IOException" type="java.io.IOException"/>
  13095. <doc>
  13096. <![CDATA[@inheritDoc]]>
  13097. </doc>
  13098. </method>
  13099. <method name="refreshNodes"
  13100. abstract="false" native="false" synchronized="false"
  13101. static="false" final="false" visibility="public"
  13102. deprecated="not deprecated">
  13103. <exception name="IOException" type="java.io.IOException"/>
  13104. <doc>
  13105. <![CDATA[Refresh the list of datanodes that the namenode should allow to
  13106. connect. Re-reads conf by creating new HdfsConfiguration object and
  13107. uses the files list in the configuration to update the list.]]>
  13108. </doc>
  13109. </method>
  13110. <method name="getEditLogSize" return="long"
  13111. abstract="false" native="false" synchronized="false"
  13112. static="false" final="false" visibility="public"
  13113. deprecated="not deprecated">
  13114. <exception name="IOException" type="java.io.IOException"/>
  13115. <doc>
  13116. <![CDATA[Returns the size of the current edit log.]]>
  13117. </doc>
  13118. </method>
  13119. <method name="rollEditLog" return="org.apache.hadoop.hdfs.server.namenode.CheckpointSignature"
  13120. abstract="false" native="false" synchronized="false"
  13121. static="false" final="false" visibility="public"
  13122. deprecated="not deprecated">
  13123. <exception name="IOException" type="java.io.IOException"/>
  13124. <doc>
  13125. <![CDATA[Roll the edit log.]]>
  13126. </doc>
  13127. </method>
  13128. <method name="rollFsImage"
  13129. abstract="false" native="false" synchronized="false"
  13130. static="false" final="false" visibility="public"
  13131. deprecated="not deprecated">
  13132. <exception name="IOException" type="java.io.IOException"/>
  13133. <doc>
  13134. <![CDATA[Roll the image]]>
  13135. </doc>
  13136. </method>
  13137. <method name="finalizeUpgrade"
  13138. abstract="false" native="false" synchronized="false"
  13139. static="false" final="false" visibility="public"
  13140. deprecated="not deprecated">
  13141. <exception name="IOException" type="java.io.IOException"/>
  13142. </method>
  13143. <method name="distributedUpgradeProgress" return="org.apache.hadoop.hdfs.server.common.UpgradeStatusReport"
  13144. abstract="false" native="false" synchronized="false"
  13145. static="false" final="false" visibility="public"
  13146. deprecated="not deprecated">
  13147. <param name="action" type="org.apache.hadoop.hdfs.protocol.FSConstants.UpgradeAction"/>
  13148. <exception name="IOException" type="java.io.IOException"/>
  13149. </method>
  13150. <method name="metaSave"
  13151. abstract="false" native="false" synchronized="false"
  13152. static="false" final="false" visibility="public"
  13153. deprecated="not deprecated">
  13154. <param name="filename" type="java.lang.String"/>
  13155. <exception name="IOException" type="java.io.IOException"/>
  13156. <doc>
  13157. <![CDATA[Dumps namenode state into specified file]]>
  13158. </doc>
  13159. </method>
  13160. <method name="getCorruptFiles" return="org.apache.hadoop.fs.FileStatus[]"
  13161. abstract="false" native="false" synchronized="false"
  13162. static="false" final="false" visibility="public"
  13163. deprecated="not deprecated">
  13164. <exception name="AccessControlException" type="org.apache.hadoop.security.AccessControlException"/>
  13165. <exception name="IOException" type="java.io.IOException"/>
  13166. <doc>
  13167. <![CDATA[{@inheritDoc}]]>
  13168. </doc>
  13169. </method>
  13170. <method name="getContentSummary" return="org.apache.hadoop.fs.ContentSummary"
  13171. abstract="false" native="false" synchronized="false"
  13172. static="false" final="false" visibility="public"
  13173. deprecated="not deprecated">
  13174. <param name="path" type="java.lang.String"/>
  13175. <exception name="IOException" type="java.io.IOException"/>
  13176. <doc>
  13177. <![CDATA[{@inheritDoc}]]>
  13178. </doc>
  13179. </method>
  13180. <method name="setQuota"
  13181. abstract="false" native="false" synchronized="false"
  13182. static="false" final="false" visibility="public"
  13183. deprecated="not deprecated">
  13184. <param name="path" type="java.lang.String"/>
  13185. <param name="namespaceQuota" type="long"/>
  13186. <param name="diskspaceQuota" type="long"/>
  13187. <exception name="IOException" type="java.io.IOException"/>
  13188. <doc>
  13189. <![CDATA[{@inheritDoc}]]>
  13190. </doc>
  13191. </method>
  13192. <method name="fsync"
  13193. abstract="false" native="false" synchronized="false"
  13194. static="false" final="false" visibility="public"
  13195. deprecated="not deprecated">
  13196. <param name="src" type="java.lang.String"/>
  13197. <param name="clientName" type="java.lang.String"/>
  13198. <exception name="IOException" type="java.io.IOException"/>
  13199. <doc>
  13200. <![CDATA[{@inheritDoc}]]>
  13201. </doc>
  13202. </method>
  13203. <method name="setTimes"
  13204. abstract="false" native="false" synchronized="false"
  13205. static="false" final="false" visibility="public"
  13206. deprecated="not deprecated">
  13207. <param name="src" type="java.lang.String"/>
  13208. <param name="mtime" type="long"/>
  13209. <param name="atime" type="long"/>
  13210. <exception name="IOException" type="java.io.IOException"/>
  13211. <doc>
  13212. <![CDATA[@inheritDoc]]>
  13213. </doc>
  13214. </method>
  13215. <method name="createSymlink"
  13216. abstract="false" native="false" synchronized="false"
  13217. static="false" final="false" visibility="public"
  13218. deprecated="not deprecated">
  13219. <param name="target" type="java.lang.String"/>
  13220. <param name="link" type="java.lang.String"/>
  13221. <param name="dirPerms" type="org.apache.hadoop.fs.permission.FsPermission"/>
  13222. <param name="createParent" type="boolean"/>
  13223. <exception name="IOException" type="java.io.IOException"/>
  13224. <doc>
  13225. <![CDATA[@inheritDoc]]>
  13226. </doc>
  13227. </method>
  13228. <method name="getLinkTarget" return="java.lang.String"
  13229. abstract="false" native="false" synchronized="false"
  13230. static="false" final="false" visibility="public"
  13231. deprecated="not deprecated">
  13232. <param name="path" type="java.lang.String"/>
  13233. <exception name="IOException" type="java.io.IOException"/>
  13234. <doc>
  13235. <![CDATA[@inheritDoc]]>
  13236. </doc>
  13237. </method>
  13238. <method name="registerDatanode" return="org.apache.hadoop.hdfs.server.protocol.DatanodeRegistration"
  13239. abstract="false" native="false" synchronized="false"
  13240. static="false" final="false" visibility="public"
  13241. deprecated="not deprecated">
  13242. <param name="nodeReg" type="org.apache.hadoop.hdfs.server.protocol.DatanodeRegistration"/>
  13243. <exception name="IOException" type="java.io.IOException"/>
  13244. </method>
  13245. <method name="sendHeartbeat" return="org.apache.hadoop.hdfs.server.protocol.DatanodeCommand[]"
  13246. abstract="false" native="false" synchronized="false"
  13247. static="false" final="false" visibility="public"
  13248. deprecated="not deprecated">
  13249. <param name="nodeReg" type="org.apache.hadoop.hdfs.server.protocol.DatanodeRegistration"/>
  13250. <param name="capacity" type="long"/>
  13251. <param name="dfsUsed" type="long"/>
  13252. <param name="remaining" type="long"/>
  13253. <param name="xmitsInProgress" type="int"/>
  13254. <param name="xceiverCount" type="int"/>
  13255. <exception name="IOException" type="java.io.IOException"/>
  13256. <doc>
  13257. <![CDATA[Data node notify the name node that it is alive
  13258. Return an array of block-oriented commands for the datanode to execute.
  13259. This will be either a transfer or a delete operation.]]>
  13260. </doc>
  13261. </method>
  13262. <method name="blockReport" return="org.apache.hadoop.hdfs.server.protocol.DatanodeCommand"
  13263. abstract="false" native="false" synchronized="false"
  13264. static="false" final="false" visibility="public"
  13265. deprecated="not deprecated">
  13266. <param name="nodeReg" type="org.apache.hadoop.hdfs.server.protocol.DatanodeRegistration"/>
  13267. <param name="blocks" type="long[]"/>
  13268. <exception name="IOException" type="java.io.IOException"/>
  13269. </method>
  13270. <method name="blockReceived"
  13271. abstract="false" native="false" synchronized="false"
  13272. static="false" final="false" visibility="public"
  13273. deprecated="not deprecated">
  13274. <param name="nodeReg" type="org.apache.hadoop.hdfs.server.protocol.DatanodeRegistration"/>
  13275. <param name="blocks" type="org.apache.hadoop.hdfs.protocol.Block[]"/>
  13276. <param name="delHints" type="java.lang.String[]"/>
  13277. <exception name="IOException" type="java.io.IOException"/>
  13278. </method>
  13279. <method name="errorReport"
  13280. abstract="false" native="false" synchronized="false"
  13281. static="false" final="false" visibility="public"
  13282. deprecated="not deprecated">
  13283. <param name="nodeReg" type="org.apache.hadoop.hdfs.server.protocol.DatanodeRegistration"/>
  13284. <param name="errorCode" type="int"/>
  13285. <param name="msg" type="java.lang.String"/>
  13286. <exception name="IOException" type="java.io.IOException"/>
  13287. </method>
  13288. <method name="versionRequest" return="org.apache.hadoop.hdfs.server.protocol.NamespaceInfo"
  13289. abstract="false" native="false" synchronized="false"
  13290. static="false" final="false" visibility="public"
  13291. deprecated="not deprecated">
  13292. <exception name="IOException" type="java.io.IOException"/>
  13293. </method>
  13294. <method name="processUpgradeCommand" return="org.apache.hadoop.hdfs.server.protocol.UpgradeCommand"
  13295. abstract="false" native="false" synchronized="false"
  13296. static="false" final="false" visibility="public"
  13297. deprecated="not deprecated">
  13298. <param name="comm" type="org.apache.hadoop.hdfs.server.protocol.UpgradeCommand"/>
  13299. <exception name="IOException" type="java.io.IOException"/>
  13300. </method>
  13301. <method name="verifyRequest"
  13302. abstract="false" native="false" synchronized="false"
  13303. static="false" final="false" visibility="public"
  13304. deprecated="not deprecated">
  13305. <param name="nodeReg" type="org.apache.hadoop.hdfs.server.protocol.NodeRegistration"/>
  13306. <exception name="IOException" type="java.io.IOException"/>
  13307. <doc>
  13308. <![CDATA[Verify request.
  13309. Verifies correctness of the datanode version, registration ID, and
  13310. if the datanode does not need to be shutdown.
  13311. @param nodeReg data node registration
  13312. @throws IOException]]>
  13313. </doc>
  13314. </method>
  13315. <method name="verifyVersion"
  13316. abstract="false" native="false" synchronized="false"
  13317. static="false" final="false" visibility="public"
  13318. deprecated="not deprecated">
  13319. <param name="version" type="int"/>
  13320. <exception name="IOException" type="java.io.IOException"/>
  13321. <doc>
  13322. <![CDATA[Verify version.
  13323. @param version
  13324. @throws IOException]]>
  13325. </doc>
  13326. </method>
  13327. <method name="getFsImageName" return="java.io.File"
  13328. abstract="false" native="false" synchronized="false"
  13329. static="false" final="false" visibility="public"
  13330. deprecated="not deprecated">
  13331. <exception name="IOException" type="java.io.IOException"/>
  13332. <doc>
  13333. <![CDATA[Returns the name of the fsImage file]]>
  13334. </doc>
  13335. </method>
  13336. <method name="getFSImage" return="org.apache.hadoop.hdfs.server.namenode.FSImage"
  13337. abstract="false" native="false" synchronized="false"
  13338. static="false" final="false" visibility="public"
  13339. deprecated="not deprecated">
  13340. </method>
  13341. <method name="getFsImageNameCheckpoint" return="java.io.File[]"
  13342. abstract="false" native="false" synchronized="false"
  13343. static="false" final="false" visibility="public"
  13344. deprecated="not deprecated">
  13345. <exception name="IOException" type="java.io.IOException"/>
  13346. <doc>
  13347. <![CDATA[Returns the name of the fsImage file uploaded by periodic
  13348. checkpointing]]>
  13349. </doc>
  13350. </method>
  13351. <method name="getNameNodeAddress" return="java.net.InetSocketAddress"
  13352. abstract="false" native="false" synchronized="false"
  13353. static="false" final="false" visibility="public"
  13354. deprecated="not deprecated">
  13355. <doc>
  13356. <![CDATA[Returns the address on which the NameNodes is listening to.
  13357. @return the address on which the NameNodes is listening to.]]>
  13358. </doc>
  13359. </method>
  13360. <method name="getHttpAddress" return="java.net.InetSocketAddress"
  13361. abstract="false" native="false" synchronized="false"
  13362. static="false" final="false" visibility="public"
  13363. deprecated="not deprecated">
  13364. <doc>
  13365. <![CDATA[Returns the address of the NameNodes http server,
  13366. which is used to access the name-node web UI.
  13367. @return the http address.]]>
  13368. </doc>
  13369. </method>
  13370. <method name="refreshServiceAcl"
  13371. abstract="false" native="false" synchronized="false"
  13372. static="false" final="false" visibility="public"
  13373. deprecated="not deprecated">
  13374. <exception name="IOException" type="java.io.IOException"/>
  13375. </method>
  13376. <method name="refreshUserToGroupsMappings"
  13377. abstract="false" native="false" synchronized="false"
  13378. static="false" final="false" visibility="public"
  13379. deprecated="not deprecated">
  13380. <param name="conf" type="org.apache.hadoop.conf.Configuration"/>
  13381. <exception name="IOException" type="java.io.IOException"/>
  13382. </method>
  13383. <method name="createNameNode" return="org.apache.hadoop.hdfs.server.namenode.NameNode"
  13384. abstract="false" native="false" synchronized="false"
  13385. static="true" final="false" visibility="public"
  13386. deprecated="not deprecated">
  13387. <param name="argv" type="java.lang.String[]"/>
  13388. <param name="conf" type="org.apache.hadoop.conf.Configuration"/>
  13389. <exception name="IOException" type="java.io.IOException"/>
  13390. </method>
  13391. <method name="main"
  13392. abstract="false" native="false" synchronized="false"
  13393. static="true" final="false" visibility="public"
  13394. deprecated="not deprecated">
  13395. <param name="argv" type="java.lang.String[]"/>
  13396. <exception name="Exception" type="java.lang.Exception"/>
  13397. </method>
  13398. <field name="DEFAULT_PORT" type="int"
  13399. transient="false" volatile="false"
  13400. static="true" final="true" visibility="public"
  13401. deprecated="not deprecated">
  13402. </field>
  13403. <field name="LOG" type="org.apache.commons.logging.Log"
  13404. transient="false" volatile="false"
  13405. static="true" final="true" visibility="public"
  13406. deprecated="not deprecated">
  13407. </field>
  13408. <field name="stateChangeLog" type="org.apache.commons.logging.Log"
  13409. transient="false" volatile="false"
  13410. static="true" final="true" visibility="public"
  13411. deprecated="not deprecated">
  13412. </field>
  13413. <field name="namesystem" type="org.apache.hadoop.hdfs.server.namenode.FSNamesystem"
  13414. transient="false" volatile="false"
  13415. static="false" final="false" visibility="protected"
  13416. deprecated="not deprecated">
  13417. </field>
  13418. <field name="role" type="org.apache.hadoop.hdfs.server.common.HdfsConstants.NamenodeRole"
  13419. transient="false" volatile="false"
  13420. static="false" final="false" visibility="protected"
  13421. deprecated="not deprecated">
  13422. </field>
  13423. <field name="server" type="org.apache.hadoop.ipc.Server"
  13424. transient="false" volatile="false"
  13425. static="false" final="false" visibility="protected"
  13426. deprecated="not deprecated">
  13427. <doc>
  13428. <![CDATA[RPC server]]>
  13429. </doc>
  13430. </field>
  13431. <field name="rpcAddress" type="java.net.InetSocketAddress"
  13432. transient="false" volatile="false"
  13433. static="false" final="false" visibility="protected"
  13434. deprecated="not deprecated">
  13435. <doc>
  13436. <![CDATA[RPC server address]]>
  13437. </doc>
  13438. </field>
  13439. <field name="httpServer" type="org.apache.hadoop.http.HttpServer"
  13440. transient="false" volatile="false"
  13441. static="false" final="false" visibility="protected"
  13442. deprecated="not deprecated">
  13443. <doc>
  13444. <![CDATA[httpServer]]>
  13445. </doc>
  13446. </field>
  13447. <field name="httpAddress" type="java.net.InetSocketAddress"
  13448. transient="false" volatile="false"
  13449. static="false" final="false" visibility="protected"
  13450. deprecated="not deprecated">
  13451. <doc>
  13452. <![CDATA[HTTP server address]]>
  13453. </doc>
  13454. </field>
  13455. <field name="stopRequested" type="boolean"
  13456. transient="false" volatile="false"
  13457. static="false" final="false" visibility="protected"
  13458. deprecated="not deprecated">
  13459. <doc>
  13460. <![CDATA[only used for testing purposes]]>
  13461. </doc>
  13462. </field>
  13463. <field name="nodeRegistration" type="org.apache.hadoop.hdfs.server.protocol.NamenodeRegistration"
  13464. transient="false" volatile="false"
  13465. static="false" final="false" visibility="protected"
  13466. deprecated="not deprecated">
  13467. <doc>
  13468. <![CDATA[Registration information of this name-node]]>
  13469. </doc>
  13470. </field>
  13471. <doc>
  13472. <![CDATA[NameNode serves as both directory namespace manager and
  13473. "inode table" for the Hadoop DFS. There is a single NameNode
  13474. running in any DFS deployment. (Well, except when there
  13475. is a second backup/failover NameNode.)
  13476. The NameNode controls two critical tables:
  13477. 1) filename->blocksequence (namespace)
  13478. 2) block->machinelist ("inodes")
  13479. The first table is stored on disk and is very precious.
  13480. The second table is rebuilt every time the NameNode comes
  13481. up.
  13482. 'NameNode' refers to both this class as well as the 'NameNode server'.
  13483. The 'FSNamesystem' class actually performs most of the filesystem
  13484. management. The majority of the 'NameNode' class itself is concerned
  13485. with exposing the IPC interface and the http server to the outside world,
  13486. plus some configuration management.
  13487. NameNode implements the ClientProtocol interface, which allows
  13488. clients to ask for DFS services. ClientProtocol is not
  13489. designed for direct use by authors of DFS client code. End-users
  13490. should instead use the org.apache.nutch.hadoop.fs.FileSystem class.
  13491. NameNode also implements the DatanodeProtocol interface, used by
  13492. DataNode programs that actually store DFS data blocks. These
  13493. methods are invoked repeatedly and automatically by all the
  13494. DataNodes in a DFS deployment.
  13495. NameNode also implements the NamenodeProtocol interface, used by
  13496. secondary namenodes or rebalancing processes to get partial namenode's
  13497. state, for example partial blocksMap etc.]]>
  13498. </doc>
  13499. </class>
  13500. <!-- end class org.apache.hadoop.hdfs.server.namenode.NameNode -->
  13501. <!-- start class org.apache.hadoop.hdfs.server.namenode.NamenodeFsck -->
  13502. <class name="NamenodeFsck" extends="java.lang.Object"
  13503. abstract="false"
  13504. static="false" final="false" visibility="public"
  13505. deprecated="not deprecated">
  13506. <method name="fsck"
  13507. abstract="false" native="false" synchronized="false"
  13508. static="false" final="false" visibility="public"
  13509. deprecated="not deprecated">
  13510. <doc>
  13511. <![CDATA[Check files on DFS, starting from the indicated path.]]>
  13512. </doc>
  13513. </method>
  13514. <field name="LOG" type="org.apache.commons.logging.Log"
  13515. transient="false" volatile="false"
  13516. static="true" final="true" visibility="public"
  13517. deprecated="not deprecated">
  13518. </field>
  13519. <field name="CORRUPT_STATUS" type="java.lang.String"
  13520. transient="false" volatile="false"
  13521. static="true" final="true" visibility="public"
  13522. deprecated="not deprecated">
  13523. </field>
  13524. <field name="HEALTHY_STATUS" type="java.lang.String"
  13525. transient="false" volatile="false"
  13526. static="true" final="true" visibility="public"
  13527. deprecated="not deprecated">
  13528. </field>
  13529. <field name="NONEXISTENT_STATUS" type="java.lang.String"
  13530. transient="false" volatile="false"
  13531. static="true" final="true" visibility="public"
  13532. deprecated="not deprecated">
  13533. </field>
  13534. <field name="FAILURE_STATUS" type="java.lang.String"
  13535. transient="false" volatile="false"
  13536. static="true" final="true" visibility="public"
  13537. deprecated="not deprecated">
  13538. </field>
  13539. <field name="FIXING_NONE" type="int"
  13540. transient="false" volatile="false"
  13541. static="true" final="true" visibility="public"
  13542. deprecated="not deprecated">
  13543. <doc>
  13544. <![CDATA[Don't attempt any fixing .]]>
  13545. </doc>
  13546. </field>
  13547. <field name="FIXING_MOVE" type="int"
  13548. transient="false" volatile="false"
  13549. static="true" final="true" visibility="public"
  13550. deprecated="not deprecated">
  13551. <doc>
  13552. <![CDATA[Move corrupted files to /lost+found .]]>
  13553. </doc>
  13554. </field>
  13555. <field name="FIXING_DELETE" type="int"
  13556. transient="false" volatile="false"
  13557. static="true" final="true" visibility="public"
  13558. deprecated="not deprecated">
  13559. <doc>
  13560. <![CDATA[Delete corrupted files.]]>
  13561. </doc>
  13562. </field>
  13563. <doc>
  13564. <![CDATA[This class provides rudimentary checking of DFS volumes for errors and
  13565. sub-optimal conditions.
  13566. <p>The tool scans all files and directories, starting from an indicated
  13567. root path. The following abnormal conditions are detected and handled:</p>
  13568. <ul>
  13569. <li>files with blocks that are completely missing from all datanodes.<br/>
  13570. In this case the tool can perform one of the following actions:
  13571. <ul>
  13572. <li>none ({@link #FIXING_NONE})</li>
  13573. <li>move corrupted files to /lost+found directory on DFS
  13574. ({@link #FIXING_MOVE}). Remaining data blocks are saved as a
  13575. block chains, representing longest consecutive series of valid blocks.</li>
  13576. <li>delete corrupted files ({@link #FIXING_DELETE})</li>
  13577. </ul>
  13578. </li>
  13579. <li>detect files with under-replicated or over-replicated blocks</li>
  13580. </ul>
  13581. Additionally, the tool collects a detailed overall DFS statistics, and
  13582. optionally can print detailed statistics on block locations and replication
  13583. factors of each file.]]>
  13584. </doc>
  13585. </class>
  13586. <!-- end class org.apache.hadoop.hdfs.server.namenode.NamenodeFsck -->
  13587. <!-- start class org.apache.hadoop.hdfs.server.namenode.NotReplicatedYetException -->
  13588. <class name="NotReplicatedYetException" extends="java.io.IOException"
  13589. abstract="false"
  13590. static="false" final="false" visibility="public"
  13591. deprecated="not deprecated">
  13592. <constructor name="NotReplicatedYetException" type="java.lang.String"
  13593. static="false" final="false" visibility="public"
  13594. deprecated="not deprecated">
  13595. </constructor>
  13596. <doc>
  13597. <![CDATA[The file has not finished being written to enough datanodes yet.]]>
  13598. </doc>
  13599. </class>
  13600. <!-- end class org.apache.hadoop.hdfs.server.namenode.NotReplicatedYetException -->
  13601. <!-- start class org.apache.hadoop.hdfs.server.namenode.SafeModeException -->
  13602. <class name="SafeModeException" extends="java.io.IOException"
  13603. abstract="false"
  13604. static="false" final="false" visibility="public"
  13605. deprecated="not deprecated">
  13606. <constructor name="SafeModeException"
  13607. static="false" final="false" visibility="public"
  13608. deprecated="not deprecated">
  13609. </constructor>
  13610. <constructor name="SafeModeException" type="java.lang.String, org.apache.hadoop.hdfs.server.namenode.FSNamesystem.SafeModeInfo"
  13611. static="false" final="false" visibility="public"
  13612. deprecated="not deprecated">
  13613. </constructor>
  13614. <doc>
  13615. <![CDATA[This exception is thrown when the name node is in safe mode.
  13616. Client cannot modified namespace until the safe mode is off.]]>
  13617. </doc>
  13618. </class>
  13619. <!-- end class org.apache.hadoop.hdfs.server.namenode.SafeModeException -->
  13620. <!-- start class org.apache.hadoop.hdfs.server.namenode.SecondaryNameNode -->
  13621. <class name="SecondaryNameNode" extends="java.lang.Object"
  13622. abstract="false"
  13623. static="false" final="false" visibility="public"
  13624. deprecated="not deprecated">
  13625. <implements name="java.lang.Runnable"/>
  13626. <constructor name="SecondaryNameNode" type="org.apache.hadoop.conf.Configuration"
  13627. static="false" final="false" visibility="public"
  13628. deprecated="not deprecated">
  13629. <exception name="IOException" type="java.io.IOException"/>
  13630. <doc>
  13631. <![CDATA[Create a connection to the primary namenode.]]>
  13632. </doc>
  13633. </constructor>
  13634. <method name="toString" return="java.lang.String"
  13635. abstract="false" native="false" synchronized="false"
  13636. static="false" final="false" visibility="public"
  13637. deprecated="not deprecated">
  13638. <doc>
  13639. <![CDATA[{@inheritDoc}]]>
  13640. </doc>
  13641. </method>
  13642. <method name="shutdown"
  13643. abstract="false" native="false" synchronized="false"
  13644. static="false" final="false" visibility="public"
  13645. deprecated="not deprecated">
  13646. <doc>
  13647. <![CDATA[Shut down this instance of the datanode.
  13648. Returns only after shutdown is complete.]]>
  13649. </doc>
  13650. </method>
  13651. <method name="run"
  13652. abstract="false" native="false" synchronized="false"
  13653. static="false" final="false" visibility="public"
  13654. deprecated="not deprecated">
  13655. </method>
  13656. <method name="main"
  13657. abstract="false" native="false" synchronized="false"
  13658. static="true" final="false" visibility="public"
  13659. deprecated="not deprecated">
  13660. <param name="argv" type="java.lang.String[]"/>
  13661. <exception name="Exception" type="java.lang.Exception"/>
  13662. <doc>
  13663. <![CDATA[main() has some simple utility methods.
  13664. @param argv Command line parameters.
  13665. @exception Exception if the filesystem does not exist.]]>
  13666. </doc>
  13667. </method>
  13668. <field name="LOG" type="org.apache.commons.logging.Log"
  13669. transient="false" volatile="false"
  13670. static="true" final="true" visibility="public"
  13671. deprecated="not deprecated">
  13672. </field>
  13673. <doc>
  13674. <![CDATA[The Secondary NameNode is a helper to the primary NameNode.
  13675. The Secondary is responsible for supporting periodic checkpoints
  13676. of the HDFS metadata. The current design allows only one Secondary
  13677. NameNode per HDFs cluster.
  13678. The Secondary NameNode is a daemon that periodically wakes
  13679. up (determined by the schedule specified in the configuration),
  13680. triggers a periodic checkpoint and then goes back to sleep.
  13681. The Secondary NameNode uses the ClientProtocol to talk to the
  13682. primary NameNode.]]>
  13683. </doc>
  13684. </class>
  13685. <!-- end class org.apache.hadoop.hdfs.server.namenode.SecondaryNameNode -->
  13686. <!-- start class org.apache.hadoop.hdfs.server.namenode.StreamFile -->
  13687. <class name="StreamFile" extends="org.apache.hadoop.hdfs.server.namenode.DfsServlet"
  13688. abstract="false"
  13689. static="false" final="false" visibility="public"
  13690. deprecated="not deprecated">
  13691. <constructor name="StreamFile"
  13692. static="false" final="false" visibility="public"
  13693. deprecated="not deprecated">
  13694. </constructor>
  13695. <method name="getDFSClient" return="org.apache.hadoop.hdfs.DFSClient"
  13696. abstract="false" native="false" synchronized="false"
  13697. static="false" final="false" visibility="protected"
  13698. deprecated="not deprecated">
  13699. <param name="request" type="javax.servlet.http.HttpServletRequest"/>
  13700. <exception name="IOException" type="java.io.IOException"/>
  13701. <exception name="InterruptedException" type="java.lang.InterruptedException"/>
  13702. <doc>
  13703. <![CDATA[getting a client for connecting to dfs]]>
  13704. </doc>
  13705. </method>
  13706. <method name="doGet"
  13707. abstract="false" native="false" synchronized="false"
  13708. static="false" final="false" visibility="public"
  13709. deprecated="not deprecated">
  13710. <param name="request" type="javax.servlet.http.HttpServletRequest"/>
  13711. <param name="response" type="javax.servlet.http.HttpServletResponse"/>
  13712. <exception name="ServletException" type="javax.servlet.ServletException"/>
  13713. <exception name="IOException" type="java.io.IOException"/>
  13714. </method>
  13715. </class>
  13716. <!-- end class org.apache.hadoop.hdfs.server.namenode.StreamFile -->
  13717. <!-- start class org.apache.hadoop.hdfs.server.namenode.UnsupportedActionException -->
  13718. <class name="UnsupportedActionException" extends="java.io.IOException"
  13719. abstract="false"
  13720. static="false" final="false" visibility="public"
  13721. deprecated="not deprecated">
  13722. <constructor name="UnsupportedActionException" type="java.lang.String"
  13723. static="false" final="false" visibility="public"
  13724. deprecated="not deprecated">
  13725. </constructor>
  13726. <doc>
  13727. <![CDATA[This exception is thrown when an operation is not supported.]]>
  13728. </doc>
  13729. </class>
  13730. <!-- end class org.apache.hadoop.hdfs.server.namenode.UnsupportedActionException -->
  13731. <!-- start class org.apache.hadoop.hdfs.server.namenode.UpgradeObjectNamenode -->
  13732. <class name="UpgradeObjectNamenode" extends="org.apache.hadoop.hdfs.server.common.UpgradeObject"
  13733. abstract="true"
  13734. static="false" final="false" visibility="public"
  13735. deprecated="not deprecated">
  13736. <constructor name="UpgradeObjectNamenode"
  13737. static="false" final="false" visibility="public"
  13738. deprecated="not deprecated">
  13739. </constructor>
  13740. <method name="processUpgradeCommand" return="org.apache.hadoop.hdfs.server.protocol.UpgradeCommand"
  13741. abstract="true" native="false" synchronized="false"
  13742. static="false" final="false" visibility="public"
  13743. deprecated="not deprecated">
  13744. <param name="command" type="org.apache.hadoop.hdfs.server.protocol.UpgradeCommand"/>
  13745. <exception name="IOException" type="java.io.IOException"/>
  13746. <doc>
  13747. <![CDATA[Process an upgrade command.
  13748. RPC has only one very generic command for all upgrade related inter
  13749. component communications.
  13750. The actual command recognition and execution should be handled here.
  13751. The reply is sent back also as an UpgradeCommand.
  13752. @param command
  13753. @return the reply command which is analyzed on the client side.]]>
  13754. </doc>
  13755. </method>
  13756. <method name="getType" return="org.apache.hadoop.hdfs.server.common.HdfsConstants.NodeType"
  13757. abstract="false" native="false" synchronized="false"
  13758. static="false" final="false" visibility="public"
  13759. deprecated="not deprecated">
  13760. </method>
  13761. <method name="startUpgrade" return="org.apache.hadoop.hdfs.server.protocol.UpgradeCommand"
  13762. abstract="false" native="false" synchronized="false"
  13763. static="false" final="false" visibility="public"
  13764. deprecated="not deprecated">
  13765. <exception name="IOException" type="java.io.IOException"/>
  13766. </method>
  13767. <method name="forceProceed"
  13768. abstract="false" native="false" synchronized="false"
  13769. static="false" final="false" visibility="public"
  13770. deprecated="not deprecated">
  13771. <exception name="IOException" type="java.io.IOException"/>
  13772. </method>
  13773. <doc>
  13774. <![CDATA[Base class for name-node upgrade objects.
  13775. Data-node upgrades are run in separate threads.]]>
  13776. </doc>
  13777. </class>
  13778. <!-- end class org.apache.hadoop.hdfs.server.namenode.UpgradeObjectNamenode -->
  13779. </package>
  13780. <package name="org.apache.hadoop.hdfs.server.namenode.metrics">
  13781. <!-- start interface org.apache.hadoop.hdfs.server.namenode.metrics.FSNamesystemMBean -->
  13782. <interface name="FSNamesystemMBean" abstract="true"
  13783. static="false" final="false" visibility="public"
  13784. deprecated="not deprecated">
  13785. <method name="getFSState" return="java.lang.String"
  13786. abstract="false" native="false" synchronized="false"
  13787. static="false" final="false" visibility="public"
  13788. deprecated="not deprecated">
  13789. <doc>
  13790. <![CDATA[The state of the file system: Safemode or Operational
  13791. @return the state]]>
  13792. </doc>
  13793. </method>
  13794. <method name="getBlocksTotal" return="long"
  13795. abstract="false" native="false" synchronized="false"
  13796. static="false" final="false" visibility="public"
  13797. deprecated="not deprecated">
  13798. <doc>
  13799. <![CDATA[Number of allocated blocks in the system
  13800. @return - number of allocated blocks]]>
  13801. </doc>
  13802. </method>
  13803. <method name="getCapacityTotal" return="long"
  13804. abstract="false" native="false" synchronized="false"
  13805. static="false" final="false" visibility="public"
  13806. deprecated="not deprecated">
  13807. <doc>
  13808. <![CDATA[Total storage capacity
  13809. @return - total capacity in bytes]]>
  13810. </doc>
  13811. </method>
  13812. <method name="getCapacityRemaining" return="long"
  13813. abstract="false" native="false" synchronized="false"
  13814. static="false" final="false" visibility="public"
  13815. deprecated="not deprecated">
  13816. <doc>
  13817. <![CDATA[Free (unused) storage capacity
  13818. @return - free capacity in bytes]]>
  13819. </doc>
  13820. </method>
  13821. <method name="getCapacityUsed" return="long"
  13822. abstract="false" native="false" synchronized="false"
  13823. static="false" final="false" visibility="public"
  13824. deprecated="not deprecated">
  13825. <doc>
  13826. <![CDATA[Used storage capacity
  13827. @return - used capacity in bytes]]>
  13828. </doc>
  13829. </method>
  13830. <method name="getFilesTotal" return="long"
  13831. abstract="false" native="false" synchronized="false"
  13832. static="false" final="false" visibility="public"
  13833. deprecated="not deprecated">
  13834. <doc>
  13835. <![CDATA[Total number of files and directories
  13836. @return - num of files and directories]]>
  13837. </doc>
  13838. </method>
  13839. <method name="getPendingReplicationBlocks" return="long"
  13840. abstract="false" native="false" synchronized="false"
  13841. static="false" final="false" visibility="public"
  13842. deprecated="not deprecated">
  13843. <doc>
  13844. <![CDATA[Blocks pending to be replicated
  13845. @return - num of blocks to be replicated]]>
  13846. </doc>
  13847. </method>
  13848. <method name="getUnderReplicatedBlocks" return="long"
  13849. abstract="false" native="false" synchronized="false"
  13850. static="false" final="false" visibility="public"
  13851. deprecated="not deprecated">
  13852. <doc>
  13853. <![CDATA[Blocks under replicated
  13854. @return - num of blocks under replicated]]>
  13855. </doc>
  13856. </method>
  13857. <method name="getScheduledReplicationBlocks" return="long"
  13858. abstract="false" native="false" synchronized="false"
  13859. static="false" final="false" visibility="public"
  13860. deprecated="not deprecated">
  13861. <doc>
  13862. <![CDATA[Blocks scheduled for replication
  13863. @return - num of blocks scheduled for replication]]>
  13864. </doc>
  13865. </method>
  13866. <method name="getTotalLoad" return="int"
  13867. abstract="false" native="false" synchronized="false"
  13868. static="false" final="false" visibility="public"
  13869. deprecated="not deprecated">
  13870. <doc>
  13871. <![CDATA[Total Load on the FSNamesystem
  13872. @return - total load of FSNamesystem]]>
  13873. </doc>
  13874. </method>
  13875. <method name="getNumLiveDataNodes" return="int"
  13876. abstract="false" native="false" synchronized="false"
  13877. static="false" final="false" visibility="public"
  13878. deprecated="not deprecated">
  13879. <doc>
  13880. <![CDATA[Number of Live data nodes
  13881. @return number of live data nodes]]>
  13882. </doc>
  13883. </method>
  13884. <method name="getNumDeadDataNodes" return="int"
  13885. abstract="false" native="false" synchronized="false"
  13886. static="false" final="false" visibility="public"
  13887. deprecated="not deprecated">
  13888. <doc>
  13889. <![CDATA[Number of dead data nodes
  13890. @return number of dead data nodes]]>
  13891. </doc>
  13892. </method>
  13893. <doc>
  13894. <![CDATA[This Interface defines the methods to get the status of a the FSNamesystem of
  13895. a name node.
  13896. It is also used for publishing via JMX (hence we follow the JMX naming
  13897. convention.)
  13898. Note we have not used the MetricsDynamicMBeanBase to implement this
  13899. because the interface for the NameNodeStateMBean is stable and should
  13900. be published as an interface.
  13901. <p>
  13902. Name Node runtime activity statistic info is report in another MBean
  13903. @see org.apache.hadoop.hdfs.server.namenode.metrics.NameNodeActivityMBean]]>
  13904. </doc>
  13905. </interface>
  13906. <!-- end interface org.apache.hadoop.hdfs.server.namenode.metrics.FSNamesystemMBean -->
  13907. <!-- start class org.apache.hadoop.hdfs.server.namenode.metrics.FSNamesystemMetrics -->
  13908. <class name="FSNamesystemMetrics" extends="java.lang.Object"
  13909. abstract="false"
  13910. static="false" final="false" visibility="public"
  13911. deprecated="not deprecated">
  13912. <implements name="org.apache.hadoop.metrics.Updater"/>
  13913. <constructor name="FSNamesystemMetrics" type="org.apache.hadoop.hdfs.server.namenode.FSNamesystem, org.apache.hadoop.conf.Configuration"
  13914. static="false" final="false" visibility="public"
  13915. deprecated="not deprecated">
  13916. </constructor>
  13917. <method name="doUpdates"
  13918. abstract="false" native="false" synchronized="false"
  13919. static="false" final="false" visibility="public"
  13920. deprecated="not deprecated">
  13921. <param name="unused" type="org.apache.hadoop.metrics.MetricsContext"/>
  13922. <doc>
  13923. <![CDATA[Since this object is a registered updater, this method will be called
  13924. periodically, e.g. every 5 seconds.
  13925. We set the metrics value within this function before pushing it out.
  13926. FSNamesystem updates its own local variables which are
  13927. light weight compared to Metrics counters.
  13928. Some of the metrics are explicity casted to int. Few metrics collectors
  13929. do not handle long values. It is safe to cast to int for now as all these
  13930. values fit in int value.
  13931. Metrics related to DFS capacity are stored in bytes which do not fit in
  13932. int, so they are rounded to GB]]>
  13933. </doc>
  13934. </method>
  13935. <field name="numExpiredHeartbeats" type="org.apache.hadoop.metrics.util.MetricsTimeVaryingInt"
  13936. transient="false" volatile="false"
  13937. static="false" final="true" visibility="public"
  13938. deprecated="not deprecated">
  13939. </field>
  13940. <doc>
  13941. <![CDATA[This class is for maintaining the various FSNamesystem status metrics
  13942. and publishing them through the metrics interfaces.
  13943. The SNamesystem creates and registers the JMX MBean.
  13944. <p>
  13945. This class has a number of metrics variables that are publicly accessible;
  13946. these variables (objects) have methods to update their values;
  13947. for example:
  13948. <p> {@link #filesTotal}.set()]]>
  13949. </doc>
  13950. </class>
  13951. <!-- end class org.apache.hadoop.hdfs.server.namenode.metrics.FSNamesystemMetrics -->
  13952. <!-- start class org.apache.hadoop.hdfs.server.namenode.metrics.NameNodeActivityMBean -->
  13953. <class name="NameNodeActivityMBean" extends="org.apache.hadoop.metrics.util.MetricsDynamicMBeanBase"
  13954. abstract="false"
  13955. static="false" final="false" visibility="public"
  13956. deprecated="not deprecated">
  13957. <constructor name="NameNodeActivityMBean" type="org.apache.hadoop.metrics.util.MetricsRegistry"
  13958. static="false" final="false" visibility="protected"
  13959. deprecated="not deprecated">
  13960. </constructor>
  13961. <method name="shutdown"
  13962. abstract="false" native="false" synchronized="false"
  13963. static="false" final="false" visibility="public"
  13964. deprecated="not deprecated">
  13965. </method>
  13966. <doc>
  13967. <![CDATA[This is the JMX MBean for reporting the NameNode Activity.
  13968. The MBean is register using the name
  13969. "hadoop:service=NameNode,name=NameNodeActivity"
  13970. Many of the activity metrics are sampled and averaged on an interval
  13971. which can be specified in the metrics config file.
  13972. <p>
  13973. For the metrics that are sampled and averaged, one must specify
  13974. a metrics context that does periodic update calls. Most metrics contexts do.
  13975. The default Null metrics context however does NOT. So if you aren't
  13976. using any other metrics context then you can turn on the viewing and averaging
  13977. of sampled metrics by specifying the following two lines
  13978. in the hadoop-meterics.properties file:
  13979. <pre>
  13980. dfs.class=org.apache.hadoop.metrics.spi.NullContextWithUpdateThread
  13981. dfs.period=10
  13982. </pre>
  13983. <p>
  13984. Note that the metrics are collected regardless of the context used.
  13985. The context with the update thread is used to average the data periodically
  13986. Impl details: We use a dynamic mbean that gets the list of the metrics
  13987. from the metrics registry passed as an argument to the constructor]]>
  13988. </doc>
  13989. </class>
  13990. <!-- end class org.apache.hadoop.hdfs.server.namenode.metrics.NameNodeActivityMBean -->
  13991. <!-- start class org.apache.hadoop.hdfs.server.namenode.metrics.NameNodeMetrics -->
  13992. <class name="NameNodeMetrics" extends="java.lang.Object"
  13993. abstract="false"
  13994. static="false" final="false" visibility="public"
  13995. deprecated="not deprecated">
  13996. <implements name="org.apache.hadoop.metrics.Updater"/>
  13997. <constructor name="NameNodeMetrics" type="org.apache.hadoop.conf.Configuration, org.apache.hadoop.hdfs.server.common.HdfsConstants.NamenodeRole"
  13998. static="false" final="false" visibility="public"
  13999. deprecated="not deprecated">
  14000. </constructor>
  14001. <method name="shutdown"
  14002. abstract="false" native="false" synchronized="false"
  14003. static="false" final="false" visibility="public"
  14004. deprecated="not deprecated">
  14005. </method>
  14006. <method name="doUpdates"
  14007. abstract="false" native="false" synchronized="false"
  14008. static="false" final="false" visibility="public"
  14009. deprecated="not deprecated">
  14010. <param name="unused" type="org.apache.hadoop.metrics.MetricsContext"/>
  14011. <doc>
  14012. <![CDATA[Since this object is a registered updater, this method will be called
  14013. periodically, e.g. every 5 seconds.]]>
  14014. </doc>
  14015. </method>
  14016. <method name="resetAllMinMax"
  14017. abstract="false" native="false" synchronized="false"
  14018. static="false" final="false" visibility="public"
  14019. deprecated="not deprecated">
  14020. </method>
  14021. <field name="registry" type="org.apache.hadoop.metrics.util.MetricsRegistry"
  14022. transient="false" volatile="false"
  14023. static="false" final="false" visibility="public"
  14024. deprecated="not deprecated">
  14025. </field>
  14026. <field name="numCreateFileOps" type="org.apache.hadoop.metrics.util.MetricsTimeVaryingInt"
  14027. transient="false" volatile="false"
  14028. static="false" final="false" visibility="public"
  14029. deprecated="not deprecated">
  14030. </field>
  14031. <field name="numFilesCreated" type="org.apache.hadoop.metrics.util.MetricsTimeVaryingInt"
  14032. transient="false" volatile="false"
  14033. static="false" final="false" visibility="public"
  14034. deprecated="not deprecated">
  14035. </field>
  14036. <field name="numFilesAppended" type="org.apache.hadoop.metrics.util.MetricsTimeVaryingInt"
  14037. transient="false" volatile="false"
  14038. static="false" final="false" visibility="public"
  14039. deprecated="not deprecated">
  14040. </field>
  14041. <field name="numGetBlockLocations" type="org.apache.hadoop.metrics.util.MetricsTimeVaryingInt"
  14042. transient="false" volatile="false"
  14043. static="false" final="false" visibility="public"
  14044. deprecated="not deprecated">
  14045. </field>
  14046. <field name="numFilesRenamed" type="org.apache.hadoop.metrics.util.MetricsTimeVaryingInt"
  14047. transient="false" volatile="false"
  14048. static="false" final="false" visibility="public"
  14049. deprecated="not deprecated">
  14050. </field>
  14051. <field name="numGetListingOps" type="org.apache.hadoop.metrics.util.MetricsTimeVaryingInt"
  14052. transient="false" volatile="false"
  14053. static="false" final="false" visibility="public"
  14054. deprecated="not deprecated">
  14055. </field>
  14056. <field name="numDeleteFileOps" type="org.apache.hadoop.metrics.util.MetricsTimeVaryingInt"
  14057. transient="false" volatile="false"
  14058. static="false" final="false" visibility="public"
  14059. deprecated="not deprecated">
  14060. </field>
  14061. <field name="numFilesDeleted" type="org.apache.hadoop.metrics.util.MetricsTimeVaryingInt"
  14062. transient="false" volatile="false"
  14063. static="false" final="false" visibility="public"
  14064. deprecated="not deprecated">
  14065. </field>
  14066. <field name="numFileInfoOps" type="org.apache.hadoop.metrics.util.MetricsTimeVaryingInt"
  14067. transient="false" volatile="false"
  14068. static="false" final="false" visibility="public"
  14069. deprecated="not deprecated">
  14070. </field>
  14071. <field name="numAddBlockOps" type="org.apache.hadoop.metrics.util.MetricsTimeVaryingInt"
  14072. transient="false" volatile="false"
  14073. static="false" final="false" visibility="public"
  14074. deprecated="not deprecated">
  14075. </field>
  14076. <field name="numcreateSymlinkOps" type="org.apache.hadoop.metrics.util.MetricsTimeVaryingInt"
  14077. transient="false" volatile="false"
  14078. static="false" final="false" visibility="public"
  14079. deprecated="not deprecated">
  14080. </field>
  14081. <field name="numgetLinkTargetOps" type="org.apache.hadoop.metrics.util.MetricsTimeVaryingInt"
  14082. transient="false" volatile="false"
  14083. static="false" final="false" visibility="public"
  14084. deprecated="not deprecated">
  14085. </field>
  14086. <field name="transactions" type="org.apache.hadoop.metrics.util.MetricsTimeVaryingRate"
  14087. transient="false" volatile="false"
  14088. static="false" final="false" visibility="public"
  14089. deprecated="not deprecated">
  14090. </field>
  14091. <field name="syncs" type="org.apache.hadoop.metrics.util.MetricsTimeVaryingRate"
  14092. transient="false" volatile="false"
  14093. static="false" final="false" visibility="public"
  14094. deprecated="not deprecated">
  14095. </field>
  14096. <field name="transactionsBatchedInSync" type="org.apache.hadoop.metrics.util.MetricsTimeVaryingInt"
  14097. transient="false" volatile="false"
  14098. static="false" final="false" visibility="public"
  14099. deprecated="not deprecated">
  14100. </field>
  14101. <field name="blockReport" type="org.apache.hadoop.metrics.util.MetricsTimeVaryingRate"
  14102. transient="false" volatile="false"
  14103. static="false" final="false" visibility="public"
  14104. deprecated="not deprecated">
  14105. </field>
  14106. <field name="safeModeTime" type="org.apache.hadoop.metrics.util.MetricsIntValue"
  14107. transient="false" volatile="false"
  14108. static="false" final="false" visibility="public"
  14109. deprecated="not deprecated">
  14110. </field>
  14111. <field name="fsImageLoadTime" type="org.apache.hadoop.metrics.util.MetricsIntValue"
  14112. transient="false" volatile="false"
  14113. static="false" final="false" visibility="public"
  14114. deprecated="not deprecated">
  14115. </field>
  14116. <field name="numBlocksCorrupted" type="org.apache.hadoop.metrics.util.MetricsIntValue"
  14117. transient="false" volatile="false"
  14118. static="false" final="false" visibility="public"
  14119. deprecated="not deprecated">
  14120. </field>
  14121. <field name="numFilesInGetListingOps" type="org.apache.hadoop.metrics.util.MetricsTimeVaryingInt"
  14122. transient="false" volatile="false"
  14123. static="false" final="false" visibility="public"
  14124. deprecated="not deprecated">
  14125. </field>
  14126. <doc>
  14127. <![CDATA[This class is for maintaining the various NameNode activity statistics
  14128. and publishing them through the metrics interfaces.
  14129. This also registers the JMX MBean for RPC.
  14130. <p>
  14131. This class has a number of metrics variables that are publicly accessible;
  14132. these variables (objects) have methods to update their values;
  14133. for example:
  14134. <p> {@link #syncs}.inc()]]>
  14135. </doc>
  14136. </class>
  14137. <!-- end class org.apache.hadoop.hdfs.server.namenode.metrics.NameNodeMetrics -->
  14138. </package>
  14139. <package name="org.apache.hadoop.hdfs.server.protocol">
  14140. <!-- start class org.apache.hadoop.hdfs.server.protocol.BlockCommand -->
  14141. <class name="BlockCommand" extends="org.apache.hadoop.hdfs.server.protocol.DatanodeCommand"
  14142. abstract="false"
  14143. static="false" final="false" visibility="public"
  14144. deprecated="not deprecated">
  14145. <constructor name="BlockCommand"
  14146. static="false" final="false" visibility="public"
  14147. deprecated="not deprecated">
  14148. </constructor>
  14149. <constructor name="BlockCommand" type="int, java.util.List"
  14150. static="false" final="false" visibility="public"
  14151. deprecated="not deprecated">
  14152. <doc>
  14153. <![CDATA[Create BlockCommand for transferring blocks to another datanode
  14154. @param blocktargetlist blocks to be transferred]]>
  14155. </doc>
  14156. </constructor>
  14157. <constructor name="BlockCommand" type="int, org.apache.hadoop.hdfs.protocol.Block[]"
  14158. static="false" final="false" visibility="public"
  14159. deprecated="not deprecated">
  14160. <doc>
  14161. <![CDATA[Create BlockCommand for the given action
  14162. @param blocks blocks related to the action]]>
  14163. </doc>
  14164. </constructor>
  14165. <method name="getBlocks" return="org.apache.hadoop.hdfs.protocol.Block[]"
  14166. abstract="false" native="false" synchronized="false"
  14167. static="false" final="false" visibility="public"
  14168. deprecated="not deprecated">
  14169. </method>
  14170. <method name="getTargets" return="org.apache.hadoop.hdfs.protocol.DatanodeInfo[][]"
  14171. abstract="false" native="false" synchronized="false"
  14172. static="false" final="false" visibility="public"
  14173. deprecated="not deprecated">
  14174. </method>
  14175. <method name="write"
  14176. abstract="false" native="false" synchronized="false"
  14177. static="false" final="false" visibility="public"
  14178. deprecated="not deprecated">
  14179. <param name="out" type="java.io.DataOutput"/>
  14180. <exception name="IOException" type="java.io.IOException"/>
  14181. </method>
  14182. <method name="readFields"
  14183. abstract="false" native="false" synchronized="false"
  14184. static="false" final="false" visibility="public"
  14185. deprecated="not deprecated">
  14186. <param name="in" type="java.io.DataInput"/>
  14187. <exception name="IOException" type="java.io.IOException"/>
  14188. </method>
  14189. <doc>
  14190. <![CDATA[A BlockCommand is an instruction to a datanode
  14191. regarding some blocks under its control. It tells
  14192. the DataNode to either invalidate a set of indicated
  14193. blocks, or to copy a set of indicated blocks to
  14194. another DataNode.]]>
  14195. </doc>
  14196. </class>
  14197. <!-- end class org.apache.hadoop.hdfs.server.protocol.BlockCommand -->
  14198. <!-- start class org.apache.hadoop.hdfs.server.protocol.BlockRecoveryCommand -->
  14199. <class name="BlockRecoveryCommand" extends="org.apache.hadoop.hdfs.server.protocol.DatanodeCommand"
  14200. abstract="false"
  14201. static="false" final="false" visibility="public"
  14202. deprecated="not deprecated">
  14203. <constructor name="BlockRecoveryCommand"
  14204. static="false" final="false" visibility="public"
  14205. deprecated="not deprecated">
  14206. <doc>
  14207. <![CDATA[Create empty BlockRecoveryCommand.]]>
  14208. </doc>
  14209. </constructor>
  14210. <constructor name="BlockRecoveryCommand" type="int"
  14211. static="false" final="false" visibility="public"
  14212. deprecated="not deprecated">
  14213. <doc>
  14214. <![CDATA[Create BlockRecoveryCommand with
  14215. the specified capacity for recovering blocks.]]>
  14216. </doc>
  14217. </constructor>
  14218. <method name="getRecoveringBlocks" return="java.util.Collection"
  14219. abstract="false" native="false" synchronized="false"
  14220. static="false" final="false" visibility="public"
  14221. deprecated="not deprecated">
  14222. <doc>
  14223. <![CDATA[Return the list of recovering blocks.]]>
  14224. </doc>
  14225. </method>
  14226. <method name="add"
  14227. abstract="false" native="false" synchronized="false"
  14228. static="false" final="false" visibility="public"
  14229. deprecated="not deprecated">
  14230. <param name="block" type="org.apache.hadoop.hdfs.server.protocol.BlockRecoveryCommand.RecoveringBlock"/>
  14231. <doc>
  14232. <![CDATA[Add recovering block to the command.]]>
  14233. </doc>
  14234. </method>
  14235. <method name="write"
  14236. abstract="false" native="false" synchronized="false"
  14237. static="false" final="false" visibility="public"
  14238. deprecated="not deprecated">
  14239. <param name="out" type="java.io.DataOutput"/>
  14240. <exception name="IOException" type="java.io.IOException"/>
  14241. </method>
  14242. <method name="readFields"
  14243. abstract="false" native="false" synchronized="false"
  14244. static="false" final="false" visibility="public"
  14245. deprecated="not deprecated">
  14246. <param name="in" type="java.io.DataInput"/>
  14247. <exception name="IOException" type="java.io.IOException"/>
  14248. </method>
  14249. <doc>
  14250. <![CDATA[BlockRecoveryCommand is an instruction to a data-node to recover
  14251. the specified blocks.
  14252. The data-node that receives this command treats itself as a primary
  14253. data-node in the recover process.
  14254. Block recovery is identified by a recoveryId, which is also the new
  14255. generation stamp, which the block will have after the recovery succeeds.]]>
  14256. </doc>
  14257. </class>
  14258. <!-- end class org.apache.hadoop.hdfs.server.protocol.BlockRecoveryCommand -->
  14259. <!-- start class org.apache.hadoop.hdfs.server.protocol.BlockRecoveryCommand.RecoveringBlock -->
  14260. <class name="BlockRecoveryCommand.RecoveringBlock" extends="org.apache.hadoop.hdfs.protocol.LocatedBlock"
  14261. abstract="false"
  14262. static="true" final="false" visibility="public"
  14263. deprecated="not deprecated">
  14264. <constructor name="BlockRecoveryCommand.RecoveringBlock"
  14265. static="false" final="false" visibility="public"
  14266. deprecated="not deprecated">
  14267. <doc>
  14268. <![CDATA[Create empty RecoveringBlock.]]>
  14269. </doc>
  14270. </constructor>
  14271. <constructor name="BlockRecoveryCommand.RecoveringBlock" type="org.apache.hadoop.hdfs.protocol.Block, org.apache.hadoop.hdfs.protocol.DatanodeInfo[], long"
  14272. static="false" final="false" visibility="public"
  14273. deprecated="not deprecated">
  14274. <doc>
  14275. <![CDATA[Create RecoveringBlock.]]>
  14276. </doc>
  14277. </constructor>
  14278. <method name="getNewGenerationStamp" return="long"
  14279. abstract="false" native="false" synchronized="false"
  14280. static="false" final="false" visibility="public"
  14281. deprecated="not deprecated">
  14282. <doc>
  14283. <![CDATA[Return the new generation stamp of the block,
  14284. which also plays role of the recovery id.]]>
  14285. </doc>
  14286. </method>
  14287. <method name="write"
  14288. abstract="false" native="false" synchronized="false"
  14289. static="false" final="false" visibility="public"
  14290. deprecated="not deprecated">
  14291. <param name="out" type="java.io.DataOutput"/>
  14292. <exception name="IOException" type="java.io.IOException"/>
  14293. </method>
  14294. <method name="readFields"
  14295. abstract="false" native="false" synchronized="false"
  14296. static="false" final="false" visibility="public"
  14297. deprecated="not deprecated">
  14298. <param name="in" type="java.io.DataInput"/>
  14299. <exception name="IOException" type="java.io.IOException"/>
  14300. </method>
  14301. <doc>
  14302. <![CDATA[This is a block with locations from which it should be recovered
  14303. and the new generation stamp, which the block will have after
  14304. successful recovery.
  14305. The new generation stamp of the block, also plays role of the recovery id.]]>
  14306. </doc>
  14307. </class>
  14308. <!-- end class org.apache.hadoop.hdfs.server.protocol.BlockRecoveryCommand.RecoveringBlock -->
  14309. <!-- start class org.apache.hadoop.hdfs.server.protocol.BlocksWithLocations -->
  14310. <class name="BlocksWithLocations" extends="java.lang.Object"
  14311. abstract="false"
  14312. static="false" final="false" visibility="public"
  14313. deprecated="not deprecated">
  14314. <implements name="org.apache.hadoop.io.Writable"/>
  14315. <constructor name="BlocksWithLocations" type="org.apache.hadoop.hdfs.server.protocol.BlocksWithLocations.BlockWithLocations[]"
  14316. static="false" final="false" visibility="public"
  14317. deprecated="not deprecated">
  14318. <doc>
  14319. <![CDATA[Constructor with one parameter]]>
  14320. </doc>
  14321. </constructor>
  14322. <method name="getBlocks" return="org.apache.hadoop.hdfs.server.protocol.BlocksWithLocations.BlockWithLocations[]"
  14323. abstract="false" native="false" synchronized="false"
  14324. static="false" final="false" visibility="public"
  14325. deprecated="not deprecated">
  14326. <doc>
  14327. <![CDATA[getter]]>
  14328. </doc>
  14329. </method>
  14330. <method name="write"
  14331. abstract="false" native="false" synchronized="false"
  14332. static="false" final="false" visibility="public"
  14333. deprecated="not deprecated">
  14334. <param name="out" type="java.io.DataOutput"/>
  14335. <exception name="IOException" type="java.io.IOException"/>
  14336. <doc>
  14337. <![CDATA[serialization method]]>
  14338. </doc>
  14339. </method>
  14340. <method name="readFields"
  14341. abstract="false" native="false" synchronized="false"
  14342. static="false" final="false" visibility="public"
  14343. deprecated="not deprecated">
  14344. <param name="in" type="java.io.DataInput"/>
  14345. <exception name="IOException" type="java.io.IOException"/>
  14346. <doc>
  14347. <![CDATA[deserialization method]]>
  14348. </doc>
  14349. </method>
  14350. <doc>
  14351. <![CDATA[A class to implement an array of BlockLocations
  14352. It provide efficient customized serialization/deserialization methods
  14353. in stead of using the default array (de)serialization provided by RPC]]>
  14354. </doc>
  14355. </class>
  14356. <!-- end class org.apache.hadoop.hdfs.server.protocol.BlocksWithLocations -->
  14357. <!-- start class org.apache.hadoop.hdfs.server.protocol.BlocksWithLocations.BlockWithLocations -->
  14358. <class name="BlocksWithLocations.BlockWithLocations" extends="java.lang.Object"
  14359. abstract="false"
  14360. static="true" final="false" visibility="public"
  14361. deprecated="not deprecated">
  14362. <implements name="org.apache.hadoop.io.Writable"/>
  14363. <constructor name="BlocksWithLocations.BlockWithLocations"
  14364. static="false" final="false" visibility="public"
  14365. deprecated="not deprecated">
  14366. <doc>
  14367. <![CDATA[default constructor]]>
  14368. </doc>
  14369. </constructor>
  14370. <constructor name="BlocksWithLocations.BlockWithLocations" type="org.apache.hadoop.hdfs.protocol.Block, java.lang.String[]"
  14371. static="false" final="false" visibility="public"
  14372. deprecated="not deprecated">
  14373. <doc>
  14374. <![CDATA[constructor]]>
  14375. </doc>
  14376. </constructor>
  14377. <method name="getBlock" return="org.apache.hadoop.hdfs.protocol.Block"
  14378. abstract="false" native="false" synchronized="false"
  14379. static="false" final="false" visibility="public"
  14380. deprecated="not deprecated">
  14381. <doc>
  14382. <![CDATA[get the block]]>
  14383. </doc>
  14384. </method>
  14385. <method name="getDatanodes" return="java.lang.String[]"
  14386. abstract="false" native="false" synchronized="false"
  14387. static="false" final="false" visibility="public"
  14388. deprecated="not deprecated">
  14389. <doc>
  14390. <![CDATA[get the block's locations]]>
  14391. </doc>
  14392. </method>
  14393. <method name="readFields"
  14394. abstract="false" native="false" synchronized="false"
  14395. static="false" final="false" visibility="public"
  14396. deprecated="not deprecated">
  14397. <param name="in" type="java.io.DataInput"/>
  14398. <exception name="IOException" type="java.io.IOException"/>
  14399. <doc>
  14400. <![CDATA[deserialization method]]>
  14401. </doc>
  14402. </method>
  14403. <method name="write"
  14404. abstract="false" native="false" synchronized="false"
  14405. static="false" final="false" visibility="public"
  14406. deprecated="not deprecated">
  14407. <param name="out" type="java.io.DataOutput"/>
  14408. <exception name="IOException" type="java.io.IOException"/>
  14409. <doc>
  14410. <![CDATA[serialization method]]>
  14411. </doc>
  14412. </method>
  14413. <doc>
  14414. <![CDATA[A class to keep track of a block and its locations]]>
  14415. </doc>
  14416. </class>
  14417. <!-- end class org.apache.hadoop.hdfs.server.protocol.BlocksWithLocations.BlockWithLocations -->
  14418. <!-- start class org.apache.hadoop.hdfs.server.protocol.CheckpointCommand -->
  14419. <class name="CheckpointCommand" extends="org.apache.hadoop.hdfs.server.protocol.NamenodeCommand"
  14420. abstract="false"
  14421. static="false" final="false" visibility="public"
  14422. deprecated="not deprecated">
  14423. <constructor name="CheckpointCommand"
  14424. static="false" final="false" visibility="public"
  14425. deprecated="not deprecated">
  14426. </constructor>
  14427. <constructor name="CheckpointCommand" type="org.apache.hadoop.hdfs.server.namenode.CheckpointSignature, boolean, boolean"
  14428. static="false" final="false" visibility="public"
  14429. deprecated="not deprecated">
  14430. </constructor>
  14431. <method name="getSignature" return="org.apache.hadoop.hdfs.server.namenode.CheckpointSignature"
  14432. abstract="false" native="false" synchronized="false"
  14433. static="false" final="false" visibility="public"
  14434. deprecated="not deprecated">
  14435. <doc>
  14436. <![CDATA[Checkpoint signature is used to ensure
  14437. that nodes are talking about the same checkpoint.]]>
  14438. </doc>
  14439. </method>
  14440. <method name="isImageObsolete" return="boolean"
  14441. abstract="false" native="false" synchronized="false"
  14442. static="false" final="false" visibility="public"
  14443. deprecated="not deprecated">
  14444. <doc>
  14445. <![CDATA[Indicates whether current backup image is obsolete, and therefore
  14446. need to be discarded?
  14447. @return true if current image should be discarded.]]>
  14448. </doc>
  14449. </method>
  14450. <method name="needToReturnImage" return="boolean"
  14451. abstract="false" native="false" synchronized="false"
  14452. static="false" final="false" visibility="public"
  14453. deprecated="not deprecated">
  14454. <doc>
  14455. <![CDATA[Indicates whether the new checkpoint image needs to be transfered
  14456. back to the name-node after the checkpoint is done.
  14457. @return true if the checkpoint should be returned back.]]>
  14458. </doc>
  14459. </method>
  14460. <method name="write"
  14461. abstract="false" native="false" synchronized="false"
  14462. static="false" final="false" visibility="public"
  14463. deprecated="not deprecated">
  14464. <param name="out" type="java.io.DataOutput"/>
  14465. <exception name="IOException" type="java.io.IOException"/>
  14466. </method>
  14467. <method name="readFields"
  14468. abstract="false" native="false" synchronized="false"
  14469. static="false" final="false" visibility="public"
  14470. deprecated="not deprecated">
  14471. <param name="in" type="java.io.DataInput"/>
  14472. <exception name="IOException" type="java.io.IOException"/>
  14473. </method>
  14474. <doc>
  14475. <![CDATA[Checkpoint command.
  14476. <p>
  14477. Returned to the backup node by the name-node as a reply to the
  14478. {@link NamenodeProtocol#startCheckpoint(NamenodeRegistration)}
  14479. request.<br>
  14480. Contains:
  14481. <ul>
  14482. <li>{@link CheckpointSignature} identifying the particular checkpoint</li>
  14483. <li>indicator whether the backup image should be discarded before starting
  14484. the checkpoint</li>
  14485. <li>indicator whether the image should be transfered back to the name-node
  14486. upon completion of the checkpoint.</li>
  14487. </ul>]]>
  14488. </doc>
  14489. </class>
  14490. <!-- end class org.apache.hadoop.hdfs.server.protocol.CheckpointCommand -->
  14491. <!-- start class org.apache.hadoop.hdfs.server.protocol.DatanodeCommand -->
  14492. <class name="DatanodeCommand" extends="org.apache.hadoop.hdfs.server.protocol.ServerCommand"
  14493. abstract="true"
  14494. static="false" final="false" visibility="public"
  14495. deprecated="not deprecated">
  14496. <constructor name="DatanodeCommand"
  14497. static="false" final="false" visibility="public"
  14498. deprecated="not deprecated">
  14499. </constructor>
  14500. <field name="REGISTER" type="org.apache.hadoop.hdfs.server.protocol.DatanodeCommand"
  14501. transient="false" volatile="false"
  14502. static="true" final="true" visibility="public"
  14503. deprecated="not deprecated">
  14504. </field>
  14505. <field name="FINALIZE" type="org.apache.hadoop.hdfs.server.protocol.DatanodeCommand"
  14506. transient="false" volatile="false"
  14507. static="true" final="true" visibility="public"
  14508. deprecated="not deprecated">
  14509. </field>
  14510. <doc>
  14511. <![CDATA[Base class for data-node command.
  14512. Issued by the name-node to notify data-nodes what should be done.]]>
  14513. </doc>
  14514. </class>
  14515. <!-- end class org.apache.hadoop.hdfs.server.protocol.DatanodeCommand -->
  14516. <!-- start interface org.apache.hadoop.hdfs.server.protocol.DatanodeProtocol -->
  14517. <interface name="DatanodeProtocol" abstract="true"
  14518. static="false" final="false" visibility="public"
  14519. deprecated="not deprecated">
  14520. <implements name="org.apache.hadoop.ipc.VersionedProtocol"/>
  14521. <method name="registerDatanode" return="org.apache.hadoop.hdfs.server.protocol.DatanodeRegistration"
  14522. abstract="false" native="false" synchronized="false"
  14523. static="false" final="false" visibility="public"
  14524. deprecated="not deprecated">
  14525. <param name="registration" type="org.apache.hadoop.hdfs.server.protocol.DatanodeRegistration"/>
  14526. <exception name="IOException" type="java.io.IOException"/>
  14527. <doc>
  14528. <![CDATA[Register Datanode.
  14529. @see org.apache.hadoop.hdfs.server.datanode.DataNode#dnRegistration
  14530. @see org.apache.hadoop.hdfs.server.namenode.FSNamesystem#registerDatanode(DatanodeRegistration)
  14531. @return updated {@link org.apache.hadoop.hdfs.server.protocol.DatanodeRegistration}, which contains
  14532. new storageID if the datanode did not have one and
  14533. registration ID for further communication.]]>
  14534. </doc>
  14535. </method>
  14536. <method name="sendHeartbeat" return="org.apache.hadoop.hdfs.server.protocol.DatanodeCommand[]"
  14537. abstract="false" native="false" synchronized="false"
  14538. static="false" final="false" visibility="public"
  14539. deprecated="not deprecated">
  14540. <param name="registration" type="org.apache.hadoop.hdfs.server.protocol.DatanodeRegistration"/>
  14541. <param name="capacity" type="long"/>
  14542. <param name="dfsUsed" type="long"/>
  14543. <param name="remaining" type="long"/>
  14544. <param name="xmitsInProgress" type="int"/>
  14545. <param name="xceiverCount" type="int"/>
  14546. <exception name="IOException" type="java.io.IOException"/>
  14547. <doc>
  14548. <![CDATA[sendHeartbeat() tells the NameNode that the DataNode is still
  14549. alive and well. Includes some status info, too.
  14550. It also gives the NameNode a chance to return
  14551. an array of "DatanodeCommand" objects.
  14552. A DatanodeCommand tells the DataNode to invalidate local block(s),
  14553. or to copy them to other DataNodes, etc.]]>
  14554. </doc>
  14555. </method>
  14556. <method name="blockReport" return="org.apache.hadoop.hdfs.server.protocol.DatanodeCommand"
  14557. abstract="false" native="false" synchronized="false"
  14558. static="false" final="false" visibility="public"
  14559. deprecated="not deprecated">
  14560. <param name="registration" type="org.apache.hadoop.hdfs.server.protocol.DatanodeRegistration"/>
  14561. <param name="blocks" type="long[]"/>
  14562. <exception name="IOException" type="java.io.IOException"/>
  14563. <doc>
  14564. <![CDATA[blockReport() tells the NameNode about all the locally-stored blocks.
  14565. The NameNode returns an array of Blocks that have become obsolete
  14566. and should be deleted. This function is meant to upload *all*
  14567. the locally-stored blocks. It's invoked upon startup and then
  14568. infrequently afterwards.
  14569. @param registration
  14570. @param blocks - the block list as an array of longs.
  14571. Each block is represented as 2 longs.
  14572. This is done instead of Block[] to reduce memory used by block reports.
  14573. @return - the next command for DN to process.
  14574. @throws IOException]]>
  14575. </doc>
  14576. </method>
  14577. <method name="blockReceived"
  14578. abstract="false" native="false" synchronized="false"
  14579. static="false" final="false" visibility="public"
  14580. deprecated="not deprecated">
  14581. <param name="registration" type="org.apache.hadoop.hdfs.server.protocol.DatanodeRegistration"/>
  14582. <param name="blocks" type="org.apache.hadoop.hdfs.protocol.Block[]"/>
  14583. <param name="delHints" type="java.lang.String[]"/>
  14584. <exception name="IOException" type="java.io.IOException"/>
  14585. <doc>
  14586. <![CDATA[blockReceived() allows the DataNode to tell the NameNode about
  14587. recently-received block data, with a hint for pereferred replica
  14588. to be deleted when there is any excessive blocks.
  14589. For example, whenever client code
  14590. writes a new Block here, or another DataNode copies a Block to
  14591. this DataNode, it will call blockReceived().]]>
  14592. </doc>
  14593. </method>
  14594. <method name="errorReport"
  14595. abstract="false" native="false" synchronized="false"
  14596. static="false" final="false" visibility="public"
  14597. deprecated="not deprecated">
  14598. <param name="registration" type="org.apache.hadoop.hdfs.server.protocol.DatanodeRegistration"/>
  14599. <param name="errorCode" type="int"/>
  14600. <param name="msg" type="java.lang.String"/>
  14601. <exception name="IOException" type="java.io.IOException"/>
  14602. <doc>
  14603. <![CDATA[errorReport() tells the NameNode about something that has gone
  14604. awry. Useful for debugging.]]>
  14605. </doc>
  14606. </method>
  14607. <method name="versionRequest" return="org.apache.hadoop.hdfs.server.protocol.NamespaceInfo"
  14608. abstract="false" native="false" synchronized="false"
  14609. static="false" final="false" visibility="public"
  14610. deprecated="not deprecated">
  14611. <exception name="IOException" type="java.io.IOException"/>
  14612. </method>
  14613. <method name="processUpgradeCommand" return="org.apache.hadoop.hdfs.server.protocol.UpgradeCommand"
  14614. abstract="false" native="false" synchronized="false"
  14615. static="false" final="false" visibility="public"
  14616. deprecated="not deprecated">
  14617. <param name="comm" type="org.apache.hadoop.hdfs.server.protocol.UpgradeCommand"/>
  14618. <exception name="IOException" type="java.io.IOException"/>
  14619. <doc>
  14620. <![CDATA[This is a very general way to send a command to the name-node during
  14621. distributed upgrade process.
  14622. The generosity is because the variety of upgrade commands is unpredictable.
  14623. The reply from the name-node is also received in the form of an upgrade
  14624. command.
  14625. @return a reply in the form of an upgrade command]]>
  14626. </doc>
  14627. </method>
  14628. <method name="reportBadBlocks"
  14629. abstract="false" native="false" synchronized="false"
  14630. static="false" final="false" visibility="public"
  14631. deprecated="not deprecated">
  14632. <param name="blocks" type="org.apache.hadoop.hdfs.protocol.LocatedBlock[]"/>
  14633. <exception name="IOException" type="java.io.IOException"/>
  14634. <doc>
  14635. <![CDATA[same as {@link org.apache.hadoop.hdfs.protocol.ClientProtocol#reportBadBlocks(LocatedBlock[])}
  14636. }]]>
  14637. </doc>
  14638. </method>
  14639. <method name="commitBlockSynchronization"
  14640. abstract="false" native="false" synchronized="false"
  14641. static="false" final="false" visibility="public"
  14642. deprecated="not deprecated">
  14643. <param name="block" type="org.apache.hadoop.hdfs.protocol.Block"/>
  14644. <param name="newgenerationstamp" type="long"/>
  14645. <param name="newlength" type="long"/>
  14646. <param name="closeFile" type="boolean"/>
  14647. <param name="deleteblock" type="boolean"/>
  14648. <param name="newtargets" type="org.apache.hadoop.hdfs.protocol.DatanodeID[]"/>
  14649. <exception name="IOException" type="java.io.IOException"/>
  14650. <doc>
  14651. <![CDATA[Commit block synchronization in lease recovery]]>
  14652. </doc>
  14653. </method>
  14654. <field name="versionID" type="long"
  14655. transient="false" volatile="false"
  14656. static="true" final="true" visibility="public"
  14657. deprecated="not deprecated">
  14658. <doc>
  14659. <![CDATA[24: register() renamed registerDatanode()]]>
  14660. </doc>
  14661. </field>
  14662. <field name="NOTIFY" type="int"
  14663. transient="false" volatile="false"
  14664. static="true" final="true" visibility="public"
  14665. deprecated="not deprecated">
  14666. </field>
  14667. <field name="DISK_ERROR" type="int"
  14668. transient="false" volatile="false"
  14669. static="true" final="true" visibility="public"
  14670. deprecated="not deprecated">
  14671. </field>
  14672. <field name="INVALID_BLOCK" type="int"
  14673. transient="false" volatile="false"
  14674. static="true" final="true" visibility="public"
  14675. deprecated="not deprecated">
  14676. </field>
  14677. <field name="FATAL_DISK_ERROR" type="int"
  14678. transient="false" volatile="false"
  14679. static="true" final="true" visibility="public"
  14680. deprecated="not deprecated">
  14681. </field>
  14682. <field name="DNA_UNKNOWN" type="int"
  14683. transient="false" volatile="false"
  14684. static="true" final="true" visibility="public"
  14685. deprecated="not deprecated">
  14686. <doc>
  14687. <![CDATA[Determines actions that data node should perform
  14688. when receiving a datanode command.]]>
  14689. </doc>
  14690. </field>
  14691. <field name="DNA_TRANSFER" type="int"
  14692. transient="false" volatile="false"
  14693. static="true" final="true" visibility="public"
  14694. deprecated="not deprecated">
  14695. </field>
  14696. <field name="DNA_INVALIDATE" type="int"
  14697. transient="false" volatile="false"
  14698. static="true" final="true" visibility="public"
  14699. deprecated="not deprecated">
  14700. </field>
  14701. <field name="DNA_SHUTDOWN" type="int"
  14702. transient="false" volatile="false"
  14703. static="true" final="true" visibility="public"
  14704. deprecated="not deprecated">
  14705. </field>
  14706. <field name="DNA_REGISTER" type="int"
  14707. transient="false" volatile="false"
  14708. static="true" final="true" visibility="public"
  14709. deprecated="not deprecated">
  14710. </field>
  14711. <field name="DNA_FINALIZE" type="int"
  14712. transient="false" volatile="false"
  14713. static="true" final="true" visibility="public"
  14714. deprecated="not deprecated">
  14715. </field>
  14716. <field name="DNA_RECOVERBLOCK" type="int"
  14717. transient="false" volatile="false"
  14718. static="true" final="true" visibility="public"
  14719. deprecated="not deprecated">
  14720. </field>
  14721. <field name="DNA_ACCESSKEYUPDATE" type="int"
  14722. transient="false" volatile="false"
  14723. static="true" final="true" visibility="public"
  14724. deprecated="not deprecated">
  14725. </field>
  14726. <doc>
  14727. <![CDATA[Protocol that a DFS datanode uses to communicate with the NameNode.
  14728. It's used to upload current load information and block reports.
  14729. The only way a NameNode can communicate with a DataNode is by
  14730. returning values from these functions.]]>
  14731. </doc>
  14732. </interface>
  14733. <!-- end interface org.apache.hadoop.hdfs.server.protocol.DatanodeProtocol -->
  14734. <!-- start class org.apache.hadoop.hdfs.server.protocol.DatanodeRegistration -->
  14735. <class name="DatanodeRegistration" extends="org.apache.hadoop.hdfs.protocol.DatanodeID"
  14736. abstract="false"
  14737. static="false" final="false" visibility="public"
  14738. deprecated="not deprecated">
  14739. <implements name="org.apache.hadoop.io.Writable"/>
  14740. <implements name="org.apache.hadoop.hdfs.server.protocol.NodeRegistration"/>
  14741. <constructor name="DatanodeRegistration"
  14742. static="false" final="false" visibility="public"
  14743. deprecated="not deprecated">
  14744. <doc>
  14745. <![CDATA[Default constructor.]]>
  14746. </doc>
  14747. </constructor>
  14748. <constructor name="DatanodeRegistration" type="java.lang.String"
  14749. static="false" final="false" visibility="public"
  14750. deprecated="not deprecated">
  14751. <doc>
  14752. <![CDATA[Create DatanodeRegistration]]>
  14753. </doc>
  14754. </constructor>
  14755. <method name="setInfoPort"
  14756. abstract="false" native="false" synchronized="false"
  14757. static="false" final="false" visibility="public"
  14758. deprecated="not deprecated">
  14759. <param name="infoPort" type="int"/>
  14760. </method>
  14761. <method name="setIpcPort"
  14762. abstract="false" native="false" synchronized="false"
  14763. static="false" final="false" visibility="public"
  14764. deprecated="not deprecated">
  14765. <param name="ipcPort" type="int"/>
  14766. </method>
  14767. <method name="setStorageInfo"
  14768. abstract="false" native="false" synchronized="false"
  14769. static="false" final="false" visibility="public"
  14770. deprecated="not deprecated">
  14771. <param name="storage" type="org.apache.hadoop.hdfs.server.datanode.DataStorage"/>
  14772. </method>
  14773. <method name="setName"
  14774. abstract="false" native="false" synchronized="false"
  14775. static="false" final="false" visibility="public"
  14776. deprecated="not deprecated">
  14777. <param name="name" type="java.lang.String"/>
  14778. </method>
  14779. <method name="getVersion" return="int"
  14780. abstract="false" native="false" synchronized="false"
  14781. static="false" final="false" visibility="public"
  14782. deprecated="not deprecated">
  14783. </method>
  14784. <method name="getRegistrationID" return="java.lang.String"
  14785. abstract="false" native="false" synchronized="false"
  14786. static="false" final="false" visibility="public"
  14787. deprecated="not deprecated">
  14788. </method>
  14789. <method name="getAddress" return="java.lang.String"
  14790. abstract="false" native="false" synchronized="false"
  14791. static="false" final="false" visibility="public"
  14792. deprecated="not deprecated">
  14793. </method>
  14794. <method name="toString" return="java.lang.String"
  14795. abstract="false" native="false" synchronized="false"
  14796. static="false" final="false" visibility="public"
  14797. deprecated="not deprecated">
  14798. </method>
  14799. <method name="write"
  14800. abstract="false" native="false" synchronized="false"
  14801. static="false" final="false" visibility="public"
  14802. deprecated="not deprecated">
  14803. <param name="out" type="java.io.DataOutput"/>
  14804. <exception name="IOException" type="java.io.IOException"/>
  14805. <doc>
  14806. <![CDATA[{@inheritDoc}]]>
  14807. </doc>
  14808. </method>
  14809. <method name="readFields"
  14810. abstract="false" native="false" synchronized="false"
  14811. static="false" final="false" visibility="public"
  14812. deprecated="not deprecated">
  14813. <param name="in" type="java.io.DataInput"/>
  14814. <exception name="IOException" type="java.io.IOException"/>
  14815. <doc>
  14816. <![CDATA[{@inheritDoc}]]>
  14817. </doc>
  14818. </method>
  14819. <method name="equals" return="boolean"
  14820. abstract="false" native="false" synchronized="false"
  14821. static="false" final="false" visibility="public"
  14822. deprecated="not deprecated">
  14823. <param name="to" type="java.lang.Object"/>
  14824. </method>
  14825. <method name="hashCode" return="int"
  14826. abstract="false" native="false" synchronized="false"
  14827. static="false" final="false" visibility="public"
  14828. deprecated="not deprecated">
  14829. </method>
  14830. <field name="storageInfo" type="org.apache.hadoop.hdfs.server.common.StorageInfo"
  14831. transient="false" volatile="false"
  14832. static="false" final="false" visibility="public"
  14833. deprecated="not deprecated">
  14834. </field>
  14835. <field name="exportedKeys" type="org.apache.hadoop.hdfs.security.ExportedAccessKeys"
  14836. transient="false" volatile="false"
  14837. static="false" final="false" visibility="public"
  14838. deprecated="not deprecated">
  14839. </field>
  14840. <doc>
  14841. <![CDATA[DatanodeRegistration class contains all information the name-node needs
  14842. to identify and verify a data-node when it contacts the name-node.
  14843. This information is sent by data-node with each communication request.]]>
  14844. </doc>
  14845. </class>
  14846. <!-- end class org.apache.hadoop.hdfs.server.protocol.DatanodeRegistration -->
  14847. <!-- start class org.apache.hadoop.hdfs.server.protocol.DisallowedDatanodeException -->
  14848. <class name="DisallowedDatanodeException" extends="java.io.IOException"
  14849. abstract="false"
  14850. static="false" final="false" visibility="public"
  14851. deprecated="not deprecated">
  14852. <constructor name="DisallowedDatanodeException" type="org.apache.hadoop.hdfs.protocol.DatanodeID"
  14853. static="false" final="false" visibility="public"
  14854. deprecated="not deprecated">
  14855. </constructor>
  14856. <doc>
  14857. <![CDATA[This exception is thrown when a datanode tries to register or communicate
  14858. with the namenode when it does not appear on the list of included nodes,
  14859. or has been specifically excluded.]]>
  14860. </doc>
  14861. </class>
  14862. <!-- end class org.apache.hadoop.hdfs.server.protocol.DisallowedDatanodeException -->
  14863. <!-- start interface org.apache.hadoop.hdfs.server.protocol.InterDatanodeProtocol -->
  14864. <interface name="InterDatanodeProtocol" abstract="true"
  14865. static="false" final="false" visibility="public"
  14866. deprecated="not deprecated">
  14867. <implements name="org.apache.hadoop.ipc.VersionedProtocol"/>
  14868. <method name="initReplicaRecovery" return="org.apache.hadoop.hdfs.server.protocol.ReplicaRecoveryInfo"
  14869. abstract="false" native="false" synchronized="false"
  14870. static="false" final="false" visibility="public"
  14871. deprecated="not deprecated">
  14872. <param name="rBlock" type="org.apache.hadoop.hdfs.server.protocol.BlockRecoveryCommand.RecoveringBlock"/>
  14873. <exception name="IOException" type="java.io.IOException"/>
  14874. <doc>
  14875. <![CDATA[Initialize a replica recovery.
  14876. @return actual state of the replica on this data-node or
  14877. null if data-node does not have the replica.]]>
  14878. </doc>
  14879. </method>
  14880. <method name="updateReplicaUnderRecovery" return="org.apache.hadoop.hdfs.protocol.Block"
  14881. abstract="false" native="false" synchronized="false"
  14882. static="false" final="false" visibility="public"
  14883. deprecated="not deprecated">
  14884. <param name="oldBlock" type="org.apache.hadoop.hdfs.protocol.Block"/>
  14885. <param name="recoveryId" type="long"/>
  14886. <param name="newLength" type="long"/>
  14887. <exception name="IOException" type="java.io.IOException"/>
  14888. <doc>
  14889. <![CDATA[Update replica with the new generation stamp and length.]]>
  14890. </doc>
  14891. </method>
  14892. <field name="LOG" type="org.apache.commons.logging.Log"
  14893. transient="false" volatile="false"
  14894. static="true" final="true" visibility="public"
  14895. deprecated="not deprecated">
  14896. </field>
  14897. <field name="versionID" type="long"
  14898. transient="false" volatile="false"
  14899. static="true" final="true" visibility="public"
  14900. deprecated="not deprecated">
  14901. <doc>
  14902. <![CDATA[5: getBlockMetaDataInfo(), updateBlock() removed.]]>
  14903. </doc>
  14904. </field>
  14905. <doc>
  14906. <![CDATA[An inter-datanode protocol for updating generation stamp]]>
  14907. </doc>
  14908. </interface>
  14909. <!-- end interface org.apache.hadoop.hdfs.server.protocol.InterDatanodeProtocol -->
  14910. <!-- start class org.apache.hadoop.hdfs.server.protocol.KeyUpdateCommand -->
  14911. <class name="KeyUpdateCommand" extends="org.apache.hadoop.hdfs.server.protocol.DatanodeCommand"
  14912. abstract="false"
  14913. static="false" final="false" visibility="public"
  14914. deprecated="not deprecated">
  14915. <constructor name="KeyUpdateCommand" type="org.apache.hadoop.hdfs.security.ExportedAccessKeys"
  14916. static="false" final="false" visibility="public"
  14917. deprecated="not deprecated">
  14918. </constructor>
  14919. <method name="getExportedKeys" return="org.apache.hadoop.hdfs.security.ExportedAccessKeys"
  14920. abstract="false" native="false" synchronized="false"
  14921. static="false" final="false" visibility="public"
  14922. deprecated="not deprecated">
  14923. </method>
  14924. <method name="write"
  14925. abstract="false" native="false" synchronized="false"
  14926. static="false" final="false" visibility="public"
  14927. deprecated="not deprecated">
  14928. <param name="out" type="java.io.DataOutput"/>
  14929. <exception name="IOException" type="java.io.IOException"/>
  14930. </method>
  14931. <method name="readFields"
  14932. abstract="false" native="false" synchronized="false"
  14933. static="false" final="false" visibility="public"
  14934. deprecated="not deprecated">
  14935. <param name="in" type="java.io.DataInput"/>
  14936. <exception name="IOException" type="java.io.IOException"/>
  14937. </method>
  14938. </class>
  14939. <!-- end class org.apache.hadoop.hdfs.server.protocol.KeyUpdateCommand -->
  14940. <!-- start class org.apache.hadoop.hdfs.server.protocol.NamenodeCommand -->
  14941. <class name="NamenodeCommand" extends="org.apache.hadoop.hdfs.server.protocol.ServerCommand"
  14942. abstract="false"
  14943. static="false" final="false" visibility="public"
  14944. deprecated="not deprecated">
  14945. <constructor name="NamenodeCommand"
  14946. static="false" final="false" visibility="public"
  14947. deprecated="not deprecated">
  14948. </constructor>
  14949. <constructor name="NamenodeCommand" type="int"
  14950. static="false" final="false" visibility="public"
  14951. deprecated="not deprecated">
  14952. </constructor>
  14953. <doc>
  14954. <![CDATA[Base class for name-node command.
  14955. Issued by the name-node to notify other name-nodes what should be done.]]>
  14956. </doc>
  14957. </class>
  14958. <!-- end class org.apache.hadoop.hdfs.server.protocol.NamenodeCommand -->
  14959. <!-- start interface org.apache.hadoop.hdfs.server.protocol.NamenodeProtocol -->
  14960. <interface name="NamenodeProtocol" abstract="true"
  14961. static="false" final="false" visibility="public"
  14962. deprecated="not deprecated">
  14963. <implements name="org.apache.hadoop.ipc.VersionedProtocol"/>
  14964. <method name="getBlocks" return="org.apache.hadoop.hdfs.server.protocol.BlocksWithLocations"
  14965. abstract="false" native="false" synchronized="false"
  14966. static="false" final="false" visibility="public"
  14967. deprecated="not deprecated">
  14968. <param name="datanode" type="org.apache.hadoop.hdfs.protocol.DatanodeInfo"/>
  14969. <param name="size" type="long"/>
  14970. <exception name="IOException" type="java.io.IOException"/>
  14971. <doc>
  14972. <![CDATA[Get a list of blocks belonging to <code>datanode</code>
  14973. whose total size equals <code>size</code>.
  14974. @see org.apache.hadoop.hdfs.server.balancer.Balancer
  14975. @param datanode a data node
  14976. @param size requested size
  14977. @return a list of blocks & their locations
  14978. @throws RemoteException if size is less than or equal to 0 or
  14979. datanode does not exist]]>
  14980. </doc>
  14981. </method>
  14982. <method name="getAccessKeys" return="org.apache.hadoop.hdfs.security.ExportedAccessKeys"
  14983. abstract="false" native="false" synchronized="false"
  14984. static="false" final="false" visibility="public"
  14985. deprecated="not deprecated">
  14986. <exception name="IOException" type="java.io.IOException"/>
  14987. <doc>
  14988. <![CDATA[Get the current access keys
  14989. @return ExportedAccessKeys containing current access keys
  14990. @throws IOException]]>
  14991. </doc>
  14992. </method>
  14993. <method name="getEditLogSize" return="long"
  14994. abstract="false" native="false" synchronized="false"
  14995. static="false" final="false" visibility="public"
  14996. deprecated="See {@link org.apache.hadoop.hdfs.server.namenode.SecondaryNameNode}">
  14997. <exception name="IOException" type="java.io.IOException"/>
  14998. <doc>
  14999. <![CDATA[Get the size of the current edit log (in bytes).
  15000. @return The number of bytes in the current edit log.
  15001. @throws IOException
  15002. @deprecated
  15003. See {@link org.apache.hadoop.hdfs.server.namenode.SecondaryNameNode}]]>
  15004. </doc>
  15005. </method>
  15006. <method name="rollEditLog" return="org.apache.hadoop.hdfs.server.namenode.CheckpointSignature"
  15007. abstract="false" native="false" synchronized="false"
  15008. static="false" final="false" visibility="public"
  15009. deprecated="See {@link org.apache.hadoop.hdfs.server.namenode.SecondaryNameNode}">
  15010. <exception name="IOException" type="java.io.IOException"/>
  15011. <doc>
  15012. <![CDATA[Closes the current edit log and opens a new one. The
  15013. call fails if the file system is in SafeMode.
  15014. @throws IOException
  15015. @return a unique token to identify this transaction.
  15016. @deprecated
  15017. See {@link org.apache.hadoop.hdfs.server.namenode.SecondaryNameNode}]]>
  15018. </doc>
  15019. </method>
  15020. <method name="rollFsImage"
  15021. abstract="false" native="false" synchronized="false"
  15022. static="false" final="false" visibility="public"
  15023. deprecated="See {@link org.apache.hadoop.hdfs.server.namenode.SecondaryNameNode}">
  15024. <exception name="IOException" type="java.io.IOException"/>
  15025. <doc>
  15026. <![CDATA[Rolls the fsImage log. It removes the old fsImage, copies the
  15027. new image to fsImage, removes the old edits and renames edits.new
  15028. to edits. The call fails if any of the four files are missing.
  15029. @throws IOException
  15030. @deprecated
  15031. See {@link org.apache.hadoop.hdfs.server.namenode.SecondaryNameNode}]]>
  15032. </doc>
  15033. </method>
  15034. <method name="versionRequest" return="org.apache.hadoop.hdfs.server.protocol.NamespaceInfo"
  15035. abstract="false" native="false" synchronized="false"
  15036. static="false" final="false" visibility="public"
  15037. deprecated="not deprecated">
  15038. <exception name="IOException" type="java.io.IOException"/>
  15039. <doc>
  15040. <![CDATA[Request name-node version and storage information.
  15041. @return {@link NamespaceInfo} identifying versions and storage information
  15042. of the name-node
  15043. @throws IOException]]>
  15044. </doc>
  15045. </method>
  15046. <method name="errorReport"
  15047. abstract="false" native="false" synchronized="false"
  15048. static="false" final="false" visibility="public"
  15049. deprecated="not deprecated">
  15050. <param name="registration" type="org.apache.hadoop.hdfs.server.protocol.NamenodeRegistration"/>
  15051. <param name="errorCode" type="int"/>
  15052. <param name="msg" type="java.lang.String"/>
  15053. <exception name="IOException" type="java.io.IOException"/>
  15054. <doc>
  15055. <![CDATA[Report to the active name-node an error occurred on a subordinate node.
  15056. Depending on the error code the active node may decide to unregister the
  15057. reporting node.
  15058. @param registration requesting node.
  15059. @param errorCode indicates the error
  15060. @param msg free text description of the error
  15061. @throws IOException]]>
  15062. </doc>
  15063. </method>
  15064. <method name="register" return="org.apache.hadoop.hdfs.server.protocol.NamenodeRegistration"
  15065. abstract="false" native="false" synchronized="false"
  15066. static="false" final="false" visibility="public"
  15067. deprecated="not deprecated">
  15068. <param name="registration" type="org.apache.hadoop.hdfs.server.protocol.NamenodeRegistration"/>
  15069. <exception name="IOException" type="java.io.IOException"/>
  15070. <doc>
  15071. <![CDATA[Register a subordinate name-node like backup node.
  15072. @return {@link NamenodeRegistration} of the node,
  15073. which this node has just registered with.]]>
  15074. </doc>
  15075. </method>
  15076. <method name="startCheckpoint" return="org.apache.hadoop.hdfs.server.protocol.NamenodeCommand"
  15077. abstract="false" native="false" synchronized="false"
  15078. static="false" final="false" visibility="public"
  15079. deprecated="not deprecated">
  15080. <param name="registration" type="org.apache.hadoop.hdfs.server.protocol.NamenodeRegistration"/>
  15081. <exception name="IOException" type="java.io.IOException"/>
  15082. <doc>
  15083. <![CDATA[A request to the active name-node to start a checkpoint.
  15084. The name-node should decide whether to admit it or reject.
  15085. The name-node also decides what should be done with the backup node
  15086. image before and after the checkpoint.
  15087. @see CheckpointCommand
  15088. @see NamenodeCommand
  15089. @see #ACT_SHUTDOWN
  15090. @param registration the requesting node
  15091. @return {@link CheckpointCommand} if checkpoint is allowed.
  15092. @throws IOException]]>
  15093. </doc>
  15094. </method>
  15095. <method name="endCheckpoint"
  15096. abstract="false" native="false" synchronized="false"
  15097. static="false" final="false" visibility="public"
  15098. deprecated="not deprecated">
  15099. <param name="registration" type="org.apache.hadoop.hdfs.server.protocol.NamenodeRegistration"/>
  15100. <param name="sig" type="org.apache.hadoop.hdfs.server.namenode.CheckpointSignature"/>
  15101. <exception name="IOException" type="java.io.IOException"/>
  15102. <doc>
  15103. <![CDATA[A request to the active name-node to finalize
  15104. previously started checkpoint.
  15105. @param registration the requesting node
  15106. @param sig {@code CheckpointSignature} which identifies the checkpoint.
  15107. @throws IOException]]>
  15108. </doc>
  15109. </method>
  15110. <method name="journalSize" return="long"
  15111. abstract="false" native="false" synchronized="false"
  15112. static="false" final="false" visibility="public"
  15113. deprecated="not deprecated">
  15114. <param name="registration" type="org.apache.hadoop.hdfs.server.protocol.NamenodeRegistration"/>
  15115. <exception name="IOException" type="java.io.IOException"/>
  15116. <doc>
  15117. <![CDATA[Get the size of the active name-node journal (edit log) in bytes.
  15118. @param registration the requesting node
  15119. @return The number of bytes in the journal.
  15120. @throws IOException]]>
  15121. </doc>
  15122. </method>
  15123. <method name="journal"
  15124. abstract="false" native="false" synchronized="false"
  15125. static="false" final="false" visibility="public"
  15126. deprecated="not deprecated">
  15127. <param name="registration" type="org.apache.hadoop.hdfs.server.protocol.NamenodeRegistration"/>
  15128. <param name="jAction" type="int"/>
  15129. <param name="length" type="int"/>
  15130. <param name="records" type="byte[]"/>
  15131. <exception name="IOException" type="java.io.IOException"/>
  15132. <doc>
  15133. <![CDATA[Journal edit records.
  15134. This message is sent by the active name-node to the backup node
  15135. via {@code EditLogBackupOutputStream} in order to synchronize meta-data
  15136. changes with the backup namespace image.
  15137. @param registration active node registration
  15138. @param jAction journal action
  15139. @param length length of the byte array
  15140. @param records byte array containing serialized journal records
  15141. @throws IOException]]>
  15142. </doc>
  15143. </method>
  15144. <field name="versionID" type="long"
  15145. transient="false" volatile="false"
  15146. static="true" final="true" visibility="public"
  15147. deprecated="not deprecated">
  15148. <doc>
  15149. <![CDATA[Compared to the previous version the following changes have been introduced:
  15150. (Only the latest change is reflected.
  15151. The log of historical changes can be retrieved from the svn).
  15152. 4: new method added: getAccessKeys()]]>
  15153. </doc>
  15154. </field>
  15155. <field name="NOTIFY" type="int"
  15156. transient="false" volatile="false"
  15157. static="true" final="true" visibility="public"
  15158. deprecated="not deprecated">
  15159. </field>
  15160. <field name="FATAL" type="int"
  15161. transient="false" volatile="false"
  15162. static="true" final="true" visibility="public"
  15163. deprecated="not deprecated">
  15164. </field>
  15165. <field name="JA_IS_ALIVE" type="byte"
  15166. transient="false" volatile="false"
  15167. static="true" final="true" visibility="public"
  15168. deprecated="not deprecated">
  15169. </field>
  15170. <field name="JA_JOURNAL" type="byte"
  15171. transient="false" volatile="false"
  15172. static="true" final="true" visibility="public"
  15173. deprecated="not deprecated">
  15174. </field>
  15175. <field name="JA_JSPOOL_START" type="byte"
  15176. transient="false" volatile="false"
  15177. static="true" final="true" visibility="public"
  15178. deprecated="not deprecated">
  15179. </field>
  15180. <field name="JA_CHECKPOINT_TIME" type="byte"
  15181. transient="false" volatile="false"
  15182. static="true" final="true" visibility="public"
  15183. deprecated="not deprecated">
  15184. </field>
  15185. <field name="ACT_UNKNOWN" type="int"
  15186. transient="false" volatile="false"
  15187. static="true" final="true" visibility="public"
  15188. deprecated="not deprecated">
  15189. </field>
  15190. <field name="ACT_SHUTDOWN" type="int"
  15191. transient="false" volatile="false"
  15192. static="true" final="true" visibility="public"
  15193. deprecated="not deprecated">
  15194. </field>
  15195. <field name="ACT_CHECKPOINT" type="int"
  15196. transient="false" volatile="false"
  15197. static="true" final="true" visibility="public"
  15198. deprecated="not deprecated">
  15199. </field>
  15200. <doc>
  15201. <![CDATA[Protocol that a secondary NameNode uses to communicate with the NameNode.
  15202. It's used to get part of the name node state]]>
  15203. </doc>
  15204. </interface>
  15205. <!-- end interface org.apache.hadoop.hdfs.server.protocol.NamenodeProtocol -->
  15206. <!-- start interface org.apache.hadoop.hdfs.server.protocol.NamenodeProtocols -->
  15207. <interface name="NamenodeProtocols" abstract="true"
  15208. static="false" final="false" visibility="public"
  15209. deprecated="not deprecated">
  15210. <implements name="org.apache.hadoop.hdfs.protocol.ClientProtocol"/>
  15211. <implements name="org.apache.hadoop.hdfs.server.protocol.DatanodeProtocol"/>
  15212. <implements name="org.apache.hadoop.hdfs.server.protocol.NamenodeProtocol"/>
  15213. <implements name="org.apache.hadoop.security.authorize.RefreshAuthorizationPolicyProtocol"/>
  15214. <implements name="org.apache.hadoop.security.RefreshUserToGroupMappingsProtocol"/>
  15215. <doc>
  15216. <![CDATA[The full set of RPC methods implemented by the Namenode.]]>
  15217. </doc>
  15218. </interface>
  15219. <!-- end interface org.apache.hadoop.hdfs.server.protocol.NamenodeProtocols -->
  15220. <!-- start class org.apache.hadoop.hdfs.server.protocol.NamenodeRegistration -->
  15221. <class name="NamenodeRegistration" extends="org.apache.hadoop.hdfs.server.common.StorageInfo"
  15222. abstract="false"
  15223. static="false" final="false" visibility="public"
  15224. deprecated="not deprecated">
  15225. <implements name="org.apache.hadoop.hdfs.server.protocol.NodeRegistration"/>
  15226. <constructor name="NamenodeRegistration"
  15227. static="false" final="false" visibility="public"
  15228. deprecated="not deprecated">
  15229. </constructor>
  15230. <constructor name="NamenodeRegistration" type="java.lang.String, java.lang.String, org.apache.hadoop.hdfs.server.common.StorageInfo, org.apache.hadoop.hdfs.server.common.HdfsConstants.NamenodeRole, long"
  15231. static="false" final="false" visibility="public"
  15232. deprecated="not deprecated">
  15233. </constructor>
  15234. <method name="getAddress" return="java.lang.String"
  15235. abstract="false" native="false" synchronized="false"
  15236. static="false" final="false" visibility="public"
  15237. deprecated="not deprecated">
  15238. </method>
  15239. <method name="getRegistrationID" return="java.lang.String"
  15240. abstract="false" native="false" synchronized="false"
  15241. static="false" final="false" visibility="public"
  15242. deprecated="not deprecated">
  15243. </method>
  15244. <method name="getVersion" return="int"
  15245. abstract="false" native="false" synchronized="false"
  15246. static="false" final="false" visibility="public"
  15247. deprecated="not deprecated">
  15248. </method>
  15249. <method name="toString" return="java.lang.String"
  15250. abstract="false" native="false" synchronized="false"
  15251. static="false" final="false" visibility="public"
  15252. deprecated="not deprecated">
  15253. </method>
  15254. <method name="getRole" return="org.apache.hadoop.hdfs.server.common.HdfsConstants.NamenodeRole"
  15255. abstract="false" native="false" synchronized="false"
  15256. static="false" final="false" visibility="public"
  15257. deprecated="not deprecated">
  15258. <doc>
  15259. <![CDATA[Get name-node role.]]>
  15260. </doc>
  15261. </method>
  15262. <method name="isRole" return="boolean"
  15263. abstract="false" native="false" synchronized="false"
  15264. static="false" final="false" visibility="public"
  15265. deprecated="not deprecated">
  15266. <param name="that" type="org.apache.hadoop.hdfs.server.common.HdfsConstants.NamenodeRole"/>
  15267. </method>
  15268. <method name="getCheckpointTime" return="long"
  15269. abstract="false" native="false" synchronized="false"
  15270. static="false" final="false" visibility="public"
  15271. deprecated="not deprecated">
  15272. <doc>
  15273. <![CDATA[Get the age of the image.]]>
  15274. </doc>
  15275. </method>
  15276. <method name="write"
  15277. abstract="false" native="false" synchronized="false"
  15278. static="false" final="false" visibility="public"
  15279. deprecated="not deprecated">
  15280. <param name="out" type="java.io.DataOutput"/>
  15281. <exception name="IOException" type="java.io.IOException"/>
  15282. </method>
  15283. <method name="readFields"
  15284. abstract="false" native="false" synchronized="false"
  15285. static="false" final="false" visibility="public"
  15286. deprecated="not deprecated">
  15287. <param name="in" type="java.io.DataInput"/>
  15288. <exception name="IOException" type="java.io.IOException"/>
  15289. </method>
  15290. <doc>
  15291. <![CDATA[Information sent by a subordinate name-node to the active name-node
  15292. during the registration process.]]>
  15293. </doc>
  15294. </class>
  15295. <!-- end class org.apache.hadoop.hdfs.server.protocol.NamenodeRegistration -->
  15296. <!-- start class org.apache.hadoop.hdfs.server.protocol.NamespaceInfo -->
  15297. <class name="NamespaceInfo" extends="org.apache.hadoop.hdfs.server.common.StorageInfo"
  15298. abstract="false"
  15299. static="false" final="false" visibility="public"
  15300. deprecated="not deprecated">
  15301. <constructor name="NamespaceInfo"
  15302. static="false" final="false" visibility="public"
  15303. deprecated="not deprecated">
  15304. </constructor>
  15305. <constructor name="NamespaceInfo" type="int, long, int"
  15306. static="false" final="false" visibility="public"
  15307. deprecated="not deprecated">
  15308. </constructor>
  15309. <method name="getBuildVersion" return="java.lang.String"
  15310. abstract="false" native="false" synchronized="false"
  15311. static="false" final="false" visibility="public"
  15312. deprecated="not deprecated">
  15313. </method>
  15314. <method name="getDistributedUpgradeVersion" return="int"
  15315. abstract="false" native="false" synchronized="false"
  15316. static="false" final="false" visibility="public"
  15317. deprecated="not deprecated">
  15318. </method>
  15319. <method name="write"
  15320. abstract="false" native="false" synchronized="false"
  15321. static="false" final="false" visibility="public"
  15322. deprecated="not deprecated">
  15323. <param name="out" type="java.io.DataOutput"/>
  15324. <exception name="IOException" type="java.io.IOException"/>
  15325. </method>
  15326. <method name="readFields"
  15327. abstract="false" native="false" synchronized="false"
  15328. static="false" final="false" visibility="public"
  15329. deprecated="not deprecated">
  15330. <param name="in" type="java.io.DataInput"/>
  15331. <exception name="IOException" type="java.io.IOException"/>
  15332. </method>
  15333. <doc>
  15334. <![CDATA[NamespaceInfo is returned by the name-node in reply
  15335. to a data-node handshake.]]>
  15336. </doc>
  15337. </class>
  15338. <!-- end class org.apache.hadoop.hdfs.server.protocol.NamespaceInfo -->
  15339. <!-- start interface org.apache.hadoop.hdfs.server.protocol.NodeRegistration -->
  15340. <interface name="NodeRegistration" abstract="true"
  15341. static="false" final="false" visibility="public"
  15342. deprecated="not deprecated">
  15343. <method name="getAddress" return="java.lang.String"
  15344. abstract="false" native="false" synchronized="false"
  15345. static="false" final="false" visibility="public"
  15346. deprecated="not deprecated">
  15347. <doc>
  15348. <![CDATA[Get address of the server node.
  15349. @return hostname:portNumber]]>
  15350. </doc>
  15351. </method>
  15352. <method name="getRegistrationID" return="java.lang.String"
  15353. abstract="false" native="false" synchronized="false"
  15354. static="false" final="false" visibility="public"
  15355. deprecated="not deprecated">
  15356. <doc>
  15357. <![CDATA[Get registration ID of the server node.]]>
  15358. </doc>
  15359. </method>
  15360. <method name="getVersion" return="int"
  15361. abstract="false" native="false" synchronized="false"
  15362. static="false" final="false" visibility="public"
  15363. deprecated="not deprecated">
  15364. <doc>
  15365. <![CDATA[Get layout version of the server node.]]>
  15366. </doc>
  15367. </method>
  15368. <method name="toString" return="java.lang.String"
  15369. abstract="false" native="false" synchronized="false"
  15370. static="false" final="false" visibility="public"
  15371. deprecated="not deprecated">
  15372. </method>
  15373. <doc>
  15374. <![CDATA[Generic class specifying information, which need to be sent to the name-node
  15375. during the registration process.]]>
  15376. </doc>
  15377. </interface>
  15378. <!-- end interface org.apache.hadoop.hdfs.server.protocol.NodeRegistration -->
  15379. <!-- start class org.apache.hadoop.hdfs.server.protocol.ReplicaRecoveryInfo -->
  15380. <class name="ReplicaRecoveryInfo" extends="org.apache.hadoop.hdfs.protocol.Block"
  15381. abstract="false"
  15382. static="false" final="false" visibility="public"
  15383. deprecated="not deprecated">
  15384. <constructor name="ReplicaRecoveryInfo"
  15385. static="false" final="false" visibility="public"
  15386. deprecated="not deprecated">
  15387. </constructor>
  15388. <constructor name="ReplicaRecoveryInfo" type="long, long, long, org.apache.hadoop.hdfs.server.common.HdfsConstants.ReplicaState"
  15389. static="false" final="false" visibility="public"
  15390. deprecated="not deprecated">
  15391. </constructor>
  15392. <method name="getOriginalReplicaState" return="org.apache.hadoop.hdfs.server.common.HdfsConstants.ReplicaState"
  15393. abstract="false" native="false" synchronized="false"
  15394. static="false" final="false" visibility="public"
  15395. deprecated="not deprecated">
  15396. </method>
  15397. <method name="equals" return="boolean"
  15398. abstract="false" native="false" synchronized="false"
  15399. static="false" final="false" visibility="public"
  15400. deprecated="not deprecated">
  15401. <param name="o" type="java.lang.Object"/>
  15402. </method>
  15403. <method name="hashCode" return="int"
  15404. abstract="false" native="false" synchronized="false"
  15405. static="false" final="false" visibility="public"
  15406. deprecated="not deprecated">
  15407. </method>
  15408. <method name="readFields"
  15409. abstract="false" native="false" synchronized="false"
  15410. static="false" final="false" visibility="public"
  15411. deprecated="not deprecated">
  15412. <param name="in" type="java.io.DataInput"/>
  15413. <exception name="IOException" type="java.io.IOException"/>
  15414. </method>
  15415. <method name="write"
  15416. abstract="false" native="false" synchronized="false"
  15417. static="false" final="false" visibility="public"
  15418. deprecated="not deprecated">
  15419. <param name="out" type="java.io.DataOutput"/>
  15420. <exception name="IOException" type="java.io.IOException"/>
  15421. </method>
  15422. <doc>
  15423. <![CDATA[Replica recovery information.]]>
  15424. </doc>
  15425. </class>
  15426. <!-- end class org.apache.hadoop.hdfs.server.protocol.ReplicaRecoveryInfo -->
  15427. <!-- start class org.apache.hadoop.hdfs.server.protocol.ServerCommand -->
  15428. <class name="ServerCommand" extends="java.lang.Object"
  15429. abstract="true"
  15430. static="false" final="false" visibility="public"
  15431. deprecated="not deprecated">
  15432. <implements name="org.apache.hadoop.io.Writable"/>
  15433. <constructor name="ServerCommand"
  15434. static="false" final="false" visibility="public"
  15435. deprecated="not deprecated">
  15436. <doc>
  15437. <![CDATA[Unknown server command constructor.
  15438. Creates a command with action 0.
  15439. @see NamenodeProtocol#ACT_UNKNOWN
  15440. @see DatanodeProtocol#DNA_UNKNOWN]]>
  15441. </doc>
  15442. </constructor>
  15443. <constructor name="ServerCommand" type="int"
  15444. static="false" final="false" visibility="public"
  15445. deprecated="not deprecated">
  15446. <doc>
  15447. <![CDATA[Create a command for the specified action.
  15448. Actions are protocol specific.
  15449. @see DatanodeProtocol
  15450. @see NamenodeProtocol
  15451. @param action]]>
  15452. </doc>
  15453. </constructor>
  15454. <method name="getAction" return="int"
  15455. abstract="false" native="false" synchronized="false"
  15456. static="false" final="false" visibility="public"
  15457. deprecated="not deprecated">
  15458. <doc>
  15459. <![CDATA[Get server command action.
  15460. @return action code.]]>
  15461. </doc>
  15462. </method>
  15463. <method name="write"
  15464. abstract="false" native="false" synchronized="false"
  15465. static="false" final="false" visibility="public"
  15466. deprecated="not deprecated">
  15467. <param name="out" type="java.io.DataOutput"/>
  15468. <exception name="IOException" type="java.io.IOException"/>
  15469. </method>
  15470. <method name="readFields"
  15471. abstract="false" native="false" synchronized="false"
  15472. static="false" final="false" visibility="public"
  15473. deprecated="not deprecated">
  15474. <param name="in" type="java.io.DataInput"/>
  15475. <exception name="IOException" type="java.io.IOException"/>
  15476. </method>
  15477. <doc>
  15478. <![CDATA[Base class for a server command.
  15479. Issued by the name-node to notify other servers what should be done.
  15480. Commands are defined by actions defined in respective protocols.
  15481. @see DatanodeProtocol
  15482. @see NamenodeProtocol]]>
  15483. </doc>
  15484. </class>
  15485. <!-- end class org.apache.hadoop.hdfs.server.protocol.ServerCommand -->
  15486. <!-- start class org.apache.hadoop.hdfs.server.protocol.UpgradeCommand -->
  15487. <class name="UpgradeCommand" extends="org.apache.hadoop.hdfs.server.protocol.DatanodeCommand"
  15488. abstract="false"
  15489. static="false" final="false" visibility="public"
  15490. deprecated="not deprecated">
  15491. <constructor name="UpgradeCommand"
  15492. static="false" final="false" visibility="public"
  15493. deprecated="not deprecated">
  15494. </constructor>
  15495. <constructor name="UpgradeCommand" type="int, int, short"
  15496. static="false" final="false" visibility="public"
  15497. deprecated="not deprecated">
  15498. </constructor>
  15499. <method name="getVersion" return="int"
  15500. abstract="false" native="false" synchronized="false"
  15501. static="false" final="false" visibility="public"
  15502. deprecated="not deprecated">
  15503. </method>
  15504. <method name="getCurrentStatus" return="short"
  15505. abstract="false" native="false" synchronized="false"
  15506. static="false" final="false" visibility="public"
  15507. deprecated="not deprecated">
  15508. </method>
  15509. <method name="write"
  15510. abstract="false" native="false" synchronized="false"
  15511. static="false" final="false" visibility="public"
  15512. deprecated="not deprecated">
  15513. <param name="out" type="java.io.DataOutput"/>
  15514. <exception name="IOException" type="java.io.IOException"/>
  15515. </method>
  15516. <method name="readFields"
  15517. abstract="false" native="false" synchronized="false"
  15518. static="false" final="false" visibility="public"
  15519. deprecated="not deprecated">
  15520. <param name="in" type="java.io.DataInput"/>
  15521. <exception name="IOException" type="java.io.IOException"/>
  15522. </method>
  15523. <field name="UC_ACTION_REPORT_STATUS" type="int"
  15524. transient="false" volatile="false"
  15525. static="true" final="true" visibility="public"
  15526. deprecated="not deprecated">
  15527. </field>
  15528. <field name="UC_ACTION_START_UPGRADE" type="int"
  15529. transient="false" volatile="false"
  15530. static="true" final="true" visibility="public"
  15531. deprecated="not deprecated">
  15532. </field>
  15533. <doc>
  15534. <![CDATA[This as a generic distributed upgrade command.
  15535. During the upgrade cluster components send upgrade commands to each other
  15536. in order to obtain or share information with them.
  15537. It is supposed that each upgrade defines specific upgrade command by
  15538. deriving them from this class.
  15539. The upgrade command contains version of the upgrade, which is verified
  15540. on the receiving side and current status of the upgrade.]]>
  15541. </doc>
  15542. </class>
  15543. <!-- end class org.apache.hadoop.hdfs.server.protocol.UpgradeCommand -->
  15544. </package>
  15545. <package name="org.apache.hadoop.hdfs.tools">
  15546. <!-- start class org.apache.hadoop.hdfs.tools.DelegationTokenFetcher -->
  15547. <class name="DelegationTokenFetcher" extends="java.lang.Object"
  15548. abstract="false"
  15549. static="false" final="false" visibility="public"
  15550. deprecated="not deprecated">
  15551. <constructor name="DelegationTokenFetcher" type="org.apache.hadoop.hdfs.DistributedFileSystem, java.io.DataOutputStream, org.apache.hadoop.security.UserGroupInformation"
  15552. static="false" final="false" visibility="public"
  15553. deprecated="not deprecated">
  15554. </constructor>
  15555. <method name="main"
  15556. abstract="false" native="false" synchronized="false"
  15557. static="true" final="false" visibility="public"
  15558. deprecated="not deprecated">
  15559. <param name="args" type="java.lang.String[]"/>
  15560. <exception name="Exception" type="java.lang.Exception"/>
  15561. <doc>
  15562. <![CDATA[Command-line interface]]>
  15563. </doc>
  15564. </method>
  15565. <method name="go"
  15566. abstract="false" native="false" synchronized="false"
  15567. static="false" final="false" visibility="public"
  15568. deprecated="not deprecated">
  15569. <exception name="IOException" type="java.io.IOException"/>
  15570. </method>
  15571. <doc>
  15572. <![CDATA[Fetch a DelegationToken from the current Namenode and store it in the
  15573. specified file.]]>
  15574. </doc>
  15575. </class>
  15576. <!-- end class org.apache.hadoop.hdfs.tools.DelegationTokenFetcher -->
  15577. <!-- start class org.apache.hadoop.hdfs.tools.DFSAdmin -->
  15578. <class name="DFSAdmin" extends="org.apache.hadoop.fs.FsShell"
  15579. abstract="false"
  15580. static="false" final="false" visibility="public"
  15581. deprecated="not deprecated">
  15582. <constructor name="DFSAdmin"
  15583. static="false" final="false" visibility="public"
  15584. deprecated="not deprecated">
  15585. <doc>
  15586. <![CDATA[Construct a DFSAdmin object.]]>
  15587. </doc>
  15588. </constructor>
  15589. <constructor name="DFSAdmin" type="org.apache.hadoop.conf.Configuration"
  15590. static="false" final="false" visibility="public"
  15591. deprecated="not deprecated">
  15592. <doc>
  15593. <![CDATA[Construct a DFSAdmin object.]]>
  15594. </doc>
  15595. </constructor>
  15596. <method name="report"
  15597. abstract="false" native="false" synchronized="false"
  15598. static="false" final="false" visibility="public"
  15599. deprecated="not deprecated">
  15600. <exception name="IOException" type="java.io.IOException"/>
  15601. <doc>
  15602. <![CDATA[Gives a report on how the FileSystem is doing.
  15603. @exception IOException if the filesystem does not exist.]]>
  15604. </doc>
  15605. </method>
  15606. <method name="setSafeMode"
  15607. abstract="false" native="false" synchronized="false"
  15608. static="false" final="false" visibility="public"
  15609. deprecated="not deprecated">
  15610. <param name="argv" type="java.lang.String[]"/>
  15611. <param name="idx" type="int"/>
  15612. <exception name="IOException" type="java.io.IOException"/>
  15613. <doc>
  15614. <![CDATA[Safe mode maintenance command.
  15615. Usage: java DFSAdmin -safemode [enter | leave | get]
  15616. @param argv List of of command line parameters.
  15617. @param idx The index of the command that is being processed.
  15618. @exception IOException if the filesystem does not exist.]]>
  15619. </doc>
  15620. </method>
  15621. <method name="saveNamespace" return="int"
  15622. abstract="false" native="false" synchronized="false"
  15623. static="false" final="false" visibility="public"
  15624. deprecated="not deprecated">
  15625. <exception name="IOException" type="java.io.IOException"/>
  15626. <doc>
  15627. <![CDATA[Command to ask the namenode to save the namespace.
  15628. Usage: java DFSAdmin -saveNamespace
  15629. @exception IOException
  15630. @see org.apache.hadoop.hdfs.protocol.ClientProtocol#saveNamespace()]]>
  15631. </doc>
  15632. </method>
  15633. <method name="restoreFaileStorage" return="int"
  15634. abstract="false" native="false" synchronized="false"
  15635. static="false" final="false" visibility="public"
  15636. deprecated="not deprecated">
  15637. <param name="arg" type="java.lang.String"/>
  15638. <exception name="IOException" type="java.io.IOException"/>
  15639. <doc>
  15640. <![CDATA[Command to enable/disable/check restoring of failed storage replicas in the namenode.
  15641. Usage: java DFSAdmin -restoreFailedStorage true|false|check
  15642. @exception IOException
  15643. @see org.apache.hadoop.hdfs.protocol.ClientProtocol#restoreFailedStorage(String arg)]]>
  15644. </doc>
  15645. </method>
  15646. <method name="refreshNodes" return="int"
  15647. abstract="false" native="false" synchronized="false"
  15648. static="false" final="false" visibility="public"
  15649. deprecated="not deprecated">
  15650. <exception name="IOException" type="java.io.IOException"/>
  15651. <doc>
  15652. <![CDATA[Command to ask the namenode to reread the hosts and excluded hosts
  15653. file.
  15654. Usage: java DFSAdmin -refreshNodes
  15655. @exception IOException]]>
  15656. </doc>
  15657. </method>
  15658. <method name="finalizeUpgrade" return="int"
  15659. abstract="false" native="false" synchronized="false"
  15660. static="false" final="false" visibility="public"
  15661. deprecated="not deprecated">
  15662. <exception name="IOException" type="java.io.IOException"/>
  15663. <doc>
  15664. <![CDATA[Command to ask the namenode to finalize previously performed upgrade.
  15665. Usage: java DFSAdmin -finalizeUpgrade
  15666. @exception IOException]]>
  15667. </doc>
  15668. </method>
  15669. <method name="upgradeProgress" return="int"
  15670. abstract="false" native="false" synchronized="false"
  15671. static="false" final="false" visibility="public"
  15672. deprecated="not deprecated">
  15673. <param name="argv" type="java.lang.String[]"/>
  15674. <param name="idx" type="int"/>
  15675. <exception name="IOException" type="java.io.IOException"/>
  15676. <doc>
  15677. <![CDATA[Command to request current distributed upgrade status,
  15678. a detailed status, or to force the upgrade to proceed.
  15679. Usage: java DFSAdmin -upgradeProgress [status | details | force]
  15680. @exception IOException]]>
  15681. </doc>
  15682. </method>
  15683. <method name="metaSave" return="int"
  15684. abstract="false" native="false" synchronized="false"
  15685. static="false" final="false" visibility="public"
  15686. deprecated="not deprecated">
  15687. <param name="argv" type="java.lang.String[]"/>
  15688. <param name="idx" type="int"/>
  15689. <exception name="IOException" type="java.io.IOException"/>
  15690. <doc>
  15691. <![CDATA[Dumps DFS data structures into specified file.
  15692. Usage: java DFSAdmin -metasave filename
  15693. @param argv List of of command line parameters.
  15694. @param idx The index of the command that is being processed.
  15695. @exception IOException if an error accoured wile accessing
  15696. the file or path.]]>
  15697. </doc>
  15698. </method>
  15699. <method name="printTopology" return="int"
  15700. abstract="false" native="false" synchronized="false"
  15701. static="false" final="false" visibility="public"
  15702. deprecated="not deprecated">
  15703. <exception name="IOException" type="java.io.IOException"/>
  15704. <doc>
  15705. <![CDATA[Display each rack and the nodes assigned to that rack, as determined
  15706. by the NameNode, in a hierarchical manner. The nodes and racks are
  15707. sorted alphabetically.
  15708. @throws IOException If an error while getting datanode report]]>
  15709. </doc>
  15710. </method>
  15711. <method name="refreshServiceAcl" return="int"
  15712. abstract="false" native="false" synchronized="false"
  15713. static="false" final="false" visibility="public"
  15714. deprecated="not deprecated">
  15715. <exception name="IOException" type="java.io.IOException"/>
  15716. <doc>
  15717. <![CDATA[Refresh the authorization policy on the {@link NameNode}.
  15718. @return exitcode 0 on success, non-zero on failure
  15719. @throws IOException]]>
  15720. </doc>
  15721. </method>
  15722. <method name="refreshUserToGroupsMappings" return="int"
  15723. abstract="false" native="false" synchronized="false"
  15724. static="false" final="false" visibility="public"
  15725. deprecated="not deprecated">
  15726. <exception name="IOException" type="java.io.IOException"/>
  15727. <doc>
  15728. <![CDATA[Refresh the user-to-groups mappings on the {@link NameNode}.
  15729. @return exitcode 0 on success, non-zero on failure
  15730. @throws IOException]]>
  15731. </doc>
  15732. </method>
  15733. <method name="run" return="int"
  15734. abstract="false" native="false" synchronized="false"
  15735. static="false" final="false" visibility="public"
  15736. deprecated="not deprecated">
  15737. <param name="argv" type="java.lang.String[]"/>
  15738. <exception name="Exception" type="java.lang.Exception"/>
  15739. <doc>
  15740. <![CDATA[@param argv The parameters passed to this program.
  15741. @exception Exception if the filesystem does not exist.
  15742. @return 0 on success, non zero on error.]]>
  15743. </doc>
  15744. </method>
  15745. <method name="main"
  15746. abstract="false" native="false" synchronized="false"
  15747. static="true" final="false" visibility="public"
  15748. deprecated="not deprecated">
  15749. <param name="argv" type="java.lang.String[]"/>
  15750. <exception name="Exception" type="java.lang.Exception"/>
  15751. <doc>
  15752. <![CDATA[main() has some simple utility methods.
  15753. @param argv Command line parameters.
  15754. @exception Exception if the filesystem does not exist.]]>
  15755. </doc>
  15756. </method>
  15757. <doc>
  15758. <![CDATA[This class provides some DFS administrative access.]]>
  15759. </doc>
  15760. </class>
  15761. <!-- end class org.apache.hadoop.hdfs.tools.DFSAdmin -->
  15762. <!-- start class org.apache.hadoop.hdfs.tools.DFSck -->
  15763. <class name="DFSck" extends="org.apache.hadoop.conf.Configured"
  15764. abstract="false"
  15765. static="false" final="false" visibility="public"
  15766. deprecated="not deprecated">
  15767. <implements name="org.apache.hadoop.util.Tool"/>
  15768. <constructor name="DFSck" type="org.apache.hadoop.conf.Configuration"
  15769. static="false" final="false" visibility="public"
  15770. deprecated="not deprecated">
  15771. <exception name="IOException" type="java.io.IOException"/>
  15772. <doc>
  15773. <![CDATA[Filesystem checker.
  15774. @param conf current Configuration]]>
  15775. </doc>
  15776. </constructor>
  15777. <method name="run" return="int"
  15778. abstract="false" native="false" synchronized="false"
  15779. static="false" final="false" visibility="public"
  15780. deprecated="not deprecated">
  15781. <param name="args" type="java.lang.String[]"/>
  15782. <exception name="IOException" type="java.io.IOException"/>
  15783. <doc>
  15784. <![CDATA[@param args]]>
  15785. </doc>
  15786. </method>
  15787. <method name="main"
  15788. abstract="false" native="false" synchronized="false"
  15789. static="true" final="false" visibility="public"
  15790. deprecated="not deprecated">
  15791. <param name="args" type="java.lang.String[]"/>
  15792. <exception name="Exception" type="java.lang.Exception"/>
  15793. </method>
  15794. <doc>
  15795. <![CDATA[This class provides rudimentary checking of DFS volumes for errors and
  15796. sub-optimal conditions.
  15797. <p>The tool scans all files and directories, starting from an indicated
  15798. root path. The following abnormal conditions are detected and handled:</p>
  15799. <ul>
  15800. <li>files with blocks that are completely missing from all datanodes.<br/>
  15801. In this case the tool can perform one of the following actions:
  15802. <ul>
  15803. <li>none ({@link org.apache.hadoop.hdfs.server.namenode.NamenodeFsck#FIXING_NONE})</li>
  15804. <li>move corrupted files to /lost+found directory on DFS
  15805. ({@link org.apache.hadoop.hdfs.server.namenode.NamenodeFsck#FIXING_MOVE}). Remaining data blocks are saved as a
  15806. block chains, representing longest consecutive series of valid blocks.</li>
  15807. <li>delete corrupted files ({@link org.apache.hadoop.hdfs.server.namenode.NamenodeFsck#FIXING_DELETE})</li>
  15808. </ul>
  15809. </li>
  15810. <li>detect files with under-replicated or over-replicated blocks</li>
  15811. </ul>
  15812. Additionally, the tool collects a detailed overall DFS statistics, and
  15813. optionally can print detailed statistics on block locations and replication
  15814. factors of each file.
  15815. The tool also provides and option to filter open files during the scan.]]>
  15816. </doc>
  15817. </class>
  15818. <!-- end class org.apache.hadoop.hdfs.tools.DFSck -->
  15819. <!-- start class org.apache.hadoop.hdfs.tools.HDFSConcat -->
  15820. <class name="HDFSConcat" extends="java.lang.Object"
  15821. abstract="false"
  15822. static="false" final="false" visibility="public"
  15823. deprecated="not deprecated">
  15824. <constructor name="HDFSConcat"
  15825. static="false" final="false" visibility="public"
  15826. deprecated="not deprecated">
  15827. </constructor>
  15828. <method name="main"
  15829. abstract="false" native="false" synchronized="false"
  15830. static="true" final="false" visibility="public"
  15831. deprecated="not deprecated">
  15832. <param name="args" type="java.lang.String[]"/>
  15833. <exception name="IOException" type="java.io.IOException"/>
  15834. <doc>
  15835. <![CDATA[@param args]]>
  15836. </doc>
  15837. </method>
  15838. </class>
  15839. <!-- end class org.apache.hadoop.hdfs.tools.HDFSConcat -->
  15840. <!-- start class org.apache.hadoop.hdfs.tools.JMXGet -->
  15841. <class name="JMXGet" extends="java.lang.Object"
  15842. abstract="false"
  15843. static="false" final="false" visibility="public"
  15844. deprecated="not deprecated">
  15845. <constructor name="JMXGet"
  15846. static="false" final="false" visibility="public"
  15847. deprecated="not deprecated">
  15848. </constructor>
  15849. <method name="setService"
  15850. abstract="false" native="false" synchronized="false"
  15851. static="false" final="false" visibility="public"
  15852. deprecated="not deprecated">
  15853. <param name="service" type="java.lang.String"/>
  15854. </method>
  15855. <method name="setPort"
  15856. abstract="false" native="false" synchronized="false"
  15857. static="false" final="false" visibility="public"
  15858. deprecated="not deprecated">
  15859. <param name="port" type="java.lang.String"/>
  15860. </method>
  15861. <method name="setServer"
  15862. abstract="false" native="false" synchronized="false"
  15863. static="false" final="false" visibility="public"
  15864. deprecated="not deprecated">
  15865. <param name="server" type="java.lang.String"/>
  15866. </method>
  15867. <method name="setLocalVMUrl"
  15868. abstract="false" native="false" synchronized="false"
  15869. static="false" final="false" visibility="public"
  15870. deprecated="not deprecated">
  15871. <param name="url" type="java.lang.String"/>
  15872. </method>
  15873. <method name="printAllValues"
  15874. abstract="false" native="false" synchronized="false"
  15875. static="false" final="false" visibility="public"
  15876. deprecated="not deprecated">
  15877. <exception name="Exception" type="java.lang.Exception"/>
  15878. <doc>
  15879. <![CDATA[print all attributes' values]]>
  15880. </doc>
  15881. </method>
  15882. <method name="getValue" return="java.lang.String"
  15883. abstract="false" native="false" synchronized="false"
  15884. static="false" final="false" visibility="public"
  15885. deprecated="not deprecated">
  15886. <param name="key" type="java.lang.String"/>
  15887. <exception name="Exception" type="java.lang.Exception"/>
  15888. <doc>
  15889. <![CDATA[get single value by key]]>
  15890. </doc>
  15891. </method>
  15892. <method name="init"
  15893. abstract="false" native="false" synchronized="false"
  15894. static="false" final="false" visibility="public"
  15895. deprecated="not deprecated">
  15896. <exception name="Exception" type="java.lang.Exception"/>
  15897. <doc>
  15898. <![CDATA[@throws Exception
  15899. initializes MBeanServer]]>
  15900. </doc>
  15901. </method>
  15902. <method name="main"
  15903. abstract="false" native="false" synchronized="false"
  15904. static="true" final="false" visibility="public"
  15905. deprecated="not deprecated">
  15906. <param name="args" type="java.lang.String[]"/>
  15907. <doc>
  15908. <![CDATA[main
  15909. @param args]]>
  15910. </doc>
  15911. </method>
  15912. <doc>
  15913. <![CDATA[tool to get data from NameNode or DataNode using MBeans currently the
  15914. following MBeans are available (under hadoop domain):
  15915. hadoop:service=NameNode,name=FSNamesystemState (static)
  15916. hadoop:service=NameNode,name=NameNodeActivity (dynamic)
  15917. hadoop:service=NameNode,name=RpcActivityForPort9000 (dynamic)
  15918. hadoop:service=DataNode,name=RpcActivityForPort50020 (dynamic)
  15919. hadoop:name=service=DataNode,FSDatasetState-UndefinedStorageId663800459
  15920. (static)
  15921. hadoop:service=DataNode,name=DataNodeActivity-UndefinedStorageId-520845215
  15922. (dynamic)
  15923. implementation note: all logging is sent to System.err (since it is a command
  15924. line tool)]]>
  15925. </doc>
  15926. </class>
  15927. <!-- end class org.apache.hadoop.hdfs.tools.JMXGet -->
  15928. </package>
  15929. <package name="org.apache.hadoop.hdfs.tools.offlineImageViewer">
  15930. <!-- start class org.apache.hadoop.hdfs.tools.offlineImageViewer.OfflineImageViewer -->
  15931. <class name="OfflineImageViewer" extends="java.lang.Object"
  15932. abstract="false"
  15933. static="false" final="false" visibility="public"
  15934. deprecated="not deprecated">
  15935. <constructor name="OfflineImageViewer" type="java.lang.String, org.apache.hadoop.hdfs.tools.offlineImageViewer.ImageVisitor, boolean"
  15936. static="false" final="false" visibility="public"
  15937. deprecated="not deprecated">
  15938. </constructor>
  15939. <method name="go"
  15940. abstract="false" native="false" synchronized="false"
  15941. static="false" final="false" visibility="public"
  15942. deprecated="not deprecated">
  15943. <exception name="IOException" type="java.io.IOException"/>
  15944. <doc>
  15945. <![CDATA[Process image file.]]>
  15946. </doc>
  15947. </method>
  15948. <method name="buildOptions" return="org.apache.commons.cli.Options"
  15949. abstract="false" native="false" synchronized="false"
  15950. static="true" final="false" visibility="public"
  15951. deprecated="not deprecated">
  15952. <doc>
  15953. <![CDATA[Build command-line options and descriptions]]>
  15954. </doc>
  15955. </method>
  15956. <method name="main"
  15957. abstract="false" native="false" synchronized="false"
  15958. static="true" final="false" visibility="public"
  15959. deprecated="not deprecated">
  15960. <param name="args" type="java.lang.String[]"/>
  15961. <exception name="IOException" type="java.io.IOException"/>
  15962. <doc>
  15963. <![CDATA[Entry point to command-line-driven operation. User may specify
  15964. options and start fsimage viewer from the command line. Program
  15965. will process image file and exit cleanly or, if an error is
  15966. encountered, inform user and exit.
  15967. @param args Command line options
  15968. @throws IOException]]>
  15969. </doc>
  15970. </method>
  15971. <doc>
  15972. <![CDATA[OfflineImageViewer to dump the contents of an Hadoop image file to XML
  15973. or the console. Main entry point into utility, either via the
  15974. command line or programatically.]]>
  15975. </doc>
  15976. </class>
  15977. <!-- end class org.apache.hadoop.hdfs.tools.offlineImageViewer.OfflineImageViewer -->
  15978. </package>
  15979. </api>