autodoc.xml 438 KB

1234567891011121314151617181920212223242526272829303132333435363738394041424344454647484950515253545556575859606162636465666768697071727374757677787980818283848586878889909192939495969798991001011021031041051061071081091101111121131141151161171181191201211221231241251261271281291301311321331341351361371381391401411421431441451461471481491501511521531541551561571581591601611621631641651661671681691701711721731741751761771781791801811821831841851861871881891901911921931941951961971981992002012022032042052062072082092102112122132142152162172182192202212222232242252262272282292302312322332342352362372382392402412422432442452462472482492502512522532542552562572582592602612622632642652662672682692702712722732742752762772782792802812822832842852862872882892902912922932942952962972982993003013023033043053063073083093103113123133143153163173183193203213223233243253263273283293303313323333343353363373383393403413423433443453463473483493503513523533543553563573583593603613623633643653663673683693703713723733743753763773783793803813823833843853863873883893903913923933943953963973983994004014024034044054064074084094104114124134144154164174184194204214224234244254264274284294304314324334344354364374384394404414424434444454464474484494504514524534544554564574584594604614624634644654664674684694704714724734744754764774784794804814824834844854864874884894904914924934944954964974984995005015025035045055065075085095105115125135145155165175185195205215225235245255265275285295305315325335345355365375385395405415425435445455465475485495505515525535545555565575585595605615625635645655665675685695705715725735745755765775785795805815825835845855865875885895905915925935945955965975985996006016026036046056066076086096106116126136146156166176186196206216226236246256266276286296306316326336346356366376386396406416426436446456466476486496506516526536546556566576586596606616626636646656666676686696706716726736746756766776786796806816826836846856866876886896906916926936946956966976986997007017027037047057067077087097107117127137147157167177187197207217227237247257267277287297307317327337347357367377387397407417427437447457467477487497507517527537547557567577587597607617627637647657667677687697707717727737747757767777787797807817827837847857867877887897907917927937947957967977987998008018028038048058068078088098108118128138148158168178188198208218228238248258268278288298308318328338348358368378388398408418428438448458468478488498508518528538548558568578588598608618628638648658668678688698708718728738748758768778788798808818828838848858868878888898908918928938948958968978988999009019029039049059069079089099109119129139149159169179189199209219229239249259269279289299309319329339349359369379389399409419429439449459469479489499509519529539549559569579589599609619629639649659669679689699709719729739749759769779789799809819829839849859869879889899909919929939949959969979989991000100110021003100410051006100710081009101010111012101310141015101610171018101910201021102210231024102510261027102810291030103110321033103410351036103710381039104010411042104310441045104610471048104910501051105210531054105510561057105810591060106110621063106410651066106710681069107010711072107310741075107610771078107910801081108210831084108510861087108810891090109110921093109410951096109710981099110011011102110311041105110611071108110911101111111211131114111511161117111811191120112111221123112411251126112711281129113011311132113311341135113611371138113911401141114211431144114511461147114811491150115111521153115411551156115711581159116011611162116311641165116611671168116911701171117211731174117511761177117811791180118111821183118411851186118711881189119011911192119311941195119611971198119912001201120212031204120512061207120812091210121112121213121412151216121712181219122012211222122312241225122612271228122912301231123212331234123512361237123812391240124112421243124412451246124712481249125012511252125312541255125612571258125912601261126212631264126512661267126812691270127112721273127412751276127712781279128012811282128312841285128612871288128912901291129212931294129512961297129812991300130113021303130413051306130713081309131013111312131313141315131613171318131913201321132213231324132513261327132813291330133113321333133413351336133713381339134013411342134313441345134613471348134913501351135213531354135513561357135813591360136113621363136413651366136713681369137013711372137313741375137613771378137913801381138213831384138513861387138813891390139113921393139413951396139713981399140014011402140314041405140614071408140914101411141214131414141514161417141814191420142114221423142414251426142714281429143014311432143314341435143614371438143914401441144214431444144514461447144814491450145114521453145414551456145714581459146014611462146314641465146614671468146914701471147214731474147514761477147814791480148114821483148414851486148714881489149014911492149314941495149614971498149915001501150215031504150515061507150815091510151115121513151415151516151715181519152015211522152315241525152615271528152915301531153215331534153515361537153815391540154115421543154415451546154715481549155015511552155315541555155615571558155915601561156215631564156515661567156815691570157115721573157415751576157715781579158015811582158315841585158615871588158915901591159215931594159515961597159815991600160116021603160416051606160716081609161016111612161316141615161616171618161916201621162216231624162516261627162816291630163116321633163416351636163716381639164016411642164316441645164616471648164916501651165216531654165516561657165816591660166116621663166416651666166716681669167016711672167316741675167616771678167916801681168216831684168516861687168816891690169116921693169416951696169716981699170017011702170317041705170617071708170917101711171217131714171517161717171817191720172117221723172417251726172717281729173017311732173317341735173617371738173917401741174217431744174517461747174817491750175117521753175417551756175717581759176017611762176317641765176617671768176917701771177217731774177517761777177817791780178117821783178417851786178717881789179017911792179317941795179617971798179918001801180218031804180518061807180818091810181118121813181418151816181718181819182018211822182318241825182618271828182918301831183218331834183518361837183818391840184118421843184418451846184718481849185018511852185318541855185618571858185918601861186218631864186518661867186818691870187118721873187418751876187718781879188018811882188318841885188618871888188918901891189218931894189518961897189818991900190119021903190419051906190719081909191019111912191319141915191619171918191919201921192219231924192519261927192819291930193119321933193419351936193719381939194019411942194319441945194619471948194919501951195219531954195519561957195819591960196119621963196419651966196719681969197019711972197319741975197619771978197919801981198219831984198519861987198819891990199119921993199419951996199719981999200020012002200320042005200620072008200920102011201220132014201520162017201820192020202120222023202420252026202720282029203020312032203320342035203620372038203920402041204220432044204520462047204820492050205120522053205420552056205720582059206020612062206320642065206620672068206920702071207220732074207520762077207820792080208120822083208420852086208720882089209020912092209320942095209620972098209921002101210221032104210521062107210821092110211121122113211421152116211721182119212021212122212321242125212621272128212921302131213221332134213521362137213821392140214121422143214421452146214721482149215021512152215321542155215621572158215921602161216221632164216521662167216821692170217121722173217421752176217721782179218021812182218321842185218621872188218921902191219221932194219521962197219821992200220122022203220422052206220722082209221022112212221322142215221622172218221922202221222222232224222522262227222822292230223122322233223422352236223722382239224022412242224322442245224622472248224922502251225222532254225522562257225822592260226122622263226422652266226722682269227022712272227322742275227622772278227922802281228222832284228522862287228822892290229122922293229422952296229722982299230023012302230323042305230623072308230923102311231223132314231523162317231823192320232123222323232423252326232723282329233023312332233323342335233623372338233923402341234223432344234523462347234823492350235123522353235423552356235723582359236023612362236323642365236623672368236923702371237223732374237523762377237823792380238123822383238423852386238723882389239023912392239323942395239623972398239924002401240224032404240524062407240824092410241124122413241424152416241724182419242024212422242324242425242624272428242924302431243224332434243524362437243824392440244124422443244424452446244724482449245024512452245324542455245624572458245924602461246224632464246524662467246824692470247124722473247424752476247724782479248024812482248324842485248624872488248924902491249224932494249524962497249824992500250125022503250425052506250725082509251025112512251325142515251625172518251925202521252225232524252525262527252825292530253125322533253425352536253725382539254025412542254325442545254625472548254925502551255225532554255525562557255825592560256125622563256425652566256725682569257025712572257325742575257625772578257925802581258225832584258525862587258825892590259125922593259425952596259725982599260026012602260326042605260626072608260926102611261226132614261526162617261826192620262126222623262426252626262726282629263026312632263326342635263626372638263926402641264226432644264526462647264826492650265126522653265426552656265726582659266026612662266326642665266626672668266926702671267226732674267526762677267826792680268126822683268426852686268726882689269026912692269326942695269626972698269927002701270227032704270527062707270827092710271127122713271427152716271727182719272027212722272327242725272627272728272927302731273227332734273527362737273827392740274127422743274427452746274727482749275027512752275327542755275627572758275927602761276227632764276527662767276827692770277127722773277427752776277727782779278027812782278327842785278627872788278927902791279227932794279527962797279827992800280128022803280428052806280728082809281028112812281328142815281628172818281928202821282228232824282528262827282828292830283128322833283428352836283728382839284028412842284328442845284628472848284928502851285228532854285528562857285828592860286128622863286428652866286728682869287028712872287328742875287628772878287928802881288228832884288528862887288828892890289128922893289428952896289728982899290029012902290329042905290629072908290929102911291229132914291529162917291829192920292129222923292429252926292729282929293029312932293329342935293629372938293929402941294229432944294529462947294829492950295129522953295429552956295729582959296029612962296329642965296629672968296929702971297229732974297529762977297829792980298129822983298429852986298729882989299029912992299329942995299629972998299930003001300230033004300530063007300830093010301130123013301430153016301730183019302030213022302330243025302630273028302930303031303230333034303530363037303830393040304130423043304430453046304730483049305030513052305330543055305630573058305930603061306230633064306530663067306830693070307130723073307430753076307730783079308030813082308330843085308630873088308930903091309230933094309530963097309830993100310131023103310431053106310731083109311031113112311331143115311631173118311931203121312231233124312531263127312831293130313131323133313431353136313731383139314031413142314331443145314631473148314931503151315231533154315531563157315831593160316131623163316431653166316731683169317031713172317331743175317631773178317931803181318231833184318531863187318831893190319131923193319431953196319731983199320032013202320332043205320632073208320932103211321232133214321532163217321832193220322132223223322432253226322732283229323032313232323332343235323632373238323932403241324232433244324532463247324832493250325132523253325432553256325732583259326032613262326332643265326632673268326932703271327232733274327532763277327832793280328132823283328432853286328732883289329032913292329332943295329632973298329933003301330233033304330533063307330833093310331133123313331433153316331733183319332033213322332333243325332633273328332933303331333233333334333533363337333833393340334133423343334433453346334733483349335033513352335333543355335633573358335933603361336233633364336533663367336833693370337133723373337433753376337733783379338033813382338333843385338633873388338933903391339233933394339533963397339833993400340134023403340434053406340734083409341034113412341334143415341634173418341934203421342234233424342534263427342834293430343134323433343434353436343734383439344034413442344334443445344634473448344934503451345234533454345534563457345834593460346134623463346434653466346734683469347034713472347334743475347634773478347934803481348234833484348534863487348834893490349134923493349434953496349734983499350035013502350335043505350635073508350935103511351235133514351535163517351835193520352135223523352435253526352735283529353035313532353335343535353635373538353935403541354235433544354535463547354835493550355135523553355435553556355735583559356035613562356335643565356635673568356935703571357235733574357535763577357835793580358135823583358435853586358735883589359035913592359335943595359635973598359936003601360236033604360536063607360836093610361136123613361436153616361736183619362036213622362336243625362636273628362936303631363236333634363536363637363836393640364136423643364436453646364736483649365036513652365336543655365636573658365936603661366236633664366536663667366836693670367136723673367436753676367736783679368036813682368336843685368636873688368936903691369236933694369536963697369836993700370137023703370437053706370737083709371037113712371337143715371637173718371937203721372237233724372537263727372837293730373137323733373437353736373737383739374037413742374337443745374637473748374937503751375237533754375537563757375837593760376137623763376437653766376737683769377037713772377337743775377637773778377937803781378237833784378537863787378837893790379137923793379437953796379737983799380038013802380338043805380638073808380938103811381238133814381538163817381838193820382138223823382438253826382738283829383038313832383338343835383638373838383938403841384238433844384538463847384838493850385138523853385438553856385738583859386038613862386338643865386638673868386938703871387238733874387538763877387838793880388138823883388438853886388738883889389038913892389338943895389638973898389939003901390239033904390539063907390839093910391139123913391439153916391739183919392039213922392339243925392639273928392939303931393239333934393539363937393839393940394139423943394439453946394739483949395039513952395339543955395639573958395939603961396239633964396539663967396839693970397139723973397439753976397739783979398039813982398339843985398639873988398939903991399239933994399539963997399839994000400140024003400440054006400740084009401040114012401340144015401640174018401940204021402240234024402540264027402840294030403140324033403440354036403740384039404040414042404340444045404640474048404940504051405240534054405540564057405840594060406140624063406440654066406740684069407040714072407340744075407640774078407940804081408240834084408540864087408840894090409140924093409440954096409740984099410041014102410341044105410641074108410941104111411241134114411541164117411841194120412141224123412441254126412741284129413041314132413341344135413641374138413941404141414241434144414541464147414841494150415141524153415441554156415741584159416041614162416341644165416641674168416941704171417241734174417541764177417841794180418141824183418441854186418741884189419041914192419341944195419641974198419942004201420242034204420542064207420842094210421142124213421442154216421742184219422042214222422342244225422642274228422942304231423242334234423542364237423842394240424142424243424442454246424742484249425042514252425342544255425642574258425942604261426242634264426542664267426842694270427142724273427442754276427742784279428042814282428342844285428642874288428942904291429242934294429542964297429842994300430143024303430443054306430743084309431043114312431343144315431643174318431943204321432243234324432543264327432843294330433143324333433443354336433743384339434043414342434343444345434643474348434943504351435243534354435543564357435843594360436143624363436443654366436743684369437043714372437343744375437643774378437943804381438243834384438543864387438843894390439143924393439443954396439743984399440044014402440344044405440644074408440944104411441244134414441544164417441844194420442144224423442444254426442744284429443044314432443344344435443644374438443944404441444244434444444544464447444844494450445144524453445444554456445744584459446044614462446344644465446644674468446944704471447244734474447544764477447844794480448144824483448444854486448744884489449044914492449344944495449644974498449945004501450245034504450545064507450845094510451145124513451445154516451745184519452045214522452345244525452645274528452945304531453245334534453545364537453845394540454145424543454445454546454745484549455045514552455345544555455645574558455945604561456245634564456545664567456845694570457145724573457445754576457745784579458045814582458345844585458645874588458945904591459245934594459545964597459845994600460146024603460446054606460746084609461046114612461346144615461646174618461946204621462246234624462546264627462846294630463146324633463446354636463746384639464046414642464346444645464646474648464946504651465246534654465546564657465846594660466146624663466446654666466746684669467046714672467346744675467646774678467946804681468246834684468546864687468846894690469146924693469446954696469746984699470047014702470347044705470647074708470947104711471247134714471547164717471847194720472147224723472447254726472747284729473047314732473347344735473647374738473947404741474247434744474547464747474847494750475147524753475447554756475747584759476047614762476347644765476647674768476947704771477247734774477547764777477847794780478147824783478447854786478747884789479047914792479347944795479647974798479948004801480248034804480548064807480848094810481148124813481448154816481748184819482048214822482348244825482648274828482948304831483248334834483548364837483848394840484148424843484448454846484748484849485048514852485348544855485648574858485948604861486248634864486548664867486848694870487148724873487448754876487748784879488048814882488348844885488648874888488948904891489248934894489548964897489848994900490149024903490449054906490749084909491049114912491349144915491649174918491949204921492249234924492549264927492849294930493149324933493449354936493749384939494049414942494349444945494649474948494949504951495249534954495549564957495849594960496149624963496449654966496749684969497049714972497349744975497649774978497949804981498249834984498549864987498849894990499149924993499449954996499749984999500050015002500350045005500650075008500950105011501250135014501550165017501850195020502150225023502450255026502750285029503050315032503350345035503650375038503950405041504250435044504550465047504850495050505150525053505450555056505750585059506050615062506350645065506650675068506950705071507250735074507550765077507850795080508150825083508450855086508750885089509050915092509350945095509650975098509951005101510251035104510551065107510851095110511151125113511451155116511751185119512051215122512351245125512651275128512951305131513251335134513551365137513851395140514151425143514451455146514751485149515051515152515351545155515651575158515951605161516251635164516551665167516851695170517151725173517451755176517751785179518051815182518351845185518651875188518951905191519251935194519551965197519851995200520152025203520452055206520752085209521052115212521352145215521652175218521952205221522252235224522552265227522852295230523152325233523452355236523752385239524052415242524352445245524652475248524952505251525252535254525552565257525852595260526152625263526452655266526752685269527052715272527352745275527652775278527952805281528252835284528552865287528852895290529152925293529452955296529752985299530053015302530353045305530653075308530953105311531253135314531553165317531853195320532153225323532453255326532753285329533053315332533353345335533653375338533953405341534253435344534553465347534853495350535153525353535453555356535753585359536053615362536353645365536653675368536953705371537253735374537553765377537853795380538153825383538453855386538753885389539053915392539353945395539653975398539954005401540254035404540554065407540854095410541154125413541454155416541754185419542054215422542354245425542654275428542954305431543254335434543554365437543854395440544154425443544454455446544754485449545054515452545354545455545654575458545954605461546254635464546554665467546854695470547154725473547454755476547754785479548054815482548354845485548654875488548954905491549254935494549554965497549854995500550155025503550455055506550755085509551055115512551355145515551655175518551955205521552255235524552555265527552855295530553155325533553455355536553755385539554055415542554355445545554655475548554955505551555255535554555555565557555855595560556155625563556455655566556755685569557055715572557355745575557655775578557955805581558255835584558555865587558855895590559155925593559455955596559755985599560056015602560356045605560656075608560956105611561256135614561556165617561856195620562156225623562456255626562756285629563056315632563356345635563656375638563956405641564256435644564556465647564856495650565156525653565456555656565756585659566056615662566356645665566656675668566956705671567256735674567556765677567856795680568156825683568456855686568756885689569056915692569356945695569656975698569957005701570257035704570557065707570857095710571157125713571457155716571757185719572057215722572357245725572657275728572957305731573257335734573557365737573857395740574157425743574457455746574757485749575057515752575357545755575657575758575957605761576257635764576557665767576857695770577157725773577457755776577757785779578057815782578357845785578657875788578957905791579257935794579557965797579857995800580158025803580458055806580758085809581058115812581358145815581658175818581958205821582258235824582558265827582858295830583158325833583458355836583758385839584058415842584358445845584658475848584958505851585258535854585558565857585858595860586158625863586458655866586758685869587058715872587358745875587658775878587958805881588258835884588558865887588858895890589158925893589458955896589758985899590059015902590359045905590659075908590959105911591259135914591559165917591859195920592159225923592459255926592759285929593059315932593359345935593659375938593959405941594259435944594559465947594859495950595159525953595459555956595759585959596059615962596359645965596659675968596959705971597259735974597559765977597859795980598159825983598459855986598759885989599059915992599359945995599659975998599960006001600260036004600560066007600860096010601160126013601460156016601760186019602060216022602360246025602660276028602960306031603260336034603560366037603860396040604160426043604460456046604760486049605060516052605360546055605660576058605960606061606260636064606560666067606860696070607160726073607460756076607760786079608060816082608360846085608660876088608960906091609260936094609560966097609860996100610161026103610461056106610761086109611061116112611361146115611661176118611961206121612261236124612561266127612861296130613161326133613461356136613761386139614061416142614361446145614661476148614961506151615261536154615561566157615861596160616161626163616461656166616761686169617061716172617361746175617661776178617961806181618261836184618561866187618861896190619161926193619461956196619761986199
  1. <?xml version="1.0" standalone="yes"?>
  2. <library-reference id="boost_interprocess_header_reference"><title>Boost.Interprocess Header Reference</title><header name="boost/interprocess/allocators/adaptive_pool.hpp">
  3. <para>Describes adaptive_pool pooled shared memory STL compatible allocator </para><namespace name="boost">
  4. <namespace name="interprocess">
  5. <class name="adaptive_pool"><template>
  6. <template-type-parameter name="T"/>
  7. <template-type-parameter name="SegmentManager"/>
  8. <template-nontype-parameter name="NodesPerBlock"><type>std::size_t</type></template-nontype-parameter>
  9. <template-nontype-parameter name="MaxFreeBlocks"><type>std::size_t</type></template-nontype-parameter>
  10. <template-nontype-parameter name="OverheadPercent"><type>unsigned char</type></template-nontype-parameter>
  11. </template><description><para>An STL node allocator that uses a segment manager as memory source. The internal pointer type will of the same type (raw, smart) as "typename SegmentManager::void_pointer" type. This allows placing the allocator in shared memory, memory mapped-files, etc...</para><para>This node allocator shares a segregated storage between all instances of <classname alt="boost::interprocess::adaptive_pool">adaptive_pool</classname> with equal sizeof(T) placed in the same segment group. NodesPerBlock is the number of nodes allocated at once when the allocator needs runs out of nodes. MaxFreeBlocks is the maximum number of totally free blocks that the adaptive node pool will hold. The rest of the totally free blocks will be deallocated with the segment manager.</para><para>OverheadPercent is the (approximated) maximum size overhead (1-20%) of the allocator: (memory usable for nodes / total memory allocated from the segment manager) </para></description><struct name="rebind"><template>
  12. <template-type-parameter name="T2"/>
  13. </template><description><para>Obtains <classname alt="boost::interprocess::adaptive_pool">adaptive_pool</classname> from <classname alt="boost::interprocess::adaptive_pool">adaptive_pool</classname> </para></description><typedef name="other"><type><classname>adaptive_pool</classname>&lt; T2, SegmentManager, NodesPerBlock, MaxFreeBlocks, OverheadPercent &gt;</type></typedef>
  14. </struct><typedef name="segment_manager"><type>implementation_defined::segment_manager</type></typedef>
  15. <typedef name="void_pointer"><type>segment_manager::void_pointer</type></typedef>
  16. <typedef name="pointer"><type>implementation_defined::pointer</type></typedef>
  17. <typedef name="const_pointer"><type>implementation_defined::const_pointer</type></typedef>
  18. <typedef name="value_type"><type>T</type></typedef>
  19. <typedef name="reference"><type><emphasis>unspecified</emphasis></type></typedef>
  20. <typedef name="const_reference"><type><emphasis>unspecified</emphasis></type></typedef>
  21. <typedef name="size_type"><type>segment_manager::size_type</type></typedef>
  22. <typedef name="difference_type"><type>segment_manager::difference_type</type></typedef>
  23. <method-group name="private member functions">
  24. </method-group>
  25. <copy-assignment><type><classname>adaptive_pool</classname> &amp;</type><template>
  26. <template-type-parameter name="T2"/>
  27. <template-type-parameter name="SegmentManager2"/>
  28. <template-nontype-parameter name="N2"><type>std::size_t</type></template-nontype-parameter>
  29. <template-nontype-parameter name="F2"><type>std::size_t</type></template-nontype-parameter>
  30. <template-nontype-parameter name="OP2"><type>unsigned char</type></template-nontype-parameter>
  31. </template><parameter name=""><paramtype>const <classname>adaptive_pool</classname>&lt; T2, SegmentManager2, N2, F2, OP2 &gt; &amp;</paramtype></parameter><description><para>Not assignable from related <classname alt="boost::interprocess::adaptive_pool">adaptive_pool</classname> </para></description></copy-assignment>
  32. <method-group name="public member functions">
  33. <method name="get_node_pool" cv="const"><type>void *</type><description><para>Returns a pointer to the node pool. Never throws </para></description></method>
  34. <method name="get_segment_manager" cv="const"><type>segment_manager *</type><description><para>Returns the segment manager. Never throws </para></description></method>
  35. <method name="max_size" cv="const"><type>size_type</type><description><para>Returns the number of elements that could be allocated. Never throws </para></description></method>
  36. <method name="allocate"><type>pointer</type><parameter name="count"><paramtype>size_type</paramtype></parameter><parameter name="hint"><paramtype>cvoid_pointer</paramtype><default>0</default></parameter><description><para>Allocate memory for an array of count elements. Throws <classname alt="boost::interprocess::bad_alloc">boost::interprocess::bad_alloc</classname> if there is no enough memory </para></description></method>
  37. <method name="deallocate"><type>void</type><parameter name="ptr"><paramtype>const pointer &amp;</paramtype></parameter><parameter name="count"><paramtype>size_type</paramtype></parameter><description><para>Deallocate allocated memory. Never throws </para></description></method>
  38. <method name="deallocate_free_blocks"><type>void</type><description><para>Deallocates all free blocks of the pool </para></description></method>
  39. <method name="address" cv="const"><type>pointer</type><parameter name="value"><paramtype>reference</paramtype></parameter><description><para>Returns address of mutable object. Never throws </para></description></method>
  40. <method name="address" cv="const"><type>const_pointer</type><parameter name="value"><paramtype>const_reference</paramtype></parameter><description><para>Returns address of non mutable object. Never throws </para></description></method>
  41. <method name="size" cv="const"><type>size_type</type><parameter name="p"><paramtype>const pointer &amp;</paramtype></parameter><description><para>Returns maximum the number of objects the previously allocated memory pointed by p can hold. This size only works for memory allocated with allocate, allocation_command and allocate_many. </para></description></method>
  42. <method name="allocation_command"><type>pointer</type><parameter name="command"><paramtype>boost::interprocess::allocation_type</paramtype></parameter><parameter name="limit_size"><paramtype>size_type</paramtype></parameter><parameter name="prefer_in_recvd_out_size"><paramtype>size_type &amp;</paramtype></parameter><parameter name="reuse"><paramtype>pointer &amp;</paramtype></parameter></method>
  43. <method name="allocate_many"><type>void</type><parameter name="elem_size"><paramtype>size_type</paramtype></parameter><parameter name="num_elements"><paramtype>size_type</paramtype></parameter><parameter name="chain"><paramtype>multiallocation_chain &amp;</paramtype></parameter><description><para>Allocates many elements of size elem_size in a contiguous block of memory. The minimum number to be allocated is min_elements, the preferred and maximum number is preferred_elements. The number of actually allocated elements is will be assigned to received_size. The elements must be deallocated with deallocate(...) </para></description></method>
  44. <method name="allocate_many"><type>void</type><parameter name="elem_sizes"><paramtype>const size_type *</paramtype></parameter><parameter name="n_elements"><paramtype>size_type</paramtype></parameter><parameter name="chain"><paramtype>multiallocation_chain &amp;</paramtype></parameter><description><para>Allocates n_elements elements, each one of size elem_sizes[i]in a contiguous block of memory. The elements must be deallocated </para></description></method>
  45. <method name="deallocate_many"><type>void</type><parameter name="chain"><paramtype>multiallocation_chain &amp;</paramtype></parameter><description><para>Allocates many elements of size elem_size in a contiguous block of memory. The minimum number to be allocated is min_elements, the preferred and maximum number is preferred_elements. The number of actually allocated elements is will be assigned to received_size. The elements must be deallocated with deallocate(...) </para></description></method>
  46. <method name="allocate_one"><type>pointer</type><description><para>Allocates just one object. Memory allocated with this function must be deallocated only with deallocate_one(). Throws <classname alt="boost::interprocess::bad_alloc">boost::interprocess::bad_alloc</classname> if there is no enough memory </para></description></method>
  47. <method name="allocate_individual"><type>void</type><parameter name="num_elements"><paramtype>size_type</paramtype></parameter><parameter name="chain"><paramtype>multiallocation_chain &amp;</paramtype></parameter><description><para>Allocates many elements of size == 1 in a contiguous block of memory. The minimum number to be allocated is min_elements, the preferred and maximum number is preferred_elements. The number of actually allocated elements is will be assigned to received_size. Memory allocated with this function must be deallocated only with deallocate_one(). </para></description></method>
  48. <method name="deallocate_one"><type>void</type><parameter name="p"><paramtype>const pointer &amp;</paramtype></parameter><description><para>Deallocates memory previously allocated with allocate_one(). You should never use deallocate_one to deallocate memory allocated with other functions different from allocate_one(). Never throws </para></description></method>
  49. <method name="deallocate_individual"><type>void</type><parameter name="chain"><paramtype>multiallocation_chain &amp;</paramtype></parameter><description><para>Allocates many elements of size == 1 in a contiguous block of memory. The minimum number to be allocated is min_elements, the preferred and maximum number is preferred_elements. The number of actually allocated elements is will be assigned to received_size. Memory allocated with this function must be deallocated only with deallocate_one(). </para></description></method>
  50. </method-group>
  51. <constructor><parameter name="segment_mngr"><paramtype>segment_manager *</paramtype></parameter><description><para>Not assignable from other <classname alt="boost::interprocess::adaptive_pool">adaptive_pool</classname> Constructor from a segment manager. If not present, constructs a node pool. Increments the reference count of the associated node pool. Can throw <classname alt="boost::interprocess::bad_alloc">boost::interprocess::bad_alloc</classname> </para></description></constructor>
  52. <constructor><parameter name="other"><paramtype>const <classname>adaptive_pool</classname> &amp;</paramtype></parameter><description><para>Copy constructor from other <classname alt="boost::interprocess::adaptive_pool">adaptive_pool</classname>. Increments the reference count of the associated node pool. Never throws </para></description></constructor>
  53. <constructor><template>
  54. <template-type-parameter name="T2"/>
  55. </template><parameter name="other"><paramtype>const <classname>adaptive_pool</classname>&lt; T2, SegmentManager, NodesPerBlock, MaxFreeBlocks, OverheadPercent &gt; &amp;</paramtype></parameter><description><para>Copy constructor from related <classname alt="boost::interprocess::adaptive_pool">adaptive_pool</classname>. If not present, constructs a node pool. Increments the reference count of the associated node pool. Can throw <classname alt="boost::interprocess::bad_alloc">boost::interprocess::bad_alloc</classname> </para></description></constructor>
  56. <destructor><description><para>Destructor, removes node_pool_t from memory if its reference count reaches to zero. Never throws </para></description></destructor>
  57. <method-group name="friend functions">
  58. <method name="swap"><type>friend void</type><parameter name="alloc1"><paramtype>self_t &amp;</paramtype></parameter><parameter name="alloc2"><paramtype>self_t &amp;</paramtype></parameter><description><para>Swaps allocators. Does not throw. If each allocator is placed in a different memory segment, the result is undefined. </para></description></method>
  59. </method-group>
  60. </class>
  61. <function name="operator=="><type>bool</type><template>
  62. <template-type-parameter name="T"/>
  63. <template-type-parameter name="S"/>
  64. <template-nontype-parameter name="NodesPerBlock"><type>std::size_t</type></template-nontype-parameter>
  65. <template-nontype-parameter name="F"><type>std::size_t</type></template-nontype-parameter>
  66. <template-nontype-parameter name="OP"><type>unsigned char</type></template-nontype-parameter>
  67. </template><parameter name="alloc1"><paramtype>const <classname>adaptive_pool</classname>&lt; T, S, NodesPerBlock, F, OP &gt; &amp;</paramtype></parameter><parameter name="alloc2"><paramtype>const <classname>adaptive_pool</classname>&lt; T, S, NodesPerBlock, F, OP &gt; &amp;</paramtype></parameter><description><para>Equality test for same type of <classname alt="boost::interprocess::adaptive_pool">adaptive_pool</classname> </para></description></function>
  68. <function name="operator!="><type>bool</type><template>
  69. <template-type-parameter name="T"/>
  70. <template-type-parameter name="S"/>
  71. <template-nontype-parameter name="NodesPerBlock"><type>std::size_t</type></template-nontype-parameter>
  72. <template-nontype-parameter name="F"><type>std::size_t</type></template-nontype-parameter>
  73. <template-nontype-parameter name="OP"><type>unsigned char</type></template-nontype-parameter>
  74. </template><parameter name="alloc1"><paramtype>const <classname>adaptive_pool</classname>&lt; T, S, NodesPerBlock, F, OP &gt; &amp;</paramtype></parameter><parameter name="alloc2"><paramtype>const <classname>adaptive_pool</classname>&lt; T, S, NodesPerBlock, F, OP &gt; &amp;</paramtype></parameter><description><para>Inequality test for same type of <classname alt="boost::interprocess::adaptive_pool">adaptive_pool</classname> </para></description></function>
  75. </namespace>
  76. </namespace>
  77. </header>
  78. <header name="boost/interprocess/allocators/allocator.hpp">
  79. <para>Describes an allocator that allocates portions of fixed size memory buffer (shared memory, mapped file...) </para><namespace name="boost">
  80. <namespace name="interprocess">
  81. <class name="allocator"><template>
  82. <template-type-parameter name="T"/>
  83. <template-type-parameter name="SegmentManager"/>
  84. </template><description><para>An STL compatible allocator that uses a segment manager as memory source. The internal pointer type will of the same type (raw, smart) as "typename SegmentManager::void_pointer" type. This allows placing the allocator in shared memory, memory mapped-files, etc... </para></description><struct name="rebind"><template>
  85. <template-type-parameter name="T2"/>
  86. </template><description><para>Obtains an allocator that allocates objects of type T2 </para></description><typedef name="other"><type><classname>allocator</classname>&lt; T2, SegmentManager &gt;</type></typedef>
  87. </struct><typedef name="segment_manager"><type>SegmentManager</type></typedef>
  88. <typedef name="void_pointer"><type>SegmentManager::void_pointer</type></typedef>
  89. <typedef name="value_type"><type>T</type></typedef>
  90. <typedef name="pointer"><type>boost::intrusive::pointer_traits&lt; cvoid_ptr &gt;::template rebind_pointer&lt; T &gt;::type</type></typedef>
  91. <typedef name="const_pointer"><type>boost::intrusive::pointer_traits&lt; pointer &gt;::template rebind_pointer&lt; const T &gt;::type</type></typedef>
  92. <typedef name="reference"><type><emphasis>unspecified</emphasis></type></typedef>
  93. <typedef name="const_reference"><type><emphasis>unspecified</emphasis></type></typedef>
  94. <typedef name="size_type"><type>segment_manager::size_type</type></typedef>
  95. <typedef name="difference_type"><type>segment_manager::difference_type</type></typedef>
  96. <typedef name="version"><type>boost::interprocess::version_type&lt; <classname>allocator</classname>, 2 &gt;</type></typedef>
  97. <method-group name="public member functions">
  98. <method name="get_segment_manager" cv="const"><type>segment_manager *</type><description><para>Returns the segment manager. Never throws </para></description></method>
  99. <method name="allocate"><type>pointer</type><parameter name="count"><paramtype>size_type</paramtype></parameter><parameter name="hint"><paramtype>cvoid_ptr</paramtype><default>0</default></parameter><description><para>Allocates memory for an array of count elements. Throws <classname alt="boost::interprocess::bad_alloc">boost::interprocess::bad_alloc</classname> if there is no enough memory </para></description></method>
  100. <method name="deallocate"><type>void</type><parameter name="ptr"><paramtype>const pointer &amp;</paramtype></parameter><parameter name=""><paramtype>size_type</paramtype></parameter><description><para>Deallocates memory previously allocated. Never throws </para></description></method>
  101. <method name="max_size" cv="const"><type>size_type</type><description><para>Returns the number of elements that could be allocated. Never throws </para></description></method>
  102. <method name="size" cv="const"><type>size_type</type><parameter name="p"><paramtype>const pointer &amp;</paramtype></parameter><description><para>Returns maximum the number of objects the previously allocated memory pointed by p can hold. This size only works for memory allocated with allocate, allocation_command and allocate_many. </para></description></method>
  103. <method name="allocation_command"><type>pointer</type><parameter name="command"><paramtype>boost::interprocess::allocation_type</paramtype></parameter><parameter name="limit_size"><paramtype>size_type</paramtype></parameter><parameter name="prefer_in_recvd_out_size"><paramtype>size_type &amp;</paramtype></parameter><parameter name="reuse"><paramtype>pointer &amp;</paramtype></parameter></method>
  104. <method name="allocate_many"><type>void</type><parameter name="elem_size"><paramtype>size_type</paramtype></parameter><parameter name="num_elements"><paramtype>size_type</paramtype></parameter><parameter name="chain"><paramtype>multiallocation_chain &amp;</paramtype></parameter><description><para>Allocates many elements of size elem_size in a contiguous block of memory. The minimum number to be allocated is min_elements, the preferred and maximum number is preferred_elements. The number of actually allocated elements is will be assigned to received_size. The elements must be deallocated with deallocate(...) </para></description></method>
  105. <method name="allocate_many"><type>void</type><parameter name="elem_sizes"><paramtype>const size_type *</paramtype></parameter><parameter name="n_elements"><paramtype>size_type</paramtype></parameter><parameter name="chain"><paramtype>multiallocation_chain &amp;</paramtype></parameter><description><para>Allocates n_elements elements, each one of size elem_sizes[i]in a contiguous block of memory. The elements must be deallocated </para></description></method>
  106. <method name="deallocate_many"><type>void</type><parameter name="chain"><paramtype>multiallocation_chain &amp;</paramtype></parameter><description><para>Allocates many elements of size elem_size in a contiguous block of memory. The minimum number to be allocated is min_elements, the preferred and maximum number is preferred_elements. The number of actually allocated elements is will be assigned to received_size. The elements must be deallocated with deallocate(...) </para></description></method>
  107. <method name="allocate_one"><type>pointer</type><description><para>Allocates just one object. Memory allocated with this function must be deallocated only with deallocate_one(). Throws <classname alt="boost::interprocess::bad_alloc">boost::interprocess::bad_alloc</classname> if there is no enough memory </para></description></method>
  108. <method name="allocate_individual"><type>void</type><parameter name="num_elements"><paramtype>size_type</paramtype></parameter><parameter name="chain"><paramtype>multiallocation_chain &amp;</paramtype></parameter><description><para>Allocates many elements of size == 1 in a contiguous block of memory. The minimum number to be allocated is min_elements, the preferred and maximum number is preferred_elements. The number of actually allocated elements is will be assigned to received_size. Memory allocated with this function must be deallocated only with deallocate_one(). </para></description></method>
  109. <method name="deallocate_one"><type>void</type><parameter name="p"><paramtype>const pointer &amp;</paramtype></parameter><description><para>Deallocates memory previously allocated with allocate_one(). You should never use deallocate_one to deallocate memory allocated with other functions different from allocate_one(). Never throws </para></description></method>
  110. <method name="deallocate_individual"><type>void</type><parameter name="chain"><paramtype>multiallocation_chain &amp;</paramtype></parameter><description><para>Allocates many elements of size == 1 in a contiguous block of memory. The minimum number to be allocated is min_elements, the preferred and maximum number is preferred_elements. The number of actually allocated elements is will be assigned to received_size. Memory allocated with this function must be deallocated only with deallocate_one(). </para></description></method>
  111. <method name="address" cv="const"><type>pointer</type><parameter name="value"><paramtype>reference</paramtype></parameter><description><para>Returns address of mutable object. Never throws </para></description></method>
  112. <method name="address" cv="const"><type>const_pointer</type><parameter name="value"><paramtype>const_reference</paramtype></parameter><description><para>Returns address of non mutable object. Never throws </para></description></method>
  113. <method name="construct"><type>void</type><template>
  114. <template-type-parameter name="P"/>
  115. </template><parameter name="ptr"><paramtype>const pointer &amp;</paramtype></parameter><parameter name="p"><paramtype>P &amp;&amp;</paramtype></parameter><description><para>Constructs an object Throws if T's constructor throws For backwards compatibility with libraries using C++03 allocators </para></description></method>
  116. <method name="destroy"><type>void</type><parameter name="ptr"><paramtype>const pointer &amp;</paramtype></parameter><description><para>Destroys object. Throws if object's destructor throws </para></description></method>
  117. </method-group>
  118. <constructor><parameter name="segment_mngr"><paramtype>segment_manager *</paramtype></parameter><description><para>Constructor from the segment manager. Never throws </para></description></constructor>
  119. <constructor><parameter name="other"><paramtype>const <classname>allocator</classname> &amp;</paramtype></parameter><description><para>Constructor from other allocator. Never throws </para></description></constructor>
  120. <constructor><template>
  121. <template-type-parameter name="T2"/>
  122. </template><parameter name="other"><paramtype>const <classname>allocator</classname>&lt; T2, SegmentManager &gt; &amp;</paramtype></parameter><description><para>Constructor from related allocator. Never throws </para></description></constructor>
  123. <method-group name="friend functions">
  124. <method name="swap"><type>friend void</type><parameter name="alloc1"><paramtype>self_t &amp;</paramtype></parameter><parameter name="alloc2"><paramtype>self_t &amp;</paramtype></parameter><description><para>Swap segment manager. Does not throw. If each allocator is placed in different memory segments, the result is undefined. </para></description></method>
  125. </method-group>
  126. </class>
  127. <function name="operator=="><type>bool</type><template>
  128. <template-type-parameter name="T"/>
  129. <template-type-parameter name="SegmentManager"/>
  130. </template><parameter name="alloc1"><paramtype>const <classname>allocator</classname>&lt; T, SegmentManager &gt; &amp;</paramtype></parameter><parameter name="alloc2"><paramtype>const <classname>allocator</classname>&lt; T, SegmentManager &gt; &amp;</paramtype></parameter><description><para>Equality test for same type of allocator </para></description></function>
  131. <function name="operator!="><type>bool</type><template>
  132. <template-type-parameter name="T"/>
  133. <template-type-parameter name="SegmentManager"/>
  134. </template><parameter name="alloc1"><paramtype>const <classname>allocator</classname>&lt; T, SegmentManager &gt; &amp;</paramtype></parameter><parameter name="alloc2"><paramtype>const <classname>allocator</classname>&lt; T, SegmentManager &gt; &amp;</paramtype></parameter><description><para>Inequality test for same type of allocator </para></description></function>
  135. </namespace>
  136. </namespace>
  137. </header>
  138. <header name="boost/interprocess/allocators/cached_adaptive_pool.hpp">
  139. <para>Describes cached_adaptive_pool pooled shared memory STL compatible allocator </para><namespace name="boost">
  140. <namespace name="interprocess">
  141. <class name="cached_adaptive_pool"><template>
  142. <template-type-parameter name="T"/>
  143. <template-type-parameter name="SegmentManager"/>
  144. <template-nontype-parameter name="NodesPerBlock"><type>std::size_t</type></template-nontype-parameter>
  145. <template-nontype-parameter name="MaxFreeBlocks"><type>std::size_t</type></template-nontype-parameter>
  146. <template-nontype-parameter name="OverheadPercent"><type>unsigned char</type></template-nontype-parameter>
  147. </template><description><para>An STL node allocator that uses a segment manager as memory source. The internal pointer type will of the same type (raw, smart) as "typename SegmentManager::void_pointer" type. This allows placing the allocator in shared memory, memory mapped-files, etc...</para><para>This node allocator shares a segregated storage between all instances of <classname alt="boost::interprocess::cached_adaptive_pool">cached_adaptive_pool</classname> with equal sizeof(T) placed in the same memory segment. But also caches some nodes privately to avoid some synchronization overhead.</para><para>NodesPerBlock is the minimum number of nodes of nodes allocated at once when the allocator needs runs out of nodes. MaxFreeBlocks is the maximum number of totally free blocks that the adaptive node pool will hold. The rest of the totally free blocks will be deallocated with the segment manager.</para><para>OverheadPercent is the (approximated) maximum size overhead (1-20%) of the allocator: (memory usable for nodes / total memory allocated from the segment manager) </para></description><struct name="rebind"><template>
  148. <template-type-parameter name="T2"/>
  149. </template><description><para>Obtains <classname alt="boost::interprocess::cached_adaptive_pool">cached_adaptive_pool</classname> from <classname alt="boost::interprocess::cached_adaptive_pool">cached_adaptive_pool</classname> </para></description><typedef name="other"><type><classname>cached_adaptive_pool</classname>&lt; T2, SegmentManager, NodesPerBlock, MaxFreeBlocks, OverheadPercent &gt;</type></typedef>
  150. </struct><typedef name="segment_manager"><type>implementation_defined::segment_manager</type></typedef>
  151. <typedef name="void_pointer"><type>segment_manager::void_pointer</type></typedef>
  152. <typedef name="pointer"><type>implementation_defined::pointer</type></typedef>
  153. <typedef name="const_pointer"><type>implementation_defined::const_pointer</type></typedef>
  154. <typedef name="value_type"><type>T</type></typedef>
  155. <typedef name="reference"><type><emphasis>unspecified</emphasis></type></typedef>
  156. <typedef name="const_reference"><type><emphasis>unspecified</emphasis></type></typedef>
  157. <typedef name="size_type"><type>segment_manager::size_type</type></typedef>
  158. <typedef name="difference_type"><type>segment_manager::difference_type</type></typedef>
  159. <method-group name="private member functions">
  160. </method-group>
  161. <copy-assignment><type><classname>cached_adaptive_pool</classname> &amp;</type><template>
  162. <template-type-parameter name="T2"/>
  163. <template-type-parameter name="SegmentManager2"/>
  164. <template-nontype-parameter name="N2"><type>std::size_t</type></template-nontype-parameter>
  165. <template-nontype-parameter name="F2"><type>std::size_t</type></template-nontype-parameter>
  166. <template-nontype-parameter name="OP2"><type>unsigned char</type></template-nontype-parameter>
  167. </template><parameter name=""><paramtype>const <classname>cached_adaptive_pool</classname>&lt; T2, SegmentManager2, N2, F2, OP2 &gt; &amp;</paramtype></parameter><description><para>Not assignable from related <classname alt="boost::interprocess::cached_adaptive_pool">cached_adaptive_pool</classname> </para></description></copy-assignment>
  168. <copy-assignment><type><classname>cached_adaptive_pool</classname> &amp;</type><parameter name=""><paramtype>const <classname>cached_adaptive_pool</classname> &amp;</paramtype></parameter><description><para>Not assignable from other <classname alt="boost::interprocess::cached_adaptive_pool">cached_adaptive_pool</classname> </para></description></copy-assignment>
  169. <method-group name="public member functions">
  170. <method name="get_node_pool" cv="const"><type>node_pool_t *</type><description><para>Returns a pointer to the node pool. Never throws </para></description></method>
  171. <method name="get_segment_manager" cv="const"><type>segment_manager *</type><description><para>Returns the segment manager. Never throws </para></description></method>
  172. <method name="max_size" cv="const"><type>size_type</type><description><para>Returns the number of elements that could be allocated. Never throws </para></description></method>
  173. <method name="allocate"><type>pointer</type><parameter name="count"><paramtype>size_type</paramtype></parameter><parameter name="hint"><paramtype>cvoid_pointer</paramtype><default>0</default></parameter><description><para>Allocate memory for an array of count elements. Throws <classname alt="boost::interprocess::bad_alloc">boost::interprocess::bad_alloc</classname> if there is no enough memory </para></description></method>
  174. <method name="deallocate"><type>void</type><parameter name="ptr"><paramtype>const pointer &amp;</paramtype></parameter><parameter name="count"><paramtype>size_type</paramtype></parameter><description><para>Deallocate allocated memory. Never throws </para></description></method>
  175. <method name="deallocate_free_blocks"><type>void</type><description><para>Deallocates all free blocks of the pool </para></description></method>
  176. <method name="address" cv="const"><type>pointer</type><parameter name="value"><paramtype>reference</paramtype></parameter><description><para>Returns address of mutable object. Never throws </para></description></method>
  177. <method name="address" cv="const"><type>const_pointer</type><parameter name="value"><paramtype>const_reference</paramtype></parameter><description><para>Returns address of non mutable object. Never throws </para></description></method>
  178. <method name="construct"><type>void</type><parameter name="ptr"><paramtype>const pointer &amp;</paramtype></parameter><parameter name="v"><paramtype>const_reference</paramtype></parameter><description><para>Copy construct an object. Throws if T's copy constructor throws </para></description></method>
  179. <method name="destroy"><type>void</type><parameter name="ptr"><paramtype>const pointer &amp;</paramtype></parameter><description><para>Destroys object. Throws if object's destructor throws </para></description></method>
  180. <method name="size" cv="const"><type>size_type</type><parameter name="p"><paramtype>const pointer &amp;</paramtype></parameter><description><para>Returns maximum the number of objects the previously allocated memory pointed by p can hold. This size only works for memory allocated with allocate, allocation_command and allocate_many. </para></description></method>
  181. <method name="allocation_command"><type>pointer</type><parameter name="command"><paramtype>boost::interprocess::allocation_type</paramtype></parameter><parameter name="limit_size"><paramtype>size_type</paramtype></parameter><parameter name="prefer_in_recvd_out_size"><paramtype>size_type &amp;</paramtype></parameter><parameter name="reuse"><paramtype>pointer &amp;</paramtype></parameter></method>
  182. <method name="allocate_many"><type>void</type><parameter name="elem_size"><paramtype>size_type</paramtype></parameter><parameter name="num_elements"><paramtype>size_type</paramtype></parameter><parameter name="chain"><paramtype>multiallocation_chain &amp;</paramtype></parameter><description><para>Allocates many elements of size elem_size in a contiguous block of memory. The minimum number to be allocated is min_elements, the preferred and maximum number is preferred_elements. The number of actually allocated elements is will be assigned to received_size. The elements must be deallocated with deallocate(...) </para></description></method>
  183. <method name="allocate_many"><type>void</type><parameter name="elem_sizes"><paramtype>const size_type *</paramtype></parameter><parameter name="n_elements"><paramtype>size_type</paramtype></parameter><parameter name="chain"><paramtype>multiallocation_chain &amp;</paramtype></parameter><description><para>Allocates n_elements elements, each one of size elem_sizes[i]in a contiguous block of memory. The elements must be deallocated </para></description></method>
  184. <method name="deallocate_many"><type>void</type><parameter name="chain"><paramtype>multiallocation_chain &amp;</paramtype></parameter><description><para>Allocates many elements of size elem_size in a contiguous block of memory. The minimum number to be allocated is min_elements, the preferred and maximum number is preferred_elements. The number of actually allocated elements is will be assigned to received_size. The elements must be deallocated with deallocate(...) </para></description></method>
  185. <method name="allocate_one"><type>pointer</type><description><para>Allocates just one object. Memory allocated with this function must be deallocated only with deallocate_one(). Throws <classname alt="boost::interprocess::bad_alloc">boost::interprocess::bad_alloc</classname> if there is no enough memory </para></description></method>
  186. <method name="allocate_individual"><type>multiallocation_chain</type><parameter name="num_elements"><paramtype>size_type</paramtype></parameter><description><para>Allocates many elements of size == 1 in a contiguous block of memory. The minimum number to be allocated is min_elements, the preferred and maximum number is preferred_elements. The number of actually allocated elements is will be assigned to received_size. Memory allocated with this function must be deallocated only with deallocate_one(). </para></description></method>
  187. <method name="deallocate_one"><type>void</type><parameter name="p"><paramtype>const pointer &amp;</paramtype></parameter><description><para>Deallocates memory previously allocated with allocate_one(). You should never use deallocate_one to deallocate memory allocated with other functions different from allocate_one(). Never throws </para></description></method>
  188. <method name="deallocate_individual"><type>void</type><parameter name="chain"><paramtype>multiallocation_chain &amp;</paramtype></parameter><description><para>Allocates many elements of size == 1 in a contiguous block of memory. The minimum number to be allocated is min_elements, the preferred and maximum number is preferred_elements. The number of actually allocated elements is will be assigned to received_size. Memory allocated with this function must be deallocated only with deallocate_one(). </para></description></method>
  189. <method name="set_max_cached_nodes"><type>void</type><parameter name="newmax"><paramtype>size_type</paramtype></parameter><description><para>Sets the new max cached nodes value. This can provoke deallocations if "newmax" is less than current cached nodes. Never throws </para></description></method>
  190. <method name="get_max_cached_nodes" cv="const"><type>size_type</type><description><para>Returns the max cached nodes parameter. Never throws </para></description></method>
  191. </method-group>
  192. <constructor><parameter name="segment_mngr"><paramtype>segment_manager *</paramtype></parameter><description><para>Constructor from a segment manager. If not present, constructs a node pool. Increments the reference count of the associated node pool. Can throw <classname alt="boost::interprocess::bad_alloc">boost::interprocess::bad_alloc</classname> </para></description></constructor>
  193. <constructor><parameter name="other"><paramtype>const <classname>cached_adaptive_pool</classname> &amp;</paramtype></parameter><description><para>Copy constructor from other <classname alt="boost::interprocess::cached_adaptive_pool">cached_adaptive_pool</classname>. Increments the reference count of the associated node pool. Never throws </para></description></constructor>
  194. <constructor><template>
  195. <template-type-parameter name="T2"/>
  196. </template><parameter name="other"><paramtype>const <classname>cached_adaptive_pool</classname>&lt; T2, SegmentManager, NodesPerBlock, MaxFreeBlocks, OverheadPercent &gt; &amp;</paramtype></parameter><description><para>Copy constructor from related <classname alt="boost::interprocess::cached_adaptive_pool">cached_adaptive_pool</classname>. If not present, constructs a node pool. Increments the reference count of the associated node pool. Can throw <classname alt="boost::interprocess::bad_alloc">boost::interprocess::bad_alloc</classname> </para></description></constructor>
  197. <destructor><description><para>Destructor, removes node_pool_t from memory if its reference count reaches to zero. Never throws </para></description></destructor>
  198. <method-group name="friend functions">
  199. <method name="swap"><type>friend void</type><parameter name="alloc1"><paramtype>self_t &amp;</paramtype></parameter><parameter name="alloc2"><paramtype>self_t &amp;</paramtype></parameter><description><para>Swaps allocators. Does not throw. If each allocator is placed in a different memory segment, the result is undefined. </para></description></method>
  200. </method-group>
  201. </class>
  202. <function name="operator=="><type>bool</type><template>
  203. <template-type-parameter name="T"/>
  204. <template-type-parameter name="S"/>
  205. <template-nontype-parameter name="NodesPerBlock"><type>std::size_t</type></template-nontype-parameter>
  206. <template-nontype-parameter name="F"><type>std::size_t</type></template-nontype-parameter>
  207. <template-nontype-parameter name="OP"><type>std::size_t</type></template-nontype-parameter>
  208. </template><parameter name="alloc1"><paramtype>const <classname>cached_adaptive_pool</classname>&lt; T, S, NodesPerBlock, F, OP &gt; &amp;</paramtype></parameter><parameter name="alloc2"><paramtype>const <classname>cached_adaptive_pool</classname>&lt; T, S, NodesPerBlock, F, OP &gt; &amp;</paramtype></parameter><description><para>Equality test for same type of <classname alt="boost::interprocess::cached_adaptive_pool">cached_adaptive_pool</classname> </para></description></function>
  209. <function name="operator!="><type>bool</type><template>
  210. <template-type-parameter name="T"/>
  211. <template-type-parameter name="S"/>
  212. <template-nontype-parameter name="NodesPerBlock"><type>std::size_t</type></template-nontype-parameter>
  213. <template-nontype-parameter name="F"><type>std::size_t</type></template-nontype-parameter>
  214. <template-nontype-parameter name="OP"><type>std::size_t</type></template-nontype-parameter>
  215. </template><parameter name="alloc1"><paramtype>const <classname>cached_adaptive_pool</classname>&lt; T, S, NodesPerBlock, F, OP &gt; &amp;</paramtype></parameter><parameter name="alloc2"><paramtype>const <classname>cached_adaptive_pool</classname>&lt; T, S, NodesPerBlock, F, OP &gt; &amp;</paramtype></parameter><description><para>Inequality test for same type of <classname alt="boost::interprocess::cached_adaptive_pool">cached_adaptive_pool</classname> </para></description></function>
  216. </namespace>
  217. </namespace>
  218. </header>
  219. <header name="boost/interprocess/allocators/cached_node_allocator.hpp">
  220. <para>Describes cached_cached_node_allocator pooled shared memory STL compatible allocator </para><namespace name="boost">
  221. <namespace name="interprocess">
  222. <class name="cached_node_allocator"><template>
  223. <template-type-parameter name="T"/>
  224. <template-type-parameter name="SegmentManager"/>
  225. <template-nontype-parameter name="NodesPerBlock"><type>std::size_t</type></template-nontype-parameter>
  226. </template><struct name="rebind"><template>
  227. <template-type-parameter name="T2"/>
  228. </template><description><para>Obtains <classname alt="boost::interprocess::cached_node_allocator">cached_node_allocator</classname> from <classname alt="boost::interprocess::cached_node_allocator">cached_node_allocator</classname> </para></description><typedef name="other"><type><classname>cached_node_allocator</classname>&lt; T2, SegmentManager &gt;</type></typedef>
  229. </struct><typedef name="segment_manager"><type>implementation_defined::segment_manager</type></typedef>
  230. <typedef name="void_pointer"><type>segment_manager::void_pointer</type></typedef>
  231. <typedef name="pointer"><type>implementation_defined::pointer</type></typedef>
  232. <typedef name="const_pointer"><type>implementation_defined::const_pointer</type></typedef>
  233. <typedef name="value_type"><type>T</type></typedef>
  234. <typedef name="reference"><type><emphasis>unspecified</emphasis></type></typedef>
  235. <typedef name="const_reference"><type><emphasis>unspecified</emphasis></type></typedef>
  236. <typedef name="size_type"><type>SegmentManager::size_type</type></typedef>
  237. <typedef name="difference_type"><type>SegmentManager::difference_type</type></typedef>
  238. <method-group name="private member functions">
  239. </method-group>
  240. <copy-assignment><type><classname>cached_node_allocator</classname> &amp;</type><template>
  241. <template-type-parameter name="T2"/>
  242. <template-type-parameter name="SegmentManager2"/>
  243. <template-nontype-parameter name="N2"><type>std::size_t</type></template-nontype-parameter>
  244. </template><parameter name=""><paramtype>const <classname>cached_node_allocator</classname>&lt; T2, SegmentManager2, N2 &gt; &amp;</paramtype></parameter><description><para>Not assignable from related <classname alt="boost::interprocess::cached_node_allocator">cached_node_allocator</classname> </para></description></copy-assignment>
  245. <copy-assignment><type><classname>cached_node_allocator</classname> &amp;</type><parameter name=""><paramtype>const <classname>cached_node_allocator</classname> &amp;</paramtype></parameter><description><para>Not assignable from other <classname alt="boost::interprocess::cached_node_allocator">cached_node_allocator</classname> </para></description></copy-assignment>
  246. <method-group name="public member functions">
  247. <method name="get_node_pool" cv="const"><type>node_pool_t *</type><description><para>Returns a pointer to the node pool. Never throws </para></description></method>
  248. <method name="get_segment_manager" cv="const"><type>segment_manager *</type><description><para>Returns the segment manager. Never throws </para></description></method>
  249. <method name="max_size" cv="const"><type>size_type</type><description><para>Returns the number of elements that could be allocated. Never throws </para></description></method>
  250. <method name="allocate"><type>pointer</type><parameter name="count"><paramtype>size_type</paramtype></parameter><parameter name="hint"><paramtype>cvoid_pointer</paramtype><default>0</default></parameter><description><para>Allocate memory for an array of count elements. Throws <classname alt="boost::interprocess::bad_alloc">boost::interprocess::bad_alloc</classname> if there is no enough memory </para></description></method>
  251. <method name="deallocate"><type>void</type><parameter name="ptr"><paramtype>const pointer &amp;</paramtype></parameter><parameter name="count"><paramtype>size_type</paramtype></parameter><description><para>Deallocate allocated memory. Never throws </para></description></method>
  252. <method name="deallocate_free_blocks"><type>void</type><description><para>Deallocates all free blocks of the pool </para></description></method>
  253. <method name="address" cv="const"><type>pointer</type><parameter name="value"><paramtype>reference</paramtype></parameter><description><para>Returns address of mutable object. Never throws </para></description></method>
  254. <method name="address" cv="const"><type>const_pointer</type><parameter name="value"><paramtype>const_reference</paramtype></parameter><description><para>Returns address of non mutable object. Never throws </para></description></method>
  255. <method name="construct"><type>void</type><parameter name="ptr"><paramtype>const pointer &amp;</paramtype></parameter><parameter name="v"><paramtype>const_reference</paramtype></parameter><description><para>Default construct an object. Throws if T's default constructor throws </para></description></method>
  256. <method name="destroy"><type>void</type><parameter name="ptr"><paramtype>const pointer &amp;</paramtype></parameter><description><para>Destroys object. Throws if object's destructor throws </para></description></method>
  257. <method name="size" cv="const"><type>size_type</type><parameter name="p"><paramtype>const pointer &amp;</paramtype></parameter><description><para>Returns maximum the number of objects the previously allocated memory pointed by p can hold. This size only works for memory allocated with allocate, allocation_command and allocate_many. </para></description></method>
  258. <method name="allocation_command"><type>pointer</type><parameter name="command"><paramtype>boost::interprocess::allocation_type</paramtype></parameter><parameter name="limit_size"><paramtype>size_type</paramtype></parameter><parameter name="prefer_in_recvd_out_size"><paramtype>size_type &amp;</paramtype></parameter><parameter name="reuse"><paramtype>pointer &amp;</paramtype></parameter></method>
  259. <method name="allocate_many"><type>void</type><parameter name="elem_size"><paramtype>size_type</paramtype></parameter><parameter name="num_elements"><paramtype>size_type</paramtype></parameter><parameter name="chain"><paramtype>multiallocation_chain &amp;</paramtype></parameter><description><para>Allocates many elements of size elem_size in a contiguous block of memory. The minimum number to be allocated is min_elements, the preferred and maximum number is preferred_elements. The number of actually allocated elements is will be assigned to received_size. The elements must be deallocated with deallocate(...) </para></description></method>
  260. <method name="allocate_many"><type>void</type><parameter name="elem_sizes"><paramtype>const size_type *</paramtype></parameter><parameter name="n_elements"><paramtype>size_type</paramtype></parameter><parameter name="chain"><paramtype>multiallocation_chain &amp;</paramtype></parameter><description><para>Allocates n_elements elements, each one of size elem_sizes[i]in a contiguous block of memory. The elements must be deallocated </para></description></method>
  261. <method name="deallocate_many"><type>void</type><parameter name="chain"><paramtype>multiallocation_chain &amp;</paramtype></parameter><description><para>Allocates many elements of size elem_size in a contiguous block of memory. The minimum number to be allocated is min_elements, the preferred and maximum number is preferred_elements. The number of actually allocated elements is will be assigned to received_size. The elements must be deallocated with deallocate(...) </para></description></method>
  262. <method name="allocate_one"><type>pointer</type><description><para>Allocates just one object. Memory allocated with this function must be deallocated only with deallocate_one(). Throws <classname alt="boost::interprocess::bad_alloc">boost::interprocess::bad_alloc</classname> if there is no enough memory </para></description></method>
  263. <method name="allocate_individual"><type>multiallocation_chain</type><parameter name="num_elements"><paramtype>size_type</paramtype></parameter><description><para>Allocates many elements of size == 1 in a contiguous block of memory. The minimum number to be allocated is min_elements, the preferred and maximum number is preferred_elements. The number of actually allocated elements is will be assigned to received_size. Memory allocated with this function must be deallocated only with deallocate_one(). </para></description></method>
  264. <method name="deallocate_one"><type>void</type><parameter name="p"><paramtype>const pointer &amp;</paramtype></parameter><description><para>Deallocates memory previously allocated with allocate_one(). You should never use deallocate_one to deallocate memory allocated with other functions different from allocate_one(). Never throws </para></description></method>
  265. <method name="deallocate_individual"><type>void</type><parameter name="it"><paramtype>multiallocation_chain</paramtype></parameter><description><para>Allocates many elements of size == 1 in a contiguous block of memory. The minimum number to be allocated is min_elements, the preferred and maximum number is preferred_elements. The number of actually allocated elements is will be assigned to received_size. Memory allocated with this function must be deallocated only with deallocate_one(). </para></description></method>
  266. <method name="set_max_cached_nodes"><type>void</type><parameter name="newmax"><paramtype>size_type</paramtype></parameter><description><para>Sets the new max cached nodes value. This can provoke deallocations if "newmax" is less than current cached nodes. Never throws </para></description></method>
  267. <method name="get_max_cached_nodes" cv="const"><type>size_type</type><description><para>Returns the max cached nodes parameter. Never throws </para></description></method>
  268. </method-group>
  269. <constructor><parameter name="segment_mngr"><paramtype>segment_manager *</paramtype></parameter><description><para>Constructor from a segment manager. If not present, constructs a node pool. Increments the reference count of the associated node pool. Can throw <classname alt="boost::interprocess::bad_alloc">boost::interprocess::bad_alloc</classname> </para></description></constructor>
  270. <constructor><parameter name="other"><paramtype>const <classname>cached_node_allocator</classname> &amp;</paramtype></parameter><description><para>Copy constructor from other <classname alt="boost::interprocess::cached_node_allocator">cached_node_allocator</classname>. Increments the reference count of the associated node pool. Never throws </para></description></constructor>
  271. <constructor><template>
  272. <template-type-parameter name="T2"/>
  273. </template><parameter name="other"><paramtype>const <classname>cached_node_allocator</classname>&lt; T2, SegmentManager, NodesPerBlock &gt; &amp;</paramtype></parameter><description><para>Copy constructor from related <classname alt="boost::interprocess::cached_node_allocator">cached_node_allocator</classname>. If not present, constructs a node pool. Increments the reference count of the associated node pool. Can throw <classname alt="boost::interprocess::bad_alloc">boost::interprocess::bad_alloc</classname> </para></description></constructor>
  274. <destructor><description><para>Destructor, removes node_pool_t from memory if its reference count reaches to zero. Never throws </para></description></destructor>
  275. <method-group name="friend functions">
  276. <method name="swap"><type>friend void</type><parameter name="alloc1"><paramtype>self_t &amp;</paramtype></parameter><parameter name="alloc2"><paramtype>self_t &amp;</paramtype></parameter><description><para>Swaps allocators. Does not throw. If each allocator is placed in a different memory segment, the result is undefined. </para></description></method>
  277. </method-group>
  278. </class>
  279. <function name="operator=="><type>bool</type><template>
  280. <template-type-parameter name="T"/>
  281. <template-type-parameter name="S"/>
  282. <template-nontype-parameter name="NPC"><type>std::size_t</type></template-nontype-parameter>
  283. </template><parameter name="alloc1"><paramtype>const <classname>cached_node_allocator</classname>&lt; T, S, NPC &gt; &amp;</paramtype></parameter><parameter name="alloc2"><paramtype>const <classname>cached_node_allocator</classname>&lt; T, S, NPC &gt; &amp;</paramtype></parameter><description><para>Equality test for same type of <classname alt="boost::interprocess::cached_node_allocator">cached_node_allocator</classname> </para></description></function>
  284. <function name="operator!="><type>bool</type><template>
  285. <template-type-parameter name="T"/>
  286. <template-type-parameter name="S"/>
  287. <template-nontype-parameter name="NPC"><type>std::size_t</type></template-nontype-parameter>
  288. </template><parameter name="alloc1"><paramtype>const <classname>cached_node_allocator</classname>&lt; T, S, NPC &gt; &amp;</paramtype></parameter><parameter name="alloc2"><paramtype>const <classname>cached_node_allocator</classname>&lt; T, S, NPC &gt; &amp;</paramtype></parameter><description><para>Inequality test for same type of <classname alt="boost::interprocess::cached_node_allocator">cached_node_allocator</classname> </para></description></function>
  289. </namespace>
  290. </namespace>
  291. </header>
  292. <header name="boost/interprocess/allocators/node_allocator.hpp">
  293. <para>Describes node_allocator pooled shared memory STL compatible allocator </para><namespace name="boost">
  294. <namespace name="interprocess">
  295. <class name="node_allocator"><template>
  296. <template-type-parameter name="T"/>
  297. <template-type-parameter name="SegmentManager"/>
  298. <template-nontype-parameter name="NodesPerBlock"><type>std::size_t</type></template-nontype-parameter>
  299. </template><description><para>An STL node allocator that uses a segment manager as memory source. The internal pointer type will of the same type (raw, smart) as "typename SegmentManager::void_pointer" type. This allows placing the allocator in shared memory, memory mapped-files, etc... This node allocator shares a segregated storage between all instances of <classname alt="boost::interprocess::node_allocator">node_allocator</classname> with equal sizeof(T) placed in the same segment group. NodesPerBlock is the number of nodes allocated at once when the allocator runs out of nodes </para></description><struct name="rebind"><template>
  300. <template-type-parameter name="T2"/>
  301. </template><description><para>Obtains <classname alt="boost::interprocess::node_allocator">node_allocator</classname> from <classname alt="boost::interprocess::node_allocator">node_allocator</classname> </para></description><typedef name="other"><type><classname>node_allocator</classname>&lt; T2, SegmentManager, NodesPerBlock &gt;</type></typedef>
  302. </struct><typedef name="segment_manager"><type>implementation_defined::segment_manager</type></typedef>
  303. <typedef name="void_pointer"><type>segment_manager::void_pointer</type></typedef>
  304. <typedef name="pointer"><type>implementation_defined::pointer</type></typedef>
  305. <typedef name="const_pointer"><type>implementation_defined::const_pointer</type></typedef>
  306. <typedef name="value_type"><type>T</type></typedef>
  307. <typedef name="reference"><type><emphasis>unspecified</emphasis></type></typedef>
  308. <typedef name="const_reference"><type><emphasis>unspecified</emphasis></type></typedef>
  309. <typedef name="size_type"><type>segment_manager::size_type</type></typedef>
  310. <typedef name="difference_type"><type>segment_manager::difference_type</type></typedef>
  311. <method-group name="private member functions">
  312. </method-group>
  313. <copy-assignment><type><classname>node_allocator</classname> &amp;</type><template>
  314. <template-type-parameter name="T2"/>
  315. <template-type-parameter name="SegmentManager2"/>
  316. <template-nontype-parameter name="N2"><type>std::size_t</type></template-nontype-parameter>
  317. </template><parameter name=""><paramtype>const <classname>node_allocator</classname>&lt; T2, SegmentManager2, N2 &gt; &amp;</paramtype></parameter><description><para>Not assignable from related <classname alt="boost::interprocess::node_allocator">node_allocator</classname> </para></description></copy-assignment>
  318. <method-group name="public member functions">
  319. <method name="get_node_pool" cv="const"><type>void *</type><description><para>Returns a pointer to the node pool. Never throws </para></description></method>
  320. <method name="get_segment_manager" cv="const"><type>segment_manager *</type><description><para>Returns the segment manager. Never throws </para></description></method>
  321. <method name="max_size" cv="const"><type>size_type</type><description><para>Returns the number of elements that could be allocated. Never throws </para></description></method>
  322. <method name="allocate"><type>pointer</type><parameter name="count"><paramtype>size_type</paramtype></parameter><parameter name="hint"><paramtype>cvoid_pointer</paramtype><default>0</default></parameter><description><para>Allocate memory for an array of count elements. Throws <classname alt="boost::interprocess::bad_alloc">boost::interprocess::bad_alloc</classname> if there is no enough memory </para></description></method>
  323. <method name="deallocate"><type>void</type><parameter name="ptr"><paramtype>const pointer &amp;</paramtype></parameter><parameter name="count"><paramtype>size_type</paramtype></parameter><description><para>Deallocate allocated memory. Never throws </para></description></method>
  324. <method name="deallocate_free_blocks"><type>void</type><description><para>Deallocates all free blocks of the pool </para></description></method>
  325. <method name="address" cv="const"><type>pointer</type><parameter name="value"><paramtype>reference</paramtype></parameter><description><para>Returns address of mutable object. Never throws </para></description></method>
  326. <method name="address" cv="const"><type>const_pointer</type><parameter name="value"><paramtype>const_reference</paramtype></parameter><description><para>Returns address of non mutable object. Never throws </para></description></method>
  327. <method name="construct"><type>void</type><parameter name="ptr"><paramtype>const pointer &amp;</paramtype></parameter><parameter name="v"><paramtype>const_reference</paramtype></parameter><description><para>Copy construct an object. Throws if T's copy constructor throws </para></description></method>
  328. <method name="destroy"><type>void</type><parameter name="ptr"><paramtype>const pointer &amp;</paramtype></parameter><description><para>Destroys object. Throws if object's destructor throws </para></description></method>
  329. <method name="size" cv="const"><type>size_type</type><parameter name="p"><paramtype>const pointer &amp;</paramtype></parameter><description><para>Returns maximum the number of objects the previously allocated memory pointed by p can hold. This size only works for memory allocated with allocate, allocation_command and allocate_many. </para></description></method>
  330. <method name="allocation_command"><type>pointer</type><parameter name="command"><paramtype>boost::interprocess::allocation_type</paramtype></parameter><parameter name="limit_size"><paramtype>size_type</paramtype></parameter><parameter name="prefer_in_recvd_out_size"><paramtype>size_type &amp;</paramtype></parameter><parameter name="reuse"><paramtype>pointer &amp;</paramtype></parameter></method>
  331. <method name="allocate_many"><type>void</type><parameter name="elem_size"><paramtype>size_type</paramtype></parameter><parameter name="num_elements"><paramtype>size_type</paramtype></parameter><parameter name="chain"><paramtype>multiallocation_chain &amp;</paramtype></parameter><description><para>Allocates many elements of size elem_size in a contiguous block of memory. The minimum number to be allocated is min_elements, the preferred and maximum number is preferred_elements. The number of actually allocated elements is will be assigned to received_size. The elements must be deallocated with deallocate(...) </para></description></method>
  332. <method name="allocate_many"><type>void</type><parameter name="elem_sizes"><paramtype>const size_type *</paramtype></parameter><parameter name="n_elements"><paramtype>size_type</paramtype></parameter><parameter name="chain"><paramtype>multiallocation_chain &amp;</paramtype></parameter><description><para>Allocates n_elements elements, each one of size elem_sizes[i]in a contiguous block of memory. The elements must be deallocated </para></description></method>
  333. <method name="deallocate_many"><type>void</type><parameter name="chain"><paramtype>multiallocation_chain &amp;</paramtype></parameter><description><para>Allocates many elements of size elem_size in a contiguous block of memory. The minimum number to be allocated is min_elements, the preferred and maximum number is preferred_elements. The number of actually allocated elements is will be assigned to received_size. The elements must be deallocated with deallocate(...) </para></description></method>
  334. <method name="allocate_one"><type>pointer</type><description><para>Allocates just one object. Memory allocated with this function must be deallocated only with deallocate_one(). Throws <classname alt="boost::interprocess::bad_alloc">boost::interprocess::bad_alloc</classname> if there is no enough memory </para></description></method>
  335. <method name="allocate_individual"><type>void</type><parameter name="num_elements"><paramtype>size_type</paramtype></parameter><parameter name="chain"><paramtype>multiallocation_chain &amp;</paramtype></parameter><description><para>Allocates many elements of size == 1 in a contiguous block of memory. The minimum number to be allocated is min_elements, the preferred and maximum number is preferred_elements. The number of actually allocated elements is will be assigned to received_size. Memory allocated with this function must be deallocated only with deallocate_one(). </para></description></method>
  336. <method name="deallocate_one"><type>void</type><parameter name="p"><paramtype>const pointer &amp;</paramtype></parameter><description><para>Deallocates memory previously allocated with allocate_one(). You should never use deallocate_one to deallocate memory allocated with other functions different from allocate_one(). Never throws </para></description></method>
  337. <method name="deallocate_individual"><type>void</type><parameter name="chain"><paramtype>multiallocation_chain &amp;</paramtype></parameter><description><para>Allocates many elements of size == 1 in a contiguous block of memory. The minimum number to be allocated is min_elements, the preferred and maximum number is preferred_elements. The number of actually allocated elements is will be assigned to received_size. Memory allocated with this function must be deallocated only with deallocate_one(). </para></description></method>
  338. </method-group>
  339. <constructor><parameter name="segment_mngr"><paramtype>segment_manager *</paramtype></parameter><description><para>Not assignable from other <classname alt="boost::interprocess::node_allocator">node_allocator</classname> Constructor from a segment manager. If not present, constructs a node pool. Increments the reference count of the associated node pool. Can throw <classname alt="boost::interprocess::bad_alloc">boost::interprocess::bad_alloc</classname> </para></description></constructor>
  340. <constructor><parameter name="other"><paramtype>const <classname>node_allocator</classname> &amp;</paramtype></parameter><description><para>Copy constructor from other <classname alt="boost::interprocess::node_allocator">node_allocator</classname>. Increments the reference count of the associated node pool. Never throws </para></description></constructor>
  341. <constructor><template>
  342. <template-type-parameter name="T2"/>
  343. </template><parameter name="other"><paramtype>const <classname>node_allocator</classname>&lt; T2, SegmentManager, NodesPerBlock &gt; &amp;</paramtype></parameter><description><para>Copy constructor from related <classname alt="boost::interprocess::node_allocator">node_allocator</classname>. If not present, constructs a node pool. Increments the reference count of the associated node pool. Can throw <classname alt="boost::interprocess::bad_alloc">boost::interprocess::bad_alloc</classname> </para></description></constructor>
  344. <destructor><description><para>Destructor, removes node_pool_t from memory if its reference count reaches to zero. Never throws </para></description></destructor>
  345. <method-group name="friend functions">
  346. <method name="swap"><type>friend void</type><parameter name="alloc1"><paramtype>self_t &amp;</paramtype></parameter><parameter name="alloc2"><paramtype>self_t &amp;</paramtype></parameter><description><para>Swaps allocators. Does not throw. If each allocator is placed in a different memory segment, the result is undefined. </para></description></method>
  347. </method-group>
  348. </class>
  349. <function name="operator=="><type>bool</type><template>
  350. <template-type-parameter name="T"/>
  351. <template-type-parameter name="S"/>
  352. <template-nontype-parameter name="NPC"><type>std::size_t</type></template-nontype-parameter>
  353. </template><parameter name="alloc1"><paramtype>const <classname>node_allocator</classname>&lt; T, S, NPC &gt; &amp;</paramtype></parameter><parameter name="alloc2"><paramtype>const <classname>node_allocator</classname>&lt; T, S, NPC &gt; &amp;</paramtype></parameter><description><para>Equality test for same type of <classname alt="boost::interprocess::node_allocator">node_allocator</classname> </para></description></function>
  354. <function name="operator!="><type>bool</type><template>
  355. <template-type-parameter name="T"/>
  356. <template-type-parameter name="S"/>
  357. <template-nontype-parameter name="NPC"><type>std::size_t</type></template-nontype-parameter>
  358. </template><parameter name="alloc1"><paramtype>const <classname>node_allocator</classname>&lt; T, S, NPC &gt; &amp;</paramtype></parameter><parameter name="alloc2"><paramtype>const <classname>node_allocator</classname>&lt; T, S, NPC &gt; &amp;</paramtype></parameter><description><para>Inequality test for same type of <classname alt="boost::interprocess::node_allocator">node_allocator</classname> </para></description></function>
  359. </namespace>
  360. </namespace>
  361. </header>
  362. <header name="boost/interprocess/allocators/private_adaptive_pool.hpp">
  363. <para>Describes private_adaptive_pool_base pooled shared memory STL compatible allocator </para><namespace name="boost">
  364. <namespace name="interprocess">
  365. <class name="private_adaptive_pool"><template>
  366. <template-type-parameter name="T"/>
  367. <template-type-parameter name="SegmentManager"/>
  368. <template-nontype-parameter name="NodesPerBlock"><type>std::size_t</type></template-nontype-parameter>
  369. <template-nontype-parameter name="MaxFreeBlocks"><type>std::size_t</type></template-nontype-parameter>
  370. <template-nontype-parameter name="OverheadPercent"><type>unsigned char</type></template-nontype-parameter>
  371. </template><description><para>An STL node allocator that uses a segment manager as memory source. The internal pointer type will of the same type (raw, smart) as "typename SegmentManager::void_pointer" type. This allows placing the allocator in shared memory, memory mapped-files, etc... This allocator has its own node pool.</para><para>NodesPerBlock is the minimum number of nodes of nodes allocated at once when the allocator needs runs out of nodes. MaxFreeBlocks is the maximum number of totally free blocks that the adaptive node pool will hold. The rest of the totally free blocks will be deallocated with the segment manager.</para><para>OverheadPercent is the (approximated) maximum size overhead (1-20%) of the allocator: (memory usable for nodes / total memory allocated from the segment manager) </para></description><struct name="rebind"><template>
  372. <template-type-parameter name="T2"/>
  373. </template><description><para>Obtains <classname alt="boost::interprocess::private_adaptive_pool">private_adaptive_pool</classname> from <classname alt="boost::interprocess::private_adaptive_pool">private_adaptive_pool</classname> </para></description><typedef name="other"><type><classname>private_adaptive_pool</classname>&lt; T2, SegmentManager, NodesPerBlock, MaxFreeBlocks, OverheadPercent &gt;</type></typedef>
  374. </struct><typedef name="segment_manager"><type>implementation_defined::segment_manager</type></typedef>
  375. <typedef name="void_pointer"><type>segment_manager::void_pointer</type></typedef>
  376. <typedef name="pointer"><type>implementation_defined::pointer</type></typedef>
  377. <typedef name="const_pointer"><type>implementation_defined::const_pointer</type></typedef>
  378. <typedef name="value_type"><type>T</type></typedef>
  379. <typedef name="reference"><type><emphasis>unspecified</emphasis></type></typedef>
  380. <typedef name="const_reference"><type><emphasis>unspecified</emphasis></type></typedef>
  381. <typedef name="size_type"><type>segment_manager::size_type</type></typedef>
  382. <typedef name="difference_type"><type>segment_manager::difference_type</type></typedef>
  383. <method-group name="private member functions">
  384. </method-group>
  385. <copy-assignment><type><classname>private_adaptive_pool</classname> &amp;</type><template>
  386. <template-type-parameter name="T2"/>
  387. <template-type-parameter name="SegmentManager2"/>
  388. <template-nontype-parameter name="N2"><type>std::size_t</type></template-nontype-parameter>
  389. <template-nontype-parameter name="F2"><type>std::size_t</type></template-nontype-parameter>
  390. <template-nontype-parameter name="OP2"><type>unsigned char</type></template-nontype-parameter>
  391. </template><parameter name=""><paramtype>const <classname>private_adaptive_pool</classname>&lt; T2, SegmentManager2, N2, F2 &gt; &amp;</paramtype></parameter><description><para>Not assignable from related <classname alt="boost::interprocess::private_adaptive_pool">private_adaptive_pool</classname> </para></description></copy-assignment>
  392. <copy-assignment><type><classname>private_adaptive_pool</classname> &amp;</type><parameter name=""><paramtype>const <classname>private_adaptive_pool</classname> &amp;</paramtype></parameter><description><para>Not assignable from other <classname alt="boost::interprocess::private_adaptive_pool">private_adaptive_pool</classname> </para></description></copy-assignment>
  393. <method-group name="public member functions">
  394. <method name="get_node_pool" cv="const"><type>node_pool_t *</type><description><para>Returns a pointer to the node pool. Never throws </para></description></method>
  395. <method name="get_segment_manager" cv="const"><type>segment_manager *</type><description><para>Returns the segment manager. Never throws </para></description></method>
  396. <method name="max_size" cv="const"><type>size_type</type><description><para>Returns the number of elements that could be allocated. Never throws </para></description></method>
  397. <method name="allocate"><type>pointer</type><parameter name="count"><paramtype>size_type</paramtype></parameter><parameter name="hint"><paramtype>cvoid_pointer</paramtype><default>0</default></parameter><description><para>Allocate memory for an array of count elements. Throws <classname alt="boost::interprocess::bad_alloc">boost::interprocess::bad_alloc</classname> if there is no enough memory </para></description></method>
  398. <method name="deallocate"><type>void</type><parameter name="ptr"><paramtype>const pointer &amp;</paramtype></parameter><parameter name="count"><paramtype>size_type</paramtype></parameter><description><para>Deallocate allocated memory. Never throws </para></description></method>
  399. <method name="deallocate_free_blocks"><type>void</type><description><para>Deallocates all free blocks of the pool </para></description></method>
  400. <method name="address" cv="const"><type>pointer</type><parameter name="value"><paramtype>reference</paramtype></parameter><description><para>Returns address of mutable object. Never throws </para></description></method>
  401. <method name="address" cv="const"><type>const_pointer</type><parameter name="value"><paramtype>const_reference</paramtype></parameter><description><para>Returns address of non mutable object. Never throws </para></description></method>
  402. <method name="construct"><type>void</type><parameter name="ptr"><paramtype>const pointer &amp;</paramtype></parameter><parameter name="v"><paramtype>const_reference</paramtype></parameter><description><para>Copy construct an object. Throws if T's copy constructor throws </para></description></method>
  403. <method name="destroy"><type>void</type><parameter name="ptr"><paramtype>const pointer &amp;</paramtype></parameter><description><para>Destroys object. Throws if object's destructor throws </para></description></method>
  404. <method name="size" cv="const"><type>size_type</type><parameter name="p"><paramtype>const pointer &amp;</paramtype></parameter><description><para>Returns maximum the number of objects the previously allocated memory pointed by p can hold. This size only works for memory allocated with allocate, allocation_command and allocate_many. </para></description></method>
  405. <method name="allocation_command"><type>pointer</type><parameter name="command"><paramtype>boost::interprocess::allocation_type</paramtype></parameter><parameter name="limit_size"><paramtype>size_type</paramtype></parameter><parameter name="prefer_in_recvd_out_size"><paramtype>size_type &amp;</paramtype></parameter><parameter name="reuse"><paramtype>pointer &amp;</paramtype></parameter></method>
  406. <method name="allocate_many"><type>void</type><parameter name="elem_size"><paramtype>size_type</paramtype></parameter><parameter name="num_elements"><paramtype>size_type</paramtype></parameter><parameter name="chain"><paramtype>multiallocation_chain &amp;</paramtype></parameter><description><para>Allocates many elements of size elem_size in a contiguous block of memory. The minimum number to be allocated is min_elements, the preferred and maximum number is preferred_elements. The number of actually allocated elements is will be assigned to received_size. The elements must be deallocated with deallocate(...) </para></description></method>
  407. <method name="allocate_many"><type>void</type><parameter name="elem_sizes"><paramtype>const size_type *</paramtype></parameter><parameter name="n_elements"><paramtype>size_type</paramtype></parameter><parameter name="chain"><paramtype>multiallocation_chain &amp;</paramtype></parameter><description><para>Allocates n_elements elements, each one of size elem_sizes[i]in a contiguous block of memory. The elements must be deallocated </para></description></method>
  408. <method name="deallocate_many"><type>void</type><parameter name="chain"><paramtype>multiallocation_chain &amp;</paramtype></parameter><description><para>Allocates many elements of size elem_size in a contiguous block of memory. The minimum number to be allocated is min_elements, the preferred and maximum number is preferred_elements. The number of actually allocated elements is will be assigned to received_size. The elements must be deallocated with deallocate(...) </para></description></method>
  409. <method name="allocate_one"><type>pointer</type><description><para>Allocates just one object. Memory allocated with this function must be deallocated only with deallocate_one(). Throws <classname alt="boost::interprocess::bad_alloc">boost::interprocess::bad_alloc</classname> if there is no enough memory </para></description></method>
  410. <method name="allocate_individual"><type>void</type><parameter name="num_elements"><paramtype>size_type</paramtype></parameter><parameter name="chain"><paramtype>multiallocation_chain &amp;</paramtype></parameter><description><para>Allocates many elements of size == 1 in a contiguous block of memory. The minimum number to be allocated is min_elements, the preferred and maximum number is preferred_elements. The number of actually allocated elements is will be assigned to received_size. Memory allocated with this function must be deallocated only with deallocate_one(). </para></description></method>
  411. <method name="deallocate_one"><type>void</type><parameter name="p"><paramtype>const pointer &amp;</paramtype></parameter><description><para>Deallocates memory previously allocated with allocate_one(). You should never use deallocate_one to deallocate memory allocated with other functions different from allocate_one(). Never throws </para></description></method>
  412. <method name="deallocate_individual"><type>void</type><parameter name="chain"><paramtype>multiallocation_chain &amp;</paramtype></parameter><description><para>Allocates many elements of size == 1 in a contiguous block of memory. The minimum number to be allocated is min_elements, the preferred and maximum number is preferred_elements. The number of actually allocated elements is will be assigned to received_size. Memory allocated with this function must be deallocated only with deallocate_one(). </para></description></method>
  413. </method-group>
  414. <constructor><parameter name="segment_mngr"><paramtype>segment_manager *</paramtype></parameter><description><para>Constructor from a segment manager. If not present, constructs a node pool. Increments the reference count of the associated node pool. Can throw <classname alt="boost::interprocess::bad_alloc">boost::interprocess::bad_alloc</classname> </para></description></constructor>
  415. <constructor><parameter name="other"><paramtype>const <classname>private_adaptive_pool</classname> &amp;</paramtype></parameter><description><para>Copy constructor from other <classname alt="boost::interprocess::private_adaptive_pool">private_adaptive_pool</classname>. Increments the reference count of the associated node pool. Never throws </para></description></constructor>
  416. <constructor><template>
  417. <template-type-parameter name="T2"/>
  418. </template><parameter name="other"><paramtype>const <classname>private_adaptive_pool</classname>&lt; T2, SegmentManager, NodesPerBlock, MaxFreeBlocks, OverheadPercent &gt; &amp;</paramtype></parameter><description><para>Copy constructor from related <classname alt="boost::interprocess::private_adaptive_pool">private_adaptive_pool</classname>. If not present, constructs a node pool. Increments the reference count of the associated node pool. Can throw <classname alt="boost::interprocess::bad_alloc">boost::interprocess::bad_alloc</classname> </para></description></constructor>
  419. <destructor><description><para>Destructor, removes node_pool_t from memory if its reference count reaches to zero. Never throws </para></description></destructor>
  420. <method-group name="friend functions">
  421. <method name="swap"><type>friend void</type><parameter name="alloc1"><paramtype>self_t &amp;</paramtype></parameter><parameter name="alloc2"><paramtype>self_t &amp;</paramtype></parameter><description><para>Swaps allocators. Does not throw. If each allocator is placed in a different memory segment, the result is undefined. </para></description></method>
  422. </method-group>
  423. </class>
  424. <function name="operator=="><type>bool</type><template>
  425. <template-type-parameter name="T"/>
  426. <template-type-parameter name="S"/>
  427. <template-nontype-parameter name="NodesPerBlock"><type>std::size_t</type></template-nontype-parameter>
  428. <template-nontype-parameter name="F"><type>std::size_t</type></template-nontype-parameter>
  429. <template-nontype-parameter name="OP"><type>unsigned char</type></template-nontype-parameter>
  430. </template><parameter name="alloc1"><paramtype>const <classname>private_adaptive_pool</classname>&lt; T, S, NodesPerBlock, F, OP &gt; &amp;</paramtype></parameter><parameter name="alloc2"><paramtype>const <classname>private_adaptive_pool</classname>&lt; T, S, NodesPerBlock, F, OP &gt; &amp;</paramtype></parameter><description><para>Equality test for same type of <classname alt="boost::interprocess::private_adaptive_pool">private_adaptive_pool</classname> </para></description></function>
  431. <function name="operator!="><type>bool</type><template>
  432. <template-type-parameter name="T"/>
  433. <template-type-parameter name="S"/>
  434. <template-nontype-parameter name="NodesPerBlock"><type>std::size_t</type></template-nontype-parameter>
  435. <template-nontype-parameter name="F"><type>std::size_t</type></template-nontype-parameter>
  436. <template-nontype-parameter name="OP"><type>unsigned char</type></template-nontype-parameter>
  437. </template><parameter name="alloc1"><paramtype>const <classname>private_adaptive_pool</classname>&lt; T, S, NodesPerBlock, F, OP &gt; &amp;</paramtype></parameter><parameter name="alloc2"><paramtype>const <classname>private_adaptive_pool</classname>&lt; T, S, NodesPerBlock, F, OP &gt; &amp;</paramtype></parameter><description><para>Inequality test for same type of <classname alt="boost::interprocess::private_adaptive_pool">private_adaptive_pool</classname> </para></description></function>
  438. </namespace>
  439. </namespace>
  440. </header>
  441. <header name="boost/interprocess/allocators/private_node_allocator.hpp">
  442. <para>Describes private_node_allocator_base pooled shared memory STL compatible allocator </para><namespace name="boost">
  443. <namespace name="interprocess">
  444. <class name="private_node_allocator"><template>
  445. <template-type-parameter name="T"/>
  446. <template-type-parameter name="SegmentManager"/>
  447. <template-nontype-parameter name="NodesPerBlock"><type>std::size_t</type></template-nontype-parameter>
  448. </template><description><para>An STL node allocator that uses a segment manager as memory source. The internal pointer type will of the same type (raw, smart) as "typename SegmentManager::void_pointer" type. This allows placing the allocator in shared memory, memory mapped-files, etc... This allocator has its own node pool. NodesPerBlock is the number of nodes allocated at once when the allocator needs runs out of nodes </para></description><struct name="rebind"><template>
  449. <template-type-parameter name="T2"/>
  450. </template><description><para>Obtains <classname alt="boost::interprocess::private_node_allocator">private_node_allocator</classname> from <classname alt="boost::interprocess::private_node_allocator">private_node_allocator</classname> </para></description><typedef name="other"><type><classname>private_node_allocator</classname>&lt; T2, SegmentManager, NodesPerBlock &gt;</type></typedef>
  451. </struct><typedef name="segment_manager"><type>implementation_defined::segment_manager</type></typedef>
  452. <typedef name="void_pointer"><type>segment_manager::void_pointer</type></typedef>
  453. <typedef name="pointer"><type>implementation_defined::pointer</type></typedef>
  454. <typedef name="const_pointer"><type>implementation_defined::const_pointer</type></typedef>
  455. <typedef name="value_type"><type>T</type></typedef>
  456. <typedef name="reference"><type><emphasis>unspecified</emphasis></type></typedef>
  457. <typedef name="const_reference"><type><emphasis>unspecified</emphasis></type></typedef>
  458. <typedef name="size_type"><type>segment_manager::size_type</type></typedef>
  459. <typedef name="difference_type"><type>segment_manage::difference_type</type></typedef>
  460. <method-group name="private member functions">
  461. </method-group>
  462. <copy-assignment><type><classname>private_node_allocator</classname> &amp;</type><template>
  463. <template-type-parameter name="T2"/>
  464. <template-type-parameter name="SegmentManager2"/>
  465. <template-nontype-parameter name="N2"><type>std::size_t</type></template-nontype-parameter>
  466. </template><parameter name=""><paramtype>const <classname>private_node_allocator</classname>&lt; T2, SegmentManager2, N2 &gt; &amp;</paramtype></parameter><description><para>Not assignable from related <classname alt="boost::interprocess::private_node_allocator">private_node_allocator</classname> </para></description></copy-assignment>
  467. <copy-assignment><type><classname>private_node_allocator</classname> &amp;</type><parameter name=""><paramtype>const <classname>private_node_allocator</classname> &amp;</paramtype></parameter><description><para>Not assignable from other <classname alt="boost::interprocess::private_node_allocator">private_node_allocator</classname> </para></description></copy-assignment>
  468. <method-group name="public member functions">
  469. <method name="get_node_pool" cv="const"><type>node_pool_t *</type><description><para>Returns a pointer to the node pool. Never throws </para></description></method>
  470. <method name="get_segment_manager" cv="const"><type>segment_manager *</type><description><para>Returns the segment manager. Never throws </para></description></method>
  471. <method name="max_size" cv="const"><type>size_type</type><description><para>Returns the number of elements that could be allocated. Never throws </para></description></method>
  472. <method name="allocate"><type>pointer</type><parameter name="count"><paramtype>size_type</paramtype></parameter><parameter name="hint"><paramtype>cvoid_pointer</paramtype><default>0</default></parameter><description><para>Allocate memory for an array of count elements. Throws <classname alt="boost::interprocess::bad_alloc">boost::interprocess::bad_alloc</classname> if there is no enough memory </para></description></method>
  473. <method name="deallocate"><type>void</type><parameter name="ptr"><paramtype>const pointer &amp;</paramtype></parameter><parameter name="count"><paramtype>size_type</paramtype></parameter><description><para>Deallocate allocated memory. Never throws </para></description></method>
  474. <method name="deallocate_free_blocks"><type>void</type><description><para>Deallocates all free blocks of the pool </para></description></method>
  475. <method name="address" cv="const"><type>pointer</type><parameter name="value"><paramtype>reference</paramtype></parameter><description><para>Returns address of mutable object. Never throws </para></description></method>
  476. <method name="address" cv="const"><type>const_pointer</type><parameter name="value"><paramtype>const_reference</paramtype></parameter><description><para>Returns address of non mutable object. Never throws </para></description></method>
  477. <method name="construct"><type>void</type><parameter name="ptr"><paramtype>const pointer &amp;</paramtype></parameter><parameter name="v"><paramtype>const_reference</paramtype></parameter><description><para>Copy construct an object. Throws if T's copy constructor throws </para></description></method>
  478. <method name="destroy"><type>void</type><parameter name="ptr"><paramtype>const pointer &amp;</paramtype></parameter><description><para>Destroys object. Throws if object's destructor throws </para></description></method>
  479. <method name="size" cv="const"><type>size_type</type><parameter name="p"><paramtype>const pointer &amp;</paramtype></parameter><description><para>Returns maximum the number of objects the previously allocated memory pointed by p can hold. This size only works for memory allocated with allocate, allocation_command and allocate_many. </para></description></method>
  480. <method name="allocation_command"><type>pointer</type><parameter name="command"><paramtype>boost::interprocess::allocation_type</paramtype></parameter><parameter name="limit_size"><paramtype>size_type</paramtype></parameter><parameter name="prefer_in_recvd_out_size"><paramtype>size_type &amp;</paramtype></parameter><parameter name="reuse"><paramtype>pointer &amp;</paramtype></parameter></method>
  481. <method name="allocate_many"><type>void</type><parameter name="elem_size"><paramtype>size_type</paramtype></parameter><parameter name="num_elements"><paramtype>size_type</paramtype></parameter><parameter name="chain"><paramtype>multiallocation_chain &amp;</paramtype></parameter><description><para>Allocates many elements of size elem_size in a contiguous block of memory. The minimum number to be allocated is min_elements, the preferred and maximum number is preferred_elements. The number of actually allocated elements is will be assigned to received_size. The elements must be deallocated with deallocate(...) </para></description></method>
  482. <method name="allocate_many"><type>void</type><parameter name="elem_sizes"><paramtype>const size_type *</paramtype></parameter><parameter name="n_elements"><paramtype>size_type</paramtype></parameter><parameter name="chain"><paramtype>multiallocation_chain &amp;</paramtype></parameter><description><para>Allocates n_elements elements, each one of size elem_sizes[i]in a contiguous block of memory. The elements must be deallocated </para></description></method>
  483. <method name="deallocate_many"><type>void</type><parameter name="chain"><paramtype>multiallocation_chain &amp;</paramtype></parameter><description><para>Allocates many elements of size elem_size in a contiguous block of memory. The minimum number to be allocated is min_elements, the preferred and maximum number is preferred_elements. The number of actually allocated elements is will be assigned to received_size. The elements must be deallocated with deallocate(...) </para></description></method>
  484. <method name="allocate_one"><type>pointer</type><description><para>Allocates just one object. Memory allocated with this function must be deallocated only with deallocate_one(). Throws <classname alt="boost::interprocess::bad_alloc">boost::interprocess::bad_alloc</classname> if there is no enough memory </para></description></method>
  485. <method name="allocate_individual"><type>void</type><parameter name="num_elements"><paramtype>size_type</paramtype></parameter><parameter name="chain"><paramtype>multiallocation_chain &amp;</paramtype></parameter><description><para>Allocates many elements of size == 1 in a contiguous block of memory. The minimum number to be allocated is min_elements, the preferred and maximum number is preferred_elements. The number of actually allocated elements is will be assigned to received_size. Memory allocated with this function must be deallocated only with deallocate_one(). </para></description></method>
  486. <method name="deallocate_one"><type>void</type><parameter name="p"><paramtype>const pointer &amp;</paramtype></parameter><description><para>Deallocates memory previously allocated with allocate_one(). You should never use deallocate_one to deallocate memory allocated with other functions different from allocate_one(). Never throws </para></description></method>
  487. <method name="deallocate_individual"><type>void</type><parameter name="chain"><paramtype>multiallocation_chain &amp;</paramtype></parameter><description><para>Allocates many elements of size == 1 in a contiguous block of memory. The minimum number to be allocated is min_elements, the preferred and maximum number is preferred_elements. The number of actually allocated elements is will be assigned to received_size. Memory allocated with this function must be deallocated only with deallocate_one(). </para></description></method>
  488. </method-group>
  489. <constructor><parameter name="segment_mngr"><paramtype>segment_manager *</paramtype></parameter><description><para>Constructor from a segment manager. If not present, constructs a node pool. Increments the reference count of the associated node pool. Can throw <classname alt="boost::interprocess::bad_alloc">boost::interprocess::bad_alloc</classname> </para></description></constructor>
  490. <constructor><parameter name="other"><paramtype>const <classname>private_node_allocator</classname> &amp;</paramtype></parameter><description><para>Copy constructor from other <classname alt="boost::interprocess::private_node_allocator">private_node_allocator</classname>. Increments the reference count of the associated node pool. Never throws </para></description></constructor>
  491. <constructor><template>
  492. <template-type-parameter name="T2"/>
  493. </template><parameter name="other"><paramtype>const <classname>private_node_allocator</classname>&lt; T2, SegmentManager, NodesPerBlock &gt; &amp;</paramtype></parameter><description><para>Copy constructor from related <classname alt="boost::interprocess::private_node_allocator">private_node_allocator</classname>. If not present, constructs a node pool. Increments the reference count of the associated node pool. Can throw <classname alt="boost::interprocess::bad_alloc">boost::interprocess::bad_alloc</classname> </para></description></constructor>
  494. <destructor><description><para>Destructor, removes node_pool_t from memory if its reference count reaches to zero. Never throws </para></description></destructor>
  495. <method-group name="friend functions">
  496. <method name="swap"><type>friend void</type><parameter name="alloc1"><paramtype>self_t &amp;</paramtype></parameter><parameter name="alloc2"><paramtype>self_t &amp;</paramtype></parameter><description><para>Swaps allocators. Does not throw. If each allocator is placed in a different memory segment, the result is undefined. </para></description></method>
  497. </method-group>
  498. </class>
  499. <function name="operator=="><type>bool</type><template>
  500. <template-type-parameter name="T"/>
  501. <template-type-parameter name="S"/>
  502. <template-nontype-parameter name="NodesPerBlock"><type>std::size_t</type></template-nontype-parameter>
  503. <template-nontype-parameter name="F"><type>std::size_t</type></template-nontype-parameter>
  504. <template-nontype-parameter name="OP"><type>unsigned char</type></template-nontype-parameter>
  505. </template><parameter name="alloc1"><paramtype>const <classname>private_node_allocator</classname>&lt; T, S, NodesPerBlock, F, OP &gt; &amp;</paramtype></parameter><parameter name="alloc2"><paramtype>const <classname>private_node_allocator</classname>&lt; T, S, NodesPerBlock, F, OP &gt; &amp;</paramtype></parameter><description><para>Equality test for same type of <classname alt="boost::interprocess::private_node_allocator">private_node_allocator</classname> </para></description></function>
  506. <function name="operator!="><type>bool</type><template>
  507. <template-type-parameter name="T"/>
  508. <template-type-parameter name="S"/>
  509. <template-nontype-parameter name="NodesPerBlock"><type>std::size_t</type></template-nontype-parameter>
  510. <template-nontype-parameter name="F"><type>std::size_t</type></template-nontype-parameter>
  511. <template-nontype-parameter name="OP"><type>unsigned char</type></template-nontype-parameter>
  512. </template><parameter name="alloc1"><paramtype>const <classname>private_node_allocator</classname>&lt; T, S, NodesPerBlock, F, OP &gt; &amp;</paramtype></parameter><parameter name="alloc2"><paramtype>const <classname>private_node_allocator</classname>&lt; T, S, NodesPerBlock, F, OP &gt; &amp;</paramtype></parameter><description><para>Inequality test for same type of <classname alt="boost::interprocess::private_node_allocator">private_node_allocator</classname> </para></description></function>
  513. </namespace>
  514. </namespace>
  515. </header>
  516. <header name="boost/interprocess/anonymous_shared_memory.hpp">
  517. <para>Describes a function that creates anonymous shared memory that can be shared between forked processes </para><namespace name="boost">
  518. <namespace name="interprocess">
  519. <function name="anonymous_shared_memory"><type><classname>mapped_region</classname></type><parameter name="size"><paramtype>std::size_t</paramtype></parameter><parameter name="address"><paramtype>void *</paramtype><default>0</default></parameter><description><para>A function that creates an anonymous shared memory segment of size "size". If "address" is passed the function will try to map the segment in that address. Otherwise the operating system will choose the mapping address. The function returns a <classname alt="boost::interprocess::mapped_region">mapped_region</classname> holding that segment or throws <classname alt="boost::interprocess::interprocess_exception">interprocess_exception</classname> if the function fails. </para></description></function>
  520. </namespace>
  521. </namespace>
  522. </header>
  523. <header name="boost/interprocess/containers/allocation_type.hpp">
  524. <namespace name="boost">
  525. <namespace name="interprocess">
  526. <data-member name="allocate_new" specifiers="static"><type>const allocation_type</type></data-member>
  527. <data-member name="expand_fwd" specifiers="static"><type>const allocation_type</type></data-member>
  528. <data-member name="expand_bwd" specifiers="static"><type>const allocation_type</type></data-member>
  529. <data-member name="shrink_in_place" specifiers="static"><type>const allocation_type</type></data-member>
  530. <data-member name="try_shrink_in_place" specifiers="static"><type>const allocation_type</type></data-member>
  531. <data-member name="nothrow_allocation" specifiers="static"><type>const allocation_type</type></data-member>
  532. <data-member name="zero_memory" specifiers="static"><type>const allocation_type</type></data-member>
  533. </namespace>
  534. </namespace>
  535. </header>
  536. <header name="boost/interprocess/containers/containers_fwd.hpp">
  537. </header>
  538. <header name="boost/interprocess/containers/deque.hpp">
  539. <namespace name="boost">
  540. <namespace name="interprocess">
  541. </namespace>
  542. </namespace>
  543. </header>
  544. <header name="boost/interprocess/containers/flat_map.hpp">
  545. <namespace name="boost">
  546. <namespace name="interprocess">
  547. </namespace>
  548. </namespace>
  549. </header>
  550. <header name="boost/interprocess/containers/flat_set.hpp">
  551. <namespace name="boost">
  552. <namespace name="interprocess">
  553. </namespace>
  554. </namespace>
  555. </header>
  556. <header name="boost/interprocess/containers/list.hpp">
  557. <namespace name="boost">
  558. <namespace name="interprocess">
  559. </namespace>
  560. </namespace>
  561. </header>
  562. <header name="boost/interprocess/containers/map.hpp">
  563. <namespace name="boost">
  564. <namespace name="interprocess">
  565. </namespace>
  566. </namespace>
  567. </header>
  568. <header name="boost/interprocess/containers/pair.hpp">
  569. <namespace name="boost">
  570. <namespace name="interprocess">
  571. </namespace>
  572. </namespace>
  573. </header>
  574. <header name="boost/interprocess/containers/set.hpp">
  575. <namespace name="boost">
  576. <namespace name="interprocess">
  577. </namespace>
  578. </namespace>
  579. </header>
  580. <header name="boost/interprocess/containers/slist.hpp">
  581. <namespace name="boost">
  582. <namespace name="interprocess">
  583. </namespace>
  584. </namespace>
  585. </header>
  586. <header name="boost/interprocess/containers/stable_vector.hpp">
  587. <namespace name="boost">
  588. <namespace name="interprocess">
  589. </namespace>
  590. </namespace>
  591. </header>
  592. <header name="boost/interprocess/containers/string.hpp">
  593. <namespace name="boost">
  594. <namespace name="interprocess">
  595. </namespace>
  596. </namespace>
  597. </header>
  598. <header name="boost/interprocess/containers/vector.hpp">
  599. <namespace name="boost">
  600. <namespace name="interprocess">
  601. </namespace>
  602. </namespace>
  603. </header>
  604. <header name="boost/interprocess/containers/version_type.hpp">
  605. <namespace name="boost">
  606. <namespace name="interprocess">
  607. </namespace>
  608. </namespace>
  609. </header>
  610. <header name="boost/interprocess/creation_tags.hpp">
  611. <namespace name="boost">
  612. <namespace name="interprocess">
  613. <struct name="create_only_t"><description><para>Tag to indicate that the resource must be only created </para></description></struct><struct name="open_copy_on_write_t"><description><para>Tag to indicate that the resource must be only opened for reading </para></description></struct><struct name="open_only_t"><description><para>Tag to indicate that the resource must be only opened </para></description></struct><struct name="open_or_create_t"><description><para>Tag to indicate that the resource must be created. If already created, it must be opened. </para></description></struct><struct name="open_read_only_t"><description><para>Tag to indicate that the resource must be only opened for reading </para></description></struct><struct name="open_read_private_t"><description><para>Tag to indicate that the resource must be only opened privately for reading </para></description></struct><data-member name="create_only" specifiers="static"><type>const <classname>create_only_t</classname></type><description><para>Value to indicate that the resource must be only created </para></description></data-member>
  614. <data-member name="open_only" specifiers="static"><type>const <classname>open_only_t</classname></type><description><para>Value to indicate that the resource must be only opened </para></description></data-member>
  615. <data-member name="open_read_only" specifiers="static"><type>const <classname>open_read_only_t</classname></type><description><para>Value to indicate that the resource must be only opened for reading </para></description></data-member>
  616. <data-member name="open_or_create" specifiers="static"><type>const <classname>open_or_create_t</classname></type><description><para>Value to indicate that the resource must be created. If already created, it must be opened. </para></description></data-member>
  617. <data-member name="open_copy_on_write" specifiers="static"><type>const <classname>open_copy_on_write_t</classname></type><description><para>Value to indicate that the resource must be only opened for reading </para></description></data-member>
  618. </namespace>
  619. </namespace>
  620. </header>
  621. <header name="boost/interprocess/errors.hpp">
  622. <para>Describes the error numbering of interprocess classes </para><namespace name="boost">
  623. <namespace name="interprocess">
  624. <enum name="error_code_t"><enumvalue name="no_error"><default>= 0</default></enumvalue><enumvalue name="system_error"/><enumvalue name="other_error"/><enumvalue name="security_error"/><enumvalue name="read_only_error"/><enumvalue name="io_error"/><enumvalue name="path_error"/><enumvalue name="not_found_error"/><enumvalue name="busy_error"/><enumvalue name="already_exists_error"/><enumvalue name="not_empty_error"/><enumvalue name="is_directory_error"/><enumvalue name="out_of_space_error"/><enumvalue name="out_of_memory_error"/><enumvalue name="out_of_resource_error"/><enumvalue name="lock_error"/><enumvalue name="sem_error"/><enumvalue name="mode_error"/><enumvalue name="size_error"/><enumvalue name="corrupted_error"/><enumvalue name="not_such_file_or_directory"/><enumvalue name="invalid_argument"/><enumvalue name="timeout_when_locking_error"/><enumvalue name="timeout_when_waiting_error"/><enumvalue name="owner_dead_error"/></enum>
  625. <typedef name="native_error_t"><type>int</type></typedef>
  626. </namespace>
  627. </namespace>
  628. </header>
  629. <header name="boost/interprocess/exceptions.hpp">
  630. <para>Describes exceptions thrown by interprocess classes </para><namespace name="boost">
  631. <namespace name="interprocess">
  632. <class name="bad_alloc"><inherit access="public">boost::interprocess::interprocess_exception</inherit><description><para>This exception is thrown when a memory request can't be fulfilled. </para></description><method-group name="public member functions">
  633. <method name="what" cv="const noexcept" specifiers="virtual"><type>const char *</type></method>
  634. </method-group>
  635. <constructor/>
  636. </class><class name="interprocess_exception"><inherit access="public">exception</inherit><description><para>This class is the base class of all exceptions thrown by boost::interprocess </para></description><method-group name="public member functions">
  637. <method name="what" cv="const noexcept" specifiers="virtual"><type>const char *</type></method>
  638. <method name="get_native_error" cv="const"><type>native_error_t</type></method>
  639. <method name="get_error_code" cv="const"><type>error_code_t</type></method>
  640. </method-group>
  641. <constructor><parameter name="err"><paramtype>const char *</paramtype></parameter></constructor>
  642. <constructor><parameter name="err_info"><paramtype>const error_info &amp;</paramtype></parameter><parameter name="str"><paramtype>const char *</paramtype><default>0</default></parameter></constructor>
  643. <destructor/>
  644. </class><class name="lock_exception"><inherit access="public">boost::interprocess::interprocess_exception</inherit><description><para>This is the exception thrown by shared <classname alt="boost::interprocess::interprocess_mutex">interprocess_mutex</classname> family when a deadlock situation is detected or when using a <classname alt="boost::interprocess::interprocess_condition">interprocess_condition</classname> the <classname alt="boost::interprocess::interprocess_mutex">interprocess_mutex</classname> is not locked </para></description><method-group name="public member functions">
  645. <method name="what" cv="const noexcept" specifiers="virtual"><type>const char *</type></method>
  646. </method-group>
  647. <constructor/>
  648. </class>
  649. </namespace>
  650. </namespace>
  651. </header>
  652. <header name="boost/interprocess/file_mapping.hpp">
  653. <para>Describes file_mapping and mapped region classes </para><namespace name="boost">
  654. <namespace name="interprocess">
  655. <class name="file_mapping"><description><para>A class that wraps a file-mapping that can be used to create mapped regions from the mapped files </para></description><method-group name="public member functions">
  656. <method name="swap"><type>void</type><parameter name="other"><paramtype><classname>file_mapping</classname> &amp;</paramtype></parameter><description><para>Swaps to file_mappings. Does not throw. </para></description></method>
  657. <method name="get_mode" cv="const"><type>mode_t</type><description><para>Returns access mode used in the constructor </para></description></method>
  658. <method name="get_mapping_handle" cv="const"><type>mapping_handle_t</type><description><para>Obtains the mapping handle to be used with <classname alt="boost::interprocess::mapped_region">mapped_region</classname> </para></description></method>
  659. <method name="get_name" cv="const"><type>const char *</type><description><para>Returns the name of the file used in the constructor. </para></description></method>
  660. </method-group>
  661. <constructor><description><para>Constructs an empty file mapping. Does not throw </para></description></constructor>
  662. <constructor><parameter name="filename"><paramtype>const char *</paramtype></parameter><parameter name="mode"><paramtype>mode_t</paramtype></parameter><description><para>Opens a file mapping of file "filename", starting in offset "file_offset", and the mapping's size will be "size". The mapping can be opened for read-only "read_only" or read-write "read_write" modes. Throws <classname alt="boost::interprocess::interprocess_exception">interprocess_exception</classname> on error. </para></description></constructor>
  663. <constructor><parameter name="moved"><paramtype><classname>file_mapping</classname> &amp;&amp;</paramtype></parameter><description><para>Moves the ownership of "moved"'s file mapping object to *this. After the call, "moved" does not represent any file mapping object. Does not throw </para></description></constructor>
  664. <copy-assignment><type><classname>file_mapping</classname> &amp;</type><parameter name="moved"><paramtype><classname>file_mapping</classname> &amp;&amp;</paramtype></parameter><description><para>Moves the ownership of "moved"'s file mapping to *this. After the call, "moved" does not represent any file mapping. Does not throw </para></description></copy-assignment>
  665. <destructor><description><para>Destroys the file mapping. All mapped regions created from this are still valid. Does not throw </para></description></destructor>
  666. <method-group name="public static functions">
  667. <method name="remove" specifiers="static"><type>bool</type><parameter name="filename"><paramtype>const char *</paramtype></parameter><description><para>Removes the file named "filename" even if it's been memory mapped. Returns true on success. The function might fail in some operating systems if the file is being used other processes and no deletion permission was shared. </para></description></method>
  668. </method-group>
  669. </class>
  670. </namespace>
  671. </namespace>
  672. </header>
  673. <header name="boost/interprocess/indexes/flat_map_index.hpp">
  674. <para>Describes index adaptor of boost::map container, to use it as name/shared memory index </para><namespace name="boost">
  675. <namespace name="interprocess">
  676. <class name="flat_map_index"><template>
  677. <template-type-parameter name="MapConfig"/>
  678. </template><inherit access="public">flat_map_index_aux::index_t&lt; MapConfig &gt;</inherit><description><para>Index type based in flat_map. Just derives from flat_map and defines the interface needed by managed memory segments. </para></description><method-group name="public member functions">
  679. <method name="reserve"><type>void</type><parameter name="n"><paramtype>typename segment_manager_base::size_type</paramtype></parameter><purpose>This reserves memory to optimize the insertion of n elements in the index. </purpose></method>
  680. <method name="shrink_to_fit"><type>void</type><purpose>This frees all unnecessary memory. </purpose></method>
  681. </method-group>
  682. <constructor><parameter name="segment_mngr"><paramtype><classname>segment_manager_base</classname> *</paramtype></parameter><purpose>Constructor. Takes a pointer to the segment manager. Can throw. </purpose></constructor>
  683. </class>
  684. </namespace>
  685. </namespace>
  686. </header>
  687. <header name="boost/interprocess/indexes/iset_index.hpp">
  688. <para>Describes index adaptor of boost::intrusive::set container, to use it as name/shared memory index </para><namespace name="boost">
  689. <namespace name="interprocess">
  690. <class name="iset_index"><template>
  691. <template-type-parameter name="MapConfig"/>
  692. </template><inherit access="public">iset_index_aux::index_t&lt; MapConfig &gt;</inherit><description><para>Index type based in boost::intrusive::set. Just derives from boost::intrusive::set and defines the interface needed by managed memory segments </para></description><typedef name="iterator"><type>index_type::iterator</type></typedef>
  693. <typedef name="const_iterator"><type>index_type::const_iterator</type></typedef>
  694. <typedef name="insert_commit_data"><type>index_type::insert_commit_data</type></typedef>
  695. <typedef name="value_type"><type>index_type::value_type</type></typedef>
  696. <method-group name="public member functions">
  697. <method name="reserve"><type>void</type><parameter name=""><paramtype>typename MapConfig::segment_manager_base::size_type</paramtype></parameter><description><para>This reserves memory to optimize the insertion of n elements in the index </para></description></method>
  698. <method name="shrink_to_fit"><type>void</type><purpose>This frees all unnecessary memory. </purpose></method>
  699. <method name="find"><type>iterator</type><parameter name="key"><paramtype>const intrusive_compare_key_type &amp;</paramtype></parameter></method>
  700. <method name="find" cv="const"><type>const_iterator</type><parameter name="key"><paramtype>const intrusive_compare_key_type &amp;</paramtype></parameter></method>
  701. <method name="insert_check"><type>std::pair&lt; iterator, bool &gt;</type><parameter name="key"><paramtype>const intrusive_compare_key_type &amp;</paramtype></parameter><parameter name="commit_data"><paramtype>insert_commit_data &amp;</paramtype></parameter></method>
  702. </method-group>
  703. <constructor><parameter name=""><paramtype>typename MapConfig::segment_manager_base *</paramtype></parameter><description><para>Constructor. Takes a pointer to the segment manager. Can throw </para></description></constructor>
  704. </class>
  705. </namespace>
  706. </namespace>
  707. </header>
  708. <header name="boost/interprocess/indexes/iunordered_set_index.hpp">
  709. <para>Describes index adaptor of boost::intrusive::unordered_set container, to use it as name/shared memory index </para><namespace name="boost">
  710. <namespace name="interprocess">
  711. <class name="iunordered_set_index"><template>
  712. <template-type-parameter name="MapConfig"/>
  713. </template><inherit access="private">iunordered_set_index_aux::allocator_holder&lt; MapConfig &gt;</inherit><inherit access="public">iunordered_set_index_aux::index_t&lt; MapConfig &gt;</inherit><description><para>Index type based in boost::intrusive::set. Just derives from boost::intrusive::set and defines the interface needed by managed memory segments </para></description><typedef name="iterator"><type>index_type::iterator</type></typedef>
  714. <typedef name="const_iterator"><type>index_type::const_iterator</type></typedef>
  715. <typedef name="insert_commit_data"><type>index_type::insert_commit_data</type></typedef>
  716. <typedef name="value_type"><type>index_type::value_type</type></typedef>
  717. <typedef name="bucket_ptr"><type>index_type::bucket_ptr</type></typedef>
  718. <typedef name="bucket_type"><type>index_type::bucket_type</type></typedef>
  719. <typedef name="bucket_traits"><type>index_type::bucket_traits</type></typedef>
  720. <typedef name="size_type"><type>index_type::size_type</type></typedef>
  721. <method-group name="public member functions">
  722. <method name="reserve"><type>void</type><parameter name="new_n"><paramtype>size_type</paramtype></parameter><description><para>This reserves memory to optimize the insertion of n elements in the index </para></description></method>
  723. <method name="shrink_to_fit"><type>void</type><description><para>This tries to free unused memory previously allocated. </para></description></method>
  724. <method name="find"><type>iterator</type><parameter name="key"><paramtype>const intrusive_compare_key_type &amp;</paramtype></parameter></method>
  725. <method name="find" cv="const"><type>const_iterator</type><parameter name="key"><paramtype>const intrusive_compare_key_type &amp;</paramtype></parameter></method>
  726. <method name="insert_check"><type>std::pair&lt; iterator, bool &gt;</type><parameter name="key"><paramtype>const intrusive_compare_key_type &amp;</paramtype></parameter><parameter name="commit_data"><paramtype>insert_commit_data &amp;</paramtype></parameter></method>
  727. <method name="insert_commit"><type>iterator</type><parameter name="val"><paramtype>value_type &amp;</paramtype></parameter><parameter name="commit_data"><paramtype>insert_commit_data &amp;</paramtype></parameter></method>
  728. </method-group>
  729. <constructor><parameter name="mngr"><paramtype><classname>segment_manager_base</classname> *</paramtype></parameter><description><para>Constructor. Takes a pointer to the segment manager. Can throw </para></description></constructor>
  730. <destructor/>
  731. </class>
  732. </namespace>
  733. </namespace>
  734. </header>
  735. <header name="boost/interprocess/indexes/map_index.hpp">
  736. <para>Describes index adaptor of boost::map container, to use it as name/shared memory index </para><namespace name="boost">
  737. <namespace name="interprocess">
  738. <class name="map_index"><template>
  739. <template-type-parameter name="MapConfig"/>
  740. </template><inherit access="public">boost::container::map&lt; MapConfig &gt;</inherit><description><para>Index type based in boost::interprocess::map. Just derives from boost::interprocess::map and defines the interface needed by managed memory segments </para></description><method-group name="public member functions">
  741. <method name="reserve"><type>void</type><parameter name=""><paramtype>typename segment_manager_base::size_type</paramtype></parameter><description><para>This reserves memory to optimize the insertion of n elements in the index </para></description></method>
  742. <method name="shrink_to_fit"><type>void</type><description><para>This tries to free previously allocate unused memory. </para></description></method>
  743. </method-group>
  744. <constructor><parameter name="segment_mngr"><paramtype><classname>segment_manager_base</classname> *</paramtype></parameter><description><para>Constructor. Takes a pointer to the segment manager. Can throw </para></description></constructor>
  745. </class>
  746. </namespace>
  747. </namespace>
  748. </header>
  749. <header name="boost/interprocess/indexes/null_index.hpp">
  750. <para>Describes a null index adaptor, so that if we don't want to construct named objects, we can use this null index type to save resources. </para><namespace name="boost">
  751. <namespace name="interprocess">
  752. <class name="null_index"><template>
  753. <template-type-parameter name="MapConfig"/>
  754. </template><description><para>Null index type used to save compilation time when named indexes are not needed. </para></description><typedef name="iterator"><type>int *</type></typedef>
  755. <typedef name="const_iterator"><type>const int *</type></typedef>
  756. <method-group name="public member functions">
  757. <method name="begin" cv="const"><type>const_iterator</type><description><para>begin() is equal to end() </para></description></method>
  758. <method name="begin"><type>iterator</type><description><para>begin() is equal to end() </para></description></method>
  759. <method name="end" cv="const"><type>const_iterator</type><description><para>begin() is equal to end() </para></description></method>
  760. <method name="end"><type>iterator</type><description><para>begin() is equal to end() </para></description></method>
  761. </method-group>
  762. <constructor><parameter name=""><paramtype><classname>segment_manager_base</classname> *</paramtype></parameter><purpose>Empty constructor. </purpose></constructor>
  763. </class>
  764. </namespace>
  765. </namespace>
  766. </header>
  767. <header name="boost/interprocess/indexes/unordered_map_index.hpp">
  768. <para>Describes index adaptor of boost::unordered_map container, to use it as name/shared memory index </para><namespace name="boost">
  769. <namespace name="interprocess">
  770. <class name="unordered_map_index"><template>
  771. <template-type-parameter name="MapConfig"/>
  772. </template><inherit access="public">unordered_map_index_aux::index_t&lt; MapConfig &gt;</inherit><description><para>Index type based in unordered_map. Just derives from unordered_map and defines the interface needed by managed memory segments </para></description><method-group name="public member functions">
  773. <method name="reserve"><type>void</type><parameter name="n"><paramtype>typename segment_manager_base::size_type</paramtype></parameter><description><para>This reserves memory to optimize the insertion of n elements in the index </para></description></method>
  774. <method name="shrink_to_fit"><type>void</type><description><para>This tries to free previously allocate unused memory. </para></description></method>
  775. </method-group>
  776. <constructor><parameter name="segment_mngr"><paramtype><classname>segment_manager_base</classname> *</paramtype></parameter><description><para>Constructor. Takes a pointer to the segment manager. Can throw </para></description></constructor>
  777. </class>
  778. </namespace>
  779. </namespace>
  780. </header>
  781. <header name="boost/interprocess/interprocess_fwd.hpp">
  782. <para>This header file forward declares the basic interprocess types:<itemizedlist>
  783. <listitem><para><classname alt="boost::interprocess::offset_ptr">boost::interprocess::offset_ptr</classname>;</para>
  784. </listitem><listitem><para><classname alt="boost::interprocess::permissions">boost::interprocess::permissions</classname>;</para>
  785. </listitem><listitem><para><classname alt="boost::interprocess::mapped_region">boost::interprocess::mapped_region</classname>;</para>
  786. </listitem><listitem><para><classname alt="boost::interprocess::file_mapping">boost::interprocess::file_mapping</classname>;</para>
  787. </listitem><listitem><para><classname alt="boost::interprocess::shared_memory_object">boost::interprocess::shared_memory_object</classname>;</para>
  788. </listitem><listitem><para><classname alt="boost::interprocess::windows_shared_memory">boost::interprocess::windows_shared_memory</classname>;</para>
  789. </listitem><listitem><para><classname alt="boost::interprocess::xsi_shared_memory">boost::interprocess::xsi_shared_memory</classname>;</para>
  790. </listitem></itemizedlist>
  791. </para><para>The following synchronization mechanisms and locks:<itemizedlist>
  792. <listitem><para><classname alt="boost::interprocess::null_mutex">boost::interprocess::null_mutex</classname>;</para>
  793. </listitem><listitem><para><classname alt="boost::interprocess::interprocess_mutex">boost::interprocess::interprocess_mutex</classname>;</para>
  794. </listitem><listitem><para><classname alt="boost::interprocess::interprocess_recursive_mutex">boost::interprocess::interprocess_recursive_mutex</classname>;</para>
  795. </listitem><listitem><para><classname alt="boost::interprocess::interprocess_semaphore">boost::interprocess::interprocess_semaphore</classname>;</para>
  796. </listitem><listitem><para><classname alt="boost::interprocess::named_mutex">boost::interprocess::named_mutex</classname>;</para>
  797. </listitem><listitem><para><classname alt="boost::interprocess::named_recursive_mutex">boost::interprocess::named_recursive_mutex</classname>;</para>
  798. </listitem><listitem><para><classname alt="boost::interprocess::named_semaphore">boost::interprocess::named_semaphore</classname>;</para>
  799. </listitem><listitem><para><classname alt="boost::interprocess::interprocess_sharable_mutex">boost::interprocess::interprocess_sharable_mutex</classname>;</para>
  800. </listitem><listitem><para><classname alt="boost::interprocess::interprocess_condition">boost::interprocess::interprocess_condition</classname>;</para>
  801. </listitem><listitem><para><classname alt="boost::interprocess::scoped_lock">boost::interprocess::scoped_lock</classname>;</para>
  802. </listitem><listitem><para><classname alt="boost::interprocess::sharable_lock">boost::interprocess::sharable_lock</classname>;</para>
  803. </listitem><listitem><para><classname alt="boost::interprocess::upgradable_lock">boost::interprocess::upgradable_lock</classname>;</para>
  804. </listitem></itemizedlist>
  805. </para><para>The following mutex families:<itemizedlist>
  806. <listitem><para><classname alt="boost::interprocess::mutex_family">boost::interprocess::mutex_family</classname>;</para>
  807. </listitem><listitem><para><classname alt="boost::interprocess::null_mutex_family">boost::interprocess::null_mutex_family</classname>;</para>
  808. </listitem></itemizedlist>
  809. </para><para>The following allocators:<itemizedlist>
  810. <listitem><para><classname alt="boost::interprocess::allocator">boost::interprocess::allocator</classname>;</para>
  811. </listitem><listitem><para><classname alt="boost::interprocess::node_allocator">boost::interprocess::node_allocator</classname>;</para>
  812. </listitem><listitem><para><classname alt="boost::interprocess::private_node_allocator">boost::interprocess::private_node_allocator</classname>;</para>
  813. </listitem><listitem><para><classname alt="boost::interprocess::cached_node_allocator">boost::interprocess::cached_node_allocator</classname>;</para>
  814. </listitem><listitem><para><classname alt="boost::interprocess::adaptive_pool">boost::interprocess::adaptive_pool</classname>;</para>
  815. </listitem><listitem><para><classname alt="boost::interprocess::private_adaptive_pool">boost::interprocess::private_adaptive_pool</classname>;</para>
  816. </listitem><listitem><para><classname alt="boost::interprocess::cached_adaptive_pool">boost::interprocess::cached_adaptive_pool</classname>;</para>
  817. </listitem></itemizedlist>
  818. </para><para>The following allocation algorithms:<itemizedlist>
  819. <listitem><para><classname alt="boost::interprocess::simple_seq_fit">boost::interprocess::simple_seq_fit</classname>;</para>
  820. </listitem><listitem><para><classname alt="boost::interprocess::rbtree_best_fit">boost::interprocess::rbtree_best_fit</classname>;</para>
  821. </listitem></itemizedlist>
  822. </para><para>The following index types:<itemizedlist>
  823. <listitem><para><classname alt="boost::interprocess::flat_map_index">boost::interprocess::flat_map_index</classname>;</para>
  824. </listitem><listitem><para><classname alt="boost::interprocess::iset_index">boost::interprocess::iset_index</classname>;</para>
  825. </listitem><listitem><para><classname alt="boost::interprocess::iunordered_set_index">boost::interprocess::iunordered_set_index</classname>;</para>
  826. </listitem><listitem><para><classname alt="boost::interprocess::map_index">boost::interprocess::map_index</classname>;</para>
  827. </listitem><listitem><para><classname alt="boost::interprocess::null_index">boost::interprocess::null_index</classname>;</para>
  828. </listitem><listitem><para><classname alt="boost::interprocess::unordered_map_index">boost::interprocess::unordered_map_index</classname>;</para>
  829. </listitem></itemizedlist>
  830. </para><para>The following managed memory types:<itemizedlist>
  831. <listitem><para><classname alt="boost::interprocess::segment_manager">boost::interprocess::segment_manager</classname>;</para>
  832. </listitem><listitem><para><classname alt="boost::interprocess::basic_managed_external_buffer">boost::interprocess::basic_managed_external_buffer</classname></para>
  833. </listitem><listitem><para>boost::interprocess::managed_external_buffer</para>
  834. </listitem><listitem><para>boost::interprocess::wmanaged_external_buffer</para>
  835. </listitem><listitem><para><classname alt="boost::interprocess::basic_managed_shared_memory">boost::interprocess::basic_managed_shared_memory</classname></para>
  836. </listitem><listitem><para>boost::interprocess::managed_shared_memory</para>
  837. </listitem><listitem><para>boost::interprocess::wmanaged_shared_memory</para>
  838. </listitem><listitem><para><classname alt="boost::interprocess::basic_managed_windows_shared_memory">boost::interprocess::basic_managed_windows_shared_memory</classname></para>
  839. </listitem><listitem><para>boost::interprocess::managed_windows_shared_memory</para>
  840. </listitem><listitem><para>boost::interprocess::wmanaged_windows_shared_memory</para>
  841. </listitem><listitem><para><classname alt="boost::interprocess::basic_managed_xsi_shared_memory">boost::interprocess::basic_managed_xsi_shared_memory</classname></para>
  842. </listitem><listitem><para>boost::interprocess::managed_xsi_shared_memory</para>
  843. </listitem><listitem><para>boost::interprocess::wmanaged_xsi_shared_memory</para>
  844. </listitem><listitem><para>boost::interprocess::fixed_managed_shared_memory</para>
  845. </listitem><listitem><para>boost::interprocess::wfixed_managed_shared_memory</para>
  846. </listitem><listitem><para><classname alt="boost::interprocess::basic_managed_heap_memory">boost::interprocess::basic_managed_heap_memory</classname></para>
  847. </listitem><listitem><para>boost::interprocess::managed_heap_memory</para>
  848. </listitem><listitem><para>boost::interprocess::wmanaged_heap_memory</para>
  849. </listitem><listitem><para><classname alt="boost::interprocess::basic_managed_mapped_file">boost::interprocess::basic_managed_mapped_file</classname></para>
  850. </listitem><listitem><para>boost::interprocess::managed_mapped_file</para>
  851. </listitem><listitem><para>boost::interprocess::wmanaged_mapped_file</para>
  852. </listitem></itemizedlist>
  853. </para><para>The following exception types:<itemizedlist>
  854. <listitem><para><classname alt="boost::interprocess::interprocess_exception">boost::interprocess::interprocess_exception</classname></para>
  855. </listitem><listitem><para><classname alt="boost::interprocess::lock_exception">boost::interprocess::lock_exception</classname></para>
  856. </listitem><listitem><para><classname alt="boost::interprocess::bad_alloc">boost::interprocess::bad_alloc</classname></para>
  857. </listitem></itemizedlist>
  858. </para><para>The following stream types:<itemizedlist>
  859. <listitem><para><classname alt="boost::interprocess::basic_bufferbuf">boost::interprocess::basic_bufferbuf</classname></para>
  860. </listitem><listitem><para><classname alt="boost::interprocess::basic_ibufferstream">boost::interprocess::basic_ibufferstream</classname></para>
  861. </listitem><listitem><para><classname alt="boost::interprocess::basic_obufferstream">boost::interprocess::basic_obufferstream</classname></para>
  862. </listitem><listitem><para><classname alt="boost::interprocess::basic_bufferstream">boost::interprocess::basic_bufferstream</classname></para>
  863. </listitem><listitem><para><classname alt="boost::interprocess::basic_vectorbuf">boost::interprocess::basic_vectorbuf</classname></para>
  864. </listitem><listitem><para><classname alt="boost::interprocess::basic_ivectorstream">boost::interprocess::basic_ivectorstream</classname></para>
  865. </listitem><listitem><para><classname alt="boost::interprocess::basic_ovectorstream">boost::interprocess::basic_ovectorstream</classname></para>
  866. </listitem><listitem><para><classname alt="boost::interprocess::basic_vectorstream">boost::interprocess::basic_vectorstream</classname></para>
  867. </listitem></itemizedlist>
  868. </para><para>The following smart pointer types:<itemizedlist>
  869. <listitem><para><classname alt="boost::interprocess::scoped_ptr">boost::interprocess::scoped_ptr</classname></para>
  870. </listitem><listitem><para><classname alt="boost::interprocess::intrusive_ptr">boost::interprocess::intrusive_ptr</classname></para>
  871. </listitem><listitem><para><classname alt="boost::interprocess::shared_ptr">boost::interprocess::shared_ptr</classname></para>
  872. </listitem><listitem><para><classname alt="boost::interprocess::weak_ptr">boost::interprocess::weak_ptr</classname></para>
  873. </listitem></itemizedlist>
  874. </para><para>The following interprocess communication types:<itemizedlist>
  875. <listitem><para><classname alt="boost::interprocess::message_queue_t">boost::interprocess::message_queue_t</classname>;</para>
  876. </listitem><listitem><para>boost::interprocess::message_queue; </para>
  877. </listitem></itemizedlist>
  878. </para></header>
  879. <header name="boost/interprocess/ipc/message_queue.hpp">
  880. <para>Describes an inter-process message queue. This class allows sending messages between processes and allows blocking, non-blocking and timed sending and receiving. </para><namespace name="boost">
  881. <namespace name="interprocess">
  882. <class name="message_queue_t"><template>
  883. <template-type-parameter name="VoidPointer"/>
  884. </template><description><para>A class that allows sending messages between processes. </para></description><typedef name="void_pointer"><type>VoidPointer</type></typedef>
  885. <typedef name="char_ptr"><type>boost::intrusive::pointer_traits&lt; void_pointer &gt;::template rebind_pointer&lt; char &gt;::type</type></typedef>
  886. <typedef name="difference_type"><type>boost::intrusive::pointer_traits&lt; char_ptr &gt;::difference_type</type></typedef>
  887. <typedef name="size_type"><type>boost::container::dtl::make_unsigned&lt; difference_type &gt;::type</type></typedef>
  888. <method-group name="public member functions">
  889. <method name="send"><type>void</type><parameter name="buffer"><paramtype>const void *</paramtype></parameter><parameter name="buffer_size"><paramtype>size_type</paramtype></parameter><parameter name="priority"><paramtype>unsigned int</paramtype></parameter><description><para>Sends a message stored in buffer "buffer" with size "buffer_size" in the message queue with priority "priority". If the message queue is full the sender is blocked. Throws interprocess_error on error. </para></description></method>
  890. <method name="try_send"><type>bool</type><parameter name="buffer"><paramtype>const void *</paramtype></parameter><parameter name="buffer_size"><paramtype>size_type</paramtype></parameter><parameter name="priority"><paramtype>unsigned int</paramtype></parameter><description><para>Sends a message stored in buffer "buffer" with size "buffer_size" through the message queue with priority "priority". If the message queue is full the sender is not blocked and returns false, otherwise returns true. Throws interprocess_error on error. </para></description></method>
  891. <method name="timed_send"><type>bool</type><parameter name="buffer"><paramtype>const void *</paramtype></parameter><parameter name="buffer_size"><paramtype>size_type</paramtype></parameter><parameter name="priority"><paramtype>unsigned int</paramtype></parameter><parameter name="abs_time"><paramtype>const boost::posix_time::ptime &amp;</paramtype></parameter><description><para>Sends a message stored in buffer "buffer" with size "buffer_size" in the message queue with priority "priority". If the message queue is full the sender retries until time "abs_time" is reached. Returns true if the message has been successfully sent. Returns false if timeout is reached. Throws interprocess_error on error. </para></description></method>
  892. <method name="receive"><type>void</type><parameter name="buffer"><paramtype>void *</paramtype></parameter><parameter name="buffer_size"><paramtype>size_type</paramtype></parameter><parameter name="recvd_size"><paramtype>size_type &amp;</paramtype></parameter><parameter name="priority"><paramtype>unsigned int &amp;</paramtype></parameter><description><para>Receives a message from the message queue. The message is stored in buffer "buffer", which has size "buffer_size". The received message has size "recvd_size" and priority "priority". If the message queue is empty the receiver is blocked. Throws interprocess_error on error. </para></description></method>
  893. <method name="try_receive"><type>bool</type><parameter name="buffer"><paramtype>void *</paramtype></parameter><parameter name="buffer_size"><paramtype>size_type</paramtype></parameter><parameter name="recvd_size"><paramtype>size_type &amp;</paramtype></parameter><parameter name="priority"><paramtype>unsigned int &amp;</paramtype></parameter><description><para>Receives a message from the message queue. The message is stored in buffer "buffer", which has size "buffer_size". The received message has size "recvd_size" and priority "priority". If the message queue is empty the receiver is not blocked and returns false, otherwise returns true. Throws interprocess_error on error. </para></description></method>
  894. <method name="timed_receive"><type>bool</type><parameter name="buffer"><paramtype>void *</paramtype></parameter><parameter name="buffer_size"><paramtype>size_type</paramtype></parameter><parameter name="recvd_size"><paramtype>size_type &amp;</paramtype></parameter><parameter name="priority"><paramtype>unsigned int &amp;</paramtype></parameter><parameter name="abs_time"><paramtype>const boost::posix_time::ptime &amp;</paramtype></parameter><description><para>Receives a message from the message queue. The message is stored in buffer "buffer", which has size "buffer_size". The received message has size "recvd_size" and priority "priority". If the message queue is empty the receiver retries until time "abs_time" is reached. Returns true if the message has been successfully sent. Returns false if timeout is reached. Throws interprocess_error on error. </para></description></method>
  895. <method name="get_max_msg" cv="const"><type>size_type</type><description><para>Returns the maximum number of messages allowed by the queue. The message queue must be opened or created previously. Otherwise, returns 0. Never throws </para></description></method>
  896. <method name="get_max_msg_size" cv="const"><type>size_type</type><description><para>Returns the maximum size of message allowed by the queue. The message queue must be opened or created previously. Otherwise, returns 0. Never throws </para></description></method>
  897. <method name="get_num_msg" cv="const"><type>size_type</type><description><para>Returns the number of messages currently stored. Never throws </para></description></method>
  898. </method-group>
  899. <constructor><parameter name="create_only"><paramtype><classname>create_only_t</classname></paramtype></parameter><parameter name="name"><paramtype>const char *</paramtype></parameter><parameter name="max_num_msg"><paramtype>size_type</paramtype></parameter><parameter name="max_msg_size"><paramtype>size_type</paramtype></parameter><parameter name="perm"><paramtype>const <classname>permissions</classname> &amp;</paramtype><default><classname alt="boost::interprocess::permissions">permissions</classname>()</default></parameter><description><para>Creates a process shared message queue with name "name". For this message queue, the maximum number of messages will be "max_num_msg" and the maximum message size will be "max_msg_size". Throws on error and if the queue was previously created. </para></description></constructor>
  900. <constructor><parameter name="open_or_create"><paramtype><classname>open_or_create_t</classname></paramtype></parameter><parameter name="name"><paramtype>const char *</paramtype></parameter><parameter name="max_num_msg"><paramtype>size_type</paramtype></parameter><parameter name="max_msg_size"><paramtype>size_type</paramtype></parameter><parameter name="perm"><paramtype>const <classname>permissions</classname> &amp;</paramtype><default><classname alt="boost::interprocess::permissions">permissions</classname>()</default></parameter><description><para>Opens or creates a process shared message queue with name "name". If the queue is created, the maximum number of messages will be "max_num_msg" and the maximum message size will be "max_msg_size". If queue was previously created the queue will be opened and "max_num_msg" and "max_msg_size" parameters are ignored. Throws on error. </para></description></constructor>
  901. <constructor><parameter name="open_only"><paramtype><classname>open_only_t</classname></paramtype></parameter><parameter name="name"><paramtype>const char *</paramtype></parameter><description><para>Opens a previously created process shared message queue with name "name". If the queue was not previously created or there are no free resources, throws an error. </para></description></constructor>
  902. <destructor><description><para>Destroys *this and indicates that the calling process is finished using the resource. All opened message queues are still valid after destruction. The destructor function will deallocate any system resources allocated by the system for use by this process for this resource. The resource can still be opened again calling the open constructor overload. To erase the message queue from the system use remove(). </para></description></destructor>
  903. <method-group name="public static functions">
  904. <method name="remove" specifiers="static"><type>bool</type><parameter name="name"><paramtype>const char *</paramtype></parameter><description><para>Removes the message queue from the system. Returns false on error. Never throws </para></description></method>
  905. </method-group>
  906. </class><typedef name="message_queue"><description><para>Typedef for a default message queue to be used between processes </para></description><type><classname>message_queue_t</classname>&lt; <classname>offset_ptr</classname>&lt; void &gt; &gt;</type></typedef>
  907. </namespace>
  908. </namespace>
  909. </header>
  910. <header name="boost/interprocess/managed_external_buffer.hpp">
  911. <para>Describes a named user memory allocation user class. </para><namespace name="boost">
  912. <namespace name="interprocess">
  913. <class name="basic_managed_external_buffer"><template>
  914. <template-type-parameter name="CharType"/>
  915. <template-type-parameter name="AllocationAlgorithm"/>
  916. <template-nontype-parameter name="IndexType"><type>template&lt; class IndexConfig &gt; class</type></template-nontype-parameter>
  917. </template><description><para>A basic user memory named object creation class. Inherits all basic functionality from basic_managed_memory_impl&lt;CharType, AllocationAlgorithm, IndexType&gt; </para></description><typedef name="size_type"><type>base_t::size_type</type></typedef>
  918. <method-group name="public member functions">
  919. <method name="grow"><type>void</type><parameter name="extra_bytes"><paramtype>size_type</paramtype></parameter></method>
  920. <method name="swap"><type>void</type><parameter name="other"><paramtype><classname>basic_managed_external_buffer</classname> &amp;</paramtype></parameter><description><para>Swaps the ownership of the managed heap memories managed by *this and other. Never throws. </para></description></method>
  921. </method-group>
  922. <constructor><description><para>Default constructor. Does nothing. Useful in combination with move semantics </para></description></constructor>
  923. <constructor><parameter name=""><paramtype><classname>create_only_t</classname></paramtype></parameter><parameter name="addr"><paramtype>void *</paramtype></parameter><parameter name="size"><paramtype>size_type</paramtype></parameter><purpose>Creates and places the segment manager. This can throw. </purpose></constructor>
  924. <constructor><parameter name=""><paramtype><classname>open_only_t</classname></paramtype></parameter><parameter name="addr"><paramtype>void *</paramtype></parameter><parameter name="size"><paramtype>size_type</paramtype></parameter><purpose>Creates and places the segment manager. This can throw. </purpose></constructor>
  925. <constructor><parameter name="moved"><paramtype><classname>basic_managed_external_buffer</classname> &amp;&amp;</paramtype></parameter><purpose>Moves the ownership of "moved"'s managed memory to *this. Does not throw. </purpose></constructor>
  926. <copy-assignment><type><classname>basic_managed_external_buffer</classname> &amp;</type><parameter name="moved"><paramtype><classname>basic_managed_external_buffer</classname> &amp;&amp;</paramtype></parameter><purpose>Moves the ownership of "moved"'s managed memory to *this. Does not throw. </purpose></copy-assignment>
  927. </class><typedef name="managed_external_buffer"><description><para>Typedef for a default <classname alt="boost::interprocess::basic_managed_external_buffer">basic_managed_external_buffer</classname> of narrow characters </para></description><type><classname>basic_managed_external_buffer</classname>&lt; char,<classname>rbtree_best_fit</classname>&lt; <classname>null_mutex_family</classname> &gt;,<classname>iset_index</classname> &gt;</type></typedef>
  928. <typedef name="wmanaged_external_buffer"><description><para>Typedef for a default <classname alt="boost::interprocess::basic_managed_external_buffer">basic_managed_external_buffer</classname> of wide characters </para></description><type><classname>basic_managed_external_buffer</classname>&lt; wchar_t,<classname>rbtree_best_fit</classname>&lt; <classname>null_mutex_family</classname> &gt;,<classname>iset_index</classname> &gt;</type></typedef>
  929. </namespace>
  930. </namespace>
  931. </header>
  932. <header name="boost/interprocess/managed_heap_memory.hpp">
  933. <para>Describes a named heap memory allocation user class. </para><namespace name="boost">
  934. <namespace name="interprocess">
  935. <class name="basic_managed_heap_memory"><template>
  936. <template-type-parameter name="CharType"/>
  937. <template-type-parameter name="AllocationAlgorithm"/>
  938. <template-nontype-parameter name="IndexType"><type>template&lt; class IndexConfig &gt; class</type></template-nontype-parameter>
  939. </template><description><para>A basic heap memory named object creation class. Initializes the heap memory segment. Inherits all basic functionality from basic_managed_memory_impl&lt;CharType, AllocationAlgorithm, IndexType&gt; </para></description><typedef name="size_type"><type>base_t::size_type</type></typedef>
  940. <method-group name="public member functions">
  941. <method name="grow"><type>bool</type><parameter name="extra_bytes"><paramtype>size_type</paramtype></parameter><description><para>Tries to resize internal heap memory so that we have room for more objects. WARNING: If memory is reallocated, all the objects will be binary-copied to the new buffer. To be able to use this function, all pointers constructed in this buffer must be offset pointers. Otherwise, the result is undefined. Returns true if the growth has been successful, so you will have some extra bytes to allocate new objects. If returns false, the heap allocation has failed. </para></description></method>
  942. <method name="swap"><type>void</type><parameter name="other"><paramtype><classname>basic_managed_heap_memory</classname> &amp;</paramtype></parameter><description><para>Swaps the ownership of the managed heap memories managed by *this and other. Never throws. </para></description></method>
  943. </method-group>
  944. <constructor><description><para>Default constructor. Does nothing. Useful in combination with move semantics </para></description></constructor>
  945. <destructor><description><para>Destructor. Liberates the heap memory holding the managed data. Never throws. </para></description></destructor>
  946. <constructor><parameter name="size"><paramtype>size_type</paramtype></parameter><description><para>Creates heap memory and initializes the segment manager. This can throw. </para></description></constructor>
  947. <constructor><parameter name="moved"><paramtype><classname>basic_managed_heap_memory</classname> &amp;&amp;</paramtype></parameter><purpose>Moves the ownership of "moved"'s managed memory to *this. Does not throw. </purpose></constructor>
  948. <copy-assignment><type><classname>basic_managed_heap_memory</classname> &amp;</type><parameter name="moved"><paramtype><classname>basic_managed_heap_memory</classname> &amp;&amp;</paramtype></parameter><purpose>Moves the ownership of "moved"'s managed memory to *this. Does not throw. </purpose></copy-assignment>
  949. </class><typedef name="managed_heap_memory"><description><para>Typedef for a default <classname alt="boost::interprocess::basic_managed_heap_memory">basic_managed_heap_memory</classname> of narrow characters </para></description><type><classname>basic_managed_heap_memory</classname>&lt; char,<classname>rbtree_best_fit</classname>&lt; <classname>null_mutex_family</classname> &gt;,<classname>iset_index</classname> &gt;</type></typedef>
  950. <typedef name="wmanaged_heap_memory"><description><para>Typedef for a default <classname alt="boost::interprocess::basic_managed_heap_memory">basic_managed_heap_memory</classname> of wide characters </para></description><type><classname>basic_managed_heap_memory</classname>&lt; wchar_t,<classname>rbtree_best_fit</classname>&lt; <classname>null_mutex_family</classname> &gt;,<classname>iset_index</classname> &gt;</type></typedef>
  951. </namespace>
  952. </namespace>
  953. </header>
  954. <header name="boost/interprocess/managed_mapped_file.hpp">
  955. <namespace name="boost">
  956. <namespace name="interprocess">
  957. <class name="basic_managed_mapped_file"><template>
  958. <template-type-parameter name="CharType"/>
  959. <template-type-parameter name="AllocationAlgorithm"/>
  960. <template-nontype-parameter name="IndexType"><type>template&lt; class IndexConfig &gt; class</type></template-nontype-parameter>
  961. </template><description><para>A basic mapped file named object creation class. Initializes the mapped file. Inherits all basic functionality from basic_managed_memory_impl&lt;CharType, AllocationAlgorithm, IndexType&gt; </para></description><typedef name="size_type"><description><para>Unsigned integral type enough to represent the size of a <classname alt="boost::interprocess::basic_managed_mapped_file">basic_managed_mapped_file</classname>. </para></description><type>implementation_defined</type></typedef>
  962. <method-group name="public member functions">
  963. <method name="swap"><type>void</type><parameter name="other"><paramtype><classname>basic_managed_mapped_file</classname> &amp;</paramtype></parameter><description><para>Swaps the ownership of the managed mapped memories managed by *this and other. Never throws. </para></description></method>
  964. <method name="flush"><type>bool</type><description><para>Flushes cached data to file. Never throws </para></description></method>
  965. </method-group>
  966. <constructor><description><para>Creates mapped file and creates and places the segment manager. This can throw. </para></description></constructor>
  967. <constructor><parameter name=""><paramtype><classname>create_only_t</classname></paramtype></parameter><parameter name="name"><paramtype>const char *</paramtype></parameter><parameter name="size"><paramtype>size_type</paramtype></parameter><parameter name="addr"><paramtype>const void *</paramtype><default>0</default></parameter><parameter name="perm"><paramtype>const <classname>permissions</classname> &amp;</paramtype><default><classname alt="boost::interprocess::permissions">permissions</classname>()</default></parameter><description><para>Creates mapped file and creates and places the segment manager. This can throw. </para></description></constructor>
  968. <constructor><parameter name=""><paramtype><classname>open_or_create_t</classname></paramtype></parameter><parameter name="name"><paramtype>const char *</paramtype></parameter><parameter name="size"><paramtype>size_type</paramtype></parameter><parameter name="addr"><paramtype>const void *</paramtype><default>0</default></parameter><parameter name="perm"><paramtype>const <classname>permissions</classname> &amp;</paramtype><default><classname alt="boost::interprocess::permissions">permissions</classname>()</default></parameter><description><para>Creates mapped file and creates and places the segment manager if segment was not created. If segment was created it connects to the segment. This can throw. </para></description></constructor>
  969. <constructor><parameter name=""><paramtype><classname>open_only_t</classname></paramtype></parameter><parameter name="name"><paramtype>const char *</paramtype></parameter><parameter name="addr"><paramtype>const void *</paramtype><default>0</default></parameter><description><para>Connects to a created mapped file and its segment manager. This can throw. </para></description></constructor>
  970. <constructor><parameter name=""><paramtype><classname>open_copy_on_write_t</classname></paramtype></parameter><parameter name="name"><paramtype>const char *</paramtype></parameter><parameter name="addr"><paramtype>const void *</paramtype><default>0</default></parameter><description><para>Connects to a created mapped file and its segment manager in copy_on_write mode. This can throw. </para></description></constructor>
  971. <constructor><parameter name=""><paramtype><classname>open_read_only_t</classname></paramtype></parameter><parameter name="name"><paramtype>const char *</paramtype></parameter><parameter name="addr"><paramtype>const void *</paramtype><default>0</default></parameter><description><para>Connects to a created mapped file and its segment manager in read-only mode. This can throw. </para></description></constructor>
  972. <constructor><parameter name="moved"><paramtype><classname>basic_managed_mapped_file</classname> &amp;&amp;</paramtype></parameter><description><para>Moves the ownership of "moved"'s managed memory to *this. Does not throw </para></description></constructor>
  973. <copy-assignment><type><classname>basic_managed_mapped_file</classname> &amp;</type><parameter name="moved"><paramtype><classname>basic_managed_mapped_file</classname> &amp;&amp;</paramtype></parameter><description><para>Moves the ownership of "moved"'s managed memory to *this. Does not throw </para></description></copy-assignment>
  974. <destructor><description><para>Destroys *this and indicates that the calling process is finished using the resource. The destructor function will deallocate any system resources allocated by the system for use by this process for this resource. The resource can still be opened again calling the open constructor overload. To erase the resource from the system use remove(). </para></description></destructor>
  975. <method-group name="public static functions">
  976. <method name="grow" specifiers="static"><type>bool</type><parameter name="filename"><paramtype>const char *</paramtype></parameter><parameter name="extra_bytes"><paramtype>size_type</paramtype></parameter><description><para>Tries to resize mapped file so that we have room for more objects.</para><para>This function is not synchronized so no other thread or process should be reading or writing the file </para></description></method>
  977. <method name="shrink_to_fit" specifiers="static"><type>bool</type><parameter name="filename"><paramtype>const char *</paramtype></parameter><description><para>Tries to resize mapped file to minimized the size of the file.</para><para>This function is not synchronized so no other thread or process should be reading or writing the file </para></description></method>
  978. </method-group>
  979. </class><typedef name="managed_mapped_file"><description><para>Typedef for a default <classname alt="boost::interprocess::basic_managed_mapped_file">basic_managed_mapped_file</classname> of narrow characters </para></description><type><classname>basic_managed_mapped_file</classname>&lt; char,<classname>rbtree_best_fit</classname>&lt; <classname>mutex_family</classname> &gt;,<classname>iset_index</classname> &gt;</type></typedef>
  980. <typedef name="wmanaged_mapped_file"><description><para>Typedef for a default <classname alt="boost::interprocess::basic_managed_mapped_file">basic_managed_mapped_file</classname> of wide characters </para></description><type><classname>basic_managed_mapped_file</classname>&lt; wchar_t,<classname>rbtree_best_fit</classname>&lt; <classname>mutex_family</classname> &gt;,<classname>iset_index</classname> &gt;</type></typedef>
  981. </namespace>
  982. </namespace>
  983. </header>
  984. <header name="boost/interprocess/managed_shared_memory.hpp">
  985. <namespace name="boost">
  986. <namespace name="interprocess">
  987. <class name="basic_managed_shared_memory"><template>
  988. <template-type-parameter name="CharType"/>
  989. <template-type-parameter name="AllocationAlgorithm"/>
  990. <template-nontype-parameter name="IndexType"><type>template&lt; class IndexConfig &gt; class</type></template-nontype-parameter>
  991. </template><description><para>A basic shared memory named object creation class. Initializes the shared memory segment. Inherits all basic functionality from basic_managed_memory_impl&lt;CharType, AllocationAlgorithm, IndexType&gt; </para></description><method-group name="public member functions">
  992. <method name="swap"><type>void</type><parameter name="other"><paramtype><classname>basic_managed_shared_memory</classname> &amp;</paramtype></parameter><description><para>Swaps the ownership of the managed shared memories managed by *this and other. Never throws. </para></description></method>
  993. </method-group>
  994. <destructor><description><para>Destroys *this and indicates that the calling process is finished using the resource. The destructor function will deallocate any system resources allocated by the system for use by this process for this resource. The resource can still be opened again calling the open constructor overload. To erase the resource from the system use remove(). </para></description></destructor>
  995. <constructor><description><para>Default constructor. Does nothing. Useful in combination with move semantics </para></description></constructor>
  996. <constructor><parameter name=""><paramtype><classname>create_only_t</classname></paramtype></parameter><parameter name="name"><paramtype>const char *</paramtype></parameter><parameter name="size"><paramtype>size_type</paramtype></parameter><parameter name="addr"><paramtype>const void *</paramtype><default>0</default></parameter><parameter name="perm"><paramtype>const <classname>permissions</classname> &amp;</paramtype><default><classname alt="boost::interprocess::permissions">permissions</classname>()</default></parameter><description><para>Creates shared memory and creates and places the segment manager. This can throw. </para></description></constructor>
  997. <constructor><parameter name=""><paramtype><classname>open_or_create_t</classname></paramtype></parameter><parameter name="name"><paramtype>const char *</paramtype></parameter><parameter name="size"><paramtype>size_type</paramtype></parameter><parameter name="addr"><paramtype>const void *</paramtype><default>0</default></parameter><parameter name="perm"><paramtype>const <classname>permissions</classname> &amp;</paramtype><default><classname alt="boost::interprocess::permissions">permissions</classname>()</default></parameter><description><para>Creates shared memory and creates and places the segment manager if segment was not created. If segment was created it connects to the segment. This can throw. </para></description></constructor>
  998. <constructor><parameter name=""><paramtype><classname>open_copy_on_write_t</classname></paramtype></parameter><parameter name="name"><paramtype>const char *</paramtype></parameter><parameter name="addr"><paramtype>const void *</paramtype><default>0</default></parameter><description><para>Connects to a created shared memory and its segment manager. in copy_on_write mode. This can throw. </para></description></constructor>
  999. <constructor><parameter name=""><paramtype><classname>open_read_only_t</classname></paramtype></parameter><parameter name="name"><paramtype>const char *</paramtype></parameter><parameter name="addr"><paramtype>const void *</paramtype><default>0</default></parameter><description><para>Connects to a created shared memory and its segment manager. in read-only mode. This can throw. </para></description></constructor>
  1000. <constructor><parameter name=""><paramtype><classname>open_only_t</classname></paramtype></parameter><parameter name="name"><paramtype>const char *</paramtype></parameter><parameter name="addr"><paramtype>const void *</paramtype><default>0</default></parameter><description><para>Connects to a created shared memory and its segment manager. This can throw. </para></description></constructor>
  1001. <constructor><parameter name="moved"><paramtype><classname>basic_managed_shared_memory</classname> &amp;&amp;</paramtype></parameter><description><para>Moves the ownership of "moved"'s managed memory to *this. Does not throw </para></description></constructor>
  1002. <copy-assignment><type><classname>basic_managed_shared_memory</classname> &amp;</type><parameter name="moved"><paramtype><classname>basic_managed_shared_memory</classname> &amp;&amp;</paramtype></parameter><description><para>Moves the ownership of "moved"'s managed memory to *this. Does not throw </para></description></copy-assignment>
  1003. <method-group name="public static functions">
  1004. <method name="grow" specifiers="static"><type>bool</type><parameter name="shmname"><paramtype>const char *</paramtype></parameter><parameter name="extra_bytes"><paramtype>size_type</paramtype></parameter><description><para>Tries to resize the managed shared memory object so that we have room for more objects.</para><para>This function is not synchronized so no other thread or process should be reading or writing the file </para></description></method>
  1005. <method name="shrink_to_fit" specifiers="static"><type>bool</type><parameter name="shmname"><paramtype>const char *</paramtype></parameter><description><para>Tries to resize the managed shared memory to minimized the size of the file.</para><para>This function is not synchronized so no other thread or process should be reading or writing the file </para></description></method>
  1006. </method-group>
  1007. </class><typedef name="managed_shared_memory"><description><para>Typedef for a default <classname alt="boost::interprocess::basic_managed_shared_memory">basic_managed_shared_memory</classname> of narrow characters </para></description><type><classname>basic_managed_shared_memory</classname>&lt; char,<classname>rbtree_best_fit</classname>&lt; <classname>mutex_family</classname> &gt;,<classname>iset_index</classname> &gt;</type></typedef>
  1008. <typedef name="wmanaged_shared_memory"><description><para>Typedef for a default <classname alt="boost::interprocess::basic_managed_shared_memory">basic_managed_shared_memory</classname> of wide characters </para></description><type><classname>basic_managed_shared_memory</classname>&lt; wchar_t,<classname>rbtree_best_fit</classname>&lt; <classname>mutex_family</classname> &gt;,<classname>iset_index</classname> &gt;</type></typedef>
  1009. <typedef name="fixed_managed_shared_memory"><description><para>Typedef for a default <classname alt="boost::interprocess::basic_managed_shared_memory">basic_managed_shared_memory</classname> of narrow characters to be placed in a fixed address </para></description><type><classname>basic_managed_shared_memory</classname>&lt; char,<classname>rbtree_best_fit</classname>&lt; <classname>mutex_family</classname>, void * &gt;,<classname>iset_index</classname> &gt;</type></typedef>
  1010. <typedef name="wfixed_managed_shared_memory"><description><para>Typedef for a default <classname alt="boost::interprocess::basic_managed_shared_memory">basic_managed_shared_memory</classname> of narrow characters to be placed in a fixed address </para></description><type><classname>basic_managed_shared_memory</classname>&lt; wchar_t,<classname>rbtree_best_fit</classname>&lt; <classname>mutex_family</classname>, void * &gt;,<classname>iset_index</classname> &gt;</type></typedef>
  1011. </namespace>
  1012. </namespace>
  1013. </header>
  1014. <header name="boost/interprocess/managed_windows_shared_memory.hpp">
  1015. <namespace name="boost">
  1016. <namespace name="interprocess">
  1017. <class name="basic_managed_windows_shared_memory"><template>
  1018. <template-type-parameter name="CharType"/>
  1019. <template-type-parameter name="AllocationAlgorithm"/>
  1020. <template-nontype-parameter name="IndexType"><type>template&lt; class IndexConfig &gt; class</type></template-nontype-parameter>
  1021. </template><description><para>A basic managed windows shared memory creation class. Initializes the shared memory segment. Inherits all basic functionality from basic_managed_memory_impl&lt;CharType, AllocationAlgorithm, IndexType&gt; Unlike <classname alt="boost::interprocess::basic_managed_shared_memory">basic_managed_shared_memory</classname>, it has no kernel persistence and the shared memory is destroyed when all processes destroy all their <classname alt="boost::interprocess::windows_shared_memory">windows_shared_memory</classname> objects and mapped regions for the same shared memory or the processes end/crash.</para><para>Warning: <classname alt="boost::interprocess::basic_managed_windows_shared_memory">basic_managed_windows_shared_memory</classname> and <classname alt="boost::interprocess::basic_managed_shared_memory">basic_managed_shared_memory</classname> can't communicate between them. </para></description><typedef name="size_type"><type>base_t::size_type</type></typedef>
  1022. <method-group name="public member functions">
  1023. <method name="swap"><type>void</type><parameter name="other"><paramtype><classname>basic_managed_windows_shared_memory</classname> &amp;</paramtype></parameter><description><para>Swaps the ownership of the managed mapped memories managed by *this and other. Never throws. </para></description></method>
  1024. </method-group>
  1025. <constructor><description><para>Default constructor. Does nothing. Useful in combination with move semantics </para></description></constructor>
  1026. <constructor><parameter name=""><paramtype><classname>create_only_t</classname></paramtype></parameter><parameter name="name"><paramtype>const char *</paramtype></parameter><parameter name="size"><paramtype>size_type</paramtype></parameter><parameter name="addr"><paramtype>const void *</paramtype><default>0</default></parameter><parameter name="perm"><paramtype>const <classname>permissions</classname> &amp;</paramtype><default><classname alt="boost::interprocess::permissions">permissions</classname>()</default></parameter><description><para>Creates shared memory and creates and places the segment manager. This can throw. </para></description></constructor>
  1027. <constructor><parameter name=""><paramtype><classname>open_or_create_t</classname></paramtype></parameter><parameter name="name"><paramtype>const char *</paramtype></parameter><parameter name="size"><paramtype>size_type</paramtype></parameter><parameter name="addr"><paramtype>const void *</paramtype><default>0</default></parameter><parameter name="perm"><paramtype>const <classname>permissions</classname> &amp;</paramtype><default><classname alt="boost::interprocess::permissions">permissions</classname>()</default></parameter><description><para>Creates shared memory and creates and places the segment manager if segment was not created. If segment was created it connects to the segment. This can throw. </para></description></constructor>
  1028. <constructor><parameter name=""><paramtype><classname>open_only_t</classname></paramtype></parameter><parameter name="name"><paramtype>const char *</paramtype></parameter><parameter name="addr"><paramtype>const void *</paramtype><default>0</default></parameter><description><para>Connects to a created shared memory and its segment manager. This can throw. </para></description></constructor>
  1029. <constructor><parameter name=""><paramtype><classname>open_copy_on_write_t</classname></paramtype></parameter><parameter name="name"><paramtype>const char *</paramtype></parameter><parameter name="addr"><paramtype>const void *</paramtype><default>0</default></parameter><description><para>Connects to a created shared memory and its segment manager in copy_on_write mode. This can throw. </para></description></constructor>
  1030. <constructor><parameter name=""><paramtype><classname>open_read_only_t</classname></paramtype></parameter><parameter name="name"><paramtype>const char *</paramtype></parameter><parameter name="addr"><paramtype>const void *</paramtype><default>0</default></parameter><description><para>Connects to a created shared memory and its segment manager in read-only mode. This can throw. </para></description></constructor>
  1031. <constructor><parameter name="moved"><paramtype><classname>basic_managed_windows_shared_memory</classname> &amp;&amp;</paramtype></parameter><description><para>Moves the ownership of "moved"'s managed memory to *this. Does not throw </para></description></constructor>
  1032. <copy-assignment><type><classname>basic_managed_windows_shared_memory</classname> &amp;</type><parameter name="moved"><paramtype><classname>basic_managed_windows_shared_memory</classname> &amp;&amp;</paramtype></parameter><description><para>Moves the ownership of "moved"'s managed memory to *this. Does not throw </para></description></copy-assignment>
  1033. <destructor><description><para>Destroys *this and indicates that the calling process is finished using the resource. All mapped regions are still valid after destruction. When all mapped regions and <classname alt="boost::interprocess::basic_managed_windows_shared_memory">basic_managed_windows_shared_memory</classname> objects referring the shared memory are destroyed, the operating system will destroy the shared memory. </para></description></destructor>
  1034. </class><typedef name="managed_windows_shared_memory"><description><para>Typedef for a default <classname alt="boost::interprocess::basic_managed_windows_shared_memory">basic_managed_windows_shared_memory</classname> of narrow characters </para></description><type><classname>basic_managed_windows_shared_memory</classname>&lt; char,<classname>rbtree_best_fit</classname>&lt; <classname>mutex_family</classname> &gt;,<classname>iset_index</classname> &gt;</type></typedef>
  1035. <typedef name="wmanaged_windows_shared_memory"><description><para>Typedef for a default <classname alt="boost::interprocess::basic_managed_windows_shared_memory">basic_managed_windows_shared_memory</classname> of wide characters </para></description><type><classname>basic_managed_windows_shared_memory</classname>&lt; wchar_t,<classname>rbtree_best_fit</classname>&lt; <classname>mutex_family</classname> &gt;,<classname>iset_index</classname> &gt;</type></typedef>
  1036. </namespace>
  1037. </namespace>
  1038. </header>
  1039. <header name="boost/interprocess/managed_xsi_shared_memory.hpp">
  1040. <namespace name="boost">
  1041. <namespace name="interprocess">
  1042. <class name="basic_managed_xsi_shared_memory"><template>
  1043. <template-type-parameter name="CharType"/>
  1044. <template-type-parameter name="AllocationAlgorithm"/>
  1045. <template-nontype-parameter name="IndexType"><type>template&lt; class IndexConfig &gt; class</type></template-nontype-parameter>
  1046. </template><description><para>A basic X/Open System Interface (XSI) shared memory named object creation class. Initializes the shared memory segment. Inherits all basic functionality from basic_managed_memory_impl&lt;CharType, AllocationAlgorithm, IndexType&gt; </para></description><typedef name="size_type"><type>base_t::size_type</type></typedef>
  1047. <method-group name="public member functions">
  1048. <method name="swap"><type>void</type><parameter name="other"><paramtype><classname>basic_managed_xsi_shared_memory</classname> &amp;</paramtype></parameter><description><para>Swaps the ownership of the managed shared memories managed by *this and other. Never throws. </para></description></method>
  1049. <method name="get_shmid" cv="const"><type>int</type></method>
  1050. </method-group>
  1051. <destructor><description><para>Destroys *this and indicates that the calling process is finished using the resource. The destructor function will deallocate any system resources allocated by the system for use by this process for this resource. The resource can still be opened again calling the open constructor overload. To erase the resource from the system use remove(). </para></description></destructor>
  1052. <constructor><description><para>Default constructor. Does nothing. Useful in combination with move semantics </para></description></constructor>
  1053. <constructor><parameter name=""><paramtype><classname>create_only_t</classname></paramtype></parameter><parameter name="key"><paramtype>const <classname>xsi_key</classname> &amp;</paramtype></parameter><parameter name="size"><paramtype>std::size_t</paramtype></parameter><parameter name="addr"><paramtype>const void *</paramtype><default>0</default></parameter><parameter name="perm"><paramtype>const <classname>permissions</classname> &amp;</paramtype><default><classname alt="boost::interprocess::permissions">permissions</classname>()</default></parameter><description><para>Creates shared memory and creates and places the segment manager. This can throw. </para></description></constructor>
  1054. <constructor><parameter name=""><paramtype><classname>open_or_create_t</classname></paramtype></parameter><parameter name="key"><paramtype>const <classname>xsi_key</classname> &amp;</paramtype></parameter><parameter name="size"><paramtype>std::size_t</paramtype></parameter><parameter name="addr"><paramtype>const void *</paramtype><default>0</default></parameter><parameter name="perm"><paramtype>const <classname>permissions</classname> &amp;</paramtype><default><classname alt="boost::interprocess::permissions">permissions</classname>()</default></parameter><description><para>Creates shared memory and creates and places the segment manager if segment was not created. If segment was created it connects to the segment. This can throw. </para></description></constructor>
  1055. <constructor><parameter name=""><paramtype><classname>open_read_only_t</classname></paramtype></parameter><parameter name="key"><paramtype>const <classname>xsi_key</classname> &amp;</paramtype></parameter><parameter name="addr"><paramtype>const void *</paramtype><default>0</default></parameter><description><para>Connects to a created shared memory and its segment manager. in read-only mode. This can throw. </para></description></constructor>
  1056. <constructor><parameter name=""><paramtype><classname>open_only_t</classname></paramtype></parameter><parameter name="key"><paramtype>const <classname>xsi_key</classname> &amp;</paramtype></parameter><parameter name="addr"><paramtype>const void *</paramtype><default>0</default></parameter><description><para>Connects to a created shared memory and its segment manager. This can throw. </para></description></constructor>
  1057. <constructor><parameter name="moved"><paramtype><classname>basic_managed_xsi_shared_memory</classname> &amp;&amp;</paramtype></parameter><description><para>Moves the ownership of "moved"'s managed memory to *this. Does not throw </para></description></constructor>
  1058. <copy-assignment><type><classname>basic_managed_xsi_shared_memory</classname> &amp;</type><parameter name="moved"><paramtype><classname>basic_managed_xsi_shared_memory</classname> &amp;&amp;</paramtype></parameter><description><para>Moves the ownership of "moved"'s managed memory to *this. Does not throw </para></description></copy-assignment>
  1059. <method-group name="public static functions">
  1060. <method name="remove" specifiers="static"><type>bool</type><parameter name="shmid"><paramtype>int</paramtype></parameter><description><para>Erases a XSI shared memory object identified by shmid from the system. Returns false on error. Never throws </para></description></method>
  1061. </method-group>
  1062. </class><typedef name="managed_xsi_shared_memory"><description><para>Typedef for a default <classname alt="boost::interprocess::basic_managed_xsi_shared_memory">basic_managed_xsi_shared_memory</classname> of narrow characters </para></description><type><classname>basic_managed_xsi_shared_memory</classname>&lt; char,<classname>rbtree_best_fit</classname>&lt; <classname>mutex_family</classname> &gt;,<classname>iset_index</classname> &gt;</type></typedef>
  1063. <typedef name="wmanaged_xsi_shared_memory"><description><para>Typedef for a default <classname alt="boost::interprocess::basic_managed_xsi_shared_memory">basic_managed_xsi_shared_memory</classname> of wide characters </para></description><type><classname>basic_managed_xsi_shared_memory</classname>&lt; wchar_t,<classname>rbtree_best_fit</classname>&lt; <classname>mutex_family</classname> &gt;,<classname>iset_index</classname> &gt;</type></typedef>
  1064. </namespace>
  1065. </namespace>
  1066. </header>
  1067. <header name="boost/interprocess/mapped_region.hpp">
  1068. <para>Describes mapped region class </para><namespace name="boost">
  1069. <namespace name="interprocess">
  1070. <class name="mapped_region"><description><para>The <classname alt="boost::interprocess::mapped_region">mapped_region</classname> class represents a portion or region created from a memory_mappable object.</para><para>The OS can map a region bigger than the requested one, as region must be multiple of the page size, but <classname alt="boost::interprocess::mapped_region">mapped_region</classname> will always refer to the region specified by the user. </para></description><enum name="advice_types"><enumvalue name="advice_normal"><description><para>Specifies that the application has no advice to give on its behavior with respect to the region. It is the default characteristic if no advice is given for a range of memory. </para></description></enumvalue><enumvalue name="advice_sequential"><description><para>Specifies that the application expects to access the region sequentially from lower addresses to higher addresses. The implementation can lower the priority of preceding pages within the region once a page have been accessed. </para></description></enumvalue><enumvalue name="advice_random"><description><para>Specifies that the application expects to access the region in a random order, and prefetching is likely not advantageous. </para></description></enumvalue><enumvalue name="advice_willneed"><description><para>Specifies that the application expects to access the region in the near future. The implementation can prefetch pages of the region. </para></description></enumvalue><enumvalue name="advice_dontneed"><description><para>Specifies that the application expects that it will not access the region in the near future. The implementation can unload pages within the range to save system resources. </para></description></enumvalue><description><para>This enum specifies region usage behaviors that an application can specify to the mapped region implementation. </para></description></enum>
  1071. <method-group name="public member functions">
  1072. <method name="swap"><type>void</type><parameter name="other"><paramtype><classname>mapped_region</classname> &amp;</paramtype></parameter><description><para>Swaps the <classname alt="boost::interprocess::mapped_region">mapped_region</classname> with another mapped region </para></description></method>
  1073. <method name="get_size" cv="const"><type>std::size_t</type><purpose>Returns the size of the mapping. Never throws. </purpose></method>
  1074. <method name="get_address" cv="const"><type>void *</type><description><para>Returns the base address of the mapping. Never throws. </para></description></method>
  1075. <method name="get_mode" cv="const"><type>mode_t</type><description><para>Returns the mode of the mapping used to construct the mapped region. Never throws. </para></description></method>
  1076. <method name="flush"><type>bool</type><parameter name="mapping_offset"><paramtype>std::size_t</paramtype><default>0</default></parameter><parameter name="numbytes"><paramtype>std::size_t</paramtype><default>0</default></parameter><parameter name="async"><paramtype>bool</paramtype><default>true</default></parameter><description><para>Flushes to the disk a byte range within the mapped memory. If 'async' is true, the function will return before flushing operation is completed If 'async' is false, function will return once data has been written into the underlying device (i.e., in mapped files OS cached information is written to disk). Never throws. Returns false if operation could not be performed. </para></description></method>
  1077. <method name="shrink_by"><type>bool</type><parameter name="bytes"><paramtype>std::size_t</paramtype></parameter><parameter name="from_back"><paramtype>bool</paramtype><default>true</default></parameter><description><para>Shrinks current mapped region. If after shrinking there is no longer need for a previously mapped memory page, accessing that page can trigger a segmentation fault. Depending on the OS, this operation might fail (XSI shared memory), it can decommit storage and free a portion of the virtual address space (e.g.POSIX) or this function can release some physical memory wihout freeing any virtual address space(Windows). Returns true on success. Never throws. </para></description></method>
  1078. <method name="advise"><type>bool</type><parameter name="advise"><paramtype>advice_types</paramtype></parameter><description><para>Advises the implementation on the expected behavior of the application with respect to the data in the region. The implementation may use this information to optimize handling of the region data. This function has no effect on the semantics of access to memory in the region, although it may affect the performance of access. If the advise type is not known to the implementation, the function returns false. True otherwise. </para></description></method>
  1079. </method-group>
  1080. <constructor><template>
  1081. <template-type-parameter name="MemoryMappable"/>
  1082. </template><parameter name="mapping"><paramtype>const MemoryMappable &amp;</paramtype></parameter><parameter name="mode"><paramtype>mode_t</paramtype></parameter><parameter name="offset"><paramtype>offset_t</paramtype><default>0</default></parameter><parameter name="size"><paramtype>std::size_t</paramtype><default>0</default></parameter><parameter name="address"><paramtype>const void *</paramtype><default>0</default></parameter><parameter name="map_options"><paramtype>map_options_t</paramtype><default>default_map_options</default></parameter><description><para>Creates a mapping region of the mapped memory "mapping", starting in offset "offset", and the mapping's size will be "size". The mapping can be opened for read only, read-write or copy-on-write.</para><para>If an address is specified, both the offset and the address must be multiples of the page size.</para><para>The map is created using "default_map_options". This flag is OS dependant and it should not be changed unless the user needs to specify special options.</para><para>In Windows systems "map_options" is a DWORD value passed as "dwDesiredAccess" to "MapViewOfFileEx". If "default_map_options" is passed it's initialized to zero. "map_options" is XORed with FILE_MAP_[COPY|READ|WRITE].</para><para>In UNIX systems and POSIX mappings "map_options" is an int value passed as "flags" to "mmap". If "default_map_options" is specified it's initialized to MAP_NOSYNC if that option exists and to zero otherwise. "map_options" XORed with MAP_PRIVATE or MAP_SHARED.</para><para>In UNIX systems and XSI mappings "map_options" is an int value passed as "shmflg" to "shmat". If "default_map_options" is specified it's initialized to zero. "map_options" is XORed with SHM_RDONLY if needed.</para><para>The OS could allocate more pages than size/page_size(), but get_address() will always return the address passed in this function (if not null) and get_size() will return the specified size. </para></description></constructor>
  1083. <constructor><description><para>Default constructor. Address will be 0 (nullptr). Size will be 0. Does not throw </para></description></constructor>
  1084. <constructor><parameter name="other"><paramtype><classname>mapped_region</classname> &amp;&amp;</paramtype></parameter><description><para>Move constructor. *this will be constructed taking ownership of "other"'s region and "other" will be left in default constructor state. </para></description></constructor>
  1085. <destructor><description><para>Destroys the mapped region. Does not throw </para></description></destructor>
  1086. <copy-assignment><type><classname>mapped_region</classname> &amp;</type><parameter name="other"><paramtype><classname>mapped_region</classname> &amp;&amp;</paramtype></parameter><description><para>Move assignment. If *this owns a memory mapped region, it will be destroyed and it will take ownership of "other"'s memory mapped region. </para></description></copy-assignment>
  1087. <method-group name="public static functions">
  1088. <method name="get_page_size" specifiers="static"><type>std::size_t</type><description><para>Returns the size of the page. This size is the minimum memory that will be used by the system when mapping a memory mappable source and will restrict the address and the offset to map. </para></description></method>
  1089. </method-group>
  1090. </class>
  1091. </namespace>
  1092. </namespace>
  1093. </header>
  1094. <header name="boost/interprocess/mem_algo/rbtree_best_fit.hpp">
  1095. <para>Describes a best-fit algorithm based in an intrusive red-black tree used to allocate objects in shared memory. This class is intended as a base class for single segment and multi-segment implementations. </para><namespace name="boost">
  1096. <namespace name="interprocess">
  1097. <class name="rbtree_best_fit"><template>
  1098. <template-type-parameter name="MutexFamily"/>
  1099. <template-type-parameter name="VoidPointer"/>
  1100. <template-nontype-parameter name="MemAlignment"><type>std::size_t</type></template-nontype-parameter>
  1101. </template><description><para>This class implements an algorithm that stores the free nodes in a red-black tree to have logarithmic search/insert times. </para></description><typedef name="mutex_family"><purpose>Shared mutex family used for the rest of the Interprocess framework. </purpose><type>MutexFamily</type></typedef>
  1102. <typedef name="void_pointer"><purpose>Pointer type to be used with the rest of the Interprocess framework. </purpose><type>VoidPointer</type></typedef>
  1103. <typedef name="multiallocation_chain"><type><emphasis>unspecified</emphasis></type></typedef>
  1104. <typedef name="difference_type"><type>boost::intrusive::pointer_traits&lt; char_ptr &gt;::difference_type</type></typedef>
  1105. <typedef name="size_type"><type>boost::container::dtl::make_unsigned&lt; difference_type &gt;::type</type></typedef>
  1106. <data-member name="PayloadPerAllocation" specifiers="static"><type>const size_type</type></data-member>
  1107. <method-group name="public member functions">
  1108. <method name="allocate"><type>void *</type><parameter name="nbytes"><paramtype>size_type</paramtype></parameter><purpose>Allocates bytes, returns 0 if there is not more memory. </purpose></method>
  1109. <method name="deallocate"><type>void</type><parameter name="addr"><paramtype>void *</paramtype></parameter><purpose>Deallocates previously allocated bytes. </purpose></method>
  1110. <method name="get_size" cv="const"><type>size_type</type><purpose>Returns the size of the memory segment. </purpose></method>
  1111. <method name="get_free_memory" cv="const"><type>size_type</type><purpose>Returns the number of free bytes of the segment. </purpose></method>
  1112. <method name="zero_free_memory"><type>void</type><description><para>Initializes to zero all the memory that's not in use. This function is normally used for security reasons. </para></description></method>
  1113. <method name="grow"><type>void</type><parameter name="extra_size"><paramtype>size_type</paramtype></parameter><description><para>Increases managed memory in extra_size bytes more </para></description></method>
  1114. <method name="shrink_to_fit"><type>void</type><purpose>Decreases managed memory as much as possible. </purpose></method>
  1115. <method name="all_memory_deallocated"><type>bool</type><purpose>Returns true if all allocated memory has been deallocated. </purpose></method>
  1116. <method name="check_sanity"><type>bool</type><description><para>Makes an internal sanity check and returns true if success </para></description></method>
  1117. <method name="allocation_command"><type>T *</type><template>
  1118. <template-type-parameter name="T"/>
  1119. </template><parameter name="command"><paramtype>boost::interprocess::allocation_type</paramtype></parameter><parameter name="limit_size"><paramtype>size_type</paramtype></parameter><parameter name="prefer_in_recvd_out_size"><paramtype>size_type &amp;</paramtype></parameter><parameter name="reuse"><paramtype>T *&amp;</paramtype></parameter></method>
  1120. <method name="raw_allocation_command"><type>void *</type><parameter name="command"><paramtype>boost::interprocess::allocation_type</paramtype></parameter><parameter name="limit_object"><paramtype>size_type</paramtype></parameter><parameter name="prefer_in_recvd_out_size"><paramtype>size_type &amp;</paramtype></parameter><parameter name="reuse_ptr"><paramtype>void *&amp;</paramtype></parameter><parameter name="sizeof_object"><paramtype>size_type</paramtype><default>1</default></parameter></method>
  1121. <method name="size" cv="const"><type>size_type</type><parameter name="ptr"><paramtype>const void *</paramtype></parameter><purpose>Returns the size of the buffer previously allocated pointed by ptr. </purpose></method>
  1122. <method name="allocate_aligned"><type>void *</type><parameter name="nbytes"><paramtype>size_type</paramtype></parameter><parameter name="alignment"><paramtype>size_type</paramtype></parameter><description><para>Allocates aligned bytes, returns 0 if there is not more memory. Alignment must be power of 2 </para></description></method>
  1123. </method-group>
  1124. <constructor><parameter name="size"><paramtype>size_type</paramtype></parameter><parameter name="extra_hdr_bytes"><paramtype>size_type</paramtype></parameter><description><para>Constructor. "size" is the total size of the managed memory segment, "extra_hdr_bytes" indicates the extra bytes beginning in the sizeof(rbtree_best_fit) offset that the allocator should not use at all. </para></description></constructor>
  1125. <destructor><purpose>Destructor. </purpose></destructor>
  1126. <method-group name="public static functions">
  1127. <method name="get_min_size" specifiers="static"><type>size_type</type><parameter name="extra_hdr_bytes"><paramtype>size_type</paramtype></parameter><purpose>Obtains the minimum size needed by the algorithm. </purpose></method>
  1128. </method-group>
  1129. </class>
  1130. </namespace>
  1131. </namespace>
  1132. </header>
  1133. <header name="boost/interprocess/mem_algo/simple_seq_fit.hpp">
  1134. <para>Describes sequential fit algorithm used to allocate objects in shared memory. </para><namespace name="boost">
  1135. <namespace name="interprocess">
  1136. <class name="simple_seq_fit"><template>
  1137. <template-type-parameter name="MutexFamily"/>
  1138. <template-type-parameter name="VoidPointer"/>
  1139. </template><description><para>This class implements the simple sequential fit algorithm with a simply linked list of free buffers. </para></description><typedef name="size_type"><type>base_t::size_type</type></typedef>
  1140. <method-group name="public member functions">
  1141. </method-group>
  1142. <constructor><parameter name="segment_size"><paramtype>size_type</paramtype></parameter><parameter name="extra_hdr_bytes"><paramtype>size_type</paramtype></parameter><description><para>Constructor. "size" is the total size of the managed memory segment, "extra_hdr_bytes" indicates the extra bytes beginning in the sizeof(simple_seq_fit) offset that the allocator should not use at all. </para></description></constructor>
  1143. </class>
  1144. </namespace>
  1145. </namespace>
  1146. </header>
  1147. <header name="boost/interprocess/offset_ptr.hpp">
  1148. <para>Describes a smart pointer that stores the offset between this pointer and target pointee, called offset_ptr. </para><namespace name="boost">
  1149. <namespace name="interprocess">
  1150. <class name="offset_ptr"><template>
  1151. <template-type-parameter name="PointedType"><purpose><para>The type of the pointee. </para></purpose></template-type-parameter>
  1152. <template-type-parameter name="DifferenceType"><purpose><para>A signed integer type that can represent the arithmetic operations on the pointer </para></purpose></template-type-parameter>
  1153. <template-type-parameter name="OffsetType"><purpose><para>An unsigned integer type that can represent the distance between two pointers reinterpret_cast-ed as unsigned integers. This type should be at least of the same size of std::uintptr_t. In some systems it's possible to communicate between 32 and 64 bit processes using 64 bit offsets. </para></purpose></template-type-parameter>
  1154. <template-nontype-parameter name="OffsetAlignment"><type>std::size_t</type><purpose><para>Alignment of the OffsetType stored inside. In some systems might be necessary to align it to 64 bits in order to communicate 32 and 64 bit processes using 64 bit offsets.</para></purpose></template-nontype-parameter>
  1155. </template><description><para>A smart pointer that stores the offset between between the pointer and the the object it points. This allows offset allows special properties, since the pointer is independent from the address of the pointee, if the pointer and the pointee are still separated by the same offset. This feature converts <classname alt="boost::interprocess::offset_ptr">offset_ptr</classname> in a smart pointer that can be placed in shared memory and memory mapped files mapped in different addresses in every process.</para><para>
  1156. b&gt;Note: <classname alt="boost::interprocess::offset_ptr">offset_ptr</classname> uses implementation defined properties, present in most platforms, for performance reasons:<itemizedlist>
  1157. <listitem><para>Assumes that OffsetType representation of nullptr is (OffsetType)zero.</para>
  1158. </listitem><listitem><para>Assumes that incrementing a OffsetType obtained from a pointer is equivalent to incrementing the pointer and then converting it back to OffsetType. </para>
  1159. </listitem></itemizedlist>
  1160. </para></description><typedef name="element_type"><type>PointedType</type></typedef>
  1161. <typedef name="pointer"><type>PointedType *</type></typedef>
  1162. <typedef name="reference"><type><emphasis>unspecified</emphasis></type></typedef>
  1163. <typedef name="value_type"><type><emphasis>unspecified</emphasis></type></typedef>
  1164. <typedef name="difference_type"><type>DifferenceType</type></typedef>
  1165. <typedef name="iterator_category"><type>std::random_access_iterator_tag</type></typedef>
  1166. <typedef name="offset_type"><type>OffsetType</type></typedef>
  1167. <typedef name="rebind"><description><para>Compatibility with pointer_traits </para></description><type><classname>offset_ptr</classname>&lt; U, DifferenceType, OffsetType, OffsetAlignment &gt;</type></typedef>
  1168. <method-group name="public member functions">
  1169. <method name="get" cv="const noexcept"><type>pointer</type><description><para>Obtains raw pointer from offset. Never throws. </para></description></method>
  1170. <method name="get_offset" cv="const noexcept"><type>offset_type</type></method>
  1171. <method name="operator-&gt;" cv="const noexcept"><type>pointer</type><description><para>Pointer-like -&gt; operator. It can return 0 pointer. Never throws. </para></description></method>
  1172. <method name="operator *" cv="const noexcept"><type>reference</type><description><para>Dereferencing operator, if it is a null <classname alt="boost::interprocess::offset_ptr">offset_ptr</classname> behavior is undefined. Never throws. </para></description></method>
  1173. <method name="operator[]" cv="const noexcept"><type>reference</type><parameter name="idx"><paramtype>difference_type</paramtype></parameter><description><para>Indexing operator. Never throws. </para></description></method>
  1174. <method name="operator+=" cv="noexcept"><type><classname>offset_ptr</classname> &amp;</type><parameter name="offset"><paramtype>difference_type</paramtype></parameter><description><para><classname alt="boost::interprocess::offset_ptr">offset_ptr</classname> += difference_type. Never throws. </para></description></method>
  1175. <method name="operator-=" cv="noexcept"><type><classname>offset_ptr</classname> &amp;</type><parameter name="offset"><paramtype>difference_type</paramtype></parameter><description><para><classname alt="boost::interprocess::offset_ptr">offset_ptr</classname> -= difference_type. Never throws. </para></description></method>
  1176. <method name="operator++" cv="noexcept"><type><classname>offset_ptr</classname> &amp;</type><parameter name=""><paramtype>void</paramtype></parameter><description><para>++<classname alt="boost::interprocess::offset_ptr">offset_ptr</classname>. Never throws. </para></description></method>
  1177. <method name="operator++" cv="noexcept"><type><classname>offset_ptr</classname></type><parameter name=""><paramtype>int</paramtype></parameter><description><para>offset_ptr++. Never throws. </para></description></method>
  1178. <method name="operator--" cv="noexcept"><type><classname>offset_ptr</classname> &amp;</type><parameter name=""><paramtype>void</paramtype></parameter><description><para>–<classname alt="boost::interprocess::offset_ptr">offset_ptr</classname>. Never throws. </para></description></method>
  1179. <method name="operator--" cv="noexcept"><type><classname>offset_ptr</classname></type><parameter name=""><paramtype>int</paramtype></parameter><description><para><classname alt="boost::interprocess::offset_ptr">offset_ptr</classname>–. Never throws. </para></description></method>
  1180. <method name="conversion-operator" cv="const noexcept" specifiers="explicit"><type>bool</type><description><para>safe bool conversion operator. Never throws. </para></description></method>
  1181. <method name="operator!" cv="const noexcept"><type>bool</type><description><para>Not operator. Not needed in theory, but improves portability. Never throws </para></description></method>
  1182. </method-group>
  1183. <constructor cv="noexcept"><description><para>Default constructor (null pointer). Never throws. </para></description></constructor>
  1184. <constructor cv="noexcept"><parameter name="ptr"><paramtype>pointer</paramtype></parameter><description><para>Constructor from raw pointer (allows "0" pointer conversion). Never throws. </para></description></constructor>
  1185. <constructor cv="noexcept"><template>
  1186. <template-type-parameter name="T"/>
  1187. </template><parameter name="ptr"><paramtype>T *</paramtype></parameter><parameter name=""><paramtype><emphasis>unspecified</emphasis></paramtype><default>0</default></parameter><description><para>Constructor from other pointer. Never throws. </para></description></constructor>
  1188. <constructor cv="noexcept"><parameter name="ptr"><paramtype>const <classname>offset_ptr</classname> &amp;</paramtype></parameter><description><para>Constructor from other <classname alt="boost::interprocess::offset_ptr">offset_ptr</classname> Never throws. </para></description></constructor>
  1189. <constructor cv="noexcept"><template>
  1190. <template-type-parameter name="T2"/>
  1191. </template><parameter name="ptr"><paramtype>const <classname>offset_ptr</classname>&lt; T2, DifferenceType, OffsetType, OffsetAlignment &gt; &amp;</paramtype></parameter><description><para>Constructor from other <classname alt="boost::interprocess::offset_ptr">offset_ptr</classname>. Only takes part in overload resolution if T2* is convertible to PointedType*. Never throws. </para></description></constructor>
  1192. <constructor specifiers="explicit" cv="noexcept"><template>
  1193. <template-type-parameter name="T2"/>
  1194. </template><parameter name="ptr"><paramtype>const <classname>offset_ptr</classname>&lt; T2, DifferenceType, OffsetType, OffsetAlignment &gt; &amp;</paramtype></parameter><description><para>Constructor from other <classname alt="boost::interprocess::offset_ptr">offset_ptr</classname>. Only takes part in overload resolution if PointedType* is constructible from T2* other than via a conversion (e.g. cast to a derived class). Never throws. </para></description></constructor>
  1195. <constructor cv="noexcept"><template>
  1196. <template-type-parameter name="T2"/>
  1197. <template-type-parameter name="P2"/>
  1198. <template-type-parameter name="O2"/>
  1199. <template-nontype-parameter name="A2"><type>std::size_t</type></template-nontype-parameter>
  1200. </template><parameter name="r"><paramtype>const <classname>offset_ptr</classname>&lt; T2, P2, O2, A2 &gt; &amp;</paramtype></parameter><parameter name=""><paramtype><emphasis>unspecified</emphasis></paramtype></parameter><description><para>Emulates static_cast operator. Never throws. </para></description></constructor>
  1201. <constructor cv="noexcept"><template>
  1202. <template-type-parameter name="T2"/>
  1203. <template-type-parameter name="P2"/>
  1204. <template-type-parameter name="O2"/>
  1205. <template-nontype-parameter name="A2"><type>std::size_t</type></template-nontype-parameter>
  1206. </template><parameter name="r"><paramtype>const <classname>offset_ptr</classname>&lt; T2, P2, O2, A2 &gt; &amp;</paramtype></parameter><parameter name=""><paramtype><emphasis>unspecified</emphasis></paramtype></parameter><description><para>Emulates const_cast operator. Never throws. </para></description></constructor>
  1207. <constructor cv="noexcept"><template>
  1208. <template-type-parameter name="T2"/>
  1209. <template-type-parameter name="P2"/>
  1210. <template-type-parameter name="O2"/>
  1211. <template-nontype-parameter name="A2"><type>std::size_t</type></template-nontype-parameter>
  1212. </template><parameter name="r"><paramtype>const <classname>offset_ptr</classname>&lt; T2, P2, O2, A2 &gt; &amp;</paramtype></parameter><parameter name=""><paramtype><emphasis>unspecified</emphasis></paramtype></parameter><description><para>Emulates dynamic_cast operator. Never throws. </para></description></constructor>
  1213. <constructor cv="noexcept"><template>
  1214. <template-type-parameter name="T2"/>
  1215. <template-type-parameter name="P2"/>
  1216. <template-type-parameter name="O2"/>
  1217. <template-nontype-parameter name="A2"><type>std::size_t</type></template-nontype-parameter>
  1218. </template><parameter name="r"><paramtype>const <classname>offset_ptr</classname>&lt; T2, P2, O2, A2 &gt; &amp;</paramtype></parameter><parameter name=""><paramtype><emphasis>unspecified</emphasis></paramtype></parameter><description><para>Emulates reinterpret_cast operator. Never throws. </para></description></constructor>
  1219. <copy-assignment cv="noexcept"><type><classname>offset_ptr</classname> &amp;</type><parameter name="from"><paramtype>pointer</paramtype></parameter><description><para>Assignment from pointer (saves extra conversion). Never throws. </para></description></copy-assignment>
  1220. <copy-assignment cv="noexcept"><type><classname>offset_ptr</classname> &amp;</type><parameter name="ptr"><paramtype>const <classname>offset_ptr</classname> &amp;</paramtype></parameter><description><para>Assignment from other <classname alt="boost::interprocess::offset_ptr">offset_ptr</classname>. Never throws. </para></description></copy-assignment>
  1221. <copy-assignment cv="noexcept"><type><classname>offset_ptr</classname> &amp;</type><template>
  1222. <template-type-parameter name="T2"/>
  1223. </template><parameter name="ptr"><paramtype>const <classname>offset_ptr</classname>&lt; T2, DifferenceType, OffsetType, OffsetAlignment &gt; &amp;</paramtype></parameter><description><para>Assignment from related <classname alt="boost::interprocess::offset_ptr">offset_ptr</classname>. If pointers of pointee types are assignable, offset_ptrs will be assignable. Never throws. </para></description></copy-assignment>
  1224. <method-group name="public static functions">
  1225. <method name="pointer_to" cv="noexcept" specifiers="static"><type><classname>offset_ptr</classname></type><parameter name="r"><paramtype>reference</paramtype></parameter><description><para>Compatibility with pointer_traits </para></description></method>
  1226. </method-group>
  1227. <method-group name="friend functions">
  1228. <method name="operator+" cv="noexcept"><type>friend <classname>offset_ptr</classname></type><parameter name="diff"><paramtype>difference_type</paramtype></parameter><parameter name="right"><paramtype><classname>offset_ptr</classname></paramtype></parameter><description><para>difference_type + <classname alt="boost::interprocess::offset_ptr">offset_ptr</classname> operation </para></description></method>
  1229. <method name="operator+" cv="noexcept"><type>friend <classname>offset_ptr</classname></type><parameter name="left"><paramtype><classname>offset_ptr</classname></paramtype></parameter><parameter name="diff"><paramtype>difference_type</paramtype></parameter><description><para><classname alt="boost::interprocess::offset_ptr">offset_ptr</classname> + difference_type operation </para></description></method>
  1230. <method name="operator-" cv="noexcept"><type>friend <classname>offset_ptr</classname></type><parameter name="left"><paramtype><classname>offset_ptr</classname></paramtype></parameter><parameter name="diff"><paramtype>difference_type</paramtype></parameter><description><para><classname alt="boost::interprocess::offset_ptr">offset_ptr</classname> - diff operation </para></description></method>
  1231. <method name="operator-" cv="noexcept"><type>friend <classname>offset_ptr</classname></type><parameter name="diff"><paramtype>difference_type</paramtype></parameter><parameter name="right"><paramtype><classname>offset_ptr</classname></paramtype></parameter><description><para><classname alt="boost::interprocess::offset_ptr">offset_ptr</classname> - diff operation </para></description></method>
  1232. <method name="operator-" cv="noexcept"><type>friend difference_type</type><parameter name="pt"><paramtype>const <classname>offset_ptr</classname> &amp;</paramtype></parameter><parameter name="pt2"><paramtype>const <classname>offset_ptr</classname> &amp;</paramtype></parameter><description><para><classname alt="boost::interprocess::offset_ptr">offset_ptr</classname> - <classname alt="boost::interprocess::offset_ptr">offset_ptr</classname> operation </para></description></method>
  1233. </method-group>
  1234. <method-group name="private member functions">
  1235. <method name="assign" cv="noexcept"><type>void</type><template>
  1236. <template-type-parameter name="T2"/>
  1237. </template><parameter name="ptr"><paramtype>const <classname>offset_ptr</classname>&lt; T2, DifferenceType, OffsetType, OffsetAlignment &gt; &amp;</paramtype></parameter><parameter name=""><paramtype><emphasis>unspecified</emphasis></paramtype></parameter></method>
  1238. <method name="assign" cv="noexcept"><type>void</type><template>
  1239. <template-type-parameter name="T2"/>
  1240. </template><parameter name="ptr"><paramtype>const <classname>offset_ptr</classname>&lt; T2, DifferenceType, OffsetType, OffsetAlignment &gt; &amp;</paramtype></parameter><parameter name=""><paramtype><emphasis>unspecified</emphasis></paramtype></parameter></method>
  1241. </method-group>
  1242. </class><function name="operator&lt;&lt;"><type>std::basic_ostream&lt; E, T &gt; &amp;</type><template>
  1243. <template-type-parameter name="E"/>
  1244. <template-type-parameter name="T"/>
  1245. <template-type-parameter name="W"/>
  1246. <template-type-parameter name="X"/>
  1247. <template-type-parameter name="Y"/>
  1248. <template-nontype-parameter name="Z"><type>std::size_t</type></template-nontype-parameter>
  1249. </template><parameter name="os"><paramtype>std::basic_ostream&lt; E, T &gt; &amp;</paramtype></parameter><parameter name="p"><paramtype><classname>offset_ptr</classname>&lt; W, X, Y, Z &gt; const &amp;</paramtype></parameter><description><para>operator&lt;&lt; for offset ptr </para></description></function>
  1250. <function name="operator&gt;&gt;"><type>std::basic_istream&lt; E, T &gt; &amp;</type><template>
  1251. <template-type-parameter name="E"/>
  1252. <template-type-parameter name="T"/>
  1253. <template-type-parameter name="W"/>
  1254. <template-type-parameter name="X"/>
  1255. <template-type-parameter name="Y"/>
  1256. <template-nontype-parameter name="Z"><type>std::size_t</type></template-nontype-parameter>
  1257. </template><parameter name="is"><paramtype>std::basic_istream&lt; E, T &gt; &amp;</paramtype></parameter><parameter name="p"><paramtype><classname>offset_ptr</classname>&lt; W, X, Y, Z &gt; &amp;</paramtype></parameter><description><para>operator&gt;&gt; for offset ptr </para></description></function>
  1258. <function name="static_pointer_cast"><type><classname>boost::interprocess::offset_ptr</classname>&lt; T1, P1, O1, A1 &gt;</type><template>
  1259. <template-type-parameter name="T1"/>
  1260. <template-type-parameter name="P1"/>
  1261. <template-type-parameter name="O1"/>
  1262. <template-nontype-parameter name="A1"><type>std::size_t</type></template-nontype-parameter>
  1263. <template-type-parameter name="T2"/>
  1264. <template-type-parameter name="P2"/>
  1265. <template-type-parameter name="O2"/>
  1266. <template-nontype-parameter name="A2"><type>std::size_t</type></template-nontype-parameter>
  1267. </template><parameter name="r"><paramtype>const <classname>boost::interprocess::offset_ptr</classname>&lt; T2, P2, O2, A2 &gt; &amp;</paramtype></parameter><purpose>Simulation of static_cast between pointers. Never throws. </purpose></function>
  1268. <function name="const_pointer_cast"><type><classname>boost::interprocess::offset_ptr</classname>&lt; T1, P1, O1, A1 &gt;</type><template>
  1269. <template-type-parameter name="T1"/>
  1270. <template-type-parameter name="P1"/>
  1271. <template-type-parameter name="O1"/>
  1272. <template-nontype-parameter name="A1"><type>std::size_t</type></template-nontype-parameter>
  1273. <template-type-parameter name="T2"/>
  1274. <template-type-parameter name="P2"/>
  1275. <template-type-parameter name="O2"/>
  1276. <template-nontype-parameter name="A2"><type>std::size_t</type></template-nontype-parameter>
  1277. </template><parameter name="r"><paramtype>const <classname>boost::interprocess::offset_ptr</classname>&lt; T2, P2, O2, A2 &gt; &amp;</paramtype></parameter><purpose>Simulation of const_cast between pointers. Never throws. </purpose></function>
  1278. <function name="dynamic_pointer_cast"><type><classname>boost::interprocess::offset_ptr</classname>&lt; T1, P1, O1, A1 &gt;</type><template>
  1279. <template-type-parameter name="T1"/>
  1280. <template-type-parameter name="P1"/>
  1281. <template-type-parameter name="O1"/>
  1282. <template-nontype-parameter name="A1"><type>std::size_t</type></template-nontype-parameter>
  1283. <template-type-parameter name="T2"/>
  1284. <template-type-parameter name="P2"/>
  1285. <template-type-parameter name="O2"/>
  1286. <template-nontype-parameter name="A2"><type>std::size_t</type></template-nontype-parameter>
  1287. </template><parameter name="r"><paramtype>const <classname>boost::interprocess::offset_ptr</classname>&lt; T2, P2, O2, A2 &gt; &amp;</paramtype></parameter><purpose>Simulation of dynamic_cast between pointers. Never throws. </purpose></function>
  1288. <function name="reinterpret_pointer_cast"><type><classname>boost::interprocess::offset_ptr</classname>&lt; T1, P1, O1, A1 &gt;</type><template>
  1289. <template-type-parameter name="T1"/>
  1290. <template-type-parameter name="P1"/>
  1291. <template-type-parameter name="O1"/>
  1292. <template-nontype-parameter name="A1"><type>std::size_t</type></template-nontype-parameter>
  1293. <template-type-parameter name="T2"/>
  1294. <template-type-parameter name="P2"/>
  1295. <template-type-parameter name="O2"/>
  1296. <template-nontype-parameter name="A2"><type>std::size_t</type></template-nontype-parameter>
  1297. </template><parameter name="r"><paramtype>const <classname>boost::interprocess::offset_ptr</classname>&lt; T2, P2, O2, A2 &gt; &amp;</paramtype></parameter><purpose>Simulation of reinterpret_cast between pointers. Never throws. </purpose></function>
  1298. </namespace>
  1299. </namespace>
  1300. </header>
  1301. <header name="boost/interprocess/permissions.hpp">
  1302. <para>Describes permissions class </para><namespace name="boost">
  1303. <namespace name="interprocess">
  1304. <class name="permissions"><description><para>The permissions class represents permissions to be set to shared memory or files, that can be constructed form usual permission representations: a SECURITY_ATTRIBUTES pointer in windows or ORed rwx chmod integer in UNIX. </para></description><method-group name="public member functions">
  1305. <method name="set_default"><type>void</type><description><para>Sets permissions to default values: A null security attributes pointer for windows or 0644 for UNIX. </para></description></method>
  1306. <method name="set_unrestricted"><type>void</type><description><para>Sets permissions to unrestricted access: A null DACL for windows or 0666 for UNIX. </para></description></method>
  1307. <method name="set_permissions"><type>void</type><parameter name="perm"><paramtype>os_permissions_type</paramtype></parameter><description><para>Sets permissions from a user provided os-dependent permissions. </para></description></method>
  1308. <method name="get_permissions" cv="const"><type>os_permissions_type</type><description><para>Returns stored os-dependent permissions </para></description></method>
  1309. </method-group>
  1310. <constructor><parameter name="type"><paramtype>os_permissions_type</paramtype></parameter><description><para>Constructs a permissions object from a user provided os-dependent permissions. </para></description></constructor>
  1311. <constructor><description><para>Constructs a default permissions object: A null security attributes pointer for windows or 0644 for UNIX. </para></description></constructor>
  1312. </class>
  1313. </namespace>
  1314. </namespace>
  1315. </header>
  1316. <header name="boost/interprocess/segment_manager.hpp">
  1317. <para>Describes the object placed in a memory segment that provides named object allocation capabilities for single-segment and multi-segment allocations. </para><namespace name="boost">
  1318. <namespace name="interprocess">
  1319. <class name="segment_manager"><template>
  1320. <template-type-parameter name="CharType"/>
  1321. <template-type-parameter name="MemoryAlgorithm"/>
  1322. <template-nontype-parameter name="IndexType"><type>template&lt; class IndexConfig &gt; class</type></template-nontype-parameter>
  1323. </template><inherit access="public">boost::interprocess::segment_manager_base&lt; MemoryAlgorithm &gt;</inherit><description><para>This object is placed in the beginning of memory segment and implements the allocation (named or anonymous) of portions of the segment. This object contains two indexes that maintain an association between a name and a portion of the segment.</para><para>The first index contains the mappings for normal named objects using the char type specified in the template parameter.</para><para>The second index contains the association for unique instances. The key will be the const char * returned from type_info.name() function for the unique type to be constructed.</para><para>segment_manager&lt;CharType, MemoryAlgorithm, IndexType&gt; inherits publicly from segment_manager_base&lt;MemoryAlgorithm&gt; and inherits from it many public functions related to anonymous object and raw memory allocation. See <classname alt="boost::interprocess::segment_manager_base">segment_manager_base</classname> reference to know about those functions. </para></description><struct name="allocator"><template>
  1324. <template-type-parameter name="T"/>
  1325. </template><description><para>This is the default allocator to allocate types T from this managed segment </para></description><typedef name="type"><type><classname>boost::interprocess::allocator</classname>&lt; T, <classname>segment_manager</classname> &gt;</type></typedef>
  1326. </struct><struct name="deleter"><template>
  1327. <template-type-parameter name="T"/>
  1328. </template><description><para>This is the default deleter to delete types T from this managed segment. </para></description><typedef name="type"><type><classname>boost::interprocess::deleter</classname>&lt; T, <classname>segment_manager</classname> &gt;</type></typedef>
  1329. </struct><typedef name="memory_algorithm"><type>MemoryAlgorithm</type></typedef>
  1330. <typedef name="void_pointer"><type>segment_manager_base_t::void_pointer</type></typedef>
  1331. <typedef name="size_type"><type>segment_manager_base_t::size_type</type></typedef>
  1332. <typedef name="difference_type"><type>segment_manager_base_t::difference_type</type></typedef>
  1333. <typedef name="char_type"><type>CharType</type></typedef>
  1334. <typedef name="segment_manager_base_type"><type><classname>segment_manager_base</classname>&lt; MemoryAlgorithm &gt;</type></typedef>
  1335. <typedef name="mutex_family"><type>segment_manager_base_t::mutex_family</type></typedef>
  1336. <typedef name="const_named_iterator"><type>transform_iterator&lt; typename named_index_t::const_iterator, named_transform &gt;</type></typedef>
  1337. <typedef name="const_unique_iterator"><type>transform_iterator&lt; typename unique_index_t::const_iterator, unique_transform &gt;</type></typedef>
  1338. <data-member name="PayloadPerAllocation" specifiers="static"><type>const size_type</type></data-member>
  1339. <method-group name="public member functions">
  1340. <method name="find"><type>std::pair&lt; T *, size_type &gt;</type><template>
  1341. <template-type-parameter name="T"/>
  1342. </template><parameter name="name"><paramtype>char_ptr_holder_t</paramtype></parameter><description><para>Tries to find a previous named/unique allocation. Returns the address and the object count. On failure the first member of the returned pair is 0. </para></description></method>
  1343. <method name="find_no_lock"><type>std::pair&lt; T *, size_type &gt;</type><template>
  1344. <template-type-parameter name="T"/>
  1345. </template><parameter name="name"><paramtype>char_ptr_holder_t</paramtype></parameter><description><para>Tries to find a previous named/unique allocation. Returns the address and the object count. On failure the first member of the returned pair is 0. This search is not mutex-protected! Use it only inside atomic_func() calls, where the internal mutex is guaranteed to be locked. </para></description></method>
  1346. <method name="construct"><type>construct_proxy&lt; T &gt;::type</type><template>
  1347. <template-type-parameter name="T"/>
  1348. </template><parameter name="name"><paramtype>char_ptr_holder_t</paramtype></parameter><description><para>Returns throwing "construct" proxy object </para></description></method>
  1349. <method name="find_or_construct"><type>construct_proxy&lt; T &gt;::type</type><template>
  1350. <template-type-parameter name="T"/>
  1351. </template><parameter name="name"><paramtype>char_ptr_holder_t</paramtype></parameter><description><para>Returns throwing "search or construct" proxy object </para></description></method>
  1352. <method name="construct"><type>construct_proxy&lt; T &gt;::type</type><template>
  1353. <template-type-parameter name="T"/>
  1354. </template><parameter name="name"><paramtype>char_ptr_holder_t</paramtype></parameter><parameter name=""><paramtype>const std::nothrow_t &amp;</paramtype></parameter><description><para>Returns no throwing "construct" proxy object </para></description></method>
  1355. <method name="find_or_construct"><type>construct_proxy&lt; T &gt;::type</type><template>
  1356. <template-type-parameter name="T"/>
  1357. </template><parameter name="name"><paramtype>char_ptr_holder_t</paramtype></parameter><parameter name=""><paramtype>const std::nothrow_t &amp;</paramtype></parameter><description><para>Returns no throwing "search or construct" proxy object </para></description></method>
  1358. <method name="construct_it"><type>construct_iter_proxy&lt; T &gt;::type</type><template>
  1359. <template-type-parameter name="T"/>
  1360. </template><parameter name="name"><paramtype>char_ptr_holder_t</paramtype></parameter><purpose>Returns throwing "construct from iterators" proxy object. </purpose></method>
  1361. <method name="find_or_construct_it"><type>construct_iter_proxy&lt; T &gt;::type</type><template>
  1362. <template-type-parameter name="T"/>
  1363. </template><parameter name="name"><paramtype>char_ptr_holder_t</paramtype></parameter><description><para>Returns throwing "search or construct from iterators" proxy object </para></description></method>
  1364. <method name="construct_it"><type>construct_iter_proxy&lt; T &gt;::type</type><template>
  1365. <template-type-parameter name="T"/>
  1366. </template><parameter name="name"><paramtype>char_ptr_holder_t</paramtype></parameter><parameter name=""><paramtype>const std::nothrow_t &amp;</paramtype></parameter><description><para>Returns no throwing "construct from iterators" proxy object </para></description></method>
  1367. <method name="find_or_construct_it"><type>construct_iter_proxy&lt; T &gt;::type</type><template>
  1368. <template-type-parameter name="T"/>
  1369. </template><parameter name="name"><paramtype>char_ptr_holder_t</paramtype></parameter><parameter name=""><paramtype>const std::nothrow_t &amp;</paramtype></parameter><description><para>Returns no throwing "search or construct from iterators" proxy object </para></description></method>
  1370. <method name="atomic_func"><type>void</type><template>
  1371. <template-type-parameter name="Func"/>
  1372. </template><parameter name="f"><paramtype>Func &amp;</paramtype></parameter><description><para>Calls object function blocking recursive <classname alt="boost::interprocess::interprocess_mutex">interprocess_mutex</classname> and guarantees that no new named_alloc or destroy will be executed by any process while executing the object function call </para></description></method>
  1373. <method name="try_atomic_func"><type>bool</type><template>
  1374. <template-type-parameter name="Func"/>
  1375. </template><parameter name="f"><paramtype>Func &amp;</paramtype></parameter><description><para>Tries to calls a functor guaranteeing that no new construction, search or destruction will be executed by any process while executing the object function call. If the atomic function can't be immediatelly executed because the internal mutex is already locked, returns false. If the functor throws, this function throws. </para></description></method>
  1376. <method name="destroy"><type>bool</type><template>
  1377. <template-type-parameter name="T"/>
  1378. </template><parameter name="name"><paramtype>char_ptr_holder_t</paramtype></parameter><description><para>Destroys a previously created named/unique instance. Returns false if the object was not present. </para></description></method>
  1379. <method name="destroy_ptr"><type>void</type><template>
  1380. <template-type-parameter name="T"/>
  1381. </template><parameter name="p"><paramtype>const T *</paramtype></parameter><description><para>Destroys an anonymous, unique or named object using its address </para></description></method>
  1382. <method name="reserve_named_objects"><type>void</type><parameter name="num"><paramtype>size_type</paramtype></parameter><description><para>Preallocates needed index resources to optimize the creation of "num" named objects in the managed memory segment. Can throw <classname alt="boost::interprocess::bad_alloc">boost::interprocess::bad_alloc</classname> if there is no enough memory. </para></description></method>
  1383. <method name="reserve_unique_objects"><type>void</type><parameter name="num"><paramtype>size_type</paramtype></parameter><description><para>Preallocates needed index resources to optimize the creation of "num" unique objects in the managed memory segment. Can throw <classname alt="boost::interprocess::bad_alloc">boost::interprocess::bad_alloc</classname> if there is no enough memory. </para></description></method>
  1384. <method name="shrink_to_fit_indexes"><type>void</type><description><para>Calls shrink_to_fit in both named and unique object indexes to try to free unused memory from those indexes. </para></description></method>
  1385. <method name="get_num_named_objects"><type>size_type</type><description><para>Returns the number of named objects stored in the segment. </para></description></method>
  1386. <method name="get_num_unique_objects"><type>size_type</type><description><para>Returns the number of unique objects stored in the segment. </para></description></method>
  1387. <method name="named_begin" cv="const"><type>const_named_iterator</type><description><para>Returns a constant iterator to the beginning of the information about the named allocations performed in this segment manager </para></description></method>
  1388. <method name="named_end" cv="const"><type>const_named_iterator</type><description><para>Returns a constant iterator to the end of the information about the named allocations performed in this segment manager </para></description></method>
  1389. <method name="unique_begin" cv="const"><type>const_unique_iterator</type><description><para>Returns a constant iterator to the beginning of the information about the unique allocations performed in this segment manager </para></description></method>
  1390. <method name="unique_end" cv="const"><type>const_unique_iterator</type><description><para>Returns a constant iterator to the end of the information about the unique allocations performed in this segment manager </para></description></method>
  1391. <method name="get_allocator"><type><classname>allocator</classname>&lt; T &gt;::type</type><template>
  1392. <template-type-parameter name="T"/>
  1393. </template><description><para>Returns an instance of the default allocator for type T initialized that allocates memory from this segment manager. </para></description></method>
  1394. <method name="get_deleter"><type><classname>deleter</classname>&lt; T &gt;::type</type><template>
  1395. <template-type-parameter name="T"/>
  1396. </template><description><para>Returns an instance of the default deleter for type T that will delete an object constructed in this segment manager. </para></description></method>
  1397. </method-group>
  1398. <constructor specifiers="explicit"><parameter name="segment_size"><paramtype>size_type</paramtype></parameter><description><para>Constructor of the segment manager "size" is the size of the memory segment where the segment manager is being constructed. Can throw </para></description></constructor>
  1399. <method-group name="public static functions">
  1400. <method name="get_instance_name" specifiers="static"><type>const CharType *</type><template>
  1401. <template-type-parameter name="T"/>
  1402. </template><parameter name="ptr"><paramtype>const T *</paramtype></parameter><description><para>Returns the name of an object created with construct/find_or_construct functions. Does not throw </para></description></method>
  1403. <method name="get_instance_length" specifiers="static"><type>size_type</type><template>
  1404. <template-type-parameter name="T"/>
  1405. </template><parameter name="ptr"><paramtype>const T *</paramtype></parameter><description><para>Returns the length of an object created with construct/find_or_construct functions. Does not throw. </para></description></method>
  1406. <method name="get_instance_type" specifiers="static"><type>instance_type</type><template>
  1407. <template-type-parameter name="T"/>
  1408. </template><parameter name="ptr"><paramtype>const T *</paramtype></parameter><description><para>Returns is the the name of an object created with construct/find_or_construct functions. Does not throw </para></description></method>
  1409. <method name="get_min_size" specifiers="static"><type>size_type</type><description><para>Obtains the minimum size needed by the segment manager </para></description></method>
  1410. </method-group>
  1411. </class><class name="segment_manager_base"><template>
  1412. <template-type-parameter name="MemoryAlgorithm"/>
  1413. </template><inherit access="private">MemoryAlgorithm</inherit><description><para>This object is the public base class of segment manager. This class only depends on the memory allocation algorithm and implements all the allocation features not related to named or unique objects.</para><para>Storing a reference to <classname alt="boost::interprocess::segment_manager">segment_manager</classname> forces the holder class to be dependent on index types and character types. When such dependence is not desirable and only anonymous and raw allocations are needed, <classname alt="boost::interprocess::segment_manager_base">segment_manager_base</classname> is the correct answer. </para></description><typedef name="segment_manager_base_type"><type><classname>segment_manager_base</classname>&lt; MemoryAlgorithm &gt;</type></typedef>
  1414. <typedef name="void_pointer"><type>MemoryAlgorithm::void_pointer</type></typedef>
  1415. <typedef name="mutex_family"><type>MemoryAlgorithm::mutex_family</type></typedef>
  1416. <typedef name="memory_algorithm"><type>MemoryAlgorithm</type></typedef>
  1417. <data-member name="PayloadPerAllocation" specifiers="static"><type>const size_type</type><description><para>This constant indicates the payload size associated with each allocation of the memory algorithm </para></description></data-member>
  1418. <method-group name="public member functions">
  1419. <method name="get_size" cv="const"><type>size_type</type><description><para>Returns the size of the memory segment </para></description></method>
  1420. <method name="get_free_memory" cv="const"><type>size_type</type><description><para>Returns the number of free bytes of the memory segment </para></description></method>
  1421. <method name="allocate"><type>void *</type><parameter name="nbytes"><paramtype>size_type</paramtype></parameter><parameter name=""><paramtype>const std::nothrow_t &amp;</paramtype></parameter><description><para>Allocates nbytes bytes. This function is only used in single-segment management. Never throws </para></description></method>
  1422. <method name="allocate"><type>void *</type><parameter name="nbytes"><paramtype>size_type</paramtype></parameter><description><para>Allocates nbytes bytes. Throws <classname alt="boost::interprocess::bad_alloc">boost::interprocess::bad_alloc</classname> on failure </para></description></method>
  1423. <method name="allocate_aligned"><type>void *</type><parameter name="nbytes"><paramtype>size_type</paramtype></parameter><parameter name="alignment"><paramtype>size_type</paramtype></parameter><parameter name=""><paramtype>const std::nothrow_t &amp;</paramtype></parameter><description><para>Allocates nbytes bytes. This function is only used in single-segment management. Never throws </para></description></method>
  1424. <method name="allocate_aligned"><type>void *</type><parameter name="nbytes"><paramtype>size_type</paramtype></parameter><parameter name="alignment"><paramtype>size_type</paramtype></parameter><description><para>Allocates nbytes bytes. This function is only used in single-segment management. Throws <classname alt="boost::interprocess::bad_alloc">bad_alloc</classname> when fails </para></description></method>
  1425. <method name="deallocate"><type>void</type><parameter name="addr"><paramtype>void *</paramtype></parameter><description><para>Deallocates the bytes allocated with allocate/allocate_many() pointed by addr </para></description></method>
  1426. <method name="grow"><type>void</type><parameter name="extra_size"><paramtype>size_type</paramtype></parameter><description><para>Increases managed memory in extra_size bytes more. This only works with single-segment management. </para></description></method>
  1427. <method name="shrink_to_fit"><type>void</type><description><para>Decreases managed memory to the minimum. This only works with single-segment management. </para></description></method>
  1428. <method name="all_memory_deallocated"><type>bool</type><description><para>Returns the result of "all_memory_deallocated()" function of the used memory algorithm </para></description></method>
  1429. <method name="check_sanity"><type>bool</type><description><para>Returns the result of "check_sanity()" function of the used memory algorithm </para></description></method>
  1430. <method name="zero_free_memory"><type>void</type><description><para>Writes to zero free memory (memory not yet allocated) of the memory algorithm </para></description></method>
  1431. <method name="size" cv="const"><type>size_type</type><parameter name="ptr"><paramtype>const void *</paramtype></parameter><purpose>Returns the size of the buffer previously allocated pointed by ptr. </purpose></method>
  1432. </method-group>
  1433. <constructor><parameter name="sz"><paramtype>size_type</paramtype></parameter><parameter name="reserved_bytes"><paramtype>size_type</paramtype></parameter><description><para>Constructor of the <classname alt="boost::interprocess::segment_manager_base">segment_manager_base</classname></para><para>"size" is the size of the memory segment where the basic segment manager is being constructed.</para><para>"reserved_bytes" is the number of bytes after the end of the memory algorithm object itself that the memory algorithm will exclude from dynamic allocation</para><para>Can throw </para></description></constructor>
  1434. <method-group name="public static functions">
  1435. <method name="get_min_size" specifiers="static"><type>size_type</type><parameter name="size"><paramtype>size_type</paramtype></parameter><description><para>Obtains the minimum size needed by the segment manager </para></description></method>
  1436. </method-group>
  1437. </class>
  1438. </namespace>
  1439. </namespace>
  1440. </header>
  1441. <header name="boost/interprocess/shared_memory_object.hpp">
  1442. <para>Describes a shared memory object management class. </para><namespace name="boost">
  1443. <namespace name="interprocess">
  1444. <class name="shared_memory_object"><description><para>A class that wraps a shared memory mapping that can be used to create mapped regions from the mapped files </para></description><method-group name="public member functions">
  1445. <method name="swap"><type>void</type><parameter name="moved"><paramtype><classname>shared_memory_object</classname> &amp;</paramtype></parameter><purpose>Swaps the shared_memory_objects. Does not throw. </purpose></method>
  1446. <method name="truncate"><type>void</type><parameter name="length"><paramtype>offset_t</paramtype></parameter><purpose>Sets the size of the shared memory mapping. </purpose></method>
  1447. <method name="get_name" cv="const"><type>const char *</type><purpose>Returns the name of the shared memory object. </purpose></method>
  1448. <method name="get_size" cv="const"><type>bool</type><parameter name="size"><paramtype>offset_t &amp;</paramtype></parameter><description><para>Returns true if the size of the shared memory object can be obtained and writes the size in the passed reference </para></description></method>
  1449. <method name="get_mode" cv="const"><type>mode_t</type><purpose>Returns access mode. </purpose></method>
  1450. <method name="get_mapping_handle" cv="const"><type>mapping_handle_t</type><purpose>Returns mapping handle. Never throws. </purpose></method>
  1451. </method-group>
  1452. <constructor><purpose>Default constructor. Represents an empty <classname alt="boost::interprocess::shared_memory_object">shared_memory_object</classname>. </purpose></constructor>
  1453. <constructor><parameter name=""><paramtype><classname>create_only_t</classname></paramtype></parameter><parameter name="name"><paramtype>const char *</paramtype></parameter><parameter name="mode"><paramtype>mode_t</paramtype></parameter><parameter name="perm"><paramtype>const <classname>permissions</classname> &amp;</paramtype><default><classname alt="boost::interprocess::permissions">permissions</classname>()</default></parameter><description><para>Creates a shared memory object with name "name" and mode "mode", with the access mode "mode" If the file previously exists, throws an error. </para></description></constructor>
  1454. <constructor><parameter name=""><paramtype><classname>open_or_create_t</classname></paramtype></parameter><parameter name="name"><paramtype>const char *</paramtype></parameter><parameter name="mode"><paramtype>mode_t</paramtype></parameter><parameter name="perm"><paramtype>const <classname>permissions</classname> &amp;</paramtype><default><classname alt="boost::interprocess::permissions">permissions</classname>()</default></parameter><description><para>Tries to create a shared memory object with name "name" and mode "mode", with the access mode "mode". If the file previously exists, it tries to open it with mode "mode". Otherwise throws an error. </para></description></constructor>
  1455. <constructor><parameter name=""><paramtype><classname>open_only_t</classname></paramtype></parameter><parameter name="name"><paramtype>const char *</paramtype></parameter><parameter name="mode"><paramtype>mode_t</paramtype></parameter><description><para>Tries to open a shared memory object with name "name", with the access mode "mode". If the file does not previously exist, it throws an error. </para></description></constructor>
  1456. <constructor><parameter name="moved"><paramtype><classname>shared_memory_object</classname> &amp;&amp;</paramtype></parameter><description><para>Moves the ownership of "moved"'s shared memory object to *this. After the call, "moved" does not represent any shared memory object. Does not throw </para></description></constructor>
  1457. <copy-assignment><type><classname>shared_memory_object</classname> &amp;</type><parameter name="moved"><paramtype><classname>shared_memory_object</classname> &amp;&amp;</paramtype></parameter><description><para>Moves the ownership of "moved"'s shared memory to *this. After the call, "moved" does not represent any shared memory. Does not throw </para></description></copy-assignment>
  1458. <destructor><description><para>Destroys *this and indicates that the calling process is finished using the resource. All mapped regions are still valid after destruction. The destructor function will deallocate any system resources allocated by the system for use by this process for this resource. The resource can still be opened again calling the open constructor overload. To erase the resource from the system use remove(). </para></description></destructor>
  1459. <method-group name="public static functions">
  1460. <method name="remove" specifiers="static"><type>bool</type><parameter name="name"><paramtype>const char *</paramtype></parameter><description><para>Erases a shared memory object from the system. Returns false on error. Never throws </para></description></method>
  1461. </method-group>
  1462. </class>
  1463. </namespace>
  1464. </namespace>
  1465. </header>
  1466. <header name="boost/interprocess/smart_ptr/deleter.hpp">
  1467. <para>Describes the functor to delete objects from the segment. </para><namespace name="boost">
  1468. <namespace name="interprocess">
  1469. <class name="deleter"><template>
  1470. <template-type-parameter name="T"/>
  1471. <template-type-parameter name="SegmentManager"/>
  1472. </template><description><para>A deleter that uses the segment manager's destroy_ptr function to destroy the passed pointer resource.</para><para>This deleter is used </para></description><typedef name="pointer"><type>boost::intrusive::pointer_traits&lt; typename SegmentManager::void_pointer &gt;::template rebind_pointer&lt; T &gt;::type</type></typedef>
  1473. <method-group name="public member functions">
  1474. <method name="operator()"><type>void</type><parameter name="p"><paramtype>const pointer &amp;</paramtype></parameter></method>
  1475. </method-group>
  1476. <constructor><parameter name="pmngr"><paramtype>segment_manager_pointer</paramtype></parameter></constructor>
  1477. </class>
  1478. </namespace>
  1479. </namespace>
  1480. </header>
  1481. <header name="boost/interprocess/smart_ptr/enable_shared_from_this.hpp">
  1482. <para>Describes an utility to form a shared pointer from this </para><namespace name="boost">
  1483. <namespace name="interprocess">
  1484. </namespace>
  1485. </namespace>
  1486. </header>
  1487. <header name="boost/interprocess/smart_ptr/intrusive_ptr.hpp">
  1488. <para>Describes an intrusive ownership pointer. </para><namespace name="boost">
  1489. <namespace name="interprocess">
  1490. <class name="intrusive_ptr"><template>
  1491. <template-type-parameter name="T"/>
  1492. <template-type-parameter name="VoidPointer"/>
  1493. </template><description><para>The <classname alt="boost::interprocess::intrusive_ptr">intrusive_ptr</classname> class template stores a pointer to an object with an embedded reference count. <classname alt="boost::interprocess::intrusive_ptr">intrusive_ptr</classname> is parameterized on T (the type of the object pointed to) and VoidPointer(a void pointer type that defines the type of pointer that <classname alt="boost::interprocess::intrusive_ptr">intrusive_ptr</classname> will store). intrusive_ptr&lt;T, void *&gt; defines a class with a T* member whereas <classname alt="boost::interprocess::intrusive_ptr">intrusive_ptr</classname>&lt;T, offset_ptr&lt;void&gt; &gt; defines a class with a offset_ptr&lt;T&gt; member. Relies on unqualified calls to:</para><para>void intrusive_ptr_add_ref(T * p) BOOST_NOEXCEPT; void intrusive_ptr_release(T * p) BOOST_NOEXCEPT;</para><para>with (p != 0)</para><para>The object is responsible for destroying itself. </para></description><typedef name="pointer"><purpose>Provides the type of the internal stored pointer. </purpose><type>boost::intrusive::pointer_traits&lt; VoidPointer &gt;::template rebind_pointer&lt; T &gt;::type</type></typedef>
  1494. <typedef name="element_type"><purpose>Provides the type of the stored pointer. </purpose><type>T</type></typedef>
  1495. <method-group name="public member functions">
  1496. <method name="reset" cv="noexcept"><type>void</type><description><para>Release internal pointer and set it to 0. If internal pointer is not 0, calls intrusive_ptr_release(to_raw_pointer(m_ptr)). Does not throw </para></description></method>
  1497. <method name="get" cv="noexcept"><type>pointer &amp;</type><description><para>Returns a reference to the internal pointer. Does not throw </para></description></method>
  1498. <method name="get" cv="const noexcept"><type>const pointer &amp;</type><description><para>Returns a reference to the internal pointer. Does not throw </para></description></method>
  1499. <method name="operator *" cv="const noexcept"><type>T &amp;</type><description><para>Returns *get(). Does not throw </para></description></method>
  1500. <method name="operator-&gt;" cv="const noexcept"><type>const pointer &amp;</type><description><para>Returns *get(). Does not throw </para></description></method>
  1501. <method name="operator-&gt;" cv="noexcept"><type>pointer &amp;</type><description><para>Returns get(). Does not throw </para></description></method>
  1502. <method name="conversion-operator" cv="const noexcept"><type>unspecified_bool_type</type><description><para>Conversion to boolean. Does not throw </para></description></method>
  1503. <method name="operator!" cv="const noexcept"><type>bool</type><description><para>Not operator. Does not throw </para></description></method>
  1504. <method name="swap" cv="noexcept"><type>void</type><parameter name="rhs"><paramtype><classname>intrusive_ptr</classname> &amp;</paramtype></parameter><description><para>Exchanges the contents of the two smart pointers. Does not throw </para></description></method>
  1505. </method-group>
  1506. <constructor cv="noexcept"><description><para>Constructor. Initializes internal pointer to 0. Does not throw </para></description></constructor>
  1507. <constructor cv="noexcept"><parameter name="p"><paramtype>const pointer &amp;</paramtype></parameter><parameter name="add_ref"><paramtype>bool</paramtype><default>true</default></parameter><description><para>Constructor. Copies pointer and if "p" is not zero and "add_ref" is true calls intrusive_ptr_add_ref(to_raw_pointer(p)). Does not throw </para></description></constructor>
  1508. <constructor cv="noexcept"><parameter name="rhs"><paramtype><classname>intrusive_ptr</classname> const &amp;</paramtype></parameter><description><para>Copy constructor. Copies the internal pointer and if "p" is not zero calls intrusive_ptr_add_ref(to_raw_pointer(p)). Does not throw </para></description></constructor>
  1509. <constructor cv="noexcept"><parameter name="rhs"><paramtype><classname>intrusive_ptr</classname> &amp;&amp;</paramtype></parameter><purpose>Move constructor. Moves the internal pointer. Does not throw. </purpose></constructor>
  1510. <constructor cv="noexcept"><template>
  1511. <template-type-parameter name="U"/>
  1512. </template><parameter name="rhs"><paramtype><classname>intrusive_ptr</classname>&lt; U, VP &gt; const &amp;</paramtype></parameter><description><para>Constructor from related. Copies the internal pointer and if "p" is not zero calls intrusive_ptr_add_ref(to_raw_pointer(p)). Does not throw </para></description></constructor>
  1513. <destructor><purpose>Destructor. Calls reset(). Does not throw. </purpose></destructor>
  1514. <copy-assignment cv="noexcept"><type><classname>intrusive_ptr</classname> &amp;</type><parameter name="rhs"><paramtype>BOOST_COPY_ASSIGN_REF(<classname>intrusive_ptr</classname>)</paramtype></parameter><description><para>Assignment operator. Equivalent to intrusive_ptr(r).swap(*this). Does not throw </para></description></copy-assignment>
  1515. <copy-assignment cv="noexcept"><type><classname>intrusive_ptr</classname> &amp;</type><parameter name="rhs"><paramtype><classname>intrusive_ptr</classname> &amp;&amp;</paramtype></parameter><description><para>Move Assignment operator Does not throw </para></description></copy-assignment>
  1516. <copy-assignment cv="noexcept"><type><classname>intrusive_ptr</classname> &amp;</type><template>
  1517. <template-type-parameter name="U"/>
  1518. </template><parameter name="rhs"><paramtype><classname>intrusive_ptr</classname>&lt; U, VP &gt; const &amp;</paramtype></parameter><description><para>Assignment from related. Equivalent to intrusive_ptr(r).swap(*this). Does not throw </para></description></copy-assignment>
  1519. <copy-assignment cv="noexcept"><type><classname>intrusive_ptr</classname> &amp;</type><parameter name="rhs"><paramtype>pointer</paramtype></parameter><description><para>Assignment from pointer. Equivalent to intrusive_ptr(r).swap(*this). Does not throw </para></description></copy-assignment>
  1520. </class>
  1521. <function name="operator=="><type>bool</type><template>
  1522. <template-type-parameter name="T"/>
  1523. <template-type-parameter name="U"/>
  1524. <template-type-parameter name="VP"/>
  1525. </template><parameter name="a"><paramtype><classname>intrusive_ptr</classname>&lt; T, VP &gt; const &amp;</paramtype></parameter><parameter name="b"><paramtype><classname>intrusive_ptr</classname>&lt; U, VP &gt; const &amp;</paramtype></parameter><description><para>Returns a.get() == b.get(). Does not throw </para></description></function>
  1526. <function name="operator!="><type>bool</type><template>
  1527. <template-type-parameter name="T"/>
  1528. <template-type-parameter name="U"/>
  1529. <template-type-parameter name="VP"/>
  1530. </template><parameter name="a"><paramtype><classname>intrusive_ptr</classname>&lt; T, VP &gt; const &amp;</paramtype></parameter><parameter name="b"><paramtype><classname>intrusive_ptr</classname>&lt; U, VP &gt; const &amp;</paramtype></parameter><description><para>Returns a.get() != b.get(). Does not throw </para></description></function>
  1531. <function name="operator=="><type>bool</type><template>
  1532. <template-type-parameter name="T"/>
  1533. <template-type-parameter name="VP"/>
  1534. </template><parameter name="a"><paramtype><classname>intrusive_ptr</classname>&lt; T, VP &gt; const &amp;</paramtype></parameter><parameter name="b"><paramtype>const typename <classname>intrusive_ptr</classname>&lt; T, VP &gt;::pointer &amp;</paramtype></parameter><description><para>Returns a.get() == b. Does not throw </para></description></function>
  1535. <function name="operator!="><type>bool</type><template>
  1536. <template-type-parameter name="T"/>
  1537. <template-type-parameter name="VP"/>
  1538. </template><parameter name="a"><paramtype><classname>intrusive_ptr</classname>&lt; T, VP &gt; const &amp;</paramtype></parameter><parameter name="b"><paramtype>const typename <classname>intrusive_ptr</classname>&lt; T, VP &gt;::pointer &amp;</paramtype></parameter><description><para>Returns a.get() != b. Does not throw </para></description></function>
  1539. <function name="operator=="><type>bool</type><template>
  1540. <template-type-parameter name="T"/>
  1541. <template-type-parameter name="VP"/>
  1542. </template><parameter name="a"><paramtype>const typename <classname>intrusive_ptr</classname>&lt; T, VP &gt;::pointer &amp;</paramtype></parameter><parameter name="b"><paramtype><classname>intrusive_ptr</classname>&lt; T, VP &gt; const &amp;</paramtype></parameter><description><para>Returns a == b.get(). Does not throw </para></description></function>
  1543. <function name="operator!="><type>bool</type><template>
  1544. <template-type-parameter name="T"/>
  1545. <template-type-parameter name="VP"/>
  1546. </template><parameter name="a"><paramtype>const typename <classname>intrusive_ptr</classname>&lt; T, VP &gt;::pointer &amp;</paramtype></parameter><parameter name="b"><paramtype><classname>intrusive_ptr</classname>&lt; T, VP &gt; const &amp;</paramtype></parameter><description><para>Returns a != b.get(). Does not throw </para></description></function>
  1547. <function name="operator&lt;"><type>bool</type><template>
  1548. <template-type-parameter name="T"/>
  1549. <template-type-parameter name="VP"/>
  1550. </template><parameter name="a"><paramtype><classname>intrusive_ptr</classname>&lt; T, VP &gt; const &amp;</paramtype></parameter><parameter name="b"><paramtype><classname>intrusive_ptr</classname>&lt; T, VP &gt; const &amp;</paramtype></parameter><description><para>Returns a.get() &lt; b.get(). Does not throw </para></description></function>
  1551. <function name="swap"><type>void</type><template>
  1552. <template-type-parameter name="T"/>
  1553. <template-type-parameter name="VP"/>
  1554. </template><parameter name="lhs"><paramtype><classname>intrusive_ptr</classname>&lt; T, VP &gt; &amp;</paramtype></parameter><parameter name="rhs"><paramtype><classname>intrusive_ptr</classname>&lt; T, VP &gt; &amp;</paramtype></parameter><description><para>Exchanges the contents of the two intrusive_ptrs. Does not throw </para></description></function>
  1555. <function name="operator&lt;&lt;"><type>std::basic_ostream&lt; E, T &gt; &amp;</type><template>
  1556. <template-type-parameter name="E"/>
  1557. <template-type-parameter name="T"/>
  1558. <template-type-parameter name="Y"/>
  1559. <template-type-parameter name="VP"/>
  1560. </template><parameter name="os"><paramtype>std::basic_ostream&lt; E, T &gt; &amp;</paramtype></parameter><parameter name="p"><paramtype><classname>intrusive_ptr</classname>&lt; Y, VP &gt; const &amp;</paramtype></parameter></function>
  1561. <function name="to_raw_pointer"><type><classname>boost::interprocess::intrusive_ptr</classname>&lt; T, VP &gt;::pointer</type><template>
  1562. <template-type-parameter name="T"/>
  1563. <template-type-parameter name="VP"/>
  1564. </template><parameter name="p"><paramtype><classname>intrusive_ptr</classname>&lt; T, VP &gt;</paramtype></parameter><description><para>Returns p.get(). Does not throw </para></description></function>
  1565. </namespace>
  1566. </namespace>
  1567. </header>
  1568. <header name="boost/interprocess/smart_ptr/scoped_ptr.hpp">
  1569. <para>Describes the smart pointer scoped_ptr </para><namespace name="boost">
  1570. <namespace name="interprocess">
  1571. <class name="scoped_ptr"><template>
  1572. <template-type-parameter name="T"/>
  1573. <template-type-parameter name="Deleter"/>
  1574. </template><inherit access="private">Deleter</inherit><description><para><classname alt="boost::interprocess::scoped_ptr">scoped_ptr</classname> stores a pointer to a dynamically allocated object. The object pointed to is guaranteed to be deleted, either on destruction of the <classname alt="boost::interprocess::scoped_ptr">scoped_ptr</classname>, or via an explicit reset. The user can avoid this deletion using release(). <classname alt="boost::interprocess::scoped_ptr">scoped_ptr</classname> is parameterized on T (the type of the object pointed to) and Deleter (the functor to be executed to delete the internal pointer). The internal pointer will be of the same pointer type as typename Deleter::pointer type (that is, if typename Deleter::pointer is offset_ptr&lt;void&gt;, the internal pointer will be offset_ptr&lt;T&gt;). </para></description><typedef name="element_type"><type>T</type></typedef>
  1575. <typedef name="deleter_type"><type>Deleter</type></typedef>
  1576. <typedef name="pointer"><type><emphasis>unspecified</emphasis></type></typedef>
  1577. <typedef name="unspecified_bool_type"><type>pointer this_type::*</type></typedef>
  1578. <method-group name="public member functions">
  1579. <method name="reset"><type>void</type><parameter name="p"><paramtype>const pointer &amp;</paramtype><default>0</default></parameter><description><para>Deletes the object pointed to by the stored pointer and then stores a copy of p. Never throws </para></description></method>
  1580. <method name="reset"><type>void</type><parameter name="p"><paramtype>const pointer &amp;</paramtype></parameter><parameter name="d"><paramtype>const Deleter &amp;</paramtype></parameter><description><para>Deletes the object pointed to by the stored pointer and then stores a copy of p and a copy of d. </para></description></method>
  1581. <method name="release"><type>pointer</type><description><para>Assigns internal pointer as 0 and returns previous pointer. This will avoid deletion on destructor </para></description></method>
  1582. <method name="operator *" cv="const"><type>reference</type><description><para>Returns a reference to the object pointed to by the stored pointer. Never throws. </para></description></method>
  1583. <method name="operator-&gt;"><type>pointer &amp;</type><description><para>Returns the internal stored pointer. Never throws. </para></description></method>
  1584. <method name="operator-&gt;" cv="const"><type>const pointer &amp;</type><description><para>Returns the internal stored pointer. Never throws. </para></description></method>
  1585. <method name="get"><type>pointer &amp;</type><description><para>Returns the stored pointer. Never throws. </para></description></method>
  1586. <method name="get" cv="const"><type>const pointer &amp;</type><description><para>Returns the stored pointer. Never throws. </para></description></method>
  1587. <method name="conversion-operator" cv="const"><type>unspecified_bool_type</type><description><para>Conversion to bool Never throws </para></description></method>
  1588. <method name="operator!" cv="const"><type>bool</type><description><para>Returns true if the stored pointer is 0. Never throws. </para></description></method>
  1589. <method name="swap"><type>void</type><parameter name="b"><paramtype><classname>scoped_ptr</classname> &amp;</paramtype></parameter><description><para>Exchanges the internal pointer and deleter with other <classname alt="boost::interprocess::scoped_ptr">scoped_ptr</classname> Never throws. </para></description></method>
  1590. </method-group>
  1591. <constructor specifiers="explicit"><parameter name="p"><paramtype>const pointer &amp;</paramtype><default>0</default></parameter><parameter name="d"><paramtype>const Deleter &amp;</paramtype><default>Deleter()</default></parameter><description><para>Constructs a <classname alt="boost::interprocess::scoped_ptr">scoped_ptr</classname>, storing a copy of p(which can be 0) and d. Does not throw. </para></description></constructor>
  1592. <destructor><description><para>If the stored pointer is not 0, destroys the object pointed to by the stored pointer. calling the operator() of the stored deleter. Never throws </para></description></destructor>
  1593. </class>
  1594. <function name="swap"><type>void</type><template>
  1595. <template-type-parameter name="T"/>
  1596. <template-type-parameter name="D"/>
  1597. </template><parameter name="a"><paramtype><classname>scoped_ptr</classname>&lt; T, D &gt; &amp;</paramtype></parameter><parameter name="b"><paramtype><classname>scoped_ptr</classname>&lt; T, D &gt; &amp;</paramtype></parameter><description><para>Exchanges the internal pointer and deleter with other <classname alt="boost::interprocess::scoped_ptr">scoped_ptr</classname> Never throws. </para></description></function>
  1598. <function name="to_raw_pointer"><type><classname>scoped_ptr</classname>&lt; T, D &gt;::pointer</type><template>
  1599. <template-type-parameter name="T"/>
  1600. <template-type-parameter name="D"/>
  1601. </template><parameter name="p"><paramtype><classname>scoped_ptr</classname>&lt; T, D &gt; const &amp;</paramtype></parameter><description><para>Returns a copy of the stored pointer Never throws </para></description></function>
  1602. </namespace>
  1603. </namespace>
  1604. </header>
  1605. <header name="boost/interprocess/smart_ptr/shared_ptr.hpp">
  1606. <para>Describes the smart pointer shared_ptr </para><namespace name="boost">
  1607. <namespace name="interprocess">
  1608. <class name="enable_shared_from_this"><template>
  1609. <template-type-parameter name="T"/>
  1610. <template-type-parameter name="A"/>
  1611. <template-type-parameter name="D"/>
  1612. </template><description><para>This class is used as a base class that allows a <classname alt="boost::interprocess::shared_ptr">shared_ptr</classname> to the current object to be obtained from within a member function. <classname alt="boost::interprocess::enable_shared_from_this">enable_shared_from_this</classname> defines two member functions called shared_from_this that return a shared_ptr&lt;T&gt; and shared_ptr&lt;T const&gt;, depending on constness, to this. </para></description><method-group name="public member functions">
  1613. <method name="shared_from_this"><type><classname>shared_ptr</classname>&lt; T, A, D &gt;</type></method>
  1614. <method name="shared_from_this" cv="const"><type><classname>shared_ptr</classname>&lt; T const, A, D &gt;</type></method>
  1615. </method-group>
  1616. </class><struct name="managed_shared_ptr"><template>
  1617. <template-type-parameter name="T"/>
  1618. <template-type-parameter name="ManagedMemory"/>
  1619. </template><description><para>Returns the type of a shared pointer of type T with the allocator <classname alt="boost::interprocess::allocator">boost::interprocess::allocator</classname> allocator and <classname alt="boost::interprocess::deleter">boost::interprocess::deleter</classname> deleter that can be constructed in the given managed segment type. </para></description><typedef name="void_allocator"><type>ManagedMemory::template <classname>allocator</classname>&lt; void &gt;::<classname>type</classname></type></typedef>
  1620. <typedef name="deleter"><type>ManagedMemory::template deleter&lt; T &gt;::<classname>type</classname></type></typedef>
  1621. <typedef name="type"><type><classname>shared_ptr</classname>&lt; T, void_allocator, deleter &gt;</type></typedef>
  1622. </struct><class name="shared_ptr"><template>
  1623. <template-type-parameter name="T"/>
  1624. <template-type-parameter name="VoidAllocator"/>
  1625. <template-type-parameter name="Deleter"/>
  1626. </template><description><para><classname alt="boost::interprocess::shared_ptr">shared_ptr</classname> stores a pointer to a dynamically allocated object. The object pointed to is guaranteed to be deleted when the last <classname alt="boost::interprocess::shared_ptr">shared_ptr</classname> pointing to it is destroyed or reset.</para><para><classname alt="boost::interprocess::shared_ptr">shared_ptr</classname> is parameterized on T (the type of the object pointed to), VoidAllocator (the void allocator to be used to allocate the auxiliary data) and Deleter (the deleter whose operator() will be used to delete the object.</para><para>The internal pointer will be of the same pointer type as typename VoidAllocator::pointer type (that is, if typename VoidAllocator::pointer is offset_ptr&lt;void&gt;, the internal pointer will be offset_ptr&lt;T&gt;).</para><para>Because the implementation uses reference counting, cycles of <classname alt="boost::interprocess::shared_ptr">shared_ptr</classname> instances will not be reclaimed. For example, if main() holds a <classname alt="boost::interprocess::shared_ptr">shared_ptr</classname> to A, which directly or indirectly holds a <classname alt="boost::interprocess::shared_ptr">shared_ptr</classname> back to A, A's use count will be 2. Destruction of the original <classname alt="boost::interprocess::shared_ptr">shared_ptr</classname> will leave A dangling with a use count of 1. Use <classname alt="boost::interprocess::weak_ptr">weak_ptr</classname> to "break cycles." </para></description><typedef name="element_type"><type>T</type></typedef>
  1627. <typedef name="value_type"><type>T</type></typedef>
  1628. <typedef name="pointer"><type>boost::intrusive::pointer_traits&lt; typename VoidAllocator::pointer &gt;::template rebind_pointer&lt; T &gt;::type</type></typedef>
  1629. <typedef name="reference"><type><emphasis>unspecified</emphasis></type></typedef>
  1630. <typedef name="const_reference"><type><emphasis>unspecified</emphasis></type></typedef>
  1631. <typedef name="const_deleter_pointer"><type>boost::intrusive::pointer_traits&lt; typename VoidAllocator::pointer &gt;::template rebind_pointer&lt; const Deleter &gt;::type</type></typedef>
  1632. <typedef name="const_allocator_pointer"><type>boost::intrusive::pointer_traits&lt; typename VoidAllocator::pointer &gt;::template rebind_pointer&lt; const VoidAllocator &gt;::type</type></typedef>
  1633. <method-group name="public member functions">
  1634. <method name="reset"><type>void</type><description><para>This is equivalent to: this_type().swap(*this); </para></description></method>
  1635. <method name="reset"><type>void</type><template>
  1636. <template-type-parameter name="Pointer"/>
  1637. </template><parameter name="p"><paramtype>const Pointer &amp;</paramtype></parameter><parameter name="a"><paramtype>const VoidAllocator &amp;</paramtype><default>VoidAllocator()</default></parameter><parameter name="d"><paramtype>const Deleter &amp;</paramtype><default>Deleter()</default></parameter><description><para>This is equivalent to: this_type(p, a, d).swap(*this); </para></description></method>
  1638. <method name="reset"><type>void</type><template>
  1639. <template-type-parameter name="Y"/>
  1640. </template><parameter name="r"><paramtype><classname>shared_ptr</classname>&lt; Y, VoidAllocator, Deleter &gt; const &amp;</paramtype></parameter><parameter name="p"><paramtype>const pointer &amp;</paramtype></parameter></method>
  1641. <method name="operator *" cv="const"><type>reference</type><description><para>Returns a reference to the pointed type </para></description></method>
  1642. <method name="operator-&gt;" cv="const"><type>pointer</type><description><para>Returns the pointer pointing to the owned object </para></description></method>
  1643. <method name="get" cv="const"><type>pointer</type><description><para>Returns the pointer pointing to the owned object </para></description></method>
  1644. <method name="operator!" cv="const"><type>bool</type><description><para>Not operator. Returns true if this-&gt;get() != 0, false otherwise </para></description></method>
  1645. <method name="unique" cv="const"><type>bool</type><description><para>Returns use_count() == 1. unique() might be faster than use_count() </para></description></method>
  1646. <method name="use_count" cv="const"><type>long</type><description><para>Returns the number of <classname alt="boost::interprocess::shared_ptr">shared_ptr</classname> objects, *this included, that share ownership with *this, or an unspecified nonnegative value when *this is empty. use_count() is not necessarily efficient. Use only for debugging and testing purposes, not for production code. </para></description></method>
  1647. <method name="swap"><type>void</type><parameter name="other"><paramtype><classname>shared_ptr</classname>&lt; T, VoidAllocator, Deleter &gt; &amp;</paramtype></parameter><description><para>Exchanges the contents of the two smart pointers. </para></description></method>
  1648. </method-group>
  1649. <constructor><description><para>Constructs an empty <classname alt="boost::interprocess::shared_ptr">shared_ptr</classname>. Use_count() == 0 &amp;&amp; get()== 0. </para></description></constructor>
  1650. <constructor specifiers="explicit"><parameter name="p"><paramtype>const pointer &amp;</paramtype></parameter><parameter name="a"><paramtype>const VoidAllocator &amp;</paramtype><default>VoidAllocator()</default></parameter><parameter name="d"><paramtype>const Deleter &amp;</paramtype><default>Deleter()</default></parameter><description><para>Constructs a <classname alt="boost::interprocess::shared_ptr">shared_ptr</classname> that owns the pointer p. Auxiliary data will be allocated with a copy of a and the object will be deleted with a copy of d. Requirements: Deleter and A's copy constructor must not throw. </para></description></constructor>
  1651. <constructor><parameter name="r"><paramtype>const <classname>shared_ptr</classname> &amp;</paramtype></parameter><description><para>Copy constructs a <classname alt="boost::interprocess::shared_ptr">shared_ptr</classname>. If r is empty, constructs an empty <classname alt="boost::interprocess::shared_ptr">shared_ptr</classname>. Otherwise, constructs a <classname alt="boost::interprocess::shared_ptr">shared_ptr</classname> that shares ownership with r. Never throws. </para></description></constructor>
  1652. <constructor><parameter name="other"><paramtype>const <classname>shared_ptr</classname> &amp;</paramtype></parameter><parameter name="p"><paramtype>const pointer &amp;</paramtype></parameter><description><para>Constructs a <classname alt="boost::interprocess::shared_ptr">shared_ptr</classname> that shares ownership with other and stores p. Postconditions: get() == p &amp;&amp; use_count() == r.use_count(). Throws: nothing. </para></description></constructor>
  1653. <constructor><template>
  1654. <template-type-parameter name="Y"/>
  1655. </template><parameter name="r"><paramtype><classname>shared_ptr</classname>&lt; Y, VoidAllocator, Deleter &gt; const &amp;</paramtype></parameter><description><para>If r is empty, constructs an empty <classname alt="boost::interprocess::shared_ptr">shared_ptr</classname>. Otherwise, constructs a <classname alt="boost::interprocess::shared_ptr">shared_ptr</classname> that shares ownership with r. Never throws. </para></description></constructor>
  1656. <constructor specifiers="explicit"><template>
  1657. <template-type-parameter name="Y"/>
  1658. </template><parameter name="r"><paramtype><classname>weak_ptr</classname>&lt; Y, VoidAllocator, Deleter &gt; const &amp;</paramtype></parameter><description><para>Constructs a <classname alt="boost::interprocess::shared_ptr">shared_ptr</classname> that shares ownership with r and stores a copy of the pointer stored in r. </para></description></constructor>
  1659. <constructor specifiers="explicit"><parameter name="other"><paramtype><classname>shared_ptr</classname> &amp;&amp;</paramtype></parameter><description><para>Move-Constructs a <classname alt="boost::interprocess::shared_ptr">shared_ptr</classname> that takes ownership of other resource and other is put in default-constructed state. Throws: nothing. </para></description></constructor>
  1660. <copy-assignment><type><classname>shared_ptr</classname> &amp;</type><template>
  1661. <template-type-parameter name="Y"/>
  1662. </template><parameter name="r"><paramtype><classname>shared_ptr</classname>&lt; Y, VoidAllocator, Deleter &gt; const &amp;</paramtype></parameter><description><para>Equivalent to shared_ptr(r).swap(*this). Never throws </para></description></copy-assignment>
  1663. <copy-assignment><type><classname>shared_ptr</classname> &amp;</type><parameter name="r"><paramtype>BOOST_COPY_ASSIGN_REF(<classname>shared_ptr</classname>)</paramtype></parameter><description><para>Equivalent to shared_ptr(r).swap(*this). Never throws </para></description></copy-assignment>
  1664. <copy-assignment><type><classname>shared_ptr</classname> &amp;</type><parameter name="other"><paramtype><classname>shared_ptr</classname> &amp;&amp;</paramtype></parameter><description><para>Move-assignment. Equivalent to shared_ptr(other).swap(*this). Never throws </para></description></copy-assignment>
  1665. </class>
  1666. <function name="operator=="><type>bool</type><template>
  1667. <template-type-parameter name="T"/>
  1668. <template-type-parameter name="VoidAllocator"/>
  1669. <template-type-parameter name="Deleter"/>
  1670. <template-type-parameter name="U"/>
  1671. <template-type-parameter name="VoidAllocator2"/>
  1672. <template-type-parameter name="Deleter2"/>
  1673. </template><parameter name="a"><paramtype><classname>shared_ptr</classname>&lt; T, VoidAllocator, Deleter &gt; const &amp;</paramtype></parameter><parameter name="b"><paramtype><classname>shared_ptr</classname>&lt; U, VoidAllocator2, Deleter2 &gt; const &amp;</paramtype></parameter></function>
  1674. <function name="operator!="><type>bool</type><template>
  1675. <template-type-parameter name="T"/>
  1676. <template-type-parameter name="VoidAllocator"/>
  1677. <template-type-parameter name="Deleter"/>
  1678. <template-type-parameter name="U"/>
  1679. <template-type-parameter name="VoidAllocator2"/>
  1680. <template-type-parameter name="Deleter2"/>
  1681. </template><parameter name="a"><paramtype><classname>shared_ptr</classname>&lt; T, VoidAllocator, Deleter &gt; const &amp;</paramtype></parameter><parameter name="b"><paramtype><classname>shared_ptr</classname>&lt; U, VoidAllocator2, Deleter2 &gt; const &amp;</paramtype></parameter></function>
  1682. <function name="operator&lt;"><type>bool</type><template>
  1683. <template-type-parameter name="T"/>
  1684. <template-type-parameter name="VoidAllocator"/>
  1685. <template-type-parameter name="Deleter"/>
  1686. <template-type-parameter name="U"/>
  1687. <template-type-parameter name="VoidAllocator2"/>
  1688. <template-type-parameter name="Deleter2"/>
  1689. </template><parameter name="a"><paramtype><classname>shared_ptr</classname>&lt; T, VoidAllocator, Deleter &gt; const &amp;</paramtype></parameter><parameter name="b"><paramtype><classname>shared_ptr</classname>&lt; U, VoidAllocator2, Deleter2 &gt; const &amp;</paramtype></parameter></function>
  1690. <function name="swap"><type>void</type><template>
  1691. <template-type-parameter name="T"/>
  1692. <template-type-parameter name="VoidAllocator"/>
  1693. <template-type-parameter name="Deleter"/>
  1694. </template><parameter name="a"><paramtype><classname>shared_ptr</classname>&lt; T, VoidAllocator, Deleter &gt; &amp;</paramtype></parameter><parameter name="b"><paramtype><classname>shared_ptr</classname>&lt; T, VoidAllocator, Deleter &gt; &amp;</paramtype></parameter></function>
  1695. <function name="static_pointer_cast"><type><classname>shared_ptr</classname>&lt; T, VoidAllocator, Deleter &gt;</type><template>
  1696. <template-type-parameter name="T"/>
  1697. <template-type-parameter name="VoidAllocator"/>
  1698. <template-type-parameter name="Deleter"/>
  1699. <template-type-parameter name="U"/>
  1700. </template><parameter name="r"><paramtype><classname>shared_ptr</classname>&lt; U, VoidAllocator, Deleter &gt; const &amp;</paramtype></parameter></function>
  1701. <function name="const_pointer_cast"><type><classname>shared_ptr</classname>&lt; T, VoidAllocator, Deleter &gt;</type><template>
  1702. <template-type-parameter name="T"/>
  1703. <template-type-parameter name="VoidAllocator"/>
  1704. <template-type-parameter name="Deleter"/>
  1705. <template-type-parameter name="U"/>
  1706. </template><parameter name="r"><paramtype><classname>shared_ptr</classname>&lt; U, VoidAllocator, Deleter &gt; const &amp;</paramtype></parameter></function>
  1707. <function name="dynamic_pointer_cast"><type><classname>shared_ptr</classname>&lt; T, VoidAllocator, Deleter &gt;</type><template>
  1708. <template-type-parameter name="T"/>
  1709. <template-type-parameter name="VoidAllocator"/>
  1710. <template-type-parameter name="Deleter"/>
  1711. <template-type-parameter name="U"/>
  1712. </template><parameter name="r"><paramtype><classname>shared_ptr</classname>&lt; U, VoidAllocator, Deleter &gt; const &amp;</paramtype></parameter></function>
  1713. <function name="to_raw_pointer"><type>T *</type><template>
  1714. <template-type-parameter name="T"/>
  1715. <template-type-parameter name="VoidAllocator"/>
  1716. <template-type-parameter name="Deleter"/>
  1717. </template><parameter name="p"><paramtype><classname>shared_ptr</classname>&lt; T, VoidAllocator, Deleter &gt; const &amp;</paramtype></parameter></function>
  1718. <function name="operator&lt;&lt;"><type>std::basic_ostream&lt; E, T &gt; &amp;</type><template>
  1719. <template-type-parameter name="E"/>
  1720. <template-type-parameter name="T"/>
  1721. <template-type-parameter name="Y"/>
  1722. <template-type-parameter name="VoidAllocator"/>
  1723. <template-type-parameter name="Deleter"/>
  1724. </template><parameter name="os"><paramtype>std::basic_ostream&lt; E, T &gt; &amp;</paramtype></parameter><parameter name="p"><paramtype><classname>shared_ptr</classname>&lt; Y, VoidAllocator, Deleter &gt; const &amp;</paramtype></parameter></function>
  1725. <function name="make_managed_shared_ptr"><type><classname>managed_shared_ptr</classname>&lt; T, ManagedMemory &gt;::type</type><template>
  1726. <template-type-parameter name="T"/>
  1727. <template-type-parameter name="ManagedMemory"/>
  1728. </template><parameter name="constructed_object"><paramtype>T *</paramtype></parameter><parameter name="managed_memory"><paramtype>ManagedMemory &amp;</paramtype></parameter><description><para>Returns an instance of a shared pointer constructed with the default allocator and deleter from a pointer of type T that has been allocated in the passed managed segment </para></description></function>
  1729. <function name="make_managed_shared_ptr"><type><classname>managed_shared_ptr</classname>&lt; T, ManagedMemory &gt;::type</type><template>
  1730. <template-type-parameter name="T"/>
  1731. <template-type-parameter name="ManagedMemory"/>
  1732. </template><parameter name="constructed_object"><paramtype>T *</paramtype></parameter><parameter name="managed_memory"><paramtype>ManagedMemory &amp;</paramtype></parameter><parameter name=""><paramtype>const std::nothrow_t &amp;</paramtype></parameter><description><para>Returns an instance of a shared pointer constructed with the default allocator and deleter from a pointer of type T that has been allocated in the passed managed segment. Does not throw, return null shared pointer in error. </para></description></function>
  1733. </namespace>
  1734. </namespace>
  1735. </header>
  1736. <header name="boost/interprocess/smart_ptr/unique_ptr.hpp">
  1737. <para>This header provides utilities to define a unique_ptr that plays nicely with managed segments. </para><namespace name="boost">
  1738. <namespace name="interprocess">
  1739. <struct name="managed_unique_ptr"><template>
  1740. <template-type-parameter name="T"/>
  1741. <template-type-parameter name="ManagedMemory"/>
  1742. </template><description><para>Returns the type of a unique pointer of type T with <classname alt="boost::interprocess::deleter">boost::interprocess::deleter</classname> deleter that can be constructed in the given managed segment type. </para></description><typedef name="type"><type>boost::movelib::unique_ptr&lt; T, typename ManagedMemory::template <classname>deleter</classname>&lt; T &gt;::type &gt;</type></typedef>
  1743. </struct>
  1744. <function name="make_managed_unique_ptr"><type><classname>managed_unique_ptr</classname>&lt; T, ManagedMemory &gt;::type</type><template>
  1745. <template-type-parameter name="T"/>
  1746. <template-type-parameter name="ManagedMemory"/>
  1747. </template><parameter name="constructed_object"><paramtype>T *</paramtype></parameter><parameter name="managed_memory"><paramtype>ManagedMemory &amp;</paramtype></parameter><description><para>Returns an instance of a unique pointer constructed with boost::interproces::deleter from a pointer of type T that has been allocated in the passed managed segment </para></description></function>
  1748. </namespace>
  1749. </namespace>
  1750. </header>
  1751. <header name="boost/interprocess/smart_ptr/weak_ptr.hpp">
  1752. <para>Describes the smart pointer weak_ptr. </para><namespace name="boost">
  1753. <namespace name="interprocess">
  1754. <struct name="managed_weak_ptr"><template>
  1755. <template-type-parameter name="T"/>
  1756. <template-type-parameter name="ManagedMemory"/>
  1757. </template><description><para>Returns the type of a weak pointer of type T with the allocator <classname alt="boost::interprocess::allocator">boost::interprocess::allocator</classname> allocator and <classname alt="boost::interprocess::deleter">boost::interprocess::deleter</classname> deleter that can be constructed in the given managed segment type. </para></description><typedef name="type"><type><classname>weak_ptr</classname>&lt; T, typename ManagedMemory::template <classname>allocator</classname>&lt; void &gt;::<classname>type</classname>, typename ManagedMemory::template <classname>deleter</classname>&lt; T &gt;::<classname>type</classname> &gt;</type></typedef>
  1758. </struct><class name="weak_ptr"><template>
  1759. <template-type-parameter name="T"/>
  1760. <template-type-parameter name="A"/>
  1761. <template-type-parameter name="D"/>
  1762. </template><description><para>The <classname alt="boost::interprocess::weak_ptr">weak_ptr</classname> class template stores a "weak reference" to an object that's already managed by a <classname alt="boost::interprocess::shared_ptr">shared_ptr</classname>. To access the object, a <classname alt="boost::interprocess::weak_ptr">weak_ptr</classname> can be converted to a <classname alt="boost::interprocess::shared_ptr">shared_ptr</classname> using the <classname alt="boost::interprocess::shared_ptr">shared_ptr</classname> constructor or the member function lock. When the last <classname alt="boost::interprocess::shared_ptr">shared_ptr</classname> to the object goes away and the object is deleted, the attempt to obtain a <classname alt="boost::interprocess::shared_ptr">shared_ptr</classname> from the <classname alt="boost::interprocess::weak_ptr">weak_ptr</classname> instances that refer to the deleted object will fail: the constructor will throw an exception of type bad_weak_ptr, and weak_ptr::lock will return an empty <classname alt="boost::interprocess::shared_ptr">shared_ptr</classname>.</para><para>Every <classname alt="boost::interprocess::weak_ptr">weak_ptr</classname> meets the CopyConstructible and Assignable requirements of the C++ Standard Library, and so can be used in standard library containers. Comparison operators are supplied so that <classname alt="boost::interprocess::weak_ptr">weak_ptr</classname> works with the standard library's associative containers.</para><para><classname alt="boost::interprocess::weak_ptr">weak_ptr</classname> operations never throw exceptions.</para><para>The class template is parameterized on T, the type of the object pointed to. </para></description><typedef name="element_type"><type>T</type></typedef>
  1763. <typedef name="value_type"><type>T</type></typedef>
  1764. <method-group name="public member functions">
  1765. <method name="lock" cv="const"><type><classname>shared_ptr</classname>&lt; T, A, D &gt;</type><description><para>Returns: expired()? shared_ptr&lt;T&gt;(): shared_ptr&lt;T&gt;(*this).</para><para>Throws: nothing. </para></description></method>
  1766. <method name="use_count" cv="const"><type>long</type><description><para>Returns: 0 if *this is empty; otherwise, the number of <classname alt="boost::interprocess::shared_ptr">shared_ptr</classname> objects that share ownership with *this.</para><para>Throws: nothing.</para><para>Notes: use_count() is not necessarily efficient. Use only for debugging and testing purposes, not for production code. </para></description></method>
  1767. <method name="expired" cv="const"><type>bool</type><description><para>Returns: Returns: use_count() == 0.</para><para>Throws: nothing.</para><para>Notes: expired() may be faster than use_count(). </para></description></method>
  1768. <method name="reset"><type>void</type><description><para>Effects: Equivalent to: weak_ptr().swap(*this). </para></description></method>
  1769. <method name="swap"><type>void</type><parameter name="other"><paramtype>this_type &amp;</paramtype></parameter><description><para>Effects: Exchanges the contents of the two smart pointers.</para><para>Throws: nothing. </para></description></method>
  1770. </method-group>
  1771. <constructor><description><para>Effects: Constructs an empty <classname alt="boost::interprocess::weak_ptr">weak_ptr</classname>. Postconditions: use_count() == 0. </para></description></constructor>
  1772. <constructor><template>
  1773. <template-type-parameter name="Y"/>
  1774. </template><parameter name="r"><paramtype><classname>weak_ptr</classname>&lt; Y, A, D &gt; const &amp;</paramtype></parameter><description><para>Effects: If r is empty, constructs an empty <classname alt="boost::interprocess::weak_ptr">weak_ptr</classname>; otherwise, constructs a <classname alt="boost::interprocess::weak_ptr">weak_ptr</classname> that shares ownership with r as if by storing a copy of the pointer stored in r.</para><para>Postconditions: use_count() == r.use_count().</para><para>Throws: nothing. </para></description></constructor>
  1775. <constructor><template>
  1776. <template-type-parameter name="Y"/>
  1777. </template><parameter name="r"><paramtype><classname>shared_ptr</classname>&lt; Y, A, D &gt; const &amp;</paramtype></parameter><description><para>Effects: If r is empty, constructs an empty <classname alt="boost::interprocess::weak_ptr">weak_ptr</classname>; otherwise, constructs a <classname alt="boost::interprocess::weak_ptr">weak_ptr</classname> that shares ownership with r as if by storing a copy of the pointer stored in r.</para><para>Postconditions: use_count() == r.use_count().</para><para>Throws: nothing. </para></description></constructor>
  1778. <copy-assignment><type><classname>weak_ptr</classname> &amp;</type><template>
  1779. <template-type-parameter name="Y"/>
  1780. </template><parameter name="r"><paramtype><classname>weak_ptr</classname>&lt; Y, A, D &gt; const &amp;</paramtype></parameter><description><para>Effects: Equivalent to weak_ptr(r).swap(*this).</para><para>Throws: nothing.</para><para>Notes: The implementation is free to meet the effects (and the implied guarantees) via different means, without creating a temporary. </para></description></copy-assignment>
  1781. <copy-assignment><type><classname>weak_ptr</classname> &amp;</type><template>
  1782. <template-type-parameter name="Y"/>
  1783. </template><parameter name="r"><paramtype><classname>shared_ptr</classname>&lt; Y, A, D &gt; const &amp;</paramtype></parameter><description><para>Effects: Equivalent to weak_ptr(r).swap(*this).</para><para>Throws: nothing.</para><para>Notes: The implementation is free to meet the effects (and the implied guarantees) via different means, without creating a temporary. </para></description></copy-assignment>
  1784. </class>
  1785. <function name="operator&lt;"><type>bool</type><template>
  1786. <template-type-parameter name="T"/>
  1787. <template-type-parameter name="A"/>
  1788. <template-type-parameter name="D"/>
  1789. <template-type-parameter name="U"/>
  1790. <template-type-parameter name="A2"/>
  1791. <template-type-parameter name="D2"/>
  1792. </template><parameter name="a"><paramtype><classname>weak_ptr</classname>&lt; T, A, D &gt; const &amp;</paramtype></parameter><parameter name="b"><paramtype><classname>weak_ptr</classname>&lt; U, A2, D2 &gt; const &amp;</paramtype></parameter></function>
  1793. <function name="swap"><type>void</type><template>
  1794. <template-type-parameter name="T"/>
  1795. <template-type-parameter name="A"/>
  1796. <template-type-parameter name="D"/>
  1797. </template><parameter name="a"><paramtype><classname>weak_ptr</classname>&lt; T, A, D &gt; &amp;</paramtype></parameter><parameter name="b"><paramtype><classname>weak_ptr</classname>&lt; T, A, D &gt; &amp;</paramtype></parameter></function>
  1798. <function name="make_managed_weak_ptr"><type><classname>managed_weak_ptr</classname>&lt; T, ManagedMemory &gt;::type</type><template>
  1799. <template-type-parameter name="T"/>
  1800. <template-type-parameter name="ManagedMemory"/>
  1801. </template><parameter name="constructed_object"><paramtype>T *</paramtype></parameter><parameter name="managed_memory"><paramtype>ManagedMemory &amp;</paramtype></parameter><description><para>Returns an instance of a weak pointer constructed with the default allocator and deleter from a pointer of type T that has been allocated in the passed managed segment </para></description></function>
  1802. </namespace>
  1803. </namespace>
  1804. </header>
  1805. <header name="boost/interprocess/streams/bufferstream.hpp">
  1806. <para>This file defines basic_bufferbuf, basic_ibufferstream, basic_obufferstream, and basic_bufferstream classes. These classes represent streamsbufs and streams whose sources or destinations are fixed size character buffers. </para><namespace name="boost">
  1807. <namespace name="interprocess">
  1808. <class name="basic_bufferbuf"><template>
  1809. <template-type-parameter name="CharT"/>
  1810. <template-type-parameter name="CharTraits"/>
  1811. </template><inherit access="public">std::basic_streambuf&lt; CharT, CharTraits &gt;</inherit><description><para>A streambuf class that controls the transmission of elements to and from a basic_xbufferstream. The elements are transmitted from a to a fixed size buffer </para></description><typedef name="char_type"><type>CharT</type></typedef>
  1812. <typedef name="int_type"><type>CharTraits::int_type</type></typedef>
  1813. <typedef name="pos_type"><type>CharTraits::pos_type</type></typedef>
  1814. <typedef name="off_type"><type>CharTraits::off_type</type></typedef>
  1815. <typedef name="traits_type"><type>CharTraits</type></typedef>
  1816. <typedef name="basic_streambuf_t"><type>std::basic_streambuf&lt; char_type, traits_type &gt;</type></typedef>
  1817. <method-group name="public member functions">
  1818. <method name="buffer" cv="const"><type>std::pair&lt; CharT *, std::size_t &gt;</type><description><para>Returns the pointer and size of the internal buffer. Does not throw. </para></description></method>
  1819. <method name="buffer"><type>void</type><parameter name="buf"><paramtype>CharT *</paramtype></parameter><parameter name="length"><paramtype>std::size_t</paramtype></parameter><description><para>Sets the underlying buffer to a new value Does not throw. </para></description></method>
  1820. </method-group>
  1821. <constructor specifiers="explicit"><parameter name="mode"><paramtype>std::ios_base::openmode</paramtype><default>std::ios_base::in|std::ios_base::out</default></parameter><description><para>Constructor. Does not throw. </para></description></constructor>
  1822. <constructor specifiers="explicit"><parameter name="buf"><paramtype>CharT *</paramtype></parameter><parameter name="length"><paramtype>std::size_t</paramtype></parameter><parameter name="mode"><paramtype>std::ios_base::openmode</paramtype><default>std::ios_base::in|std::ios_base::out</default></parameter><description><para>Constructor. Assigns formatting buffer. Does not throw. </para></description></constructor>
  1823. <destructor/>
  1824. </class><class name="basic_bufferstream"><template>
  1825. <template-type-parameter name="CharT"/>
  1826. <template-type-parameter name="CharTraits"/>
  1827. </template><inherit access="public">std::basic_iostream&lt; CharT, CharTraits &gt;</inherit><description><para>A basic_iostream class that uses a fixed size character buffer as its formatting buffer. </para></description><typedef name="char_type"><type>std::basic_ios&lt; CharT, CharTraits &gt;::char_type</type></typedef>
  1828. <typedef name="int_type"><type>std::basic_ios&lt; char_type, CharTraits &gt;::int_type</type></typedef>
  1829. <typedef name="pos_type"><type>std::basic_ios&lt; char_type, CharTraits &gt;::pos_type</type></typedef>
  1830. <typedef name="off_type"><type>std::basic_ios&lt; char_type, CharTraits &gt;::off_type</type></typedef>
  1831. <typedef name="traits_type"><type>std::basic_ios&lt; char_type, CharTraits &gt;::traits_type</type></typedef>
  1832. <method-group name="public member functions">
  1833. <method name="rdbuf" cv="const"><type><classname>basic_bufferbuf</classname>&lt; CharT, CharTraits &gt; *</type><description><para>Returns the address of the stored stream buffer. </para></description></method>
  1834. <method name="buffer" cv="const"><type>std::pair&lt; CharT *, std::size_t &gt;</type><description><para>Returns the pointer and size of the internal buffer. Does not throw. </para></description></method>
  1835. <method name="buffer"><type>void</type><parameter name="buf"><paramtype>CharT *</paramtype></parameter><parameter name="length"><paramtype>std::size_t</paramtype></parameter><description><para>Sets the underlying buffer to a new value. Resets stream position. Does not throw. </para></description></method>
  1836. </method-group>
  1837. <constructor><parameter name="mode"><paramtype>std::ios_base::openmode</paramtype><default>std::ios_base::in|std::ios_base::out</default></parameter><description><para>Constructor. Does not throw. </para></description></constructor>
  1838. <constructor><parameter name="buf"><paramtype>CharT *</paramtype></parameter><parameter name="length"><paramtype>std::size_t</paramtype></parameter><parameter name="mode"><paramtype>std::ios_base::openmode</paramtype><default>std::ios_base::in|std::ios_base::out</default></parameter><description><para>Constructor. Assigns formatting buffer. Does not throw. </para></description></constructor>
  1839. <destructor/>
  1840. </class><class name="basic_ibufferstream"><template>
  1841. <template-type-parameter name="CharT"/>
  1842. <template-type-parameter name="CharTraits"/>
  1843. </template><inherit access="public">std::basic_istream&lt; CharT, CharTraits &gt;</inherit><description><para>A basic_istream class that uses a fixed size character buffer as its formatting buffer. </para></description><typedef name="char_type"><type>std::basic_ios&lt; CharT, CharTraits &gt;::char_type</type></typedef>
  1844. <typedef name="int_type"><type>std::basic_ios&lt; char_type, CharTraits &gt;::int_type</type></typedef>
  1845. <typedef name="pos_type"><type>std::basic_ios&lt; char_type, CharTraits &gt;::pos_type</type></typedef>
  1846. <typedef name="off_type"><type>std::basic_ios&lt; char_type, CharTraits &gt;::off_type</type></typedef>
  1847. <typedef name="traits_type"><type>std::basic_ios&lt; char_type, CharTraits &gt;::traits_type</type></typedef>
  1848. <method-group name="public member functions">
  1849. <method name="rdbuf" cv="const"><type><classname>basic_bufferbuf</classname>&lt; CharT, CharTraits &gt; *</type><description><para>Returns the address of the stored stream buffer. </para></description></method>
  1850. <method name="buffer" cv="const"><type>std::pair&lt; const CharT *, std::size_t &gt;</type><description><para>Returns the pointer and size of the internal buffer. Does not throw. </para></description></method>
  1851. <method name="buffer"><type>void</type><parameter name="buf"><paramtype>const CharT *</paramtype></parameter><parameter name="length"><paramtype>std::size_t</paramtype></parameter><description><para>Sets the underlying buffer to a new value. Resets stream position. Does not throw. </para></description></method>
  1852. </method-group>
  1853. <constructor><parameter name="mode"><paramtype>std::ios_base::openmode</paramtype><default>std::ios_base::in</default></parameter><description><para>Constructor. Does not throw. </para></description></constructor>
  1854. <constructor><parameter name="buf"><paramtype>const CharT *</paramtype></parameter><parameter name="length"><paramtype>std::size_t</paramtype></parameter><parameter name="mode"><paramtype>std::ios_base::openmode</paramtype><default>std::ios_base::in</default></parameter><description><para>Constructor. Assigns formatting buffer. Does not throw. </para></description></constructor>
  1855. <destructor/>
  1856. </class><class name="basic_obufferstream"><template>
  1857. <template-type-parameter name="CharT"/>
  1858. <template-type-parameter name="CharTraits"/>
  1859. </template><inherit access="public">std::basic_ostream&lt; CharT, CharTraits &gt;</inherit><description><para>A basic_ostream class that uses a fixed size character buffer as its formatting buffer. </para></description><typedef name="char_type"><type>std::basic_ios&lt; CharT, CharTraits &gt;::char_type</type></typedef>
  1860. <typedef name="int_type"><type>std::basic_ios&lt; char_type, CharTraits &gt;::int_type</type></typedef>
  1861. <typedef name="pos_type"><type>std::basic_ios&lt; char_type, CharTraits &gt;::pos_type</type></typedef>
  1862. <typedef name="off_type"><type>std::basic_ios&lt; char_type, CharTraits &gt;::off_type</type></typedef>
  1863. <typedef name="traits_type"><type>std::basic_ios&lt; char_type, CharTraits &gt;::traits_type</type></typedef>
  1864. <method-group name="public member functions">
  1865. <method name="rdbuf" cv="const"><type><classname>basic_bufferbuf</classname>&lt; CharT, CharTraits &gt; *</type><description><para>Returns the address of the stored stream buffer. </para></description></method>
  1866. <method name="buffer" cv="const"><type>std::pair&lt; CharT *, std::size_t &gt;</type><description><para>Returns the pointer and size of the internal buffer. Does not throw. </para></description></method>
  1867. <method name="buffer"><type>void</type><parameter name="buf"><paramtype>CharT *</paramtype></parameter><parameter name="length"><paramtype>std::size_t</paramtype></parameter><description><para>Sets the underlying buffer to a new value. Resets stream position. Does not throw. </para></description></method>
  1868. </method-group>
  1869. <constructor><parameter name="mode"><paramtype>std::ios_base::openmode</paramtype><default>std::ios_base::out</default></parameter><description><para>Constructor. Does not throw. </para></description></constructor>
  1870. <constructor><parameter name="buf"><paramtype>CharT *</paramtype></parameter><parameter name="length"><paramtype>std::size_t</paramtype></parameter><parameter name="mode"><paramtype>std::ios_base::openmode</paramtype><default>std::ios_base::out</default></parameter><description><para>Constructor. Assigns formatting buffer. Does not throw. </para></description></constructor>
  1871. <destructor/>
  1872. </class><typedef name="bufferbuf"><type><classname>basic_bufferbuf</classname>&lt; char &gt;</type></typedef>
  1873. <typedef name="bufferstream"><type><classname>basic_bufferstream</classname>&lt; char &gt;</type></typedef>
  1874. <typedef name="ibufferstream"><type><classname>basic_ibufferstream</classname>&lt; char &gt;</type></typedef>
  1875. <typedef name="obufferstream"><type><classname>basic_obufferstream</classname>&lt; char &gt;</type></typedef>
  1876. <typedef name="wbufferbuf"><type><classname>basic_bufferbuf</classname>&lt; wchar_t &gt;</type></typedef>
  1877. <typedef name="wbufferstream"><type><classname>basic_bufferstream</classname>&lt; wchar_t &gt;</type></typedef>
  1878. <typedef name="wibufferstream"><type><classname>basic_ibufferstream</classname>&lt; wchar_t &gt;</type></typedef>
  1879. <typedef name="wobufferstream"><type><classname>basic_obufferstream</classname>&lt; wchar_t &gt;</type></typedef>
  1880. </namespace>
  1881. </namespace>
  1882. </header>
  1883. <header name="boost/interprocess/streams/vectorstream.hpp">
  1884. <para>This file defines basic_vectorbuf, basic_ivectorstream, basic_ovectorstream, and basic_vectorstreamclasses. These classes represent streamsbufs and streams whose sources or destinations are STL-like vectors that can be swapped with external vectors to avoid unnecessary allocations/copies. </para><namespace name="boost">
  1885. <namespace name="interprocess">
  1886. <class name="basic_ivectorstream"><template>
  1887. <template-type-parameter name="CharVector"/>
  1888. <template-type-parameter name="CharTraits"/>
  1889. </template><inherit access="public">std::basic_istream&lt; CharVector::value_type, CharTraits &gt;</inherit><description><para>A basic_istream class that holds a character vector specified by CharVector template parameter as its formatting buffer. The vector must have contiguous storage, like std::vector, boost::interprocess::vector or boost::interprocess::basic_string </para></description><typedef name="vector_type"><type>CharVector</type></typedef>
  1890. <typedef name="char_type"><type>std::basic_ios&lt; typename CharVector::value_type, CharTraits &gt;::char_type</type></typedef>
  1891. <typedef name="int_type"><type>std::basic_ios&lt; char_type, CharTraits &gt;::int_type</type></typedef>
  1892. <typedef name="pos_type"><type>std::basic_ios&lt; char_type, CharTraits &gt;::pos_type</type></typedef>
  1893. <typedef name="off_type"><type>std::basic_ios&lt; char_type, CharTraits &gt;::off_type</type></typedef>
  1894. <typedef name="traits_type"><type>std::basic_ios&lt; char_type, CharTraits &gt;::traits_type</type></typedef>
  1895. <method-group name="public member functions">
  1896. <method name="rdbuf" cv="const"><type><classname>basic_vectorbuf</classname>&lt; CharVector, CharTraits &gt; *</type><description><para>Returns the address of the stored stream buffer. </para></description></method>
  1897. <method name="swap_vector"><type>void</type><parameter name="vect"><paramtype>vector_type &amp;</paramtype></parameter><description><para>Swaps the underlying vector with the passed vector. This function resets the read position in the stream. Does not throw. </para></description></method>
  1898. <method name="vector" cv="const"><type>const vector_type &amp;</type><description><para>Returns a const reference to the internal vector. Does not throw. </para></description></method>
  1899. <method name="reserve"><type>void</type><parameter name="size"><paramtype>typename vector_type::size_type</paramtype></parameter><description><para>Calls reserve() method of the internal vector. Resets the stream to the first position. Throws if the internals vector's reserve throws. </para></description></method>
  1900. <method name="clear"><type>void</type><description><para>Calls clear() method of the internal vector. Resets the stream to the first position. </para></description></method>
  1901. </method-group>
  1902. <constructor><parameter name="mode"><paramtype>std::ios_base::openmode</paramtype><default>std::ios_base::in</default></parameter><description><para>Constructor. Throws if vector_type default constructor throws. </para></description></constructor>
  1903. <constructor><template>
  1904. <template-type-parameter name="VectorParameter"/>
  1905. </template><parameter name="param"><paramtype>const VectorParameter &amp;</paramtype></parameter><parameter name="mode"><paramtype>std::ios_base::openmode</paramtype><default>std::ios_base::in</default></parameter><description><para>Constructor. Throws if vector_type(const VectorParameter &amp;param) throws. </para></description></constructor>
  1906. </class><class name="basic_ovectorstream"><template>
  1907. <template-type-parameter name="CharVector"/>
  1908. <template-type-parameter name="CharTraits"/>
  1909. </template><inherit access="public">std::basic_ostream&lt; CharVector::value_type, CharTraits &gt;</inherit><description><para>A basic_ostream class that holds a character vector specified by CharVector template parameter as its formatting buffer. The vector must have contiguous storage, like std::vector, boost::interprocess::vector or boost::interprocess::basic_string </para></description><typedef name="vector_type"><type>CharVector</type></typedef>
  1910. <typedef name="char_type"><type>std::basic_ios&lt; typename CharVector::value_type, CharTraits &gt;::char_type</type></typedef>
  1911. <typedef name="int_type"><type>std::basic_ios&lt; char_type, CharTraits &gt;::int_type</type></typedef>
  1912. <typedef name="pos_type"><type>std::basic_ios&lt; char_type, CharTraits &gt;::pos_type</type></typedef>
  1913. <typedef name="off_type"><type>std::basic_ios&lt; char_type, CharTraits &gt;::off_type</type></typedef>
  1914. <typedef name="traits_type"><type>std::basic_ios&lt; char_type, CharTraits &gt;::traits_type</type></typedef>
  1915. <method-group name="public member functions">
  1916. <method name="rdbuf" cv="const"><type><classname>basic_vectorbuf</classname>&lt; CharVector, CharTraits &gt; *</type><description><para>Returns the address of the stored stream buffer. </para></description></method>
  1917. <method name="swap_vector"><type>void</type><parameter name="vect"><paramtype>vector_type &amp;</paramtype></parameter><description><para>Swaps the underlying vector with the passed vector. This function resets the write position in the stream. Does not throw. </para></description></method>
  1918. <method name="vector" cv="const"><type>const vector_type &amp;</type><description><para>Returns a const reference to the internal vector. Does not throw. </para></description></method>
  1919. <method name="reserve"><type>void</type><parameter name="size"><paramtype>typename vector_type::size_type</paramtype></parameter><description><para>Calls reserve() method of the internal vector. Resets the stream to the first position. Throws if the internals vector's reserve throws. </para></description></method>
  1920. </method-group>
  1921. <constructor><parameter name="mode"><paramtype>std::ios_base::openmode</paramtype><default>std::ios_base::out</default></parameter><description><para>Constructor. Throws if vector_type default constructor throws. </para></description></constructor>
  1922. <constructor><template>
  1923. <template-type-parameter name="VectorParameter"/>
  1924. </template><parameter name="param"><paramtype>const VectorParameter &amp;</paramtype></parameter><parameter name="mode"><paramtype>std::ios_base::openmode</paramtype><default>std::ios_base::out</default></parameter><description><para>Constructor. Throws if vector_type(const VectorParameter &amp;param) throws. </para></description></constructor>
  1925. </class><class name="basic_vectorbuf"><template>
  1926. <template-type-parameter name="CharVector"/>
  1927. <template-type-parameter name="CharTraits"/>
  1928. </template><inherit access="public">std::basic_streambuf&lt; CharVector::value_type, CharTraits &gt;</inherit><description><para>A streambuf class that controls the transmission of elements to and from a <classname alt="boost::interprocess::basic_ivectorstream">basic_ivectorstream</classname>, <classname alt="boost::interprocess::basic_ovectorstream">basic_ovectorstream</classname> or <classname alt="boost::interprocess::basic_vectorstream">basic_vectorstream</classname>. It holds a character vector specified by CharVector template parameter as its formatting buffer. The vector must have contiguous storage, like std::vector, boost::interprocess::vector or boost::interprocess::basic_string </para></description><typedef name="vector_type"><type>CharVector</type></typedef>
  1929. <typedef name="char_type"><type>CharVector::value_type</type></typedef>
  1930. <typedef name="int_type"><type>CharTraits::int_type</type></typedef>
  1931. <typedef name="pos_type"><type>CharTraits::pos_type</type></typedef>
  1932. <typedef name="off_type"><type>CharTraits::off_type</type></typedef>
  1933. <typedef name="traits_type"><type>CharTraits</type></typedef>
  1934. <method-group name="public member functions">
  1935. <method name="swap_vector"><type>void</type><parameter name="vect"><paramtype>vector_type &amp;</paramtype></parameter><description><para>Swaps the underlying vector with the passed vector. This function resets the read/write position in the stream. Does not throw. </para></description></method>
  1936. <method name="vector" cv="const"><type>const vector_type &amp;</type><description><para>Returns a const reference to the internal vector. Does not throw. </para></description></method>
  1937. <method name="reserve"><type>void</type><parameter name="size"><paramtype>typename vector_type::size_type</paramtype></parameter><description><para>Preallocates memory from the internal vector. Resets the stream to the first position. Throws if the internals vector's memory allocation throws. </para></description></method>
  1938. <method name="clear"><type>void</type><description><para>Calls clear() method of the internal vector. Resets the stream to the first position. </para></description></method>
  1939. </method-group>
  1940. <constructor specifiers="explicit"><parameter name="mode"><paramtype>std::ios_base::openmode</paramtype><default>std::ios_base::in|std::ios_base::out</default></parameter><description><para>Constructor. Throws if vector_type default constructor throws. </para></description></constructor>
  1941. <constructor specifiers="explicit"><template>
  1942. <template-type-parameter name="VectorParameter"/>
  1943. </template><parameter name="param"><paramtype>const VectorParameter &amp;</paramtype></parameter><parameter name="mode"><paramtype>std::ios_base::openmode</paramtype><default>std::ios_base::in|std::ios_base::out</default></parameter><description><para>Constructor. Throws if vector_type(const VectorParameter &amp;param) throws. </para></description></constructor>
  1944. </class><class name="basic_vectorstream"><template>
  1945. <template-type-parameter name="CharVector"/>
  1946. <template-type-parameter name="CharTraits"/>
  1947. </template><inherit access="public">std::basic_iostream&lt; CharVector::value_type, CharTraits &gt;</inherit><description><para>A basic_iostream class that holds a character vector specified by CharVector template parameter as its formatting buffer. The vector must have contiguous storage, like std::vector, boost::interprocess::vector or boost::interprocess::basic_string </para></description><typedef name="vector_type"><type>CharVector</type></typedef>
  1948. <typedef name="char_type"><type>std::basic_ios&lt; typename CharVector::value_type, CharTraits &gt;::char_type</type></typedef>
  1949. <typedef name="int_type"><type>std::basic_ios&lt; char_type, CharTraits &gt;::int_type</type></typedef>
  1950. <typedef name="pos_type"><type>std::basic_ios&lt; char_type, CharTraits &gt;::pos_type</type></typedef>
  1951. <typedef name="off_type"><type>std::basic_ios&lt; char_type, CharTraits &gt;::off_type</type></typedef>
  1952. <typedef name="traits_type"><type>std::basic_ios&lt; char_type, CharTraits &gt;::traits_type</type></typedef>
  1953. <method-group name="public member functions">
  1954. <method name="rdbuf" cv="const"><type><classname>basic_vectorbuf</classname>&lt; CharVector, CharTraits &gt; *</type></method>
  1955. <method name="swap_vector"><type>void</type><parameter name="vect"><paramtype>vector_type &amp;</paramtype></parameter><description><para>Swaps the underlying vector with the passed vector. This function resets the read/write position in the stream. Does not throw. </para></description></method>
  1956. <method name="vector" cv="const"><type>const vector_type &amp;</type><description><para>Returns a const reference to the internal vector. Does not throw. </para></description></method>
  1957. <method name="reserve"><type>void</type><parameter name="size"><paramtype>typename vector_type::size_type</paramtype></parameter><description><para>Calls reserve() method of the internal vector. Resets the stream to the first position. Throws if the internals vector's reserve throws. </para></description></method>
  1958. <method name="clear"><type>void</type><description><para>Calls clear() method of the internal vector. Resets the stream to the first position. </para></description></method>
  1959. </method-group>
  1960. <constructor><parameter name="mode"><paramtype>std::ios_base::openmode</paramtype><default>std::ios_base::in|std::ios_base::out</default></parameter><description><para>Constructor. Throws if vector_type default constructor throws. </para></description></constructor>
  1961. <constructor><template>
  1962. <template-type-parameter name="VectorParameter"/>
  1963. </template><parameter name="param"><paramtype>const VectorParameter &amp;</paramtype></parameter><parameter name="mode"><paramtype>std::ios_base::openmode</paramtype><default>std::ios_base::in|std::ios_base::out</default></parameter><description><para>Constructor. Throws if vector_type(const VectorParameter &amp;param) throws. </para></description></constructor>
  1964. </class>
  1965. </namespace>
  1966. </namespace>
  1967. </header>
  1968. <header name="boost/interprocess/sync/file_lock.hpp">
  1969. <para>Describes a class that wraps file locking capabilities. </para><namespace name="boost">
  1970. <namespace name="interprocess">
  1971. <class name="file_lock"><description><para>A file lock, is a mutual exclusion utility similar to a mutex using a file. A file lock has sharable and exclusive locking capabilities and can be used with <classname alt="boost::interprocess::scoped_lock">scoped_lock</classname> and <classname alt="boost::interprocess::sharable_lock">sharable_lock</classname> classes. A file lock can't guarantee synchronization between threads of the same process so just use file locks to synchronize threads from different processes. </para></description><method-group name="public member functions">
  1972. <method name="swap"><type>void</type><parameter name="other"><paramtype><classname>file_lock</classname> &amp;</paramtype></parameter><description><para>Swaps two file_locks. Does not throw. </para></description></method>
  1973. <method name="lock"><type>void</type><description><para>Effects: The calling thread tries to obtain exclusive ownership of the mutex, and if another thread has exclusive, or sharable ownership of the mutex, it waits until it can obtain the ownership. Throws: <classname alt="boost::interprocess::interprocess_exception">interprocess_exception</classname> on error. </para></description></method>
  1974. <method name="try_lock"><type>bool</type><description><para>Effects: The calling thread tries to acquire exclusive ownership of the mutex without waiting. If no other thread has exclusive, or sharable ownership of the mutex this succeeds. Returns: If it can acquire exclusive ownership immediately returns true. If it has to wait, returns false. Throws: <classname alt="boost::interprocess::interprocess_exception">interprocess_exception</classname> on error. </para></description></method>
  1975. <method name="timed_lock"><type>bool</type><parameter name="abs_time"><paramtype>const boost::posix_time::ptime &amp;</paramtype></parameter><description><para>Effects: The calling thread tries to acquire exclusive ownership of the mutex waiting if necessary until no other thread has exclusive, or sharable ownership of the mutex or abs_time is reached. Returns: If acquires exclusive ownership, returns true. Otherwise returns false. Throws: <classname alt="boost::interprocess::interprocess_exception">interprocess_exception</classname> on error. </para></description></method>
  1976. <method name="unlock"><type>void</type><description><para>Precondition: The thread must have exclusive ownership of the mutex. Effects: The calling thread releases the exclusive ownership of the mutex. Throws: An exception derived from <classname alt="boost::interprocess::interprocess_exception">interprocess_exception</classname> on error. </para></description></method>
  1977. <method name="lock_sharable"><type>void</type><description><para>Effects: The calling thread tries to obtain sharable ownership of the mutex, and if another thread has exclusive ownership of the mutex, waits until it can obtain the ownership. Throws: <classname alt="boost::interprocess::interprocess_exception">interprocess_exception</classname> on error. </para></description></method>
  1978. <method name="try_lock_sharable"><type>bool</type><description><para>Effects: The calling thread tries to acquire sharable ownership of the mutex without waiting. If no other thread has exclusive ownership of the mutex this succeeds. Returns: If it can acquire sharable ownership immediately returns true. If it has to wait, returns false. Throws: <classname alt="boost::interprocess::interprocess_exception">interprocess_exception</classname> on error. </para></description></method>
  1979. <method name="timed_lock_sharable"><type>bool</type><parameter name="abs_time"><paramtype>const boost::posix_time::ptime &amp;</paramtype></parameter><description><para>Effects: The calling thread tries to acquire sharable ownership of the mutex waiting if necessary until no other thread has exclusive ownership of the mutex or abs_time is reached. Returns: If acquires sharable ownership, returns true. Otherwise returns false. Throws: <classname alt="boost::interprocess::interprocess_exception">interprocess_exception</classname> on error. </para></description></method>
  1980. <method name="unlock_sharable"><type>void</type><description><para>Precondition: The thread must have sharable ownership of the mutex. Effects: The calling thread releases the sharable ownership of the mutex. Throws: An exception derived from <classname alt="boost::interprocess::interprocess_exception">interprocess_exception</classname> on error. </para></description></method>
  1981. </method-group>
  1982. <constructor><description><para>Constructs an empty file mapping. Does not throw </para></description></constructor>
  1983. <constructor><parameter name="name"><paramtype>const char *</paramtype></parameter><description><para>Opens a file lock. Throws <classname alt="boost::interprocess::interprocess_exception">interprocess_exception</classname> if the file does not exist or there are no operating system resources. </para></description></constructor>
  1984. <constructor><parameter name="moved"><paramtype><classname>file_lock</classname> &amp;&amp;</paramtype></parameter><description><para>Moves the ownership of "moved"'s file mapping object to *this. After the call, "moved" does not represent any file mapping object. Does not throw </para></description></constructor>
  1985. <copy-assignment><type><classname>file_lock</classname> &amp;</type><parameter name="moved"><paramtype><classname>file_lock</classname> &amp;&amp;</paramtype></parameter><description><para>Moves the ownership of "moved"'s file mapping to *this. After the call, "moved" does not represent any file mapping. Does not throw </para></description></copy-assignment>
  1986. <destructor><purpose>Closes a file lock. Does not throw. </purpose></destructor>
  1987. </class>
  1988. </namespace>
  1989. </namespace>
  1990. </header>
  1991. <header name="boost/interprocess/sync/interprocess_condition.hpp">
  1992. <para>Describes process-shared variables interprocess_condition class </para><namespace name="boost">
  1993. <namespace name="interprocess">
  1994. <class name="interprocess_condition"><description><para>This class is a condition variable that can be placed in shared memory or memory mapped files. Destroys the object of type std::condition_variable_any</para><para>Unlike std::condition_variable in C++11, it is NOT safe to invoke the destructor if all threads have been only notified. It is required that they have exited their respective wait functions. </para></description><method-group name="public member functions">
  1995. <method name="notify_one"><type>void</type><description><para>If there is a thread waiting on *this, change that thread's state to ready. Otherwise there is no effect. </para></description></method>
  1996. <method name="notify_all"><type>void</type><description><para>Change the state of all threads waiting on *this to ready. If there are no waiting threads, notify_all() has no effect. </para></description></method>
  1997. <method name="wait"><type>void</type><template>
  1998. <template-type-parameter name="L"/>
  1999. </template><parameter name="lock"><paramtype>L &amp;</paramtype></parameter><description><para>Releases the lock on the <classname alt="boost::interprocess::interprocess_mutex">interprocess_mutex</classname> object associated with lock, blocks the current thread of execution until readied by a call to this-&gt;notify_one() or this-&gt;notify_all(), and then reacquires the lock. </para></description></method>
  2000. <method name="wait"><type>void</type><template>
  2001. <template-type-parameter name="L"/>
  2002. <template-type-parameter name="Pr"/>
  2003. </template><parameter name="lock"><paramtype>L &amp;</paramtype></parameter><parameter name="pred"><paramtype>Pr</paramtype></parameter><description><para>The same as: while (!pred()) wait(lock) </para></description></method>
  2004. <method name="timed_wait"><type>bool</type><template>
  2005. <template-type-parameter name="L"/>
  2006. </template><parameter name="lock"><paramtype>L &amp;</paramtype></parameter><parameter name="abs_time"><paramtype>const boost::posix_time::ptime &amp;</paramtype></parameter><description><para>Releases the lock on the <classname alt="boost::interprocess::interprocess_mutex">interprocess_mutex</classname> object associated with lock, blocks the current thread of execution until readied by a call to this-&gt;notify_one() or this-&gt;notify_all(), or until time abs_time is reached, and then reacquires the lock. Returns: false if time abs_time is reached, otherwise true. </para></description></method>
  2007. <method name="timed_wait"><type>bool</type><template>
  2008. <template-type-parameter name="L"/>
  2009. <template-type-parameter name="Pr"/>
  2010. </template><parameter name="lock"><paramtype>L &amp;</paramtype></parameter><parameter name="abs_time"><paramtype>const boost::posix_time::ptime &amp;</paramtype></parameter><parameter name="pred"><paramtype>Pr</paramtype></parameter><description><para>The same as: while (!pred()) { if (!timed_wait(lock, abs_time)) return pred(); } return true; </para></description></method>
  2011. </method-group>
  2012. <constructor><purpose>Constructs a <classname alt="boost::interprocess::interprocess_condition">interprocess_condition</classname>. On error throws <classname alt="boost::interprocess::interprocess_exception">interprocess_exception</classname>. </purpose></constructor>
  2013. <destructor><description><para>Destroys *this liberating system resources. </para></description></destructor>
  2014. </class>
  2015. </namespace>
  2016. </namespace>
  2017. </header>
  2018. <header name="boost/interprocess/sync/interprocess_condition_any.hpp">
  2019. <para>Describes process-shared variables interprocess_condition_any class </para><namespace name="boost">
  2020. <namespace name="interprocess">
  2021. <class name="interprocess_condition_any"><description><para>This class is a condition variable that can be placed in shared memory or memory mapped files.</para><para>The <classname alt="boost::interprocess::interprocess_condition_any">interprocess_condition_any</classname> class is a generalization of <classname alt="boost::interprocess::interprocess_condition">interprocess_condition</classname>. Whereas <classname alt="boost::interprocess::interprocess_condition">interprocess_condition</classname> works only on Locks with mutex_type == <classname alt="boost::interprocess::interprocess_mutex">interprocess_mutex</classname> <classname alt="boost::interprocess::interprocess_condition_any">interprocess_condition_any</classname> can operate on any user-defined lock that meets the BasicLockable requirements (lock()/unlock() member functions).</para><para>Unlike std::condition_variable_any in C++11, it is NOT safe to invoke the destructor if all threads have been only notified. It is required that they have exited their respective wait functions. </para></description><method-group name="public member functions">
  2022. <method name="notify_one"><type>void</type><description><para>If there is a thread waiting on *this, change that thread's state to ready. Otherwise there is no effect. </para></description></method>
  2023. <method name="notify_all"><type>void</type><description><para>Change the state of all threads waiting on *this to ready. If there are no waiting threads, notify_all() has no effect. </para></description></method>
  2024. <method name="wait"><type>void</type><template>
  2025. <template-type-parameter name="L"/>
  2026. </template><parameter name="lock"><paramtype>L &amp;</paramtype></parameter><description><para>Releases the lock on the <classname alt="boost::interprocess::interprocess_mutex">interprocess_mutex</classname> object associated with lock, blocks the current thread of execution until readied by a call to this-&gt;notify_one() or this-&gt;notify_all(), and then reacquires the lock. </para></description></method>
  2027. <method name="wait"><type>void</type><template>
  2028. <template-type-parameter name="L"/>
  2029. <template-type-parameter name="Pr"/>
  2030. </template><parameter name="lock"><paramtype>L &amp;</paramtype></parameter><parameter name="pred"><paramtype>Pr</paramtype></parameter><description><para>The same as: while (!pred()) wait(lock) </para></description></method>
  2031. <method name="timed_wait"><type>bool</type><template>
  2032. <template-type-parameter name="L"/>
  2033. </template><parameter name="lock"><paramtype>L &amp;</paramtype></parameter><parameter name="abs_time"><paramtype>const boost::posix_time::ptime &amp;</paramtype></parameter><description><para>Releases the lock on the <classname alt="boost::interprocess::interprocess_mutex">interprocess_mutex</classname> object associated with lock, blocks the current thread of execution until readied by a call to this-&gt;notify_one() or this-&gt;notify_all(), or until time abs_time is reached, and then reacquires the lock. Returns: false if time abs_time is reached, otherwise true. </para></description></method>
  2034. <method name="timed_wait"><type>bool</type><template>
  2035. <template-type-parameter name="L"/>
  2036. <template-type-parameter name="Pr"/>
  2037. </template><parameter name="lock"><paramtype>L &amp;</paramtype></parameter><parameter name="abs_time"><paramtype>const boost::posix_time::ptime &amp;</paramtype></parameter><parameter name="pred"><paramtype>Pr</paramtype></parameter><description><para>The same as: while (!pred()) { if (!timed_wait(lock, abs_time)) return pred(); } return true; </para></description></method>
  2038. </method-group>
  2039. <constructor><purpose>Constructs a <classname alt="boost::interprocess::interprocess_condition_any">interprocess_condition_any</classname>. On error throws <classname alt="boost::interprocess::interprocess_exception">interprocess_exception</classname>. </purpose></constructor>
  2040. <destructor><description><para>Destroys *this liberating system resources. </para></description></destructor>
  2041. </class>
  2042. </namespace>
  2043. </namespace>
  2044. </header>
  2045. <header name="boost/interprocess/sync/interprocess_mutex.hpp">
  2046. <para>Describes a mutex class that can be placed in memory shared by several processes. </para><namespace name="boost">
  2047. <namespace name="interprocess">
  2048. <class name="interprocess_mutex"><description><para>Wraps a <classname alt="boost::interprocess::interprocess_mutex">interprocess_mutex</classname> that can be placed in shared memory and can be shared between processes. Allows timed lock tries </para></description><method-group name="public member functions">
  2049. <method name="lock"><type>void</type><description><para>Effects: The calling thread tries to obtain ownership of the mutex, and if another thread has ownership of the mutex, it waits until it can obtain the ownership. If a thread takes ownership of the mutex the mutex must be unlocked by the same mutex. Throws: <classname alt="boost::interprocess::interprocess_exception">interprocess_exception</classname> on error. </para></description></method>
  2050. <method name="try_lock"><type>bool</type><description><para>Effects: The calling thread tries to obtain ownership of the mutex, and if another thread has ownership of the mutex returns immediately. Returns: If the thread acquires ownership of the mutex, returns true, if the another thread has ownership of the mutex, returns false. Throws: <classname alt="boost::interprocess::interprocess_exception">interprocess_exception</classname> on error. </para></description></method>
  2051. <method name="timed_lock"><type>bool</type><parameter name="abs_time"><paramtype>const boost::posix_time::ptime &amp;</paramtype></parameter><description><para>Effects: The calling thread will try to obtain exclusive ownership of the mutex if it can do so in until the specified time is reached. If the mutex supports recursive locking, the mutex must be unlocked the same number of times it is locked. Returns: If the thread acquires ownership of the mutex, returns true, if the timeout expires returns false. Throws: <classname alt="boost::interprocess::interprocess_exception">interprocess_exception</classname> on error. </para></description></method>
  2052. <method name="unlock"><type>void</type><description><para>Effects: The calling thread releases the exclusive ownership of the mutex. Throws: <classname alt="boost::interprocess::interprocess_exception">interprocess_exception</classname> on error. </para></description></method>
  2053. </method-group>
  2054. <constructor><description><para>Constructor. Throws <classname alt="boost::interprocess::interprocess_exception">interprocess_exception</classname> on error. </para></description></constructor>
  2055. <destructor><description><para>Destructor. If any process uses the mutex after the destructor is called the result is undefined. Does not throw. </para></description></destructor>
  2056. </class>
  2057. </namespace>
  2058. </namespace>
  2059. </header>
  2060. <header name="boost/interprocess/sync/interprocess_recursive_mutex.hpp">
  2061. <para>Describes interprocess_recursive_mutex and shared_recursive_try_mutex classes </para><namespace name="boost">
  2062. <namespace name="interprocess">
  2063. <class name="interprocess_recursive_mutex"><description><para>Wraps a <classname alt="boost::interprocess::interprocess_mutex">interprocess_mutex</classname> that can be placed in shared memory and can be shared between processes. Allows several locking calls by the same process. Allows timed lock tries </para></description><method-group name="public member functions">
  2064. <method name="lock"><type>void</type><description><para>Effects: The calling thread tries to obtain ownership of the mutex, and if another thread has ownership of the mutex, it waits until it can obtain the ownership. If a thread takes ownership of the mutex the mutex must be unlocked by the same mutex. The mutex must be unlocked the same number of times it is locked. Throws: <classname alt="boost::interprocess::interprocess_exception">interprocess_exception</classname> on error. </para></description></method>
  2065. <method name="try_lock"><type>bool</type><description><para>Tries to lock the <classname alt="boost::interprocess::interprocess_mutex">interprocess_mutex</classname>, returns false when <classname alt="boost::interprocess::interprocess_mutex">interprocess_mutex</classname> is already locked, returns true when success. The mutex must be unlocked the same number of times it is locked. Throws: <classname alt="boost::interprocess::interprocess_exception">interprocess_exception</classname> if a severe error is found </para></description></method>
  2066. <method name="timed_lock"><type>bool</type><parameter name="abs_time"><paramtype>const boost::posix_time::ptime &amp;</paramtype></parameter><description><para>Tries to lock the <classname alt="boost::interprocess::interprocess_mutex">interprocess_mutex</classname>, if <classname alt="boost::interprocess::interprocess_mutex">interprocess_mutex</classname> can't be locked before abs_time time, returns false. The mutex must be unlocked the same number of times it is locked. Throws: <classname alt="boost::interprocess::interprocess_exception">interprocess_exception</classname> if a severe error is found </para></description></method>
  2067. <method name="unlock"><type>void</type><description><para>Effects: The calling thread releases the exclusive ownership of the mutex. If the mutex supports recursive locking, the mutex must be unlocked the same number of times it is locked. Throws: <classname alt="boost::interprocess::interprocess_exception">interprocess_exception</classname> on error. </para></description></method>
  2068. </method-group>
  2069. <constructor><description><para>Constructor. Throws <classname alt="boost::interprocess::interprocess_exception">interprocess_exception</classname> on error. </para></description></constructor>
  2070. <destructor><description><para>Destructor. If any process uses the mutex after the destructor is called the result is undefined. Does not throw. </para></description></destructor>
  2071. </class>
  2072. </namespace>
  2073. </namespace>
  2074. </header>
  2075. <header name="boost/interprocess/sync/interprocess_semaphore.hpp">
  2076. <para>Describes a interprocess_semaphore class for inter-process synchronization </para><namespace name="boost">
  2077. <namespace name="interprocess">
  2078. <class name="interprocess_semaphore"><description><para>Wraps a <classname alt="boost::interprocess::interprocess_semaphore">interprocess_semaphore</classname> that can be placed in shared memory and can be shared between processes. Allows timed lock tries </para></description><method-group name="public member functions">
  2079. <method name="post"><type>void</type><description><para>Increments the <classname alt="boost::interprocess::interprocess_semaphore">interprocess_semaphore</classname> count. If there are processes/threads blocked waiting for the <classname alt="boost::interprocess::interprocess_semaphore">interprocess_semaphore</classname>, then one of these processes will return successfully from its wait function. If there is an error an <classname alt="boost::interprocess::interprocess_exception">interprocess_exception</classname> exception is thrown. </para></description></method>
  2080. <method name="wait"><type>void</type><description><para>Decrements the <classname alt="boost::interprocess::interprocess_semaphore">interprocess_semaphore</classname>. If the <classname alt="boost::interprocess::interprocess_semaphore">interprocess_semaphore</classname> value is not greater than zero, then the calling process/thread blocks until it can decrement the counter. If there is an error an <classname alt="boost::interprocess::interprocess_exception">interprocess_exception</classname> exception is thrown. </para></description></method>
  2081. <method name="try_wait"><type>bool</type><description><para>Decrements the <classname alt="boost::interprocess::interprocess_semaphore">interprocess_semaphore</classname> if the <classname alt="boost::interprocess::interprocess_semaphore">interprocess_semaphore</classname>'s value is greater than zero and returns true. If the value is not greater than zero returns false. If there is an error an <classname alt="boost::interprocess::interprocess_exception">interprocess_exception</classname> exception is thrown. </para></description></method>
  2082. <method name="timed_wait"><type>bool</type><parameter name="abs_time"><paramtype>const boost::posix_time::ptime &amp;</paramtype></parameter><description><para>Decrements the <classname alt="boost::interprocess::interprocess_semaphore">interprocess_semaphore</classname> if the <classname alt="boost::interprocess::interprocess_semaphore">interprocess_semaphore</classname>'s value is greater than zero and returns true. Otherwise, waits for the <classname alt="boost::interprocess::interprocess_semaphore">interprocess_semaphore</classname> to the posted or the timeout expires. If the timeout expires, the function returns false. If the <classname alt="boost::interprocess::interprocess_semaphore">interprocess_semaphore</classname> is posted the function returns true. If there is an error throws sem_exception </para></description></method>
  2083. </method-group>
  2084. <constructor><parameter name="initialCount"><paramtype>unsigned int</paramtype></parameter><description><para>Creates a <classname alt="boost::interprocess::interprocess_semaphore">interprocess_semaphore</classname> with the given initial count. <classname alt="boost::interprocess::interprocess_exception">interprocess_exception</classname> if there is an error. </para></description></constructor>
  2085. <destructor><description><para>Destroys the <classname alt="boost::interprocess::interprocess_semaphore">interprocess_semaphore</classname>. Does not throw </para></description></destructor>
  2086. </class>
  2087. </namespace>
  2088. </namespace>
  2089. </header>
  2090. <header name="boost/interprocess/sync/interprocess_sharable_mutex.hpp">
  2091. <para>Describes interprocess_sharable_mutex class </para><namespace name="boost">
  2092. <namespace name="interprocess">
  2093. <class name="interprocess_sharable_mutex"><description><para>Wraps a <classname alt="boost::interprocess::interprocess_sharable_mutex">interprocess_sharable_mutex</classname> that can be placed in shared memory and can be shared between processes. Allows timed lock tries </para></description><method-group name="private member functions">
  2094. </method-group>
  2095. <constructor><parameter name=""><paramtype>const <classname>interprocess_sharable_mutex</classname> &amp;</paramtype></parameter></constructor>
  2096. <copy-assignment><type><classname>interprocess_sharable_mutex</classname> &amp;</type><parameter name=""><paramtype>const <classname>interprocess_sharable_mutex</classname> &amp;</paramtype></parameter></copy-assignment>
  2097. <method-group name="public member functions">
  2098. <method name="lock"><type>void</type><description><para>Effects: The calling thread tries to obtain exclusive ownership of the mutex, and if another thread has exclusive or sharable ownership of the mutex, it waits until it can obtain the ownership. Throws: <classname alt="boost::interprocess::interprocess_exception">interprocess_exception</classname> on error. </para></description></method>
  2099. <method name="try_lock"><type>bool</type><description><para>Effects: The calling thread tries to acquire exclusive ownership of the mutex without waiting. If no other thread has exclusive or sharable ownership of the mutex this succeeds. Returns: If it can acquire exclusive ownership immediately returns true. If it has to wait, returns false. Throws: <classname alt="boost::interprocess::interprocess_exception">interprocess_exception</classname> on error. </para></description></method>
  2100. <method name="timed_lock"><type>bool</type><parameter name="abs_time"><paramtype>const boost::posix_time::ptime &amp;</paramtype></parameter><description><para>Effects: The calling thread tries to acquire exclusive ownership of the mutex waiting if necessary until no other thread has exclusive or sharable ownership of the mutex or abs_time is reached. Returns: If acquires exclusive ownership, returns true. Otherwise returns false. Throws: <classname alt="boost::interprocess::interprocess_exception">interprocess_exception</classname> on error. </para></description></method>
  2101. <method name="unlock"><type>void</type><description><para>Precondition: The thread must have exclusive ownership of the mutex. Effects: The calling thread releases the exclusive ownership of the mutex. Throws: An exception derived from <classname alt="boost::interprocess::interprocess_exception">interprocess_exception</classname> on error. </para></description></method>
  2102. <method name="lock_sharable"><type>void</type><description><para>Effects: The calling thread tries to obtain sharable ownership of the mutex, and if another thread has exclusive ownership of the mutex, waits until it can obtain the ownership. Throws: <classname alt="boost::interprocess::interprocess_exception">interprocess_exception</classname> on error. </para></description></method>
  2103. <method name="try_lock_sharable"><type>bool</type><description><para>Effects: The calling thread tries to acquire sharable ownership of the mutex without waiting. If no other thread has exclusive ownership of the mutex this succeeds. Returns: If it can acquire sharable ownership immediately returns true. If it has to wait, returns false. Throws: <classname alt="boost::interprocess::interprocess_exception">interprocess_exception</classname> on error. </para></description></method>
  2104. <method name="timed_lock_sharable"><type>bool</type><parameter name="abs_time"><paramtype>const boost::posix_time::ptime &amp;</paramtype></parameter><description><para>Effects: The calling thread tries to acquire sharable ownership of the mutex waiting if necessary until no other thread has exclusive ownership of the mutex or abs_time is reached. Returns: If acquires sharable ownership, returns true. Otherwise returns false. Throws: <classname alt="boost::interprocess::interprocess_exception">interprocess_exception</classname> on error. </para></description></method>
  2105. <method name="unlock_sharable"><type>void</type><description><para>Precondition: The thread must have sharable ownership of the mutex. Effects: The calling thread releases the sharable ownership of the mutex. Throws: An exception derived from <classname alt="boost::interprocess::interprocess_exception">interprocess_exception</classname> on error. </para></description></method>
  2106. </method-group>
  2107. <constructor><description><para>Constructs the sharable lock. Throws <classname alt="boost::interprocess::interprocess_exception">interprocess_exception</classname> on error. </para></description></constructor>
  2108. <destructor><description><para>Destroys the sharable lock. Does not throw. </para></description></destructor>
  2109. </class>
  2110. </namespace>
  2111. </namespace>
  2112. </header>
  2113. <header name="boost/interprocess/sync/interprocess_upgradable_mutex.hpp">
  2114. <para>Describes interprocess_upgradable_mutex class </para><namespace name="boost">
  2115. <namespace name="interprocess">
  2116. <class name="interprocess_upgradable_mutex"><description><para>Wraps a <classname alt="boost::interprocess::interprocess_upgradable_mutex">interprocess_upgradable_mutex</classname> that can be placed in shared memory and can be shared between processes. Allows timed lock tries </para></description><method-group name="private member functions">
  2117. </method-group>
  2118. <constructor><parameter name=""><paramtype>const <classname>interprocess_upgradable_mutex</classname> &amp;</paramtype></parameter></constructor>
  2119. <copy-assignment><type><classname>interprocess_upgradable_mutex</classname> &amp;</type><parameter name=""><paramtype>const <classname>interprocess_upgradable_mutex</classname> &amp;</paramtype></parameter></copy-assignment>
  2120. <method-group name="public member functions">
  2121. <method name="lock"><type>void</type><description><para>Effects: The calling thread tries to obtain exclusive ownership of the mutex, and if another thread has exclusive, sharable or upgradable ownership of the mutex, it waits until it can obtain the ownership. Throws: <classname alt="boost::interprocess::interprocess_exception">interprocess_exception</classname> on error. </para></description></method>
  2122. <method name="try_lock"><type>bool</type><description><para>Effects: The calling thread tries to acquire exclusive ownership of the mutex without waiting. If no other thread has exclusive, sharable or upgradable ownership of the mutex this succeeds. Returns: If it can acquire exclusive ownership immediately returns true. If it has to wait, returns false. Throws: <classname alt="boost::interprocess::interprocess_exception">interprocess_exception</classname> on error. </para></description></method>
  2123. <method name="timed_lock"><type>bool</type><parameter name="abs_time"><paramtype>const boost::posix_time::ptime &amp;</paramtype></parameter><description><para>Effects: The calling thread tries to acquire exclusive ownership of the mutex waiting if necessary until no other thread has exclusive, sharable or upgradable ownership of the mutex or abs_time is reached. Returns: If acquires exclusive ownership, returns true. Otherwise returns false. Throws: <classname alt="boost::interprocess::interprocess_exception">interprocess_exception</classname> on error. </para></description></method>
  2124. <method name="unlock"><type>void</type><description><para>Precondition: The thread must have exclusive ownership of the mutex. Effects: The calling thread releases the exclusive ownership of the mutex. Throws: An exception derived from <classname alt="boost::interprocess::interprocess_exception">interprocess_exception</classname> on error. </para></description></method>
  2125. <method name="lock_sharable"><type>void</type><description><para>Effects: The calling thread tries to obtain sharable ownership of the mutex, and if another thread has exclusive ownership of the mutex, waits until it can obtain the ownership. Throws: <classname alt="boost::interprocess::interprocess_exception">interprocess_exception</classname> on error. </para></description></method>
  2126. <method name="try_lock_sharable"><type>bool</type><description><para>Effects: The calling thread tries to acquire sharable ownership of the mutex without waiting. If no other thread has exclusive ownership of the mutex this succeeds. Returns: If it can acquire sharable ownership immediately returns true. If it has to wait, returns false. Throws: <classname alt="boost::interprocess::interprocess_exception">interprocess_exception</classname> on error. </para></description></method>
  2127. <method name="timed_lock_sharable"><type>bool</type><parameter name="abs_time"><paramtype>const boost::posix_time::ptime &amp;</paramtype></parameter><description><para>Effects: The calling thread tries to acquire sharable ownership of the mutex waiting if necessary until no other thread has exclusive ownership of the mutex or abs_time is reached. Returns: If acquires sharable ownership, returns true. Otherwise returns false. Throws: <classname alt="boost::interprocess::interprocess_exception">interprocess_exception</classname> on error. </para></description></method>
  2128. <method name="unlock_sharable"><type>void</type><description><para>Precondition: The thread must have sharable ownership of the mutex. Effects: The calling thread releases the sharable ownership of the mutex. Throws: An exception derived from <classname alt="boost::interprocess::interprocess_exception">interprocess_exception</classname> on error. </para></description></method>
  2129. <method name="lock_upgradable"><type>void</type><description><para>Effects: The calling thread tries to obtain upgradable ownership of the mutex, and if another thread has exclusive or upgradable ownership of the mutex, waits until it can obtain the ownership. Throws: <classname alt="boost::interprocess::interprocess_exception">interprocess_exception</classname> on error. </para></description></method>
  2130. <method name="try_lock_upgradable"><type>bool</type><description><para>Effects: The calling thread tries to acquire upgradable ownership of the mutex without waiting. If no other thread has exclusive or upgradable ownership of the mutex this succeeds. Returns: If it can acquire upgradable ownership immediately returns true. If it has to wait, returns false. Throws: <classname alt="boost::interprocess::interprocess_exception">interprocess_exception</classname> on error. </para></description></method>
  2131. <method name="timed_lock_upgradable"><type>bool</type><parameter name="abs_time"><paramtype>const boost::posix_time::ptime &amp;</paramtype></parameter><description><para>Effects: The calling thread tries to acquire upgradable ownership of the mutex waiting if necessary until no other thread has exclusive or upgradable ownership of the mutex or abs_time is reached. Returns: If acquires upgradable ownership, returns true. Otherwise returns false. Throws: <classname alt="boost::interprocess::interprocess_exception">interprocess_exception</classname> on error. </para></description></method>
  2132. <method name="unlock_upgradable"><type>void</type><description><para>Precondition: The thread must have upgradable ownership of the mutex. Effects: The calling thread releases the upgradable ownership of the mutex. Throws: An exception derived from <classname alt="boost::interprocess::interprocess_exception">interprocess_exception</classname> on error. </para></description></method>
  2133. <method name="unlock_and_lock_upgradable"><type>void</type><description><para>Precondition: The thread must have exclusive ownership of the mutex. Effects: The thread atomically releases exclusive ownership and acquires upgradable ownership. This operation is non-blocking. Throws: An exception derived from <classname alt="boost::interprocess::interprocess_exception">interprocess_exception</classname> on error. </para></description></method>
  2134. <method name="unlock_and_lock_sharable"><type>void</type><description><para>Precondition: The thread must have exclusive ownership of the mutex. Effects: The thread atomically releases exclusive ownership and acquires sharable ownership. This operation is non-blocking. Throws: An exception derived from <classname alt="boost::interprocess::interprocess_exception">interprocess_exception</classname> on error. </para></description></method>
  2135. <method name="unlock_upgradable_and_lock_sharable"><type>void</type><description><para>Precondition: The thread must have upgradable ownership of the mutex. Effects: The thread atomically releases upgradable ownership and acquires sharable ownership. This operation is non-blocking. Throws: An exception derived from <classname alt="boost::interprocess::interprocess_exception">interprocess_exception</classname> on error. </para></description></method>
  2136. <method name="unlock_upgradable_and_lock"><type>void</type><description><para>Precondition: The thread must have upgradable ownership of the mutex. Effects: The thread atomically releases upgradable ownership and acquires exclusive ownership. This operation will block until all threads with sharable ownership release their sharable lock. Throws: An exception derived from <classname alt="boost::interprocess::interprocess_exception">interprocess_exception</classname> on error. </para></description></method>
  2137. <method name="try_unlock_upgradable_and_lock"><type>bool</type><description><para>Precondition: The thread must have upgradable ownership of the mutex. Effects: The thread atomically releases upgradable ownership and tries to acquire exclusive ownership. This operation will fail if there are threads with sharable ownership, but it will maintain upgradable ownership. Returns: If acquires exclusive ownership, returns true. Otherwise returns false. Throws: An exception derived from <classname alt="boost::interprocess::interprocess_exception">interprocess_exception</classname> on error. </para></description></method>
  2138. <method name="timed_unlock_upgradable_and_lock"><type>*bool</type><parameter name="abs_time"><paramtype>const boost::posix_time::ptime &amp;</paramtype></parameter><description><para>Precondition: The thread must have upgradable ownership of the mutex. Effects: The thread atomically releases upgradable ownership and tries to acquire exclusive ownership, waiting if necessary until abs_time. This operation will fail if there are threads with sharable ownership or timeout reaches, but it will maintain upgradable ownership. Returns: If acquires exclusive ownership, returns true. Otherwise returns false. Throws: An exception derived from <classname alt="boost::interprocess::interprocess_exception">interprocess_exception</classname> on error. </para></description></method>
  2139. <method name="try_unlock_sharable_and_lock"><type>bool</type><description><para>Precondition: The thread must have sharable ownership of the mutex. Effects: The thread atomically releases sharable ownership and tries to acquire exclusive ownership. This operation will fail if there are threads with sharable or upgradable ownership, but it will maintain sharable ownership. Returns: If acquires exclusive ownership, returns true. Otherwise returns false. Throws: An exception derived from <classname alt="boost::interprocess::interprocess_exception">interprocess_exception</classname> on error. </para></description></method>
  2140. <method name="try_unlock_sharable_and_lock_upgradable"><type>bool</type><description><para>Precondition: The thread must have sharable ownership of the mutex. Effects: The thread atomically releases sharable ownership and tries to acquire upgradable ownership. This operation will fail if there are threads with sharable or upgradable ownership, but it will maintain sharable ownership. Returns: If acquires upgradable ownership, returns true. Otherwise returns false. Throws: An exception derived from <classname alt="boost::interprocess::interprocess_exception">interprocess_exception</classname> on error. </para></description></method>
  2141. </method-group>
  2142. <constructor><description><para>Constructs the upgradable lock. Throws <classname alt="boost::interprocess::interprocess_exception">interprocess_exception</classname> on error. </para></description></constructor>
  2143. <destructor><description><para>Destroys the upgradable lock. Does not throw. </para></description></destructor>
  2144. </class>
  2145. </namespace>
  2146. </namespace>
  2147. </header>
  2148. <header name="boost/interprocess/sync/lock_options.hpp">
  2149. <para>Describes the lock options with associated with interprocess_mutex lock constructors. </para><namespace name="boost">
  2150. <namespace name="interprocess">
  2151. <struct name="accept_ownership_type"><purpose>Type to indicate to a mutex lock constructor that the mutex is already locked. </purpose></struct><struct name="defer_lock_type"><purpose>Type to indicate to a mutex lock constructor that must not lock the mutex. </purpose></struct><struct name="try_to_lock_type"><purpose>Type to indicate to a mutex lock constructor that must try to lock the mutex. </purpose></struct><data-member name="defer_lock" specifiers="static"><type>const <classname>defer_lock_type</classname></type><description><para>An object indicating that the locking must be deferred. </para></description></data-member>
  2152. <data-member name="try_to_lock" specifiers="static"><type>const <classname>try_to_lock_type</classname></type><description><para>An object indicating that a try_lock() operation must be executed. </para></description></data-member>
  2153. <data-member name="accept_ownership" specifiers="static"><type>const <classname>accept_ownership_type</classname></type><description><para>An object indicating that the ownership of lockable object must be accepted by the new owner. </para></description></data-member>
  2154. </namespace>
  2155. </namespace>
  2156. </header>
  2157. <header name="boost/interprocess/sync/mutex_family.hpp">
  2158. <para>Describes a shared interprocess_mutex family fit algorithm used to allocate objects in shared memory. </para><namespace name="boost">
  2159. <namespace name="interprocess">
  2160. <struct name="mutex_family"><description><para>Describes <classname alt="boost::interprocess::interprocess_mutex">interprocess_mutex</classname> family to use with Interprocess framework based on boost::interprocess synchronization objects. </para></description><typedef name="mutex_type"><type><classname>boost::interprocess::interprocess_mutex</classname></type></typedef>
  2161. <typedef name="recursive_mutex_type"><type><classname>boost::interprocess::interprocess_recursive_mutex</classname></type></typedef>
  2162. </struct><struct name="null_mutex_family"><description><para>Describes <classname alt="boost::interprocess::interprocess_mutex">interprocess_mutex</classname> family to use with Interprocess frameworks based on null operation synchronization objects. </para></description><typedef name="mutex_type"><type><classname>boost::interprocess::null_mutex</classname></type></typedef>
  2163. <typedef name="recursive_mutex_type"><type><classname>boost::interprocess::null_mutex</classname></type></typedef>
  2164. </struct>
  2165. </namespace>
  2166. </namespace>
  2167. </header>
  2168. <header name="boost/interprocess/sync/named_condition.hpp">
  2169. <para>Describes a named condition class for inter-process synchronization </para><namespace name="boost">
  2170. <namespace name="interprocess">
  2171. <class name="named_condition"><description><para>A global condition variable that can be created by name. This condition variable is designed to work with <classname alt="boost::interprocess::named_mutex">named_mutex</classname> and can't be placed in shared memory or memory mapped files. </para></description><method-group name="public member functions">
  2172. <method name="notify_one"><type>*void</type><description><para>If there is a thread waiting on *this, change that thread's state to ready. Otherwise there is no effect. </para></description></method>
  2173. <method name="notify_all"><type>void</type><description><para>Change the state of all threads waiting on *this to ready. If there are no waiting threads, notify_all() has no effect. </para></description></method>
  2174. <method name="wait"><type>void</type><template>
  2175. <template-type-parameter name="L"/>
  2176. </template><parameter name="lock"><paramtype>L &amp;</paramtype></parameter><description><para>Releases the lock on the <classname alt="boost::interprocess::named_mutex">named_mutex</classname> object associated with lock, blocks the current thread of execution until readied by a call to this-&gt;notify_one() or this-&gt;notify_all(), and then reacquires the lock. </para></description></method>
  2177. <method name="wait"><type>void</type><template>
  2178. <template-type-parameter name="L"/>
  2179. <template-type-parameter name="Pr"/>
  2180. </template><parameter name="lock"><paramtype>L &amp;</paramtype></parameter><parameter name="pred"><paramtype>Pr</paramtype></parameter><description><para>The same as: while (!pred()) wait(lock) </para></description></method>
  2181. <method name="timed_wait"><type>bool</type><template>
  2182. <template-type-parameter name="L"/>
  2183. </template><parameter name="lock"><paramtype>L &amp;</paramtype></parameter><parameter name="abs_time"><paramtype>const boost::posix_time::ptime &amp;</paramtype></parameter><description><para>Releases the lock on the <classname alt="boost::interprocess::named_mutex">named_mutex</classname> object associated with lock, blocks the current thread of execution until readied by a call to this-&gt;notify_one() or this-&gt;notify_all(), or until time abs_time is reached, and then reacquires the lock. Returns: false if time abs_time is reached, otherwise true. </para></description></method>
  2184. <method name="timed_wait"><type>bool</type><template>
  2185. <template-type-parameter name="L"/>
  2186. <template-type-parameter name="Pr"/>
  2187. </template><parameter name="lock"><paramtype>L &amp;</paramtype></parameter><parameter name="abs_time"><paramtype>const boost::posix_time::ptime &amp;</paramtype></parameter><parameter name="pred"><paramtype>Pr</paramtype></parameter><description><para>The same as: while (!pred()) { if (!timed_wait(lock, abs_time)) return pred(); } return true; </para></description></method>
  2188. </method-group>
  2189. <constructor><parameter name="create_only"><paramtype><classname>create_only_t</classname></paramtype></parameter><parameter name="name"><paramtype>const char *</paramtype></parameter><parameter name="perm"><paramtype>const <classname>permissions</classname> &amp;</paramtype><default><classname alt="boost::interprocess::permissions">permissions</classname>()</default></parameter><description><para>Creates a global condition with a name. If the condition can't be created throws <classname alt="boost::interprocess::interprocess_exception">interprocess_exception</classname> </para></description></constructor>
  2190. <constructor><parameter name="open_or_create"><paramtype><classname>open_or_create_t</classname></paramtype></parameter><parameter name="name"><paramtype>const char *</paramtype></parameter><parameter name="perm"><paramtype>const <classname>permissions</classname> &amp;</paramtype><default><classname alt="boost::interprocess::permissions">permissions</classname>()</default></parameter><description><para>Opens or creates a global condition with a name. If the condition is created, this call is equivalent to named_condition(create_only_t, ... ) If the condition is already created, this call is equivalent named_condition(open_only_t, ... ) Does not throw </para></description></constructor>
  2191. <constructor><parameter name="open_only"><paramtype><classname>open_only_t</classname></paramtype></parameter><parameter name="name"><paramtype>const char *</paramtype></parameter><description><para>Opens a global condition with a name if that condition is previously created. If it is not previously created this function throws <classname alt="boost::interprocess::interprocess_exception">interprocess_exception</classname>. </para></description></constructor>
  2192. <destructor><description><para>Destroys *this and indicates that the calling process is finished using the resource. The destructor function will deallocate any system resources allocated by the system for use by this process for this resource. The resource can still be opened again calling the open constructor overload. To erase the resource from the system use remove(). </para></description></destructor>
  2193. <method-group name="public static functions">
  2194. <method name="remove" specifiers="static"><type>bool</type><parameter name="name"><paramtype>const char *</paramtype></parameter><description><para>Erases a named condition from the system. Returns false on error. Never throws. </para></description></method>
  2195. </method-group>
  2196. </class>
  2197. </namespace>
  2198. </namespace>
  2199. </header>
  2200. <header name="boost/interprocess/sync/named_condition_any.hpp">
  2201. <para>Describes a named condition class for inter-process synchronization </para><namespace name="boost">
  2202. <namespace name="interprocess">
  2203. <class name="named_condition_any"><description><para>A global condition variable that can be created by name. This condition variable is designed to work with <classname alt="boost::interprocess::named_mutex">named_mutex</classname> and can't be placed in shared memory or memory mapped files. </para></description><method-group name="public member functions">
  2204. <method name="notify_one"><type>*void</type><description><para>If there is a thread waiting on *this, change that thread's state to ready. Otherwise there is no effect. </para></description></method>
  2205. <method name="notify_all"><type>void</type><description><para>Change the state of all threads waiting on *this to ready. If there are no waiting threads, notify_all() has no effect. </para></description></method>
  2206. <method name="wait"><type>void</type><template>
  2207. <template-type-parameter name="L"/>
  2208. </template><parameter name="lock"><paramtype>L &amp;</paramtype></parameter><description><para>Releases the lock on the <classname alt="boost::interprocess::named_mutex">named_mutex</classname> object associated with lock, blocks the current thread of execution until readied by a call to this-&gt;notify_one() or this-&gt;notify_all(), and then reacquires the lock. </para></description></method>
  2209. <method name="wait"><type>void</type><template>
  2210. <template-type-parameter name="L"/>
  2211. <template-type-parameter name="Pr"/>
  2212. </template><parameter name="lock"><paramtype>L &amp;</paramtype></parameter><parameter name="pred"><paramtype>Pr</paramtype></parameter><description><para>The same as: while (!pred()) wait(lock) </para></description></method>
  2213. <method name="timed_wait"><type>bool</type><template>
  2214. <template-type-parameter name="L"/>
  2215. </template><parameter name="lock"><paramtype>L &amp;</paramtype></parameter><parameter name="abs_time"><paramtype>const boost::posix_time::ptime &amp;</paramtype></parameter><description><para>Releases the lock on the <classname alt="boost::interprocess::named_mutex">named_mutex</classname> object associated with lock, blocks the current thread of execution until readied by a call to this-&gt;notify_one() or this-&gt;notify_all(), or until time abs_time is reached, and then reacquires the lock. Returns: false if time abs_time is reached, otherwise true. </para></description></method>
  2216. <method name="timed_wait"><type>bool</type><template>
  2217. <template-type-parameter name="L"/>
  2218. <template-type-parameter name="Pr"/>
  2219. </template><parameter name="lock"><paramtype>L &amp;</paramtype></parameter><parameter name="abs_time"><paramtype>const boost::posix_time::ptime &amp;</paramtype></parameter><parameter name="pred"><paramtype>Pr</paramtype></parameter><description><para>The same as: while (!pred()) { if (!timed_wait(lock, abs_time)) return pred(); } return true; </para></description></method>
  2220. </method-group>
  2221. <constructor><parameter name=""><paramtype><classname>create_only_t</classname></paramtype></parameter><parameter name="name"><paramtype>const char *</paramtype></parameter><parameter name="perm"><paramtype>const <classname>permissions</classname> &amp;</paramtype><default><classname alt="boost::interprocess::permissions">permissions</classname>()</default></parameter><description><para>Creates a global condition with a name. If the condition can't be created throws <classname alt="boost::interprocess::interprocess_exception">interprocess_exception</classname> </para></description></constructor>
  2222. <constructor><parameter name=""><paramtype><classname>open_or_create_t</classname></paramtype></parameter><parameter name="name"><paramtype>const char *</paramtype></parameter><parameter name="perm"><paramtype>const <classname>permissions</classname> &amp;</paramtype><default><classname alt="boost::interprocess::permissions">permissions</classname>()</default></parameter><description><para>Opens or creates a global condition with a name. If the condition is created, this call is equivalent to named_condition_any(create_only_t, ... ) If the condition is already created, this call is equivalent named_condition_any(open_only_t, ... ) Does not throw </para></description></constructor>
  2223. <constructor><parameter name=""><paramtype><classname>open_only_t</classname></paramtype></parameter><parameter name="name"><paramtype>const char *</paramtype></parameter><description><para>Opens a global condition with a name if that condition is previously created. If it is not previously created this function throws <classname alt="boost::interprocess::interprocess_exception">interprocess_exception</classname>. </para></description></constructor>
  2224. <destructor><description><para>Destroys *this and indicates that the calling process is finished using the resource. The destructor function will deallocate any system resources allocated by the system for use by this process for this resource. The resource can still be opened again calling the open constructor overload. To erase the resource from the system use remove(). </para></description></destructor>
  2225. <method-group name="public static functions">
  2226. <method name="remove" specifiers="static"><type>bool</type><parameter name="name"><paramtype>const char *</paramtype></parameter><description><para>Erases a named condition from the system. Returns false on error. Never throws. </para></description></method>
  2227. </method-group>
  2228. </class>
  2229. </namespace>
  2230. </namespace>
  2231. </header>
  2232. <header name="boost/interprocess/sync/named_mutex.hpp">
  2233. <para>Describes a named mutex class for inter-process synchronization </para><namespace name="boost">
  2234. <namespace name="interprocess">
  2235. <class name="named_mutex"><description><para>A mutex with a global name, so it can be found from different processes. This mutex can't be placed in shared memory, and each process should have it's own <classname alt="boost::interprocess::named_mutex">named_mutex</classname>. </para></description><method-group name="public member functions">
  2236. <method name="unlock"><type>void</type><description><para>Unlocks a previously locked mutex. </para></description></method>
  2237. <method name="lock"><type>void</type><description><para>Locks the mutex, sleeps when the mutex is already locked. Throws <classname alt="boost::interprocess::interprocess_exception">interprocess_exception</classname> if a severe error is found </para></description></method>
  2238. <method name="try_lock"><type>bool</type><description><para>Tries to lock the mutex, returns false when the mutex is already locked, returns true when success. Throws <classname alt="boost::interprocess::interprocess_exception">interprocess_exception</classname> if a severe error is found </para></description></method>
  2239. <method name="timed_lock"><type>bool</type><parameter name="abs_time"><paramtype>const boost::posix_time::ptime &amp;</paramtype></parameter><description><para>Tries to lock the the mutex until time abs_time, Returns false when timeout expires, returns true when locks. Throws <classname alt="boost::interprocess::interprocess_exception">interprocess_exception</classname> if a severe error is found </para></description></method>
  2240. </method-group>
  2241. <constructor><parameter name="create_only"><paramtype><classname>create_only_t</classname></paramtype></parameter><parameter name="name"><paramtype>const char *</paramtype></parameter><parameter name="perm"><paramtype>const <classname>permissions</classname> &amp;</paramtype><default><classname alt="boost::interprocess::permissions">permissions</classname>()</default></parameter><description><para>Creates a global mutex with a name. Throws <classname alt="boost::interprocess::interprocess_exception">interprocess_exception</classname> on error. </para></description></constructor>
  2242. <constructor><parameter name="open_or_create"><paramtype><classname>open_or_create_t</classname></paramtype></parameter><parameter name="name"><paramtype>const char *</paramtype></parameter><parameter name="perm"><paramtype>const <classname>permissions</classname> &amp;</paramtype><default><classname alt="boost::interprocess::permissions">permissions</classname>()</default></parameter><description><para>Opens or creates a global mutex with a name. If the mutex is created, this call is equivalent to named_mutex(create_only_t, ... ) If the mutex is already created, this call is equivalent named_mutex(open_only_t, ... ) Does not throw </para></description></constructor>
  2243. <constructor><parameter name="open_only"><paramtype><classname>open_only_t</classname></paramtype></parameter><parameter name="name"><paramtype>const char *</paramtype></parameter><description><para>Opens a global mutex with a name if that mutex is previously created. If it is not previously created this function throws <classname alt="boost::interprocess::interprocess_exception">interprocess_exception</classname>. </para></description></constructor>
  2244. <destructor><description><para>Destroys *this and indicates that the calling process is finished using the resource. The destructor function will deallocate any system resources allocated by the system for use by this process for this resource. The resource can still be opened again calling the open constructor overload. To erase the resource from the system use remove(). </para></description></destructor>
  2245. <method-group name="public static functions">
  2246. <method name="remove" specifiers="static"><type>bool</type><parameter name="name"><paramtype>const char *</paramtype></parameter><description><para>Erases a named mutex from the system. Returns false on error. Never throws. </para></description></method>
  2247. </method-group>
  2248. </class>
  2249. </namespace>
  2250. </namespace>
  2251. </header>
  2252. <header name="boost/interprocess/sync/named_recursive_mutex.hpp">
  2253. <para>Describes a named named_recursive_mutex class for inter-process synchronization </para><namespace name="boost">
  2254. <namespace name="interprocess">
  2255. <class name="named_recursive_mutex"><description><para>A recursive mutex with a global name, so it can be found from different processes. This mutex can't be placed in shared memory, and each process should have it's own <classname alt="boost::interprocess::named_recursive_mutex">named_recursive_mutex</classname>. </para></description><method-group name="public member functions">
  2256. <method name="unlock"><type>void</type><description><para>Unlocks a previously locked <classname alt="boost::interprocess::named_recursive_mutex">named_recursive_mutex</classname>. </para></description></method>
  2257. <method name="lock"><type>void</type><description><para>Locks <classname alt="boost::interprocess::named_recursive_mutex">named_recursive_mutex</classname>, sleeps when <classname alt="boost::interprocess::named_recursive_mutex">named_recursive_mutex</classname> is already locked. Throws <classname alt="boost::interprocess::interprocess_exception">interprocess_exception</classname> if a severe error is found. </para></description></method>
  2258. <method name="try_lock"><type>bool</type><description><para>Tries to lock the <classname alt="boost::interprocess::named_recursive_mutex">named_recursive_mutex</classname>, returns false when <classname alt="boost::interprocess::named_recursive_mutex">named_recursive_mutex</classname> is already locked, returns true when success. Throws <classname alt="boost::interprocess::interprocess_exception">interprocess_exception</classname> if a severe error is found. </para></description></method>
  2259. <method name="timed_lock"><type>bool</type><parameter name="abs_time"><paramtype>const boost::posix_time::ptime &amp;</paramtype></parameter><description><para>Tries to lock the <classname alt="boost::interprocess::named_recursive_mutex">named_recursive_mutex</classname> until time abs_time, Returns false when timeout expires, returns true when locks. Throws <classname alt="boost::interprocess::interprocess_exception">interprocess_exception</classname> if a severe error is found </para></description></method>
  2260. </method-group>
  2261. <constructor><parameter name="create_only"><paramtype><classname>create_only_t</classname></paramtype></parameter><parameter name="name"><paramtype>const char *</paramtype></parameter><parameter name="perm"><paramtype>const <classname>permissions</classname> &amp;</paramtype><default><classname alt="boost::interprocess::permissions">permissions</classname>()</default></parameter><description><para>Creates a global recursive_mutex with a name. If the recursive_mutex can't be created throws <classname alt="boost::interprocess::interprocess_exception">interprocess_exception</classname> </para></description></constructor>
  2262. <constructor><parameter name="open_or_create"><paramtype><classname>open_or_create_t</classname></paramtype></parameter><parameter name="name"><paramtype>const char *</paramtype></parameter><parameter name="perm"><paramtype>const <classname>permissions</classname> &amp;</paramtype><default><classname alt="boost::interprocess::permissions">permissions</classname>()</default></parameter><description><para>Opens or creates a global recursive_mutex with a name. If the recursive_mutex is created, this call is equivalent to named_recursive_mutex(create_only_t, ... ) If the recursive_mutex is already created, this call is equivalent named_recursive_mutex(open_only_t, ... ) Does not throw </para></description></constructor>
  2263. <constructor><parameter name="open_only"><paramtype><classname>open_only_t</classname></paramtype></parameter><parameter name="name"><paramtype>const char *</paramtype></parameter><description><para>Opens a global recursive_mutex with a name if that recursive_mutex is previously created. If it is not previously created this function throws <classname alt="boost::interprocess::interprocess_exception">interprocess_exception</classname>. </para></description></constructor>
  2264. <destructor><description><para>Destroys *this and indicates that the calling process is finished using the resource. The destructor function will deallocate any system resources allocated by the system for use by this process for this resource. The resource can still be opened again calling the open constructor overload. To erase the resource from the system use remove(). </para></description></destructor>
  2265. <method-group name="public static functions">
  2266. <method name="remove" specifiers="static"><type>bool</type><parameter name="name"><paramtype>const char *</paramtype></parameter><description><para>Erases a named recursive mutex from the system </para></description></method>
  2267. </method-group>
  2268. </class>
  2269. </namespace>
  2270. </namespace>
  2271. </header>
  2272. <header name="boost/interprocess/sync/named_semaphore.hpp">
  2273. <para>Describes a named semaphore class for inter-process synchronization </para><namespace name="boost">
  2274. <namespace name="interprocess">
  2275. <class name="named_semaphore"><description><para>A semaphore with a global name, so it can be found from different processes. Allows several resource sharing patterns and efficient acknowledgment mechanisms. </para></description><method-group name="public member functions">
  2276. <method name="post"><type>void</type><description><para>Increments the semaphore count. If there are processes/threads blocked waiting for the semaphore, then one of these processes will return successfully from its wait function. If there is an error an <classname alt="boost::interprocess::interprocess_exception">interprocess_exception</classname> exception is thrown. </para></description></method>
  2277. <method name="wait"><type>void</type><description><para>Decrements the semaphore. If the semaphore value is not greater than zero, then the calling process/thread blocks until it can decrement the counter. If there is an error an <classname alt="boost::interprocess::interprocess_exception">interprocess_exception</classname> exception is thrown. </para></description></method>
  2278. <method name="try_wait"><type>bool</type><description><para>Decrements the semaphore if the semaphore's value is greater than zero and returns true. If the value is not greater than zero returns false. If there is an error an <classname alt="boost::interprocess::interprocess_exception">interprocess_exception</classname> exception is thrown. </para></description></method>
  2279. <method name="timed_wait"><type>bool</type><parameter name="abs_time"><paramtype>const boost::posix_time::ptime &amp;</paramtype></parameter><description><para>Decrements the semaphore if the semaphore's value is greater than zero and returns true. Otherwise, waits for the semaphore to the posted or the timeout expires. If the timeout expires, the function returns false. If the semaphore is posted the function returns true. If there is an error throws sem_exception </para></description></method>
  2280. </method-group>
  2281. <constructor><parameter name=""><paramtype><classname>create_only_t</classname></paramtype></parameter><parameter name="name"><paramtype>const char *</paramtype></parameter><parameter name="initialCount"><paramtype>unsigned int</paramtype></parameter><parameter name="perm"><paramtype>const <classname>permissions</classname> &amp;</paramtype><default><classname alt="boost::interprocess::permissions">permissions</classname>()</default></parameter><description><para>Creates a global semaphore with a name, and an initial count. If the semaphore can't be created throws <classname alt="boost::interprocess::interprocess_exception">interprocess_exception</classname> </para></description></constructor>
  2282. <constructor><parameter name=""><paramtype><classname>open_or_create_t</classname></paramtype></parameter><parameter name="name"><paramtype>const char *</paramtype></parameter><parameter name="initialCount"><paramtype>unsigned int</paramtype></parameter><parameter name="perm"><paramtype>const <classname>permissions</classname> &amp;</paramtype><default><classname alt="boost::interprocess::permissions">permissions</classname>()</default></parameter><description><para>Opens or creates a global semaphore with a name, and an initial count. If the semaphore is created, this call is equivalent to named_semaphore(create_only_t, ...) If the semaphore is already created, this call is equivalent to named_semaphore(open_only_t, ... ) and initialCount is ignored. </para></description></constructor>
  2283. <constructor><parameter name=""><paramtype><classname>open_only_t</classname></paramtype></parameter><parameter name="name"><paramtype>const char *</paramtype></parameter><description><para>Opens a global semaphore with a name if that semaphore is previously. created. If it is not previously created this function throws <classname alt="boost::interprocess::interprocess_exception">interprocess_exception</classname>. </para></description></constructor>
  2284. <destructor><description><para>Destroys *this and indicates that the calling process is finished using the resource. The destructor function will deallocate any system resources allocated by the system for use by this process for this resource. The resource can still be opened again calling the open constructor overload. To erase the resource from the system use remove(). </para></description></destructor>
  2285. <method-group name="public static functions">
  2286. <method name="remove" specifiers="static"><type>bool</type><parameter name="name"><paramtype>const char *</paramtype></parameter><description><para>Erases a named semaphore from the system. Returns false on error. Never throws. </para></description></method>
  2287. </method-group>
  2288. </class>
  2289. </namespace>
  2290. </namespace>
  2291. </header>
  2292. <header name="boost/interprocess/sync/named_sharable_mutex.hpp">
  2293. <para>Describes a named sharable mutex class for inter-process synchronization </para><namespace name="boost">
  2294. <namespace name="interprocess">
  2295. <class name="named_sharable_mutex"><description><para>A sharable mutex with a global name, so it can be found from different processes. This mutex can't be placed in shared memory, and each process should have it's own named sharable mutex. </para></description><method-group name="public member functions">
  2296. <method name="lock"><type>void</type><description><para>Effects: The calling thread tries to obtain exclusive ownership of the mutex, and if another thread has exclusive or sharable ownership of the mutex, it waits until it can obtain the ownership. Throws: <classname alt="boost::interprocess::interprocess_exception">interprocess_exception</classname> on error. </para></description></method>
  2297. <method name="try_lock"><type>bool</type><description><para>Effects: The calling thread tries to acquire exclusive ownership of the mutex without waiting. If no other thread has exclusive or sharable ownership of the mutex this succeeds. Returns: If it can acquire exclusive ownership immediately returns true. If it has to wait, returns false. Throws: <classname alt="boost::interprocess::interprocess_exception">interprocess_exception</classname> on error. </para></description></method>
  2298. <method name="timed_lock"><type>bool</type><parameter name="abs_time"><paramtype>const boost::posix_time::ptime &amp;</paramtype></parameter><description><para>Effects: The calling thread tries to acquire exclusive ownership of the mutex waiting if necessary until no other thread has exclusive, or sharable ownership of the mutex or abs_time is reached. Returns: If acquires exclusive ownership, returns true. Otherwise returns false. Throws: <classname alt="boost::interprocess::interprocess_exception">interprocess_exception</classname> on error. </para></description></method>
  2299. <method name="unlock"><type>void</type><description><para>Precondition: The thread must have exclusive ownership of the mutex. Effects: The calling thread releases the exclusive ownership of the mutex. Throws: An exception derived from <classname alt="boost::interprocess::interprocess_exception">interprocess_exception</classname> on error. </para></description></method>
  2300. <method name="lock_sharable"><type>void</type><description><para>Effects: The calling thread tries to obtain sharable ownership of the mutex, and if another thread has exclusive ownership of the mutex, waits until it can obtain the ownership. Throws: <classname alt="boost::interprocess::interprocess_exception">interprocess_exception</classname> on error. </para></description></method>
  2301. <method name="try_lock_sharable"><type>bool</type><description><para>Effects: The calling thread tries to acquire sharable ownership of the mutex without waiting. If no other thread has exclusive ownership of the mutex this succeeds. Returns: If it can acquire sharable ownership immediately returns true. If it has to wait, returns false. Throws: <classname alt="boost::interprocess::interprocess_exception">interprocess_exception</classname> on error. </para></description></method>
  2302. <method name="timed_lock_sharable"><type>bool</type><parameter name="abs_time"><paramtype>const boost::posix_time::ptime &amp;</paramtype></parameter><description><para>Effects: The calling thread tries to acquire sharable ownership of the mutex waiting if necessary until no other thread has exclusive ownership of the mutex or abs_time is reached. Returns: If acquires sharable ownership, returns true. Otherwise returns false. Throws: <classname alt="boost::interprocess::interprocess_exception">interprocess_exception</classname> on error. </para></description></method>
  2303. <method name="unlock_sharable"><type>void</type><description><para>Precondition: The thread must have sharable ownership of the mutex. Effects: The calling thread releases the sharable ownership of the mutex. Throws: An exception derived from <classname alt="boost::interprocess::interprocess_exception">interprocess_exception</classname> on error. </para></description></method>
  2304. </method-group>
  2305. <constructor><parameter name="create_only"><paramtype><classname>create_only_t</classname></paramtype></parameter><parameter name="name"><paramtype>const char *</paramtype></parameter><parameter name="perm"><paramtype>const <classname>permissions</classname> &amp;</paramtype><default><classname alt="boost::interprocess::permissions">permissions</classname>()</default></parameter><description><para>Creates a global sharable mutex with a name. If the sharable mutex can't be created throws <classname alt="boost::interprocess::interprocess_exception">interprocess_exception</classname> </para></description></constructor>
  2306. <constructor><parameter name="open_or_create"><paramtype><classname>open_or_create_t</classname></paramtype></parameter><parameter name="name"><paramtype>const char *</paramtype></parameter><parameter name="perm"><paramtype>const <classname>permissions</classname> &amp;</paramtype><default><classname alt="boost::interprocess::permissions">permissions</classname>()</default></parameter><description><para>Opens or creates a global sharable mutex with a name. If the sharable mutex is created, this call is equivalent to named_sharable_mutex(create_only_t, ...) If the sharable mutex is already created, this call is equivalent to named_sharable_mutex(open_only_t, ... ). </para></description></constructor>
  2307. <constructor><parameter name="open_only"><paramtype><classname>open_only_t</classname></paramtype></parameter><parameter name="name"><paramtype>const char *</paramtype></parameter><description><para>Opens a global sharable mutex with a name if that sharable mutex is previously. created. If it is not previously created this function throws <classname alt="boost::interprocess::interprocess_exception">interprocess_exception</classname>. </para></description></constructor>
  2308. <destructor><description><para>Destroys *this and indicates that the calling process is finished using the resource. The destructor function will deallocate any system resources allocated by the system for use by this process for this resource. The resource can still be opened again calling the open constructor overload. To erase the resource from the system use remove(). </para></description></destructor>
  2309. <method-group name="public static functions">
  2310. <method name="remove" specifiers="static"><type>bool</type><parameter name="name"><paramtype>const char *</paramtype></parameter><description><para>Erases a named sharable mutex from the system. Returns false on error. Never throws. </para></description></method>
  2311. </method-group>
  2312. </class>
  2313. </namespace>
  2314. </namespace>
  2315. </header>
  2316. <header name="boost/interprocess/sync/named_upgradable_mutex.hpp">
  2317. <para>Describes a named upgradable mutex class for inter-process synchronization </para><namespace name="boost">
  2318. <namespace name="interprocess">
  2319. <class name="named_upgradable_mutex"><description><para>A upgradable mutex with a global name, so it can be found from different processes. This mutex can't be placed in shared memory, and each process should have it's own named upgradable mutex. </para></description><method-group name="public member functions">
  2320. <method name="lock"><type>void</type><description><para>Effects: The calling thread tries to obtain exclusive ownership of the mutex, and if another thread has exclusive, sharable or upgradable ownership of the mutex, it waits until it can obtain the ownership. Throws: <classname alt="boost::interprocess::interprocess_exception">interprocess_exception</classname> on error. </para></description></method>
  2321. <method name="try_lock"><type>bool</type><description><para>Effects: The calling thread tries to acquire exclusive ownership of the mutex without waiting. If no other thread has exclusive, sharable or upgradable ownership of the mutex this succeeds. Returns: If it can acquire exclusive ownership immediately returns true. If it has to wait, returns false. Throws: <classname alt="boost::interprocess::interprocess_exception">interprocess_exception</classname> on error. </para></description></method>
  2322. <method name="timed_lock"><type>bool</type><parameter name="abs_time"><paramtype>const boost::posix_time::ptime &amp;</paramtype></parameter><description><para>Effects: The calling thread tries to acquire exclusive ownership of the mutex waiting if necessary until no other thread has exclusive, sharable or upgradable ownership of the mutex or abs_time is reached. Returns: If acquires exclusive ownership, returns true. Otherwise returns false. Throws: <classname alt="boost::interprocess::interprocess_exception">interprocess_exception</classname> on error. </para></description></method>
  2323. <method name="unlock"><type>void</type><description><para>Precondition: The thread must have exclusive ownership of the mutex. Effects: The calling thread releases the exclusive ownership of the mutex. Throws: An exception derived from <classname alt="boost::interprocess::interprocess_exception">interprocess_exception</classname> on error. </para></description></method>
  2324. <method name="lock_sharable"><type>void</type><description><para>Effects: The calling thread tries to obtain sharable ownership of the mutex, and if another thread has exclusive ownership of the mutex, waits until it can obtain the ownership. Throws: <classname alt="boost::interprocess::interprocess_exception">interprocess_exception</classname> on error. </para></description></method>
  2325. <method name="try_lock_sharable"><type>bool</type><description><para>Effects: The calling thread tries to acquire sharable ownership of the mutex without waiting. If no other thread has exclusive ownership of the mutex this succeeds. Returns: If it can acquire sharable ownership immediately returns true. If it has to wait, returns false. Throws: <classname alt="boost::interprocess::interprocess_exception">interprocess_exception</classname> on error. </para></description></method>
  2326. <method name="timed_lock_sharable"><type>bool</type><parameter name="abs_time"><paramtype>const boost::posix_time::ptime &amp;</paramtype></parameter><description><para>Effects: The calling thread tries to acquire sharable ownership of the mutex waiting if necessary until no other thread has exclusive ownership of the mutex or abs_time is reached. Returns: If acquires sharable ownership, returns true. Otherwise returns false. Throws: <classname alt="boost::interprocess::interprocess_exception">interprocess_exception</classname> on error. </para></description></method>
  2327. <method name="unlock_sharable"><type>void</type><description><para>Precondition: The thread must have sharable ownership of the mutex. Effects: The calling thread releases the sharable ownership of the mutex. Throws: An exception derived from <classname alt="boost::interprocess::interprocess_exception">interprocess_exception</classname> on error. </para></description></method>
  2328. <method name="lock_upgradable"><type>void</type><description><para>Effects: The calling thread tries to obtain upgradable ownership of the mutex, and if another thread has exclusive or upgradable ownership of the mutex, waits until it can obtain the ownership. Throws: <classname alt="boost::interprocess::interprocess_exception">interprocess_exception</classname> on error. </para></description></method>
  2329. <method name="try_lock_upgradable"><type>bool</type><description><para>Effects: The calling thread tries to acquire upgradable ownership of the mutex without waiting. If no other thread has exclusive or upgradable ownership of the mutex this succeeds. Returns: If it can acquire upgradable ownership immediately returns true. If it has to wait, returns false. Throws: <classname alt="boost::interprocess::interprocess_exception">interprocess_exception</classname> on error. </para></description></method>
  2330. <method name="timed_lock_upgradable"><type>bool</type><parameter name="abs_time"><paramtype>const boost::posix_time::ptime &amp;</paramtype></parameter><description><para>Effects: The calling thread tries to acquire upgradable ownership of the mutex waiting if necessary until no other thread has exclusive or upgradable ownership of the mutex or abs_time is reached. Returns: If acquires upgradable ownership, returns true. Otherwise returns false. Throws: <classname alt="boost::interprocess::interprocess_exception">interprocess_exception</classname> on error. </para></description></method>
  2331. <method name="unlock_upgradable"><type>void</type><description><para>Precondition: The thread must have upgradable ownership of the mutex. Effects: The calling thread releases the upgradable ownership of the mutex. Throws: An exception derived from <classname alt="boost::interprocess::interprocess_exception">interprocess_exception</classname> on error. </para></description></method>
  2332. <method name="unlock_and_lock_upgradable"><type>void</type><description><para>Precondition: The thread must have exclusive ownership of the mutex. Effects: The thread atomically releases exclusive ownership and acquires upgradable ownership. This operation is non-blocking. Throws: An exception derived from <classname alt="boost::interprocess::interprocess_exception">interprocess_exception</classname> on error. </para></description></method>
  2333. <method name="unlock_and_lock_sharable"><type>void</type><description><para>Precondition: The thread must have exclusive ownership of the mutex. Effects: The thread atomically releases exclusive ownership and acquires sharable ownership. This operation is non-blocking. Throws: An exception derived from <classname alt="boost::interprocess::interprocess_exception">interprocess_exception</classname> on error. </para></description></method>
  2334. <method name="unlock_upgradable_and_lock_sharable"><type>void</type><description><para>Precondition: The thread must have upgradable ownership of the mutex. Effects: The thread atomically releases upgradable ownership and acquires sharable ownership. This operation is non-blocking. Throws: An exception derived from <classname alt="boost::interprocess::interprocess_exception">interprocess_exception</classname> on error. </para></description></method>
  2335. <method name="unlock_upgradable_and_lock"><type>void</type><description><para>Precondition: The thread must have upgradable ownership of the mutex. Effects: The thread atomically releases upgradable ownership and acquires exclusive ownership. This operation will block until all threads with sharable ownership release it. Throws: An exception derived from <classname alt="boost::interprocess::interprocess_exception">interprocess_exception</classname> on error. </para></description></method>
  2336. <method name="try_unlock_upgradable_and_lock"><type>bool</type><description><para>Precondition: The thread must have upgradable ownership of the mutex. Effects: The thread atomically releases upgradable ownership and tries to acquire exclusive ownership. This operation will fail if there are threads with sharable ownership, but it will maintain upgradable ownership. Returns: If acquires exclusive ownership, returns true. Otherwise returns false. Throws: An exception derived from <classname alt="boost::interprocess::interprocess_exception">interprocess_exception</classname> on error. </para></description></method>
  2337. <method name="timed_unlock_upgradable_and_lock"><type>bool</type><parameter name="abs_time"><paramtype>const boost::posix_time::ptime &amp;</paramtype></parameter><description><para>Precondition: The thread must have upgradable ownership of the mutex. Effects: The thread atomically releases upgradable ownership and tries to acquire exclusive ownership, waiting if necessary until abs_time. This operation will fail if there are threads with sharable ownership or timeout reaches, but it will maintain upgradable ownership. Returns: If acquires exclusive ownership, returns true. Otherwise returns false. Throws: An exception derived from <classname alt="boost::interprocess::interprocess_exception">interprocess_exception</classname> on error. </para></description></method>
  2338. <method name="try_unlock_sharable_and_lock"><type>bool</type><description><para>Precondition: The thread must have sharable ownership of the mutex. Effects: The thread atomically releases sharable ownership and tries to acquire exclusive ownership. This operation will fail if there are threads with sharable or upgradable ownership, but it will maintain sharable ownership. Returns: If acquires exclusive ownership, returns true. Otherwise returns false. Throws: An exception derived from <classname alt="boost::interprocess::interprocess_exception">interprocess_exception</classname> on error. </para></description></method>
  2339. <method name="try_unlock_sharable_and_lock_upgradable"><type>bool</type><description><para>Precondition: The thread must have sharable ownership of the mutex. Effects: The thread atomically releases sharable ownership and tries to acquire upgradable ownership. This operation will fail if there are threads with sharable or upgradable ownership, but it will maintain sharable ownership. Returns: If acquires upgradable ownership, returns true. Otherwise returns false. Throws: An exception derived from <classname alt="boost::interprocess::interprocess_exception">interprocess_exception</classname> on error. </para></description></method>
  2340. </method-group>
  2341. <constructor><parameter name="create_only"><paramtype><classname>create_only_t</classname></paramtype></parameter><parameter name="name"><paramtype>const char *</paramtype></parameter><parameter name="perm"><paramtype>const <classname>permissions</classname> &amp;</paramtype><default><classname alt="boost::interprocess::permissions">permissions</classname>()</default></parameter><description><para>Creates a global upgradable mutex with a name. If the upgradable mutex can't be created throws <classname alt="boost::interprocess::interprocess_exception">interprocess_exception</classname> </para></description></constructor>
  2342. <constructor><parameter name="open_or_create"><paramtype><classname>open_or_create_t</classname></paramtype></parameter><parameter name="name"><paramtype>const char *</paramtype></parameter><parameter name="perm"><paramtype>const <classname>permissions</classname> &amp;</paramtype><default><classname alt="boost::interprocess::permissions">permissions</classname>()</default></parameter><description><para>Opens or creates a global upgradable mutex with a name. If the upgradable mutex is created, this call is equivalent to named_upgradable_mutex(create_only_t, ...) If the upgradable mutex is already created, this call is equivalent to named_upgradable_mutex(open_only_t, ... ). </para></description></constructor>
  2343. <constructor><parameter name="open_only"><paramtype><classname>open_only_t</classname></paramtype></parameter><parameter name="name"><paramtype>const char *</paramtype></parameter><description><para>Opens a global upgradable mutex with a name if that upgradable mutex is previously. created. If it is not previously created this function throws <classname alt="boost::interprocess::interprocess_exception">interprocess_exception</classname>. </para></description></constructor>
  2344. <destructor><description><para>Destroys *this and indicates that the calling process is finished using the resource. The destructor function will deallocate any system resources allocated by the system for use by this process for this resource. The resource can still be opened again calling the open constructor overload. To erase the resource from the system use remove(). </para></description></destructor>
  2345. <method-group name="public static functions">
  2346. <method name="remove" specifiers="static"><type>bool</type><parameter name="name"><paramtype>const char *</paramtype></parameter><description><para>Erases a named upgradable mutex from the system. Returns false on error. Never throws. </para></description></method>
  2347. </method-group>
  2348. </class>
  2349. </namespace>
  2350. </namespace>
  2351. </header>
  2352. <header name="boost/interprocess/sync/null_mutex.hpp">
  2353. <para>Describes null_mutex classes </para><namespace name="boost">
  2354. <namespace name="interprocess">
  2355. <class name="null_mutex"><description><para>Implements a mutex that simulates a mutex without doing any operation and simulates a successful operation. </para></description><method-group name="public member functions">
  2356. <method name="lock"><type>void</type><purpose>Simulates a mutex lock() operation. Empty function. </purpose></method>
  2357. <method name="try_lock"><type>bool</type><description><para>Simulates a mutex try_lock() operation. Equivalent to "return true;" </para></description></method>
  2358. <method name="timed_lock"><type>bool</type><parameter name=""><paramtype>const boost::posix_time::ptime &amp;</paramtype></parameter><description><para>Simulates a mutex timed_lock() operation. Equivalent to "return true;" </para></description></method>
  2359. <method name="unlock"><type>void</type><description><para>Simulates a mutex unlock() operation. Empty function. </para></description></method>
  2360. <method name="lock_sharable"><type>void</type><description><para>Simulates a mutex lock_sharable() operation. Empty function. </para></description></method>
  2361. <method name="try_lock_sharable"><type>bool</type><description><para>Simulates a mutex try_lock_sharable() operation. Equivalent to "return true;" </para></description></method>
  2362. <method name="timed_lock_sharable"><type>bool</type><parameter name=""><paramtype>const boost::posix_time::ptime &amp;</paramtype></parameter><description><para>Simulates a mutex timed_lock_sharable() operation. Equivalent to "return true;" </para></description></method>
  2363. <method name="unlock_sharable"><type>void</type><description><para>Simulates a mutex unlock_sharable() operation. Empty function. </para></description></method>
  2364. <method name="lock_upgradable"><type>void</type><description><para>Simulates a mutex lock_upgradable() operation. Empty function. </para></description></method>
  2365. <method name="try_lock_upgradable"><type>bool</type><description><para>Simulates a mutex try_lock_upgradable() operation. Equivalent to "return true;" </para></description></method>
  2366. <method name="timed_lock_upgradable"><type>bool</type><parameter name=""><paramtype>const boost::posix_time::ptime &amp;</paramtype></parameter><description><para>Simulates a mutex timed_lock_upgradable() operation. Equivalent to "return true;" </para></description></method>
  2367. <method name="unlock_upgradable"><type>void</type><description><para>Simulates a mutex unlock_upgradable() operation. Empty function. </para></description></method>
  2368. <method name="unlock_and_lock_upgradable"><type>void</type><description><para>Simulates unlock_and_lock_upgradable(). Empty function. </para></description></method>
  2369. <method name="unlock_and_lock_sharable"><type>void</type><description><para>Simulates unlock_and_lock_sharable(). Empty function. </para></description></method>
  2370. <method name="unlock_upgradable_and_lock_sharable"><type>void</type><description><para>Simulates unlock_upgradable_and_lock_sharable(). Empty function. </para></description></method>
  2371. <method name="unlock_upgradable_and_lock"><type>void</type><description><para>Simulates unlock_upgradable_and_lock(). Empty function. </para></description></method>
  2372. <method name="try_unlock_upgradable_and_lock"><type>bool</type><description><para>Simulates try_unlock_upgradable_and_lock(). Equivalent to "return true;" </para></description></method>
  2373. <method name="timed_unlock_upgradable_and_lock"><type>bool</type><parameter name=""><paramtype>const boost::posix_time::ptime &amp;</paramtype></parameter><description><para>Simulates timed_unlock_upgradable_and_lock(). Equivalent to "return true;" </para></description></method>
  2374. <method name="try_unlock_sharable_and_lock"><type>bool</type><description><para>Simulates try_unlock_sharable_and_lock(). Equivalent to "return true;" </para></description></method>
  2375. <method name="try_unlock_sharable_and_lock_upgradable"><type>bool</type><description><para>Simulates try_unlock_sharable_and_lock_upgradable(). Equivalent to "return true;" </para></description></method>
  2376. </method-group>
  2377. <constructor><description><para>Constructor. Empty. </para></description></constructor>
  2378. <destructor><description><para>Destructor. Empty. </para></description></destructor>
  2379. </class>
  2380. </namespace>
  2381. </namespace>
  2382. </header>
  2383. <header name="boost/interprocess/sync/scoped_lock.hpp">
  2384. <para>Describes the scoped_lock class. </para><namespace name="boost">
  2385. <namespace name="interprocess">
  2386. <class name="scoped_lock"><template>
  2387. <template-type-parameter name="Mutex"/>
  2388. </template><description><para><classname alt="boost::interprocess::scoped_lock">scoped_lock</classname> is meant to carry out the tasks for locking, unlocking, try-locking and timed-locking (recursive or not) for the Mutex. The Mutex need not supply all of this functionality. If the client of scoped_lock&lt;Mutex&gt; does not use functionality which the Mutex does not supply, no harm is done. Mutex ownership transfer is supported through the syntax of move semantics. Ownership transfer is allowed both by construction and assignment. The <classname alt="boost::interprocess::scoped_lock">scoped_lock</classname> does not support copy semantics. A compile time error results if copy construction or copy assignment is attempted. Mutex ownership can also be moved from an <classname alt="boost::interprocess::upgradable_lock">upgradable_lock</classname> and <classname alt="boost::interprocess::sharable_lock">sharable_lock</classname> via constructor. In this role, <classname alt="boost::interprocess::scoped_lock">scoped_lock</classname> shares the same functionality as a write_lock. </para></description><typedef name="mutex_type"><type>Mutex</type></typedef>
  2389. <method-group name="public member functions">
  2390. <method name="lock"><type>void</type><description><para>Effects: If mutex() == 0 or if already locked, throws a lock_exception() exception. Calls lock() on the referenced mutex. Postconditions: owns() == true. Notes: The <classname alt="boost::interprocess::scoped_lock">scoped_lock</classname> changes from a state of not owning the mutex, to owning the mutex, blocking if necessary. </para></description></method>
  2391. <method name="try_lock"><type>*bool</type><description><para>Effects: If mutex() == 0 or if already locked, throws a lock_exception() exception. Calls try_lock() on the referenced mutex. Postconditions: owns() == the value returned from mutex()-&gt;try_lock(). Notes: The <classname alt="boost::interprocess::scoped_lock">scoped_lock</classname> changes from a state of not owning the mutex, to owning the mutex, but only if blocking was not required. If the mutex_type does not support try_lock(), this function will fail at compile time if instantiated, but otherwise have no effect. </para></description></method>
  2392. <method name="timed_lock"><type>*bool</type><parameter name="abs_time"><paramtype>const boost::posix_time::ptime &amp;</paramtype></parameter><description><para>Effects: If mutex() == 0 or if already locked, throws a lock_exception() exception. Calls timed_lock(abs_time) on the referenced mutex. Postconditions: owns() == the value returned from mutex()-&gt; timed_lock(abs_time). Notes: The <classname alt="boost::interprocess::scoped_lock">scoped_lock</classname> changes from a state of not owning the mutex, to owning the mutex, but only if it can obtain ownership by the specified time. If the mutex_type does not support timed_lock (), this function will fail at compile time if instantiated, but otherwise have no effect. </para></description></method>
  2393. <method name="unlock"><type>*void</type><description><para>Effects: If mutex() == 0 or if not locked, throws a lock_exception() exception. Calls unlock() on the referenced mutex. Postconditions: owns() == false. Notes: The <classname alt="boost::interprocess::scoped_lock">scoped_lock</classname> changes from a state of owning the mutex, to not owning the mutex. </para></description></method>
  2394. <method name="owns" cv="const"><type>bool</type><description><para>Effects: Returns true if this <classname alt="boost::interprocess::scoped_lock">scoped_lock</classname> has acquired the referenced mutex. </para></description></method>
  2395. <method name="conversion-operator" cv="const"><type>unspecified_bool_type</type><description><para>Conversion to bool. Returns owns(). </para></description></method>
  2396. <method name="mutex" cv="const"><type>mutex_type *</type><description><para>Effects: Returns a pointer to the referenced mutex, or 0 if there is no mutex to reference. </para></description></method>
  2397. <method name="release"><type>mutex_type *</type><description><para>Effects: Returns a pointer to the referenced mutex, or 0 if there is no mutex to reference. Postconditions: mutex() == 0 and owns() == false. </para></description></method>
  2398. <method name="swap"><type>void</type><parameter name="other"><paramtype><classname>scoped_lock</classname>&lt; mutex_type &gt; &amp;</paramtype></parameter><description><para>Effects: Swaps state with moved lock. Throws: Nothing. </para></description></method>
  2399. </method-group>
  2400. <constructor><description><para>Effects: Default constructs a <classname alt="boost::interprocess::scoped_lock">scoped_lock</classname>. Postconditions: owns() == false and mutex() == 0. </para></description></constructor>
  2401. <constructor specifiers="explicit"><parameter name="m"><paramtype>mutex_type &amp;</paramtype></parameter><description><para>Effects: m.lock(). Postconditions: owns() == true and mutex() == &amp;m. Notes: The constructor will take ownership of the mutex. If another thread already owns the mutex, this thread will block until the mutex is released. Whether or not this constructor handles recursive locking depends upon the mutex. </para></description></constructor>
  2402. <constructor><parameter name="m"><paramtype>mutex_type &amp;</paramtype></parameter><parameter name=""><paramtype><classname>defer_lock_type</classname></paramtype></parameter><description><para>Postconditions: owns() == false, and mutex() == &amp;m. Notes: The constructor will not take ownership of the mutex. There is no effect required on the referenced mutex. </para></description></constructor>
  2403. <constructor><parameter name="m"><paramtype>mutex_type &amp;</paramtype></parameter><parameter name=""><paramtype><classname>accept_ownership_type</classname></paramtype></parameter><description><para>Postconditions: owns() == true, and mutex() == &amp;m. Notes: The constructor will suppose that the mutex is already locked. There is no effect required on the referenced mutex. </para></description></constructor>
  2404. <constructor><parameter name="m"><paramtype>mutex_type &amp;</paramtype></parameter><parameter name=""><paramtype><classname>try_to_lock_type</classname></paramtype></parameter><description><para>Effects: m.try_lock(). Postconditions: mutex() == &amp;m. owns() == the return value of the m.try_lock() executed within the constructor. Notes: The constructor will take ownership of the mutex if it can do so without waiting. Whether or not this constructor handles recursive locking depends upon the mutex. If the mutex_type does not support try_lock, this constructor will fail at compile time if instantiated, but otherwise have no effect. </para></description></constructor>
  2405. <constructor><parameter name="m"><paramtype>mutex_type &amp;</paramtype></parameter><parameter name="abs_time"><paramtype>const boost::posix_time::ptime &amp;</paramtype></parameter><description><para>Effects: m.timed_lock(abs_time). Postconditions: mutex() == &amp;m. owns() == the return value of the m.timed_lock(abs_time) executed within the constructor. Notes: The constructor will take ownership of the mutex if it can do it until abs_time is reached. Whether or not this constructor handles recursive locking depends upon the mutex. If the mutex_type does not support try_lock, this constructor will fail at compile time if instantiated, but otherwise have no effect. </para></description></constructor>
  2406. <constructor><parameter name="scop"><paramtype><classname>scoped_lock</classname> &amp;&amp;</paramtype></parameter><description><para>Postconditions: mutex() == the value scop.mutex() had before the constructor executes. s1.mutex() == 0. owns() == the value of scop.owns() before the constructor executes. scop.owns(). Notes: If the scop <classname alt="boost::interprocess::scoped_lock">scoped_lock</classname> owns the mutex, ownership is moved to thisscoped_lock with no blocking. If the scop <classname alt="boost::interprocess::scoped_lock">scoped_lock</classname> does not own the mutex, then neither will this <classname alt="boost::interprocess::scoped_lock">scoped_lock</classname>. Only a moved <classname alt="boost::interprocess::scoped_lock">scoped_lock</classname>'s will match this signature. An non-moved <classname alt="boost::interprocess::scoped_lock">scoped_lock</classname> can be moved with the expression: "boost::move(lock);". This constructor does not alter the state of the mutex, only potentially who owns it. </para></description></constructor>
  2407. <constructor specifiers="explicit"><template>
  2408. <template-type-parameter name="T"/>
  2409. </template><parameter name="upgr"><paramtype><classname>upgradable_lock</classname>&lt; T &gt; &amp;&amp;</paramtype></parameter><parameter name=""><paramtype><emphasis>unspecified</emphasis></paramtype><default>0</default></parameter><description><para>Effects: If upgr.owns() then calls unlock_upgradable_and_lock() on the referenced mutex. upgr.release() is called. Postconditions: mutex() == the value upgr.mutex() had before the construction. upgr.mutex() == 0. owns() == upgr.owns() before the construction. upgr.owns() == false after the construction. Notes: If upgr is locked, this constructor will lock this <classname alt="boost::interprocess::scoped_lock">scoped_lock</classname> while unlocking upgr. If upgr is unlocked, then this <classname alt="boost::interprocess::scoped_lock">scoped_lock</classname> will be unlocked as well. Only a moved <classname alt="boost::interprocess::upgradable_lock">upgradable_lock</classname>'s will match this signature. An non-moved <classname alt="boost::interprocess::upgradable_lock">upgradable_lock</classname> can be moved with the expression: "boost::move(lock);" This constructor may block if other threads hold a <classname alt="boost::interprocess::sharable_lock">sharable_lock</classname> on this mutex (<classname alt="boost::interprocess::sharable_lock">sharable_lock</classname>'s can share ownership with an <classname alt="boost::interprocess::upgradable_lock">upgradable_lock</classname>). </para></description></constructor>
  2410. <constructor><template>
  2411. <template-type-parameter name="T"/>
  2412. </template><parameter name="upgr"><paramtype><classname>upgradable_lock</classname>&lt; T &gt; &amp;&amp;</paramtype></parameter><parameter name=""><paramtype><classname>try_to_lock_type</classname></paramtype></parameter><parameter name=""><paramtype><emphasis>unspecified</emphasis></paramtype><default>0</default></parameter><description><para>Effects: If upgr.owns() then calls try_unlock_upgradable_and_lock() on the referenced mutex: a)if try_unlock_upgradable_and_lock() returns true then mutex() obtains the value from upgr.release() and owns() is set to true. b)if try_unlock_upgradable_and_lock() returns false then upgr is unaffected and this <classname alt="boost::interprocess::scoped_lock">scoped_lock</classname> construction as the same effects as a default construction. c)Else upgr.owns() is false. mutex() obtains the value from upgr.release() and owns() is set to false Notes: This construction will not block. It will try to obtain mutex ownership from upgr immediately, while changing the lock type from a "read lock" to a "write lock". If the "read lock" isn't held in the first place, the mutex merely changes type to an unlocked "write lock". If the "read lock" is held, then mutex transfer occurs only if it can do so in a non-blocking manner. </para></description></constructor>
  2413. <constructor><template>
  2414. <template-type-parameter name="T"/>
  2415. </template><parameter name="upgr"><paramtype><classname>upgradable_lock</classname>&lt; T &gt; &amp;&amp;</paramtype></parameter><parameter name="abs_time"><paramtype>boost::posix_time::ptime &amp;</paramtype></parameter><parameter name=""><paramtype><emphasis>unspecified</emphasis></paramtype><default>0</default></parameter><description><para>Effects: If upgr.owns() then calls timed_unlock_upgradable_and_lock(abs_time) on the referenced mutex: a)if timed_unlock_upgradable_and_lock(abs_time) returns true then mutex() obtains the value from upgr.release() and owns() is set to true. b)if timed_unlock_upgradable_and_lock(abs_time) returns false then upgr is unaffected and this <classname alt="boost::interprocess::scoped_lock">scoped_lock</classname> construction as the same effects as a default construction. c)Else upgr.owns() is false. mutex() obtains the value from upgr.release() and owns() is set to false Notes: This construction will not block. It will try to obtain mutex ownership from upgr immediately, while changing the lock type from a "read lock" to a "write lock". If the "read lock" isn't held in the first place, the mutex merely changes type to an unlocked "write lock". If the "read lock" is held, then mutex transfer occurs only if it can do so in a non-blocking manner. </para></description></constructor>
  2416. <constructor><template>
  2417. <template-type-parameter name="T"/>
  2418. </template><parameter name="shar"><paramtype><classname>sharable_lock</classname>&lt; T &gt; &amp;&amp;</paramtype></parameter><parameter name=""><paramtype><classname>try_to_lock_type</classname></paramtype></parameter><parameter name=""><paramtype><emphasis>unspecified</emphasis></paramtype><default>0</default></parameter><description><para>Effects: If shar.owns() then calls try_unlock_sharable_and_lock() on the referenced mutex. a)if try_unlock_sharable_and_lock() returns true then mutex() obtains the value from shar.release() and owns() is set to true. b)if try_unlock_sharable_and_lock() returns false then shar is unaffected and this <classname alt="boost::interprocess::scoped_lock">scoped_lock</classname> construction has the same effects as a default construction. c)Else shar.owns() is false. mutex() obtains the value from shar.release() and owns() is set to false Notes: This construction will not block. It will try to obtain mutex ownership from shar immediately, while changing the lock type from a "read lock" to a "write lock". If the "read lock" isn't held in the first place, the mutex merely changes type to an unlocked "write lock". If the "read lock" is held, then mutex transfer occurs only if it can do so in a non-blocking manner. </para></description></constructor>
  2419. <destructor><description><para>Effects: if (owns()) mp_mutex-&gt;unlock(). Notes: The destructor behavior ensures that the mutex lock is not leaked. </para></description></destructor>
  2420. <copy-assignment><type><classname>scoped_lock</classname> &amp;</type><parameter name="scop"><paramtype><classname>scoped_lock</classname> &amp;&amp;</paramtype></parameter><description><para>Effects: If owns() before the call, then unlock() is called on mutex(). *this gets the state of scop and scop gets set to a default constructed state. Notes: With a recursive mutex it is possible that both this and scop own the same mutex before the assignment. In this case, this will own the mutex after the assignment (and scop will not), but the mutex's lock count will be decremented by one. </para></description></copy-assignment>
  2421. </class>
  2422. </namespace>
  2423. </namespace>
  2424. </header>
  2425. <header name="boost/interprocess/sync/sharable_lock.hpp">
  2426. <para>Describes the upgradable_lock class that serves to acquire the upgradable lock of a mutex. </para><namespace name="boost">
  2427. <namespace name="interprocess">
  2428. <class name="sharable_lock"><template>
  2429. <template-type-parameter name="SharableMutex"/>
  2430. </template><description><para><classname alt="boost::interprocess::sharable_lock">sharable_lock</classname> is meant to carry out the tasks for sharable-locking (such as read-locking), unlocking, try-sharable-locking and timed-sharable-locking (recursive or not) for the Mutex. The Mutex need not supply all of this functionality. If the client of sharable_lock&lt;Mutex&gt; does not use functionality which the Mutex does not supply, no harm is done. Mutex ownership can be shared among sharable_locks, and a single <classname alt="boost::interprocess::upgradable_lock">upgradable_lock</classname>. <classname alt="boost::interprocess::sharable_lock">sharable_lock</classname> does not support copy semantics. But <classname alt="boost::interprocess::sharable_lock">sharable_lock</classname> supports ownership transfer from an <classname alt="boost::interprocess::sharable_lock">sharable_lock</classname>, <classname alt="boost::interprocess::upgradable_lock">upgradable_lock</classname> and <classname alt="boost::interprocess::scoped_lock">scoped_lock</classname> via transfer_lock syntax. </para></description><typedef name="mutex_type"><type>SharableMutex</type></typedef>
  2431. <method-group name="public member functions">
  2432. <method name="lock"><type>void</type><description><para>Effects: If mutex() == 0 or already locked, throws a lock_exception() exception. Calls lock_sharable() on the referenced mutex. Postconditions: owns() == true. Notes: The <classname alt="boost::interprocess::sharable_lock">sharable_lock</classname> changes from a state of not owning the mutex, to owning the mutex, blocking if necessary. </para></description></method>
  2433. <method name="try_lock"><type>bool</type><description><para>Effects: If mutex() == 0 or already locked, throws a lock_exception() exception. Calls try_lock_sharable() on the referenced mutex. Postconditions: owns() == the value returned from mutex()-&gt;try_lock_sharable(). Notes: The <classname alt="boost::interprocess::sharable_lock">sharable_lock</classname> changes from a state of not owning the mutex, to owning the mutex, but only if blocking was not required. If the mutex_type does not support try_lock_sharable(), this function will fail at compile time if instantiated, but otherwise have no effect. </para></description></method>
  2434. <method name="timed_lock"><type>bool</type><parameter name="abs_time"><paramtype>const boost::posix_time::ptime &amp;</paramtype></parameter><description><para>Effects: If mutex() == 0 or already locked, throws a lock_exception() exception. Calls timed_lock_sharable(abs_time) on the referenced mutex. Postconditions: owns() == the value returned from mutex()-&gt;timed_lock_sharable(elps_time). Notes: The <classname alt="boost::interprocess::sharable_lock">sharable_lock</classname> changes from a state of not owning the mutex, to owning the mutex, but only if it can obtain ownership within the specified time interval. If the mutex_type does not support timed_lock_sharable(), this function will fail at compile time if instantiated, but otherwise have no effect. </para></description></method>
  2435. <method name="unlock"><type>void</type><description><para>Effects: If mutex() == 0 or not locked, throws a lock_exception() exception. Calls unlock_sharable() on the referenced mutex. Postconditions: owns() == false. Notes: The <classname alt="boost::interprocess::sharable_lock">sharable_lock</classname> changes from a state of owning the mutex, to not owning the mutex. </para></description></method>
  2436. <method name="owns" cv="const"><type>bool</type><description><para>Effects: Returns true if this <classname alt="boost::interprocess::scoped_lock">scoped_lock</classname> has acquired the referenced mutex. </para></description></method>
  2437. <method name="conversion-operator" cv="const"><type>unspecified_bool_type</type><description><para>Conversion to bool. Returns owns(). </para></description></method>
  2438. <method name="mutex" cv="const"><type>mutex_type *</type><description><para>Effects: Returns a pointer to the referenced mutex, or 0 if there is no mutex to reference. </para></description></method>
  2439. <method name="release"><type>mutex_type *</type><description><para>Effects: Returns a pointer to the referenced mutex, or 0 if there is no mutex to reference. Postconditions: mutex() == 0 and owns() == false. </para></description></method>
  2440. <method name="swap"><type>void</type><parameter name="other"><paramtype><classname>sharable_lock</classname>&lt; mutex_type &gt; &amp;</paramtype></parameter><description><para>Effects: Swaps state with moved lock. Throws: Nothing. </para></description></method>
  2441. </method-group>
  2442. <constructor><description><para>Effects: Default constructs a <classname alt="boost::interprocess::sharable_lock">sharable_lock</classname>. Postconditions: owns() == false and mutex() == 0. </para></description></constructor>
  2443. <constructor specifiers="explicit"><parameter name="m"><paramtype>mutex_type &amp;</paramtype></parameter><description><para>Effects: m.lock_sharable(). Postconditions: owns() == true and mutex() == &amp;m. Notes: The constructor will take sharable-ownership of the mutex. If another thread already owns the mutex with exclusive ownership (<classname alt="boost::interprocess::scoped_lock">scoped_lock</classname>), this thread will block until the mutex is released. If another thread owns the mutex with sharable or upgradable ownership, then no blocking will occur. Whether or not this constructor handles recursive locking depends upon the mutex. </para></description></constructor>
  2444. <constructor><parameter name="m"><paramtype>mutex_type &amp;</paramtype></parameter><parameter name=""><paramtype><classname>defer_lock_type</classname></paramtype></parameter><description><para>Postconditions: owns() == false, and mutex() == &amp;m. Notes: The constructor will not take ownership of the mutex. There is no effect required on the referenced mutex. </para></description></constructor>
  2445. <constructor><parameter name="m"><paramtype>mutex_type &amp;</paramtype></parameter><parameter name=""><paramtype><classname>accept_ownership_type</classname></paramtype></parameter><description><para>Postconditions: owns() == true, and mutex() == &amp;m. Notes: The constructor will suppose that the mutex is already sharable locked. There is no effect required on the referenced mutex. </para></description></constructor>
  2446. <constructor><parameter name="m"><paramtype>mutex_type &amp;</paramtype></parameter><parameter name=""><paramtype><classname>try_to_lock_type</classname></paramtype></parameter><description><para>Effects: m.try_lock_sharable() Postconditions: mutex() == &amp;m. owns() == the return value of the m.try_lock_sharable() executed within the constructor. Notes: The constructor will take sharable-ownership of the mutex if it can do so without waiting. Whether or not this constructor handles recursive locking depends upon the mutex. If the mutex_type does not support try_lock_sharable, this constructor will fail at compile time if instantiated, but otherwise have no effect. </para></description></constructor>
  2447. <constructor><parameter name="m"><paramtype>mutex_type &amp;</paramtype></parameter><parameter name="abs_time"><paramtype>const boost::posix_time::ptime &amp;</paramtype></parameter><description><para>Effects: m.timed_lock_sharable(abs_time) Postconditions: mutex() == &amp;m. owns() == the return value of the m.timed_lock_sharable() executed within the constructor. Notes: The constructor will take sharable-ownership of the mutex if it can do so within the time specified. Whether or not this constructor handles recursive locking depends upon the mutex. If the mutex_type does not support timed_lock_sharable, this constructor will fail at compile time if instantiated, but otherwise have no effect. </para></description></constructor>
  2448. <constructor><parameter name="upgr"><paramtype><classname>sharable_lock</classname>&lt; mutex_type &gt; &amp;&amp;</paramtype></parameter><description><para>Postconditions: mutex() == upgr.mutex(). owns() == the value of upgr.owns() before the construction. upgr.owns() == false after the construction. Notes: If the upgr <classname alt="boost::interprocess::sharable_lock">sharable_lock</classname> owns the mutex, ownership is moved to this <classname alt="boost::interprocess::sharable_lock">sharable_lock</classname> with no blocking. If the upgr <classname alt="boost::interprocess::sharable_lock">sharable_lock</classname> does not own the mutex, then neither will this <classname alt="boost::interprocess::sharable_lock">sharable_lock</classname>. Only a moved <classname alt="boost::interprocess::sharable_lock">sharable_lock</classname>'s will match this signature. An non-moved <classname alt="boost::interprocess::sharable_lock">sharable_lock</classname> can be moved with the expression: "boost::move(lock);". This constructor does not alter the state of the mutex, only potentially who owns it. </para></description></constructor>
  2449. <constructor><template>
  2450. <template-type-parameter name="T"/>
  2451. </template><parameter name="upgr"><paramtype><classname>upgradable_lock</classname>&lt; T &gt; &amp;&amp;</paramtype></parameter><parameter name=""><paramtype><emphasis>unspecified</emphasis></paramtype><default>0</default></parameter><description><para>Effects: If upgr.owns() then calls unlock_upgradable_and_lock_sharable() on the referenced mutex. Postconditions: mutex() == the value upgr.mutex() had before the construction. upgr.mutex() == 0 owns() == the value of upgr.owns() before construction. upgr.owns() == false after the construction. Notes: If upgr is locked, this constructor will lock this <classname alt="boost::interprocess::sharable_lock">sharable_lock</classname> while unlocking upgr. Only a moved <classname alt="boost::interprocess::sharable_lock">sharable_lock</classname>'s will match this signature. An non-moved <classname alt="boost::interprocess::upgradable_lock">upgradable_lock</classname> can be moved with the expression: "boost::move(lock);". </para></description></constructor>
  2452. <constructor><template>
  2453. <template-type-parameter name="T"/>
  2454. </template><parameter name="scop"><paramtype><classname>scoped_lock</classname>&lt; T &gt; &amp;&amp;</paramtype></parameter><parameter name=""><paramtype><emphasis>unspecified</emphasis></paramtype><default>0</default></parameter><description><para>Effects: If scop.owns() then calls unlock_and_lock_sharable() on the referenced mutex. Postconditions: mutex() == the value scop.mutex() had before the construction. scop.mutex() == 0 owns() == scop.owns() before the constructor. After the construction, scop.owns() == false. Notes: If scop is locked, this constructor will transfer the exclusive ownership to a sharable-ownership of this <classname alt="boost::interprocess::sharable_lock">sharable_lock</classname>. Only a moved <classname alt="boost::interprocess::scoped_lock">scoped_lock</classname>'s will match this signature. An non-moved <classname alt="boost::interprocess::scoped_lock">scoped_lock</classname> can be moved with the expression: "boost::move(lock);". </para></description></constructor>
  2455. <destructor><description><para>Effects: if (owns()) mp_mutex-&gt;unlock_sharable(). Notes: The destructor behavior ensures that the mutex lock is not leaked. </para></description></destructor>
  2456. <copy-assignment><type><classname>sharable_lock</classname> &amp;</type><parameter name="upgr"><paramtype><classname>sharable_lock</classname>&lt; mutex_type &gt; &amp;&amp;</paramtype></parameter><description><para>Effects: If owns() before the call, then unlock_sharable() is called on mutex(). *this gets the state of upgr and upgr gets set to a default constructed state. Notes: With a recursive mutex it is possible that both this and upgr own the mutex before the assignment. In this case, this will own the mutex after the assignment (and upgr will not), but the mutex's lock count will be decremented by one. </para></description></copy-assignment>
  2457. </class>
  2458. </namespace>
  2459. </namespace>
  2460. </header>
  2461. <header name="boost/interprocess/sync/upgradable_lock.hpp">
  2462. <para>Describes the upgradable_lock class that serves to acquire the upgradable lock of a mutex. </para><namespace name="boost">
  2463. <namespace name="interprocess">
  2464. <class name="upgradable_lock"><template>
  2465. <template-type-parameter name="UpgradableMutex"/>
  2466. </template><description><para><classname alt="boost::interprocess::upgradable_lock">upgradable_lock</classname> is meant to carry out the tasks for read-locking, unlocking, try-read-locking and timed-read-locking (recursive or not) for the Mutex. Additionally the <classname alt="boost::interprocess::upgradable_lock">upgradable_lock</classname> can transfer ownership to a <classname alt="boost::interprocess::scoped_lock">scoped_lock</classname> using transfer_lock syntax. The Mutex need not supply all of the functionality. If the client of upgradable_lock&lt;Mutex&gt; does not use functionality which the Mutex does not supply, no harm is done. Mutex ownership can be shared among read_locks, and a single <classname alt="boost::interprocess::upgradable_lock">upgradable_lock</classname>. <classname alt="boost::interprocess::upgradable_lock">upgradable_lock</classname> does not support copy semantics. However <classname alt="boost::interprocess::upgradable_lock">upgradable_lock</classname> supports ownership transfer from a upgradable_locks or scoped_locks via transfer_lock syntax. </para></description><typedef name="mutex_type"><type>UpgradableMutex</type></typedef>
  2467. <method-group name="public member functions">
  2468. <method name="lock"><type>void</type><description><para>Effects: If mutex() == 0 or if already locked, throws a lock_exception() exception. Calls lock_upgradable() on the referenced mutex. Postconditions: owns() == true. Notes: The <classname alt="boost::interprocess::sharable_lock">sharable_lock</classname> changes from a state of not owning the mutex, to owning the mutex, blocking if necessary. </para></description></method>
  2469. <method name="try_lock"><type>bool</type><description><para>Effects: If mutex() == 0 or if already locked, throws a lock_exception() exception. Calls try_lock_upgradable() on the referenced mutex. Postconditions: owns() == the value returned from mutex()-&gt;try_lock_upgradable(). Notes: The <classname alt="boost::interprocess::upgradable_lock">upgradable_lock</classname> changes from a state of not owning the mutex, to owning the mutex, but only if blocking was not required. If the mutex_type does not support try_lock_upgradable(), this function will fail at compile time if instantiated, but otherwise have no effect. </para></description></method>
  2470. <method name="timed_lock"><type>bool</type><parameter name="abs_time"><paramtype>const boost::posix_time::ptime &amp;</paramtype></parameter><description><para>Effects: If mutex() == 0 or if already locked, throws a lock_exception() exception. Calls timed_lock_upgradable(abs_time) on the referenced mutex. Postconditions: owns() == the value returned from mutex()-&gt;timed_lock_upgradable(abs_time). Notes: The <classname alt="boost::interprocess::upgradable_lock">upgradable_lock</classname> changes from a state of not owning the mutex, to owning the mutex, but only if it can obtain ownership within the specified time. If the mutex_type does not support timed_lock_upgradable(abs_time), this function will fail at compile time if instantiated, but otherwise have no effect. </para></description></method>
  2471. <method name="unlock"><type>void</type><description><para>Effects: If mutex() == 0 or if not locked, throws a lock_exception() exception. Calls unlock_upgradable() on the referenced mutex. Postconditions: owns() == false. Notes: The <classname alt="boost::interprocess::upgradable_lock">upgradable_lock</classname> changes from a state of owning the mutex, to not owning the mutex. </para></description></method>
  2472. <method name="owns" cv="const"><type>bool</type><description><para>Effects: Returns true if this <classname alt="boost::interprocess::scoped_lock">scoped_lock</classname> has acquired the referenced mutex. </para></description></method>
  2473. <method name="conversion-operator" cv="const"><type>unspecified_bool_type</type><description><para>Conversion to bool. Returns owns(). </para></description></method>
  2474. <method name="mutex" cv="const"><type>mutex_type *</type><description><para>Effects: Returns a pointer to the referenced mutex, or 0 if there is no mutex to reference. </para></description></method>
  2475. <method name="release"><type>mutex_type *</type><description><para>Effects: Returns a pointer to the referenced mutex, or 0 if there is no mutex to reference. Postconditions: mutex() == 0 and owns() == false. </para></description></method>
  2476. <method name="swap"><type>void</type><parameter name="other"><paramtype><classname>upgradable_lock</classname>&lt; mutex_type &gt; &amp;</paramtype></parameter><description><para>Effects: Swaps state with moved lock. Throws: Nothing. </para></description></method>
  2477. </method-group>
  2478. <constructor><description><para>Effects: Default constructs a <classname alt="boost::interprocess::upgradable_lock">upgradable_lock</classname>. Postconditions: owns() == false and mutex() == 0. </para></description></constructor>
  2479. <constructor specifiers="explicit"><parameter name="m"><paramtype>mutex_type &amp;</paramtype></parameter></constructor>
  2480. <constructor><parameter name="m"><paramtype>mutex_type &amp;</paramtype></parameter><parameter name=""><paramtype><classname>defer_lock_type</classname></paramtype></parameter><description><para>Postconditions: owns() == false, and mutex() == &amp;m. Notes: The constructor will not take ownership of the mutex. There is no effect required on the referenced mutex. </para></description></constructor>
  2481. <constructor><parameter name="m"><paramtype>mutex_type &amp;</paramtype></parameter><parameter name=""><paramtype><classname>accept_ownership_type</classname></paramtype></parameter><description><para>Postconditions: owns() == true, and mutex() == &amp;m. Notes: The constructor will suppose that the mutex is already upgradable locked. There is no effect required on the referenced mutex. </para></description></constructor>
  2482. <constructor><parameter name="m"><paramtype>mutex_type &amp;</paramtype></parameter><parameter name=""><paramtype><classname>try_to_lock_type</classname></paramtype></parameter><description><para>Effects: m.try_lock_upgradable(). Postconditions: mutex() == &amp;m. owns() == the return value of the m.try_lock_upgradable() executed within the constructor. Notes: The constructor will take upgradable-ownership of the mutex if it can do so without waiting. Whether or not this constructor handles recursive locking depends upon the mutex. If the mutex_type does not support try_lock_upgradable, this constructor will fail at compile time if instantiated, but otherwise have no effect. </para></description></constructor>
  2483. <constructor><parameter name="m"><paramtype>mutex_type &amp;</paramtype></parameter><parameter name="abs_time"><paramtype>const boost::posix_time::ptime &amp;</paramtype></parameter><description><para>Effects: m.timed_lock_upgradable(abs_time) Postconditions: mutex() == &amp;m. owns() == the return value of the m.timed_lock_upgradable() executed within the constructor. Notes: The constructor will take upgradable-ownership of the mutex if it can do so within the time specified. Whether or not this constructor handles recursive locking depends upon the mutex. If the mutex_type does not support timed_lock_upgradable, this constructor will fail at compile time if instantiated, but otherwise have no effect. </para></description></constructor>
  2484. <constructor><parameter name="upgr"><paramtype><classname>upgradable_lock</classname>&lt; mutex_type &gt; &amp;&amp;</paramtype></parameter><description><para>Effects: No effects on the underlying mutex. Postconditions: mutex() == the value upgr.mutex() had before the construction. upgr.mutex() == 0. owns() == upgr.owns() before the construction. upgr.owns() == false. Notes: If upgr is locked, this constructor will lock this <classname alt="boost::interprocess::upgradable_lock">upgradable_lock</classname> while unlocking upgr. If upgr is unlocked, then this <classname alt="boost::interprocess::upgradable_lock">upgradable_lock</classname> will be unlocked as well. Only a moved <classname alt="boost::interprocess::upgradable_lock">upgradable_lock</classname>'s will match this signature. An non-moved <classname alt="boost::interprocess::upgradable_lock">upgradable_lock</classname> can be moved with the expression: "boost::move(lock);". This constructor does not alter the state of the mutex, only potentially who owns it. </para></description></constructor>
  2485. <constructor><template>
  2486. <template-type-parameter name="T"/>
  2487. </template><parameter name="scop"><paramtype><classname>scoped_lock</classname>&lt; T &gt; &amp;&amp;</paramtype></parameter><parameter name=""><paramtype><emphasis>unspecified</emphasis></paramtype><default>0</default></parameter><description><para>Effects: If scop.owns(), m_.unlock_and_lock_upgradable(). Postconditions: mutex() == the value scop.mutex() had before the construction. scop.mutex() == 0. owns() == scop.owns() before the constructor. After the construction, scop.owns() == false. Notes: If scop is locked, this constructor will transfer the exclusive-ownership to an upgradable-ownership of this <classname alt="boost::interprocess::upgradable_lock">upgradable_lock</classname>. Only a moved <classname alt="boost::interprocess::sharable_lock">sharable_lock</classname>'s will match this signature. An non-moved <classname alt="boost::interprocess::sharable_lock">sharable_lock</classname> can be moved with the expression: "boost::move(lock);". </para></description></constructor>
  2488. <constructor><template>
  2489. <template-type-parameter name="T"/>
  2490. </template><parameter name="shar"><paramtype><classname>sharable_lock</classname>&lt; T &gt; &amp;&amp;</paramtype></parameter><parameter name=""><paramtype><classname>try_to_lock_type</classname></paramtype></parameter><parameter name=""><paramtype><emphasis>unspecified</emphasis></paramtype><default>0</default></parameter><description><para>Effects: If shar.owns() then calls try_unlock_sharable_and_lock_upgradable() on the referenced mutex. a)if try_unlock_sharable_and_lock_upgradable() returns true then mutex() obtains the value from shar.release() and owns() is set to true. b)if try_unlock_sharable_and_lock_upgradable() returns false then shar is unaffected and this <classname alt="boost::interprocess::upgradable_lock">upgradable_lock</classname> construction has the same effects as a default construction. c)Else shar.owns() is false. mutex() obtains the value from shar.release() and owns() is set to false. Notes: This construction will not block. It will try to obtain mutex ownership from shar immediately, while changing the lock type from a "read lock" to an "upgradable lock". If the "read lock" isn't held in the first place, the mutex merely changes type to an unlocked "upgradable lock". If the "read lock" is held, then mutex transfer occurs only if it can do so in a non-blocking manner. </para></description></constructor>
  2491. <destructor><description><para>Effects: if (owns()) m_-&gt;unlock_upgradable(). Notes: The destructor behavior ensures that the mutex lock is not leaked. </para></description></destructor>
  2492. <copy-assignment><type><classname>upgradable_lock</classname> &amp;</type><parameter name="upgr"><paramtype><classname>upgradable_lock</classname> &amp;&amp;</paramtype></parameter><description><para>Effects: If owns(), then unlock_upgradable() is called on mutex(). *this gets the state of upgr and upgr gets set to a default constructed state. Notes: With a recursive mutex it is possible that both this and upgr own the mutex before the assignment. In this case, this will own the mutex after the assignment (and upgr will not), but the mutex's upgradable lock count will be decremented by one. </para></description></copy-assignment>
  2493. </class>
  2494. </namespace>
  2495. </namespace>
  2496. </header>
  2497. <header name="boost/interprocess/windows_shared_memory.hpp">
  2498. <para>Describes a class representing a native windows shared memory. </para><namespace name="boost">
  2499. <namespace name="interprocess">
  2500. <class name="windows_shared_memory"><description><para>A class that wraps the native Windows shared memory that is implemented as a file mapping of the paging file. Unlike <classname alt="boost::interprocess::shared_memory_object">shared_memory_object</classname>, <classname alt="boost::interprocess::windows_shared_memory">windows_shared_memory</classname> has no kernel persistence and the shared memory is destroyed when all processes destroy all their <classname alt="boost::interprocess::windows_shared_memory">windows_shared_memory</classname> objects and mapped regions for the same shared memory or the processes end/crash.</para><para>Warning: Windows native shared memory and interprocess portable shared memory (<classname alt="boost::interprocess::shared_memory_object">boost::interprocess::shared_memory_object</classname>) can't communicate between them. </para></description><method-group name="public member functions">
  2501. <method name="swap"><type>void</type><parameter name="other"><paramtype><classname>windows_shared_memory</classname> &amp;</paramtype></parameter><purpose>Swaps to shared_memory_objects. Does not throw. </purpose></method>
  2502. <method name="get_name" cv="const"><type>const char *</type><purpose>Returns the name of the shared memory. </purpose></method>
  2503. <method name="get_mode" cv="const"><type>mode_t</type><purpose>Returns access mode. </purpose></method>
  2504. <method name="get_mapping_handle" cv="const"><type>mapping_handle_t</type><purpose>Returns the mapping handle. Never throws. </purpose></method>
  2505. <method name="get_size" cv="const"><type>offset_t</type><description><para>Returns the size of the windows shared memory. It will be a 4K rounded size of the "size" passed in the constructor. </para></description></method>
  2506. </method-group>
  2507. <constructor><description><para>Default constructor. Represents an empty <classname alt="boost::interprocess::windows_shared_memory">windows_shared_memory</classname>. </para></description></constructor>
  2508. <constructor><parameter name=""><paramtype><classname>create_only_t</classname></paramtype></parameter><parameter name="name"><paramtype>const char *</paramtype></parameter><parameter name="mode"><paramtype>mode_t</paramtype></parameter><parameter name="size"><paramtype>std::size_t</paramtype></parameter><parameter name="perm"><paramtype>const <classname>permissions</classname> &amp;</paramtype><default><classname alt="boost::interprocess::permissions">permissions</classname>()</default></parameter><description><para>Creates a new native shared memory with name "name" and at least size "size", with the access mode "mode". If the file previously exists, throws an error. </para></description></constructor>
  2509. <constructor><parameter name=""><paramtype><classname>open_or_create_t</classname></paramtype></parameter><parameter name="name"><paramtype>const char *</paramtype></parameter><parameter name="mode"><paramtype>mode_t</paramtype></parameter><parameter name="size"><paramtype>std::size_t</paramtype></parameter><parameter name="perm"><paramtype>const <classname>permissions</classname> &amp;</paramtype><default><classname alt="boost::interprocess::permissions">permissions</classname>()</default></parameter><description><para>Tries to create a shared memory object with name "name" and at least size "size", with the access mode "mode". If the file previously exists, it tries to open it with mode "mode". Otherwise throws an error. </para></description></constructor>
  2510. <constructor><parameter name=""><paramtype><classname>open_only_t</classname></paramtype></parameter><parameter name="name"><paramtype>const char *</paramtype></parameter><parameter name="mode"><paramtype>mode_t</paramtype></parameter><description><para>Tries to open a shared memory object with name "name", with the access mode "mode". If the file does not previously exist, it throws an error. </para></description></constructor>
  2511. <constructor><parameter name="moved"><paramtype><classname>windows_shared_memory</classname> &amp;&amp;</paramtype></parameter><description><para>Moves the ownership of "moved"'s shared memory object to *this. After the call, "moved" does not represent any shared memory object. Does not throw </para></description></constructor>
  2512. <copy-assignment><type><classname>windows_shared_memory</classname> &amp;</type><parameter name="moved"><paramtype><classname>windows_shared_memory</classname> &amp;&amp;</paramtype></parameter><description><para>Moves the ownership of "moved"'s shared memory to *this. After the call, "moved" does not represent any shared memory. Does not throw </para></description></copy-assignment>
  2513. <destructor><description><para>Destroys *this. All mapped regions are still valid after destruction. When all mapped regions and <classname alt="boost::interprocess::windows_shared_memory">windows_shared_memory</classname> objects referring the shared memory are destroyed, the operating system will destroy the shared memory. </para></description></destructor>
  2514. </class>
  2515. </namespace>
  2516. </namespace>
  2517. </header>
  2518. <header name="boost/interprocess/xsi_key.hpp">
  2519. <para>Describes a class representing a xsi key type. </para><namespace name="boost">
  2520. <namespace name="interprocess">
  2521. <class name="xsi_key"><description><para>A class that wraps XSI (System V) key_t type. This type calculates key_t from path and id using ftok, sets key to a specified value, or sets key to IPC_PRIVATE using the default constructor. </para></description><method-group name="public member functions">
  2522. <method name="get_key" cv="const"><type>key_t</type><purpose>Returns the internal key_t value. </purpose></method>
  2523. </method-group>
  2524. <constructor><description><para>Default constructor. Represents a private <classname alt="boost::interprocess::xsi_key">xsi_key</classname>. </para></description></constructor>
  2525. <constructor specifiers="explicit"><parameter name="key"><paramtype>key_t</paramtype></parameter><purpose>Creates a new XSI key using a specified value. Constructor is explicit to avoid ambiguity with shmid. </purpose></constructor>
  2526. <constructor><parameter name="path"><paramtype>const char *</paramtype></parameter><parameter name="id"><paramtype>boost::uint8_t</paramtype></parameter><description><para>Creates a new XSI shared memory with a key obtained from a call to ftok (with path "path" and id "id"), of size "size" and permissions "perm". If the shared memory previously exists, throws an error. </para></description></constructor>
  2527. </class>
  2528. </namespace>
  2529. </namespace>
  2530. </header>
  2531. <header name="boost/interprocess/xsi_shared_memory.hpp">
  2532. <para>Describes a class representing a native xsi shared memory. </para><namespace name="boost">
  2533. <namespace name="interprocess">
  2534. <class name="xsi_shared_memory"><description><para>A class that wraps XSI (System V) shared memory. Unlike <classname alt="boost::interprocess::shared_memory_object">shared_memory_object</classname>, <classname alt="boost::interprocess::xsi_shared_memory">xsi_shared_memory</classname> needs a valid <classname alt="boost::interprocess::xsi_key">xsi_key</classname> to identify a shared memory object.</para><para>Warning: XSI shared memory and interprocess portable shared memory (<classname alt="boost::interprocess::shared_memory_object">boost::interprocess::shared_memory_object</classname>) can't communicate between them. </para></description><method-group name="public member functions">
  2535. <method name="swap"><type>void</type><parameter name="other"><paramtype><classname>xsi_shared_memory</classname> &amp;</paramtype></parameter><purpose>Swaps two xsi_shared_memorys. Does not throw. </purpose></method>
  2536. <method name="get_shmid" cv="const"><type>int</type><description><para>Returns the shared memory ID that identifies the shared memory </para></description></method>
  2537. <method name="get_mapping_handle" cv="const"><type>mapping_handle_t</type><description><para>Returns the mapping handle. Never throws </para></description></method>
  2538. </method-group>
  2539. <constructor><description><para>Default constructor. Represents an empty <classname alt="boost::interprocess::xsi_shared_memory">xsi_shared_memory</classname>. </para></description></constructor>
  2540. <constructor><parameter name=""><paramtype><classname>open_only_t</classname></paramtype></parameter><parameter name="shmid"><paramtype>int</paramtype></parameter><description><para>Initializes *this with a shmid previously obtained (possibly from another process) This lower-level initializer allows shared memory mapping without having a key. </para></description></constructor>
  2541. <constructor><parameter name=""><paramtype><classname>create_only_t</classname></paramtype></parameter><parameter name="key"><paramtype>const <classname>xsi_key</classname> &amp;</paramtype></parameter><parameter name="size"><paramtype>std::size_t</paramtype></parameter><parameter name="perm"><paramtype>const <classname>permissions</classname> &amp;</paramtype><default><classname alt="boost::interprocess::permissions">permissions</classname>()</default></parameter><description><para>Creates a new XSI shared memory from 'key', with size "size" and permissions "perm". If the shared memory previously exists, throws an error. </para></description></constructor>
  2542. <constructor><parameter name=""><paramtype><classname>open_or_create_t</classname></paramtype></parameter><parameter name="key"><paramtype>const <classname>xsi_key</classname> &amp;</paramtype></parameter><parameter name="size"><paramtype>std::size_t</paramtype></parameter><parameter name="perm"><paramtype>const <classname>permissions</classname> &amp;</paramtype><default><classname alt="boost::interprocess::permissions">permissions</classname>()</default></parameter><description><para>Opens an existing shared memory with identifier 'key' or creates a new XSI shared memory from identifier 'key', with size "size" and permissions "perm". </para></description></constructor>
  2543. <constructor><parameter name=""><paramtype><classname>open_only_t</classname></paramtype></parameter><parameter name="key"><paramtype>const <classname>xsi_key</classname> &amp;</paramtype></parameter><description><para>Tries to open a XSI shared memory with identifier 'key' If the shared memory does not previously exist, it throws an error. </para></description></constructor>
  2544. <constructor><parameter name="moved"><paramtype><classname>xsi_shared_memory</classname> &amp;&amp;</paramtype></parameter><description><para>Moves the ownership of "moved"'s shared memory object to *this. After the call, "moved" does not represent any shared memory object. Does not throw </para></description></constructor>
  2545. <copy-assignment><type><classname>xsi_shared_memory</classname> &amp;</type><parameter name="moved"><paramtype><classname>xsi_shared_memory</classname> &amp;&amp;</paramtype></parameter><description><para>Moves the ownership of "moved"'s shared memory to *this. After the call, "moved" does not represent any shared memory. Does not throw </para></description></copy-assignment>
  2546. <destructor><description><para>Destroys *this. The shared memory won't be destroyed, just this connection to it. Use remove() to destroy the shared memory. </para></description></destructor>
  2547. <method-group name="public static functions">
  2548. <method name="remove" specifiers="static"><type>bool</type><parameter name="shmid"><paramtype>int</paramtype></parameter><description><para>Erases the XSI shared memory object identified by shmid from the system. Returns false on error. Never throws </para></description></method>
  2549. </method-group>
  2550. </class>
  2551. </namespace>
  2552. </namespace>
  2553. </header>
  2554. </library-reference>