PNG  IHDRQgAMA a cHRMz&u0`:pQ<bKGDgmIDATxwUﹻ& ^CX(J I@ "% (** BX +*i"]j(IH{~R)[~>h{}gy)I$Ij .I$I$ʊy@}x.: $I$Ii}VZPC)I$IF ^0ʐJ$I$Q^}{"r=OzI$gRZeC.IOvH eKX $IMpxsk.쒷/&r[޳<v| .I~)@$updYRa$I |M.e JaֶpSYR6j>h%IRز if&uJ)M$I vLi=H;7UJ,],X$I1AҒJ$ XY XzI@GNҥRT)E@;]K*Mw;#5_wOn~\ DC&$(A5 RRFkvIR}l!RytRl;~^ǷJj اy뷦BZJr&ӥ8Pjw~vnv X^(I;4R=P[3]J,]ȏ~:3?[ a&e)`e*P[4]T=Cq6R[ ~ޤrXR Հg(t_HZ-Hg M$ãmL5R uk*`%C-E6/%[t X.{8P9Z.vkXŐKjgKZHg(aK9ڦmKjѺm_ \#$5,)-  61eJ,5m| r'= &ڡd%-]J on Xm|{ RҞe $eڧY XYrԮ-a7RK6h>n$5AVڴi*ֆK)mѦtmr1p| q:흺,)Oi*ֺK)ܬ֦K-5r3>0ԔHjJئEZj,%re~/z%jVMڸmrt)3]J,T K֦OvԒgii*bKiNO~%PW0=dii2tJ9Jݕ{7"I P9JKTbu,%r"6RKU}Ij2HKZXJ,妝 XYrP ެ24c%i^IK|.H,%rb:XRl1X4Pe/`x&P8Pj28Mzsx2r\zRPz4J}yP[g=L) .Q[6RjWgp FIH*-`IMRaK9TXcq*I y[jE>cw%gLRԕiFCj-ďa`#e~I j,%r,)?[gp FI˨mnWX#>mʔ XA DZf9,nKҲzIZXJ,L#kiPz4JZF,I,`61%2s $,VOϚ2/UFJfy7K> X+6 STXIeJILzMfKm LRaK9%|4p9LwJI!`NsiazĔ)%- XMq>pk$-$Q2x#N ؎-QR}ᶦHZډ)J,l#i@yn3LN`;nڔ XuX5pF)m|^0(>BHF9(cզEerJI rg7 4I@z0\JIi䵙RR0s;$s6eJ,`n 䂦0a)S)A 1eJ,堌#635RIgpNHuTH_SԕqVe ` &S)>p;S$魁eKIuX`I4춒o}`m$1":PI<[v9^\pTJjriRŭ P{#{R2,`)e-`mgj~1ϣLKam7&U\j/3mJ,`F;M'䱀 .KR#)yhTq;pcK9(q!w?uRR,n.yw*UXj#\]ɱ(qv2=RqfB#iJmmL<]Y͙#$5 uTU7ӦXR+q,`I}qL'`6Kͷ6r,]0S$- [RKR3oiRE|nӦXR.(i:LDLTJjY%o:)6rxzҒqTJjh㞦I.$YR.ʼnGZ\ֿf:%55 I˼!6dKxm4E"mG_ s? .e*?LRfK9%q#uh$)i3ULRfK9yxm܌bj84$i1U^@Wbm4uJ,ҪA>_Ij?1v32[gLRD96oTaR׿N7%L2 NT,`)7&ƝL*꽙yp_$M2#AS,`)7$rkTA29_Iye"|/0t)$n XT2`YJ;6Jx".e<`$) PI$5V4]29SRI>~=@j]lp2`K9Jaai^" Ԋ29ORI%:XV5]JmN9]H;1UC39NI%Xe78t)a;Oi Ҙ>Xt"~G>_mn:%|~ޅ_+]$o)@ǀ{hgN;IK6G&rp)T2i୦KJuv*T=TOSV>(~D>dm,I*Ɛ:R#ۙNI%D>G.n$o;+#RR!.eU˽TRI28t)1LWϚ>IJa3oFbu&:tJ*(F7y0ZR ^p'Ii L24x| XRI%ۄ>S1]Jy[zL$adB7.eh4%%누>WETf+3IR:I3Xה)3אOۦSRO'ٺ)S}"qOr[B7ϙ.edG)^ETR"RtRݜh0}LFVӦDB^k_JDj\=LS(Iv─aTeZ%eUAM-0;~˃@i|l @S4y72>sX-vA}ϛBI!ݎߨWl*)3{'Y|iSlEڻ(5KtSI$Uv02,~ԩ~x;P4ցCrO%tyn425:KMlD ^4JRxSهF_}شJTS6uj+ﷸk$eZO%G*^V2u3EMj3k%)okI]dT)URKDS 7~m@TJR~荪fT"֛L \sM -0T KfJz+nإKr L&j()[E&I ߴ>e FW_kJR|!O:5/2跌3T-'|zX ryp0JS ~^F>-2< `*%ZFP)bSn"L :)+pʷf(pO3TMW$~>@~ū:TAIsV1}S2<%ޟM?@iT ,Eūoz%i~g|`wS(]oȤ8)$ ntu`өe`6yPl IzMI{ʣzʨ )IZ2= ld:5+請M$-ї;U>_gsY$ÁN5WzWfIZ)-yuXIfp~S*IZdt;t>KūKR|$#LcԀ+2\;kJ`]YǔM1B)UbG"IRߊ<xܾӔJ0Z='Y嵤 Leveg)$znV-º^3Ւof#0Tfk^Zs[*I꯳3{)ˬW4Ւ4 OdpbZRS|*I 55#"&-IvT&/윚Ye:i$ 9{LkuRe[I~_\ؠ%>GL$iY8 9ܕ"S`kS.IlC;Ҏ4x&>u_0JLr<J2(^$5L s=MgV ~,Iju> 7r2)^=G$1:3G< `J3~&IR% 6Tx/rIj3O< ʔ&#f_yXJiގNSz; Tx(i8%#4 ~AS+IjerIUrIj362v885+IjAhK__5X%nV%Iͳ-y|7XV2v4fzo_68"S/I-qbf; LkF)KSM$ Ms>K WNV}^`-큧32ŒVؙGdu,^^m%6~Nn&͓3ŒVZMsRpfEW%IwdǀLm[7W&bIRL@Q|)* i ImsIMmKmyV`i$G+R 0tV'!V)֏28vU7͒vHꦼtxꗞT ;S}7Mf+fIRHNZUkUx5SAJㄌ9MqμAIRi|j5)o*^'<$TwI1hEU^c_j?Е$%d`z cyf,XO IJnTgA UXRD }{H}^S,P5V2\Xx`pZ|Yk:$e ~ @nWL.j+ϝYb퇪bZ BVu)u/IJ_ 1[p.p60bC >|X91P:N\!5qUB}5a5ja `ubcVxYt1N0Zzl4]7­gKj]?4ϻ *[bg$)+À*x쳀ogO$~,5 زUS9 lq3+5mgw@np1sso Ӻ=|N6 /g(Wv7U;zωM=wk,0uTg_`_P`uz?2yI!b`kĸSo+Qx%!\οe|އԁKS-s6pu_(ֿ$i++T8=eY; צP+phxWQv*|p1. ά. XRkIQYP,drZ | B%wP|S5`~́@i޾ E;Չaw{o'Q?%iL{u D?N1BD!owPHReFZ* k_-~{E9b-~P`fE{AܶBJAFO wx6Rox5 K5=WwehS8 (JClJ~ p+Fi;ŗo+:bD#g(C"wA^ r.F8L;dzdIHUX݆ϞXg )IFqem%I4dj&ppT{'{HOx( Rk6^C٫O.)3:s(۳(Z?~ٻ89zmT"PLtw䥈5&b<8GZ-Y&K?e8,`I6e(֍xb83 `rzXj)F=l($Ij 2*(F?h(/9ik:I`m#p3MgLaKjc/U#n5S# m(^)=y=đx8ŬI[U]~SцA4p$-F i(R,7Cx;X=cI>{Km\ o(Tv2vx2qiiDJN,Ҏ!1f 5quBj1!8 rDFd(!WQl,gSkL1Bxg''՞^ǘ;pQ P(c_ IRujg(Wz bs#P­rz> k c&nB=q+ؔXn#r5)co*Ũ+G?7< |PQӣ'G`uOd>%Mctz# Ԫڞ&7CaQ~N'-P.W`Oedp03C!IZcIAMPUۀ5J<\u~+{9(FbbyAeBhOSܳ1 bÈT#ŠyDžs,`5}DC-`̞%r&ڙa87QWWp6e7 Rϫ/oY ꇅ Nܶըtc!LA T7V4Jsū I-0Pxz7QNF_iZgúWkG83 0eWr9 X]㾮݁#Jˢ C}0=3ݱtBi]_ &{{[/o[~ \q鯜00٩|cD3=4B_b RYb$óBRsf&lLX#M*C_L܄:gx)WΘsGSbuL rF$9';\4Ɍq'n[%p.Q`u hNb`eCQyQ|l_C>Lb꟟3hSb #xNxSs^ 88|Mz)}:](vbۢamŖ࿥ 0)Q7@0=?^k(*J}3ibkFn HjB׻NO z x}7p 0tfDX.lwgȔhԾŲ }6g E |LkLZteu+=q\Iv0쮑)QٵpH8/2?Σo>Jvppho~f>%bMM}\//":PTc(v9v!gոQ )UfVG+! 35{=x\2+ki,y$~A1iC6#)vC5^>+gǵ@1Hy٪7u;p psϰu/S <aʸGu'tD1ԝI<pg|6j'p:tպhX{o(7v],*}6a_ wXRk,O]Lܳ~Vo45rp"N5k;m{rZbΦ${#)`(Ŵg,;j%6j.pyYT?}-kBDc3qA`NWQū20/^AZW%NQ MI.X#P#,^Ebc&?XR tAV|Y.1!؅⨉ccww>ivl(JT~ u`ٵDm q)+Ri x/x8cyFO!/*!/&,7<.N,YDŽ&ܑQF1Bz)FPʛ?5d 6`kQձ λc؎%582Y&nD_$Je4>a?! ͨ|ȎWZSsv8 j(I&yj Jb5m?HWp=g}G3#|I,5v珿] H~R3@B[☉9Ox~oMy=J;xUVoj bUsl_35t-(ՃɼRB7U!qc+x4H_Qo֮$[GO<4`&č\GOc[.[*Af%mG/ ňM/r W/Nw~B1U3J?P&Y )`ѓZ1p]^l“W#)lWZilUQu`-m|xĐ,_ƪ|9i:_{*(3Gѧ}UoD+>m_?VPۅ15&}2|/pIOʵ> GZ9cmíتmnz)yߐbD >e}:) r|@R5qVSA10C%E_'^8cR7O;6[eKePGϦX7jb}OTGO^jn*媓7nGMC t,k31Rb (vyܴʭ!iTh8~ZYZp(qsRL ?b}cŨʊGO^!rPJO15MJ[c&~Z`"ѓޔH1C&^|Ш|rʼ,AwĴ?b5)tLU)F| &g٣O]oqSUjy(x<Ϳ3 .FSkoYg2 \_#wj{u'rQ>o;%n|F*O_L"e9umDds?.fuuQbIWz |4\0 sb;OvxOSs; G%T4gFRurj(֍ڑb uԖKDu1MK{1^ q; C=6\8FR艇!%\YÔU| 88m)֓NcLve C6z;o&X x59:q61Z(T7>C?gcļxѐ Z oo-08jہ x,`' ҔOcRlf~`jj".Nv+sM_]Zk g( UOPyεx%pUh2(@il0ݽQXxppx-NS( WO+轾 nFߢ3M<;z)FBZjciu/QoF 7R¥ ZFLF~#ȣߨ^<쩡ݛкvџ))ME>ώx4m#!-m!L;vv#~Y[đKmx9.[,UFS CVkZ +ߟrY٧IZd/ioi$%͝ب_ֶX3ܫhNU ZZgk=]=bbJS[wjU()*I =ώ:}-蹞lUj:1}MWm=̛ _ ¾,8{__m{_PVK^n3esw5ӫh#$-q=A̟> ,^I}P^J$qY~Q[ Xq9{#&T.^GVj__RKpn,b=`żY@^՝;z{paVKkQXj/)y TIc&F;FBG7wg ZZDG!x r_tƢ!}i/V=M/#nB8 XxЫ ^@CR<{䤭YCN)eKOSƟa $&g[i3.C6xrOc8TI;o hH6P&L{@q6[ Gzp^71j(l`J}]e6X☉#͕ ׈$AB1Vjh㭦IRsqFBjwQ_7Xk>y"N=MB0 ,C #o6MRc0|$)ف"1!ixY<B9mx `,tA>)5ػQ?jQ?cn>YZe Tisvh# GMމȇp:ԴVuږ8ɼH]C.5C!UV;F`mbBk LTMvPʍϤj?ԯ/Qr1NB`9s"s TYsz &9S%U԰> {<ؿSMxB|H\3@!U| k']$U+> |HHMLޢ?V9iD!-@x TIî%6Z*9X@HMW#?nN ,oe6?tQwڱ.]-y':mW0#!J82qFjH -`ѓ&M0u Uγmxϵ^-_\])@0Rt.8/?ٰCY]x}=sD3ojަЫNuS%U}ԤwHH>ڗjܷ_3gN q7[q2la*ArǓԖ+p8/RGM ]jacd(JhWko6ڎbj]i5Bj3+3!\j1UZLsLTv8HHmup<>gKMJj0@H%,W΃7R) ">c, xixј^ aܖ>H[i.UIHc U1=yW\=S*GR~)AF=`&2h`DzT󑓶J+?W+}C%P:|0H܆}-<;OC[~o.$~i}~HQ TvXΈr=b}$vizL4:ȰT|4~*!oXQR6Lk+#t/g lԁߖ[Jڶ_N$k*". xsxX7jRVbAAʯKҎU3)zSNN _'s?f)6X!%ssAkʱ>qƷb hg %n ~p1REGMHH=BJiy[<5 ǁJҖgKR*倳e~HUy)Ag,K)`Vw6bRR:qL#\rclK/$sh*$ 6덤 KԖc 3Z9=Ɣ=o>X Ώ"1 )a`SJJ6k(<c e{%kϊP+SL'TcMJWRm ŏ"w)qc ef꒵i?b7b('"2r%~HUS1\<(`1Wx9=8HY9m:X18bgD1u ~|H;K-Uep,, C1 RV.MR5άh,tWO8WC$ XRVsQS]3GJ|12 [vM :k#~tH30Rf-HYݺ-`I9%lIDTm\ S{]9gOڒMNCV\G*2JRŨ;Rҏ^ڽ̱mq1Eu?To3I)y^#jJw^Ńj^vvlB_⋌P4x>0$c>K†Aļ9s_VjTt0l#m>E-,,x,-W)سo&96RE XR.6bXw+)GAEvL)͞K4$p=Ũi_ѱOjb HY/+@θH9޼]Nԥ%n{ &zjT? Ty) s^ULlb,PiTf^<À] 62R^V7)S!nllS6~͝V}-=%* ʻ>G DnK<y&>LPy7'r=Hj 9V`[c"*^8HpcO8bnU`4JȪAƋ#1_\ XϘHPRgik(~G~0DAA_2p|J묭a2\NCr]M_0 ^T%e#vD^%xy-n}-E\3aS%yN!r_{ )sAw ڼp1pEAk~v<:`'ӭ^5 ArXOI驻T (dk)_\ PuA*BY]yB"l\ey hH*tbK)3 IKZ򹞋XjN n *n>k]X_d!ryBH ]*R 0(#'7 %es9??ښFC,ՁQPjARJ\Ρw K#jahgw;2$l*) %Xq5!U᢯6Re] |0[__64ch&_}iL8KEgҎ7 M/\`|.p,~`a=BR?xܐrQ8K XR2M8f ?`sgWS%" Ԉ 7R%$ N}?QL1|-эټwIZ%pvL3Hk>,ImgW7{E xPHx73RA @RS CC !\ȟ5IXR^ZxHл$Q[ŝ40 (>+ _C >BRt<,TrT {O/H+˟Pl6 I B)/VC<6a2~(XwV4gnXR ϱ5ǀHٻ?tw똤Eyxp{#WK qG%5],(0ӈH HZ])ג=K1j&G(FbM@)%I` XRg ʔ KZG(vP,<`[ Kn^ SJRsAʠ5xՅF`0&RbV tx:EaUE/{fi2;.IAwW8/tTxAGOoN?G}l L(n`Zv?pB8K_gI+ܗ #i?ޙ.) p$utc ~DžfՈEo3l/)I-U?aԅ^jxArA ΧX}DmZ@QLےbTXGd.^|xKHR{|ΕW_h] IJ`[G9{).y) 0X YA1]qp?p_k+J*Y@HI>^?gt.06Rn ,` ?);p pSF9ZXLBJPWjgQ|&)7! HjQt<| ؅W5 x W HIzYoVMGP Hjn`+\(dNW)F+IrS[|/a`K|ͻ0Hj{R,Q=\ (F}\WR)AgSG`IsnAR=|8$}G(vC$)s FBJ?]_u XRvύ6z ŨG[36-T9HzpW̞ú Xg큽=7CufzI$)ki^qk-) 0H*N` QZkk]/tnnsI^Gu't=7$ Z;{8^jB% IItRQS7[ϭ3 $_OQJ`7!]W"W,)Iy W AJA;KWG`IY{8k$I$^%9.^(`N|LJ%@$I}ֽp=FB*xN=gI?Q{٥4B)mw $Igc~dZ@G9K X?7)aK%݅K$IZ-`IpC U6$I\0>!9k} Xa IIS0H$I H ?1R.Чj:4~Rw@p$IrA*u}WjWFPJ$I➓/6#! LӾ+ X36x8J |+L;v$Io4301R20M I$-E}@,pS^ޟR[/s¹'0H$IKyfŸfVOπFT*a$I>He~VY/3R/)>d$I>28`Cjw,n@FU*9ttf$I~<;=/4RD~@ X-ѕzἱI$: ԍR a@b X{+Qxuq$IЛzo /~3\8ڒ4BN7$IҀj V]n18H$IYFBj3̵̚ja pp $Is/3R Ӻ-Yj+L;.0ŔI$Av? #!5"aʄj}UKmɽH$IjCYs?h$IDl843.v}m7UiI=&=0Lg0$I4: embe` eQbm0u? $IT!Sƍ'-sv)s#C0:XB2a w I$zbww{."pPzO =Ɔ\[ o($Iaw]`E).Kvi:L*#gР7[$IyGPI=@R 4yR~̮´cg I$I/<tPͽ hDgo 94Z^k盇΄8I56^W$I^0̜N?4*H`237}g+hxoq)SJ@p|` $I%>-hO0eO>\ԣNߌZD6R=K ~n($I$y3D>o4b#px2$yڪtzW~a $I~?x'BwwpH$IZݑnC㧄Pc_9sO gwJ=l1:mKB>Ab<4Lp$Ib o1ZQ@85b̍ S'F,Fe,^I$IjEdù{l4 8Ys_s Z8.x m"+{~?q,Z D!I$ϻ'|XhB)=…']M>5 rgotԎ 獽PH$IjIPhh)n#cÔqA'ug5qwU&rF|1E%I$%]!'3AFD/;Ck_`9 v!ٴtPV;x`'*bQa w I$Ix5 FC3D_~A_#O݆DvV?<qw+I$I{=Z8".#RIYyjǪ=fDl9%M,a8$I$Ywi[7ݍFe$s1ՋBVA?`]#!oz4zjLJo8$I$%@3jAa4(o ;p,,dya=F9ً[LSPH$IJYЉ+3> 5"39aZ<ñh!{TpBGkj}Sp $IlvF.F$I z< '\K*qq.f<2Y!S"-\I$IYwčjF$ w9 \ߪB.1v!Ʊ?+r:^!I$BϹB H"B;L'G[ 4U#5>੐)|#o0aڱ$I>}k&1`U#V?YsV x>{t1[I~D&(I$I/{H0fw"q"y%4 IXyE~M3 8XψL}qE$I[> nD?~sf ]o΁ cT6"?'_Ἣ $I>~.f|'!N?⟩0G KkXZE]ޡ;/&?k OۘH$IRۀwXӨ<7@PnS04aӶp.:@\IWQJ6sS%I$e5ڑv`3:x';wq_vpgHyXZ 3gЂ7{{EuԹn±}$I$8t;b|591nءQ"P6O5i }iR̈́%Q̄p!I䮢]O{H$IRϻ9s֧ a=`- aB\X0"+5"C1Hb?߮3x3&gşggl_hZ^,`5?ߎvĸ%̀M!OZC2#0x LJ0 Gw$I$I}<{Eb+y;iI,`ܚF:5ܛA8-O-|8K7s|#Z8a&><a&/VtbtLʌI$I$I$I$I$I$IRjDD%tEXtdate:create2022-05-31T04:40:26+00:00!Î%tEXtdate:modify2022-05-31T04:40:26+00:00|{2IENDB`Mini Shell

HOME


Mini Shell 1.0
DIR:/usr/share/doc/analog/
Upload File :
Current File : //usr/share/doc/analog/errors.html
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<html><head>
<link rel=stylesheet type="text/css" href="anlgdocs.css">
<LINK REL="SHORTCUT ICON" HREF="favicon.ico">
<title>Readme for analog -- errors and warnings</title>
</head>

<body>
[ <a href="Readme.html">Top</a> | <a href="Readme.html">Up</a> |
<a href="defns.html">Prev</a> | <a href="faq.html">Next</a> |
<a href="map.html">Map</a> | <a href="indx.html">Index</a> ]
<h1><img src="analogo.gif" alt=""> Analog 6.0:
Errors and warnings</h1>
<hr size=2 noshade>

This section lists all the errors and warnings which analog can produce,
together with a short explanation.

<p>
First, you should understand the difference between a crash, an error, a
warning, and a debugging message. First, a <i>crash</i> is when analog exits
prematurely, without producing the whole output file. The system might give a
message, but analog will not give one of its own messages. Analog should never
crash. If it does crash, please <a href="mailing.html">tell me about it</a>.

<p>
An <i>error</i> is something which stops analog finishing its job. Whenever
an error is detected, analog gives a message starting something like
<kbd>analog: Fatal error:</kbd> and will then tell you what type of thing went
wrong before quitting.

<p>
A <i>warning</i> is a problem which is not fatal to analog: it will keep on
with its processing. These vary from the possibly serious, such as files which
could not be found, to purely informational. They produce a message starting
<kbd>analog: Warning</kbd>. You can turn warnings off using the
<kbd><a href="debug.html#WARNINGS">WARNINGS</a></kbd> command.

<p>
Finally, a <i>debugging message</i> gives information on the state of the
program. They just begin with a single code letter followed by a colon. You
don't get any debugging messages unless you've
<a href="debug.html#debugs">asked for them</a>.

<p>
If you want to send these messages to a file instead of to the screen, you can
use the <kbd><a href="debug.html#ERRFILE">ERRFILE</a></kbd> command.
To tell analog the width of your screen for these messages, you can use the
<kbd><a href="debug.html#ERRLINELENGTH">ERRLINELENGTH</a></kbd> command.

<p>
Now I shall describe all the possible <a href="#errs">errors</a> and
<a href="#warns">warnings</a> in detail.
<hr size=1 noshade>
<h3><a name="errs">Errors</a></h3>
<dl>
  <dt><b>Ran out of memory: cannot continue</b>
  <dd>Analog ran out of memory. Try increasing the memory available to the
      process, if your operating system will allow it, or using the
      <kbd><a href="lowmem.html">LOWMEM</a></kbd> commands.
  <dt><b>Cannot ignore mandatory configuration file</b>
  <dd>See the section in the Readme on the
      <a href="syntax.html#specialcfgs">mandatory configuration file</a>.
  <dt><b>Can't find language file
      <br>Language file too short
      <br>Language file too long
      <br>Language file contains excessively long lines</b>
  <dd>Analog can't run without a well-formed language file. See the
      documentation on <a href="output.html#LANGUAGE">language files</a>.
  <dt><b>Attempted to read more than 50 configuration files</b>
  <dd>The most likely explanation for this is that you have accidentally
      created a loop using the
      <kbd><a href="syntax.html#CONFIGFILE">CONFIGFILE</a></kbd> command, for
      example if a configuration file includes itself.
  <dt><b>Incorrect default given in <kbd>anlghead.h</kbd>
      <br>Default given in <kbd>anlghead.h</kbd> too short</b>
  <dd>If you've compiled your own version, and you've specified an incorrect
      configuration in the file <kbd>anlghead.h</kbd>, analog gives up to
      allow you to fix it.
  <dt><b>Failed to open output file for writing</b>
  <dd>Analog couldn't create, or couldn't write to, the output file you
      specified.
  <dt><b>Cache output file already exists: won't overwrite</b>
  <dd>Analog won't overwrite an old cache file. You must move or delete it
      yourself first.
  <dt><b><kbd>OUTFILE</kbd> and <kbd>CACHEOUTFILE</kbd> are the same</b>
  <dt><b><kbd>OUTFILE</kbd> and <kbd>CACHEOUTFILE</kbd> both set to stdout</b>
  <dd>This can't be what you wanted, because one would overwrite the other.
  <dt><b><kbd>OUTPUT NONE</kbd> and <kbd>CACHEOUTFILE none</kbd> selected</b>
  <dd>You requested no output.
  <dt><b><kbd>OUTPUT LATEX</kbd> only available with <kbd>US-ASCII</kbd>,
      <kbd>ISO-8859-1</kbd> and <kbd>ISO-8859-2</kbd> character sets</b>
  <dd>The LaTeX output style only works with certain European languages
      because the standard LaTeX distribution doesn't contain the characters
      for other languages.
</dl>
<hr size=1 noshade>
<h3><a name="warns">Warnings</a></h3>
Remember that warnings are not fatal: in fact some are rarely even serious.
You can turn them off using the
<kbd><a href="debug.html#WARNINGS">WARNINGS</a></kbd> command. The possible
warnings come in several different categories, shown by a letter in the warning
message. The categories are as follows.
<dl compact>
  <dt><kbd>C</kbd><dd>invalid configuration specified
  <dt><kbd>D</kbd><dd>dubious configuration specified
  <dt><kbd>E</kbd><dd><kbd>ERRFILE</kbd> command used
  <dt><kbd>F</kbd><dd>files missing or corrupt
  <dt><kbd>G</kbd><dd>corrupt lines in support files
  <dt><kbd>L</kbd><dd>apparent problems in logfiles
  <dt><kbd>M</kbd><dd>possible problems in logfiles
  <dt><kbd>R</kbd><dd>turning off empty reports
</dl>
<p>
<h4><a name="warnsC">Category C</a></h4>
This category indicates an incorrect configuration. Analog will either ignore
what you said, or try and do the best it can with it. There are too many
warnings in this category to list completely. You will have to consult the
documentation for the particular <a href="custom.html">configuration
command</a> that gave an error. If you get an error for a command which used
to work in a previous version of analog, have a look in the section
<cite><a href="update.html">Updating from older versions</a></cite>.
<p>
<h4><a name="warnsD">Category D</a></h4>
This is for configurations which might be intended, but which look suspicious.
Analog will not override what you've specified in this case.
<dl>
  <dt><b><kbd>LOGFORMAT</kbd> with no subsequent logfile</b>
  <dd>You have specified a <kbd>LOGFORMAT</kbd> command, but no
      subsequent logfile to which it could be applied. Most likely
      you put the <kbd>LOGFORMAT</kbd> after the <kbd>LOGFILE</kbd> command.
      You must put the <kbd>LOGFORMAT</kbd> before the <kbd>LOGFILE</kbd>
      command or use <kbd>DEFAULTLOGFORMAT</kbd> instead. See the section on
      <cite><a href="logfmt.html">Specifying a log format</a></cite> for
      more details.
  <dt><b>Offset not a multiple of 30
      <br>Offset more than 25 hours</b>
  <dd>The <a href="output.html#TIMEOFFSET">time offsets</a> are meant to be for
      correcting between differences in time zones. These differences are
      usually multiples of 30 minutes between -25 and +25 hours. Maybe you
      specified the offset in hours instead of minutes by mistake, or
      something like that.
  <dt><b><kbd>FROM</kbd> time is later than the present</b>
  <dd>Usually this will mean that no entries are counted. Analog doesn't
      try and correct it in case the clock on your computer or your server is
      wrong -- but you would be better using
      <kbd><a href="output.html#TIMEOFFSET">TIMEOFFSET</a></kbd> or
      <kbd><a href="output.html#TIMEOFFSET">LOGTIMEOFFSET</a></kbd> to correct
      those clocks.
  <dt><b><kbd>SORTBY</kbd> doesn't match <kbd>FLOOR</kbd>
      <br><kbd>SORTBY</kbd> doesn't match <kbd>SUBSORTBY</kbd>
      (or <kbd>FLOOR</kbd>/<kbd>SUBFLOOR</kbd>)
      <br><kbd>SORTBY</kbd> (or <kbd>FLOOR</kbd> or <kbd>GRAPH</kbd>) isn't
      included in <kbd>COLS</kbd></b>
  <dd>Within one report, it's helpful to your readers to have the sort methods
      and the floors compatible, and all included in the <kbd>COLS</kbd>.
      (See the section on <cite><a href="othreps.html">Non-time
      reports</a></cite>).
  <dt><b>Column <kbd>N</kbd> with <kbd>SORTBY ALPHABETICAL/RANDOM</kbd></b>
  <dd>Numbering off the items when they're not in order of busyness is
      probably a mistake.
  <dt><b>Time reports have not all got same value of <kbd>BACK</kbd></b>
  <dd>It's usually helpful to have all the <a href="timereps.html#BACK">time
      reports</a> running in the same direction.
  <dt><b>Report contains no <kbd>COLS</kbd></b>
  <dd>You've got an empty <kbd>COLS</kbd> list for one report, so you'll just
      get a list of names, not any information about them.
  <dt><b><kbd>LOWMEM 3</kbd> prevents that item being cached</b>
  <dd>You're making a <a href="cache.html">cache file</a>, but one item is
      not being recorded because of a
      <kbd><a href="lowmem.html">LOWMEM</a></kbd> command, and will therefore
      not be saved in the cache file.
</dl>
<p>
<h4><a name="warnsE">Category E</a></h4>
There is only one warning in this category.
<dl>
  <dt><b>Redirecting future diagnostic messages</b>
  <dd>You've used an <kbd>ERRFILE</kbd> command to change the destination of
      errors, warnings, debugging and <kbd>PROGRESSFREQ</kbd>
      diagnostics. This is just warning you so that you don't miss any
      messages.
</dl>
<p>
<h4><a name="warnsF">Category F</a></h4>
This category is for diagnosing files which couldn't be opened or read
successfully. These can be serious, but most of the messages should be
self-explanatory. There are a few worth mentioning specifically.
<dl>
<dt><b>Can't auto-detect format of logfile</b>
<dd>The <kbd><a href="logfmt.html">LOGFORMAT</a></kbd> is set to automatic
    detection, but the first line of the logfile is not in any of the
    standard formats. This error can often be generated when you try and
    specify your own <kbd>LOGFORMAT</kbd> but put it after the
    <kbd>LOGFILE</kbd> command so that it is not in effect for that logfile.
<dt><b>Logfile with ambiguous dates</b>
<dd>Some servers, notably IIS and WebSite, record dates in their logfiles
    according to local conventions. Then if analog encounters 2/1/99, for
    example, it doesn't know whether it's the 2nd January or 1st February.
    This problem, and what to do about it, is described in more detail in the
    section on
    <cite><a href="logfile.html#IISfmt">Choosing a logfile</a></cite>.
<dt><b>Logfile seems to be in Microsoft format</b>
<dd>The most common cause of this message is that your IIS logfile uses local
    conventions for listing dates which analog doesn't know about -- e.g.
    25.12.98 instead of 25/12/98. Again, see the section on
    <cite><a href="logfile.html#IISfmt">Choosing a logfile</a></cite> for help.
<dt><b>Ignoring corrupt format line in logfile</b>
<dd>The format line within a W3 extended log, Netscape log or WebSTAR log is
    invalid in some way. Analog will always tell you what's wrong with it. The
    most common problem is that the date only appears at the top of the
    logfile, not on every line, which is not allowed. The reason for this, and
    what to do about it, are in the section on
    <cite><a href="logfile.html#dateonly">Choosing a logfile</a></cite>.
<dt><b>Failed to open domains file</b>
<dd>In this case, all domains will be counted as "unknown domains".
<dt><b>Failed to open DNS input file</b>
<dd>The first time you use DNS lookups, you don't have a DNS cache file, so
    you get this warning. Assuming you are using <kbd>DNS WRITE</kbd>, the
    message will go away next time you run analog.
<dt><b>DNS lock file already exists</b>
<dd>To stop two copies of analog trying to write the DNS file at the same
    time, an empty &quot;lock file&quot; is created, which tells the second
    copy of analog to use <kbd>DNS LOOKUP</kbd> instead of <kbd>DNS
    WRITE</kbd>. If analog crashes, it may not delete its lock file. So if you
    get the &quot;already exists&quot; message even though no other copy of
    analog is running, you may need to delete the lock file yourself.
</dl>
<p>
<h4><a name="warnsG">Category G</a></h4>
This category is used when there is a bad line in the DNS file, domains file
or report descriptions file. Analog will still use the rest of the file. All
the messages should be self-explanatory.
<p>
<h4><a name="warnsL">Category L</a></h4>
When analog finishes reading a logfile, it checks whether there might have
been something wrong with it.
<dl>
  <dt><b>Large number of corrupt lines</b>
  <dd>This could indicate a problem with the logfile, or with the
      <kbd><a href="logfmt.html">LOGFORMAT</a></kbd> specification.
      The possible causes are described in the section on
      <cite><a href="logfile.html#corruptlines">Choosing a logfile</a></cite>.
      If you specify <kbd><a href="debug.html#debugs">DEBUG ON</a></kbd>,
      analog will report where each line was corrupt.
  <dt><b>Logfiles overlap: possible double counting</b>
  <dd>This means that two logfiles which were counting the same type of item
      overlapped in time. Because it's only based on the time period of the
      logfiles, not the actual entries, this may or may not indicate a genuine
      problem. It is a problem if you read the same logfile twice. Or maybe
      you used the cache file feature
      <a href="cache.html#cacheproc">incorrectly</a>.
      Or maybe your web server produces several logfiles, and your
      <kbd><a href="logfmt.html#starredfmt">LOGFORMAT</a></kbd> specification
      should have told analog to ignore some of the items in some of the
      logfiles. It is not a problem if the logfiles are in fact completely
      disjoint; for example if you analyse logfiles from two different virtual
      hosts. In this case, the statistics produced will still be correct.
</dl>
<p>
<h4><a name="warnsM">Category M</a></h4>
This category is for warnings about logfile formats which might make analog
produce unexpected results.
<dl>
  <dt><b>Logfile contains lines with no [whatevers], which are being
      filtered</b>
  <dd>This is usually harmless. It is perhaps best explained by
      example. Suppose you are <a href="include.html">excluding</a> certain
      files from the analysis, but that you are also analysing a browser log
      which just contains information about the browsers used, not which files
      they read. Then we can't exclude the browsers which read the excluded
      files, because we don't know which they were, so all browsers will be
      included.
  <dt><b>Logfile contains lines with no file names (or bytes): page (or byte)
      counts may be low</b>
  <dd>If a logfile line doesn't contain a file name, analog will assume that
      the request wasn't for a page. Similarly, if it doesn't give the number
      of bytes transferred, analog will make the bytes zero. So the number of
      page requests or bytes credited to the other items on that line will
      then be too low.
  <dt><b>Old-style cache file doesn't contain data on first-request times of
      items; so these may be overestimated</b>
  <dd>Cache files now contain the first-request time of each item. But if you
      read a cache file from an older version of analog, this data will not
      have been recorded, and so the last-request time will be used instead.
  <dt><b>Cache file doesn't contain last-seven-day statistics</b>
  <dd>It is impossible for cache files to record the number of requests in the
      last 7 days, because the data would be wrong at the time the cache file
      was read.
</dl>
<p>
<h4><a name="warnsR">Category R</a></h4>
This is used when analog turns off an empty report. This could be because none
of the relevant items were included in any of the logfiles, or perhaps
beacause a <kbd><a href="lowmem.html">LOWMEM</a></kbd> command stopped them
being recorded. It is also used when analog turns off a pie chart which would
have contained only one wedge.
<p>
<h4><a name="brokenpipe">Broken Pipe</a></h4>
This warning is not generated by analog, but it can occur when analog decides
that it doesn't need a logfile which it's uncompressing, and so doesn't finish
reading it. It's harmless.

<hr size=2 noshade>
Go to the <a href="http://www.analog.cx/">analog home page</a>.
<p>
<address>Stephen Turner
<br>19 December 2004</address>
<p><em>Need help with analog? <a href="mailing.html">Use the analog-help
mailing list</a>.</em>
<p>
[ <a href="Readme.html">Top</a> | <a href="Readme.html">Up</a> |
<a href="defns.html">Prev</a> | <a href="faq.html">Next</a> |
<a href="map.html">Map</a> | <a href="indx.html">Index</a> ]
</body> </html>