home *** CD-ROM | disk | FTP | other *** search
/ PC World Komputer 1999 March B / SCO_CASTOR4RRT.iso / frle / root.1 / usr / lib / locale / fr / LC_MESSAGES / debug.help / debug
Text File  |  1998-08-19  |  75KB  |  2,282 lines
  1. # This file contains the help messages used by the Command Line interface.
  2. # Each help message is bracketed by lines starting with ++.
  3. # The debugger does not depend on the size (number of lines) of any message,
  4. # but it does depend on the order of the messages.  New messages MUST be
  5. # added to the end of the file.
  6.  
  7. ++ !
  8. NOM
  9. ! - exΘcution d'une commande shell.
  10.  
  11. RESUME
  12. ! cmd_line
  13. !!
  14.  
  15. DESCRIPTION
  16. ExΘcute une commande shell. Le reste de la ligne est transmis au shell
  17. pour Ωtre interprΘtΘ. En particulier, les donnΘes ne sont PAS redirigΘes
  18. par le dΘbogueur mais par le shell. La variable $SHELL, lorsqu'elle est
  19. dΘfinie, comporte le chemin d'accΦs complet du shell α utiliser. Si
  20. $SHELL n'est pas dΘfinie, c'est /usr/bin/sh qui est employΘ. Le
  21. dΘbogueur attend que la commande s'achΦve, mais ne prend pas le
  22. contr⌠le des processus rΘsultants.
  23.  
  24. !! indique que la derniΦre commande shell doit Ωtre rΘexΘcutΘe.
  25.  
  26. VOIR EGALEMENT
  27. create, redirection
  28. ++
  29.  
  30. ++ alias
  31. NOM
  32. alias - ajout, recencement ou suppression des alias.
  33.  
  34. RESUME
  35. jetons des noms d'alias ...
  36. alias [nom]
  37. alias -r nom
  38.  
  39. DESCRIPTION
  40. La premiΦre forme crΘe un alias "nom" pour les "jetons". Tous les
  41. caractΦres qui se trouvent avant le retour chariot ou le commentaire
  42. seront considΘrΘs comme faisant partie de la dΘfinition. Les alias
  43. existants ou les commandes dΘbogueur peuvent Ωtre redΘfinis sous un nom
  44. d'alias. Une fois que cette dΘfinition est effectuΘe, l'utilisation de
  45. l'alias Θquivaut α taper la sΘquence de symboles qu'il remplace. Les
  46. alias peuvent Ωtre dΘfinis par d'autres alias, mais non de faτon
  47. rΘcursive.
  48.  
  49. Les dΘfinitions d'alias peuvent contenir les identificateurs spΘciaux
  50. $1, $2,... Chacun de ces identificateurs spΘciaux $n est remplacΘ, dans
  51. une dΘfinition d'alias, par le ΘniΦme argument de l'appel d'alias, les
  52. arguments Θtant classΘs par ordre croissant α partir de 1. Chaque
  53. argument doit Ωtre prΘcΘdΘ par un espace blanc et se terminer par un
  54. espace, un caractΦre d'interligne, le caractΦre de commentaire (#) ou le
  55. dΘbut d'un bloc ({). Les identificateurs spΘciaux $1, $2, ... ne seront
  56. pas remplacΘs α l'intΘrieur d'une chaεne entre guillemets.
  57.  
  58. Si la dΘfinition d'un alias comporte l'identificateur spΘcial $#, au
  59. cours de l'appel de l'alias, celui-ci sera remplacΘ par le nombre
  60. d'arguments qui interviennent effectivement dans cet appel. Si la
  61. dΘfinition de l'alias comporte l'identificateur spΘcial $*, au cours de
  62. l'appel de l'alias, celui-ci sera remplacΘ par une liste de tous les
  63. arguments transmis au cours de cet appel, chaque argument Θtant sΘparΘ
  64. des autres par un espace.
  65.  
  66. S'il n'y a pas d'arguments, la commande alias affiche la liste de tous
  67. les alias actuels. S'il y a un seul nom, l'alias correspondant
  68. s'affiche.
  69.  
  70. L'option -r de la commande alias supprime tous les alias correspondants
  71. au nom indiquΘ.
  72.  
  73. EXEMPLES
  74. alias
  75. alias i
  76. alias i step -i
  77. alias edit list $1@1
  78. alias print_list while($1) { print *$1; set $1 = $1->next }
  79. alias b if ($# > 0) { stop $* } else { stop %list_file@%list_line }
  80. alias -r i
  81. ++
  82.  
  83. ++ stop
  84. NOM
  85. stop - dΘfinition ou affichage des ΘvΘnements stop.
  86.  
  87. RESUME
  88. stop [-p liste_proc] [[-q] [-c nombre] expr_stop [commande]]
  89. stop [-p liste_proc]
  90.  
  91. DESCRIPTION
  92. Un ΘvΘnement stop spΘcifie une condition de l'espace adresse d'un
  93. programme qui induit le dΘbogueur α arrΩter l'exΘcution du programme.
  94. "expr_stop" correspond α une ou plusieurs expressions liΘes avec les
  95. opΘrateurs spΘciaux && (et) ou || (ou). Les expressions peuvent
  96. consister en:
  97.  
  98. 1) un emplacement
  99.         Un emplacement dans le texte du programme - ceux-ci peuvent se
  100.         comparer α la ponctuation classique.
  101.  
  102. 2) (expr)
  103.         Une expression dans le langage actuel - ce type d'expression
  104.          top devient vraie en mΩme temps que l'expression elle-mΩme ;
  105.  
  106. 3) *lvalue
  107.         Un emplacement dans les donnΘes du programme pouvant Ωtre
  108.         modifiΘ - ce type d'expression se rΘalise lorsque la valeur
  109.         change.
  110.  
  111. Les expressions expr_stop sont continuellement ΘvaluΘes par le
  112. dΘbogueur lorsque le processus sujet est en cours d'exΘcution. Lorsque
  113. l'expression entiΦre devient vraie, le dΘbogueur annonce une occurrence
  114. de l'ΘvΘnement et exΘcute la commande optionnelle qui y est associΘe.
  115.  
  116. Pour plus d'informations, reportez-vous α expr_stop.
  117.  
  118. L'option -q indique que le dΘbogueur ne dΘclare pas l'ΘvΘnement.
  119.  
  120. L'option -c indique que l'ΘvΘnement ne se dΘclenche qu'aprΦs un certain
  121. nombre de fois ou l'expression expr_stop devient vraie, nombre indiquΘ par
  122. "nombre". L'ΘvΘnement se dΘclenchera toutes les autres fois ou
  123. l'expression devient vraie.
  124.  
  125. La deuxiΦme syntaxe de la commande stop recense tous les ΘvΘnements
  126. stop pour les processus indiquΘs.
  127.  
  128. A la diffΘrence de ce qui se produit pour la plupart des commandes, si
  129. l'option -p n'est pas fournie α la commande stop, celle-ci va
  130. s'appliquer α tous les processus dΘrivΘs du programme actuel (%program).
  131.  
  132. EXEMPLES
  133. stop myfile.c@230
  134. stop *bar
  135. stop (x == 5)
  136. stop foo && (a > 7)
  137. stop (a == 4) || (b == 7)
  138.  
  139. VOIR EGALEMENT
  140. %program, %verbose, assoccmd, delete, disable, enable, events,
  141. expr, emplacement, liste_proc, scope, expr_stop
  142. ++
  143.  
  144.  
  145. ++ break
  146. NOM
  147. break - sortie d'une boucle while.
  148.  
  149. RESUME
  150. break
  151.  
  152. DESCRIPTION
  153. La commande break force le dΘbogueur α sortir de la boucle while
  154. la plus profonde concernΘe par la commande.
  155.  
  156. EXEMPLES
  157. while($i < 10) { if (x[$i] == $myvar) break; set $i = $i + 1 }
  158.  
  159. VOIR EGALEMENT
  160. continue, while
  161. ++
  162.  
  163.  
  164. ++ continue
  165. NOM
  166. continue - continuation de l'exΘcution de la prochaine itΘration de
  167. la boucle while.
  168.  
  169. RESUME
  170. continue
  171.  
  172. DESCRIPTION
  173. La commande continue force le dΘbogueur α commencer l'exΘcution
  174. de la prochaine itΘration de la boucle while la plus profonde
  175. concernΘe par la commande. L'exΘcution dΘmarre avec la rΘΘvaluation
  176. de l'expression de la boucle.
  177.  
  178. EXEMPLES
  179. while (i < 20) { step; if (i % 2) continue; p i, x[i] }
  180.  
  181. VOIR EGALEMENT
  182. break, while
  183. ++
  184.  
  185.  
  186. ++ cancel
  187. NOM
  188. cancel - annulation des signaux en attente.
  189.  
  190. RESUME
  191. cancel [-p liste_proc] [signal ...]
  192.  
  193. DESCRIPTION
  194. Les signaux spΘcifiΘs sont annulΘs pour les processus
  195. indiquΘs (%proc par dΘfaut). Si un des signaux a ΘtΘ interceptΘ
  196. par le dΘbogueur dans un des processus spΘcifiΘs, ces signaux ne
  197. seront pas reτus par ces processus lorsque leur exΘcution
  198. reprend. Si aucun signal n'est spΘcifiΘ, tous les signaux en
  199. attente pour les processus indiquΘs vont Ωtre annulΘs.
  200.  
  201. EXEMPLES
  202. cancel
  203. cancel segv
  204. cancel -p all sigfpe sigemt
  205.  
  206. VOIR EGALEMENT
  207. kill, liste_proc, signal, signames
  208. ++
  209.  
  210.  
  211. ++ create
  212. NOM
  213. create - crΘation ou contr⌠le d'un ou plusieurs processus nouveaux.
  214.  
  215. RESUME
  216. create [-dr] [-f all|none|procs] [-l start_loc] [cmd_line]
  217.  
  218. DESCRIPTION
  219. La commande create prend une ligne de commande de type shell et crΘe un
  220. ou plusieurs processus. La ligne de commande peut inclure une redirection
  221. d'entrΘe et/ou de sortie, ainsi qu'un canal shell. Tous les processus
  222. rΘsultants s'arrΩtent α l'emplacement spΘcifiΘ par "start_loc".
  223. Si aucun emplacement de dΘmarrage n'est spΘcifiΘ ou que l'emplacement
  224. indiquΘ est introuvable dans l'espace adresse du processus, ce
  225. dernier s'arrΩte α la fonction "main". Si aucune fonction "main" n'existe,
  226. le processus s'arrΩte α l'adresse indiquΘe dans l'en-tΩte du
  227. fichier objet. Pour crΘer et exΘcuter un processus, tapez "create...",
  228. puis "run". 
  229.  
  230. Si aucune "cmd_line" n'est specifiΘe, c'est la "cmd_line"  prΘcΘdente
  231. qui est utilisΘe. Tout processus crΘΘ α partir d'invocations existantes
  232. de cette "cmd_line" est dΘtruit.
  233.  
  234. Un identificateur de processus dΘbogueur propre est attribuΘ α chaque
  235. processus crΘΘ. Il est possible de faire rΘfΘrence α un processus par
  236. cet identificateur ou par l'id du processus systΦme dans les commandes
  237. acceptant l'option -p. Le premier processus crΘΘ dans un pipeline
  238. devient le processus actuel (%proc). Tous les processus crΘΘs α partir
  239. d'un exΘcutable simple (via fork (2)) peuvent Ωtre rΘfΘrencΘs par le nom
  240. de cet exΘcutable (nom programme).
  241.  
  242. Si l'option -r est spΘcifiΘe, les entrΘes/sorties du processus sont
  243. redirigΘes vers un pseudo-terminal. Toutes les sorties sont prΘcΘdΘes
  244. du nom de ce pseudo-terminal. S'il est nΘcessaire de fournir des entrΘes
  245. α ce processus, la commande "input" doit Ωtre utilisΘe. L'option -d
  246. indique qu'il ne doit pas y avoir de redirection. Si aucune des deux
  247. options n'est spΘcifiΘe, le mode spΘcifiΘ par %redir sera utilisΘ (par
  248. dΘfaut, pas de redirection).
  249.  
  250. Si -f est employΘe avec un argument "none" (aucune), le dΘbogueur ne
  251. suivra pas les processus enfants d'un processus utilisant la duplication
  252. ("fork"). Si l'option -f est employΘe avec, soit la valeur "all" (tous),
  253. soit la valeur "procs" (processus), tous les processus enfant seront
  254. contr⌠lΘs par le dΘbogueur (ces processus pouvant Ωtre libΘrΘs du
  255. contr⌠le du dΘbogueur en utilisant la commande "release"). Si l'option
  256. -f n'est pas spΘcifiΘe, le fonctionnement du dΘbogueur sera contr⌠lΘ par
  257. %follow (le fonctionnement par dΘfaut Θtant de suivre tous les processus
  258. enfant).
  259.  
  260. EXEMPLES
  261. create
  262. create -f none myprog 1 2 3
  263. create myprog 1 2 3 | myfilter1 | myfilter2
  264.  
  265. VOIR EGALEMENT
  266. !, %follow, %program, %redir, grab, input, liste_proc, rename, release
  267. ++
  268.  
  269.  
  270. ++ delete
  271. NOM
  272. delete - suppression des ΘvΘnements.
  273.  
  274. RESUME
  275. delete numΘro_ΘvΘnement ...
  276. delete -a [-p liste_proc] [type_ΘvΘnement]
  277.  
  278. DESCRIPTION
  279. La premiΦre syntaxe supprime les ΘvΘnements correspondant
  280. aux numΘros d'ΘvΘnements spΘcifiΘs.
  281.  
  282. La deuxiΦme syntaxe supprime tous les ΘvΘnements du type spΘcifiΘ,
  283. type_ΘvΦnement (si aucun n'est spΘcifiΘ, tous les types), pour les
  284. processus indiquΘs (si aucun n'est indiquΘ, le processus actuel).
  285. "type_ΘvΦnement" peut Ωtre dΘfini par "onstop", "signal", "stop" ou
  286. "syscall".
  287.  
  288.  
  289. EXEMPLES
  290. delete 1 3 5
  291. delete -a -p p1
  292. delete -a stop
  293. delete -a syscall
  294.  
  295. VOIR EGALEMENT
  296. change, disable, enable, events, onstop, liste_proc,
  297. signal, stop, syscall
  298. ++
  299.  
  300.  
  301. ++ dis
  302. NOM
  303. dis - dΘsassemblage des instructions machine.
  304.  
  305. RESUME
  306. dis [-p liste_proc] [-c nombre_instr] [emplacement]
  307.  
  308. DESCRIPTION DΘsassemble les instructions "instr_count" dans chaque
  309. processus spΘcifiΘ (%proc par dΘfaut). Si aucune instruction n'est
  310. donnΘe, la valeur par dΘfaut de count est %num_lines, qui commence a 10
  311. et peut Ωtre modifiΘe.
  312.  
  313. Si un "emplacement" est spΘcifiΘ, le dΘsassemblage commence α l'adresse
  314. prΘcisΘe pour chaque processus indiquΘ. Si un "emplacement" n'est pas
  315. spΘcifiΘ, le premiΦre commande dis aprΦs dΘclenchement d'un ΘvΘnement
  316. ou aprΦs remise α zΘro de %frame, commencera α %loc. Les prochaines
  317. commandes dis continuent α partir de l'adresse qui suit la derniΦre
  318. instruction affichΘe par la commande dis prΘcΘdente.
  319.  
  320. EXEMPLES
  321. dis
  322. dis -c 20 main
  323. dis file.c@10
  324.  
  325. VOIR EGALEMENT
  326. %frame, %loc, %num_lines, dump, emplacement, print, liste_proc
  327. ++
  328.  
  329.  
  330. ++ disable
  331. NOM
  332. disable - dΘsactivation des ΘvΘnements
  333.  
  334. RESUME
  335. disable numΘro_ΘvΘnement ...
  336. disable -a [-p liste_proc] [type_ΘvΘnement]
  337.  
  338. DESCRIPTION
  339. La premiΦre syntaxe dΘsactive les ΘvΘnements correspondants aux
  340. numΘros spΘcifiΘs.
  341.  
  342. La deuxiΦme syntaxe dΘsactive tous les ΘvΘnements spΘcifiΘs par 
  343. type_ΘvΘnement (si aucun type n'est spΘcifiΘ, tous les types) pour les 
  344. processus indiquΘs (lorsqu'aucun n'est spΘcifiΘ, le processus actuel). 
  345. "type_ΘvΘnement" peut Ωtre dΘfini par  "onstop", "signal", "stop" ou
  346. "syscall".
  347.  
  348. Les ΘvΘnements dΘsactivΘs n'ont aucun effet sur les processus auxquels
  349. ils s'appliquent, mais ils ne sont pas supprimΘs. Ils pourront Ωtre
  350. rΘinstallΘs par "enable".
  351.  
  352. EXEMPLES
  353. disable 3 5
  354. disable -a -p p1
  355. disable -a onstop
  356. disable -a signal
  357.  
  358. VOIR EGALEMENT
  359. change, delete, enable, events, onstop, liste_proc, signal,
  360. stop, syscall
  361. ++
  362.  
  363. ++ dump
  364. NOM
  365. dump - affiche le contenu de la mΘmoire
  366.  
  367. RESUME
  368. dump [-p liste_proc] [-c nombre_octet] emplacement
  369.  
  370. DESCRIPTION
  371. La commande dump affiche le contenu de la mΘmoire pour
  372. chaque processus spΘcifiΘ (%thread ou %proc par dΘfaut).
  373. "nombre_octet" (%nbr_octets par dΘfaut) octets, 16 octets par
  374. ligne, en hexadΘcimal et ASCII vont s'afficher, en commenτant α
  375. l'adresse indiquΘe par un "emplacement".
  376.  
  377. %num_bytes commence α 256, mais peut Ωtre modifiΘ.
  378.  
  379. EXEMPLES
  380. dump -c 16 myptr
  381. dump %esp
  382. dump 0x80001248
  383.  
  384. VOIR EGALEMENT
  385. %num_bytes, dis, emplacement, print, liste_proc
  386. ++
  387.  
  388.  
  389. ++ enable
  390. NOM
  391. enable - activation des ΘvΘnements
  392.  
  393. RESUME
  394. enable numΘro_ΘvΘnement ...
  395. enable -a [-p liste_proc] [type_ΘvΘnement]
  396.  
  397. DESCRIPTION
  398. La premiΦre syntaxe active les ΘvΘnements correspondants aux numΘros
  399. d'ΘvΘnements spΘcifiΘs.
  400.  
  401. La  deuxiΦme syntaxe active tous les ΘvΘnements du type spΘcifiΘ (si
  402. aucun type n'est spΘcifiΘ, tous les types) pour les processus indiquΘs
  403. (lorsqu'aucun n'est spΘcifiΘ, le processus actuel). "type_ΘvΘnement"
  404. peut Ωtre dΘfini par "onstop", "signal", "stop" ou "syscall".
  405.  
  406. Seuls les ΘvΘnements prΘalablement dΘsactivΘs peuvent Ωtre activΘs.
  407. Une fois activΘ, l'ΘvΘnement affecte α nouveau le processus dans lequel
  408. il est dΘfini.
  409.  
  410. EXEMPLES
  411. enable 3 5
  412. enable -a -p p1
  413. enable -a stop
  414. enable -a signal
  415.  
  416. VOIR EGALEMENT
  417. change, delete, disable, events, onstop, liste_proc, signal,
  418. stop, syscall
  419. ++
  420.  
  421.  
  422. ++ events
  423. NOM
  424. events - liste des ΘvΘnements
  425.  
  426. RESUME
  427. events [-p liste_proc] [numΘro_ΘvΘnement ...]
  428.  
  429. DESCRIPTION
  430. Si aucun argument n'est spΘcifiΘ, la commande events
  431. affiche une liste de tous les ΘvΘnements stop, des signaux, des appels
  432. systΦme ou des actions onstop du processus actuel. Avec l'option -p,
  433. elle affiche les ΘvΘnements associΘs aux processus spΘcifiΘs.
  434.  
  435. Lorsqu'un ou plusieurs numΘros d'ΘvΘnements sont indiquΘs, la commande
  436. events affiche la liste complΦte de ces ΘvΘnements. Cette liste
  437. comporte tous les processus pour lesquels l'ΘvΘnement est dΘfini et, le
  438. cas ΘchΘant,  tout le bloc de commandes associΘ.
  439.  
  440. EXEMPLES
  441. events
  442. events -p p1,p2
  443. events 3
  444.  
  445. VOIR EGALEMENT
  446. change, delete, disable, enable, onstop, liste_proc, signal,
  447. stop, syscall
  448. ++
  449.  
  450.  
  451. ++ grab
  452. NOM
  453. grab - prend le contr⌠le des processus en cours ou d'une image du noyau.
  454.  
  455. RESUME
  456. grab  [-f all|none|procs] [-l load_file] live_object ...
  457. grab -c fichier_image_mΘmoire fichier_objet
  458.  
  459. DESCRIPTION
  460. La premiΦre syntaxe prend un ou plusieurs indicateurs de
  461. processus ; le dΘbogueur va essayer de prendre le contr⌠le de chacun
  462. des processus spΘcifiΘs (le contr⌠le n'est garanti qu'avec les
  463. autorisations correspondantes). Chaque processus peut Ωtre spΘcifiΘ α
  464. l'aide d'un chemin d'accΦs /proc ou d'un id processus.
  465.  
  466. L'option -l indique qu'un fichier objet de remplacement α utiliser pour
  467. charger les symboles du processus. Si l'option -l est spΘcifiΘe, vous
  468. ne pouvez indiquer qu'un seul processus.
  469.  
  470. Si l'option -f n'a aucun argument ("none"), le dΘbogueur ne suit pas les
  471. processus enfants d'un processus  qui se duplique. Si -f a pour
  472. arguments "all" ou "procs", tous les processus enfants vont Ωtre sous
  473. contr⌠le du dΘbogueur (ces processus peuvent Ωtre libΘrΘs du contr⌠le
  474. du dΘbogueur avec la commande "release"). Si aucune option -f n'est
  475. spΘcifiΘe, le comportement du dΘbogueur va Ωtre dictΘ par %follow
  476. (par dΘfaut, tous les processus enfants).
  477.  
  478. La deuxiΦme syntaxe ouvre et examine un fichier source et son fichier
  479. objet correspondant. Les images noyau crΘΘes par Grab peuvent Ωtre
  480. examinΘes en utilisant toutes les commandes disponibles pour l'examen
  481. des processus en cours d'exΘcution, mais sans que l'on puisse les
  482. modifier ou les lancer.
  483.  
  484. Les processus examinΘs avec Grab, comme les processus crΘΘs normalement,
  485. reτoivent un identificateur de processus du dΘbogueur et peuvent
  486. Ωtre rΘfΘrencΘs soit avec cet identificateur, soit par l'id de leur
  487. processus systΦme, soit encore par le nom du programme dont ils
  488. proviennent. Le premier processus examinΘ par grab devient le
  489. processus actuel (%proc).
  490.  
  491. EXEMPLES
  492. grab 123
  493. grab -f procs /proc/123 3455
  494. grab -l myobject /proc/3455
  495. grab -c core.save myobject
  496.  
  497. VOIR EGALEMENT
  498. %follow, %proc, %program, create, liste_proc, release, rename
  499. ++
  500.  
  501.  
  502. ++ help
  503. NOM
  504. help - demande de l'aide
  505.  
  506. RESUME
  507. help [sujet]
  508.  
  509. DESCRIPTION
  510. Le "sujet" peut Ωtre un alias, un nom de commande ou un sujet
  511. d'aide quelconque. Si aucun sujet n'est spΘcifiΘ, la liste des
  512. commandes disponibles et des sujets s'affiche.
  513.  
  514. EXEMPLES
  515. help
  516. help stop
  517. help b
  518. help emplacement
  519. ++
  520.  
  521.  
  522. ++ if
  523. NOM
  524. if - branchement conditionnel.
  525.  
  526. RESUME
  527. if (expr) cmd
  528. if (expr) cmd else cmd
  529.  
  530. DESCRIPTION
  531. L'Θvaluation de l'expression s'effectue en langage actuel
  532. (%db_lang ou %lang) dans le contexte du processus actuel (%proc).
  533. Si l'expression est vraie, la partie "then" est exΘcutΘ. Dans le
  534. cas contraire, c'est la partie "else" (si spΘcifiΘ) qui sera
  535. exΘcutΘ. "cmd" peut reprΘsenter une commande simple ou un bloc de
  536. commandes.
  537.  
  538. EXEMPLES
  539. stop  file.c@myfunc { if (x < 10) run; else print x }
  540.  
  541. VOIR EGALEMENT
  542. %db_lang, %lang, bloc, expr, scope, while
  543. ++
  544.  
  545.  
  546. ++ input
  547. NOM
  548. input - envoi d'une entrΘe α un processus.
  549.  
  550. RESUME
  551. input [-p nom_proc|-r pseudo-tty] [-n] chaεne
  552.  
  553. DESCRIPTION
  554. Si un processus a ΘtΘ crΘΘ en utilisant la commande "create -r", ses
  555. entrΘes et ses sorties, ainsi que les entrΘes/sorties des autres
  556. processus dΘrivΘs du mΩme programme, sont redirigΘes vers un
  557. pseudo-terminal. Pour envoyer une entrΘe α un tel processus, la
  558. commande "input" doit Ωtre utilisΘe.
  559.  
  560. "pseudo-tty" est le nom du pseudo-terminal sur lequel les entrΘes
  561. doivent Ωtre dirigΘes. Le dΘbogueur affiche le nom du pseudo-terminal
  562. α cotΘ des sorties redirigΘes du processus. Il est Θgalement possible
  563. d'afficher le nom du processus ou celui du programme. Si aucun processus
  564. ou nom de pseudo-terminal n'est spΘcifiΘ, le pseudo-terminal associΘ au
  565. programme actuel est celui qui sera utilisΘ.
  566.  
  567. L'entrΘe "chaεne" est envoyΘe au pseudo-terminal indiquΘ ou au
  568. pseudo-terminal associΘ au processus (ou au programme) spΘcifiΘ. Une
  569. nouvelle ligne est ajoutΘe α la fin de la chaεne, α moins que l'option
  570. -n ne soit spΘcifiΘe.
  571.  
  572. EXEMPLES
  573. input -r pts1 "voici une chaεne de caractΦres"
  574. input -p myprog "en voici une autre"
  575.  
  576. VOIR EGALEMENT
  577. %redir, create
  578. ++
  579.  
  580.  
  581. ++ jump
  582. NOM
  583. jump - modification du compteur de programme du processus.
  584.  
  585. RESUME
  586. jump [-p liste_proc] emplacement
  587.  
  588. DESCRIPTION Vous devez interrompre le processus pour pouvoir lui
  589. appliquer cette commande. La commande jump dΘfinit le compteur du
  590. programme du processus indiquΘ (par dΘfaut %proc) α l'adresse spΘcifiΘe
  591. par un "emplacement". L'exΘcution du processus reprend α cette adresse.
  592.  
  593. L'emplacement peut Ωtre n'importe quelle adresse dans le texte du processus
  594. spΘcifiΘ, mais il faut nΘanmoins faire attention. La commande jump
  595. n'essaye pas de s'adapter α la pile de processus si cette adresse est
  596. en dehors de la fonction actuelle. Il faut Θgalement faire attention en
  597. l'appliquant α des codes pouvant avoir des effets secondaires non
  598. nΘgligeables.
  599.  
  600. RESUME
  601. jump 10
  602. jump -p p2 main+8
  603.  
  604. VOIR EGALEMENT
  605. emplacement, liste_proc
  606. ++
  607.  
  608.  
  609. ++ kill
  610. NOM
  611. kill - envoie un signal α un processus
  612.  
  613. RESUME
  614. kill [-p liste_proc] [signal]
  615.  
  616. DESCRIPTION
  617. "signal" est transmis aux processus indiquΘs (%proc par dΘfaut).
  618. Les signaux peuvent Ωtre spΘcifiΘs par leur nom ou leur numΘro. Un nom
  619. de signal peut Ωtre ou non accompagnΘ du prΘfixe "SIG". Les majuscules
  620. ou les minuscules ont la mΩme valeur. Si aucun signal n'est donnΘ, la
  621. commande kill utilise les signaux SIGKILL.
  622.  
  623. EXEMPLES
  624. kill -p all
  625. kill sigfpe
  626. kill -p p3 8
  627.  
  628. VOIR EGALEMENT
  629. cancel, liste_proc, signal, signames
  630. ++
  631.  
  632.  
  633. ++ list
  634. NOM
  635. list - affiche les lignes de code source.
  636.  
  637. RESUME
  638. list [-p liste_proc] [-c nombre] [id_proc@][nom_fichier@]nom_fonc
  639. list [-p liste_proc] [-c nombre] [id_proc@][nom_fichier@]num_ligne
  640. list [-p liste_proc] [-c nombre] /expreg/
  641. list [-p listeproc] [-c nombre] ?expreg?
  642. list [-p listeproc] [-c nombre]
  643.  
  644. DESCRIPTION
  645. La commande list affiche les lignes source pour les processus spΘcifiΘs
  646. ou pour le processus actuel, si liste_proc n'est pas spΘcifiΘ.
  647.  
  648. Les quatre premiΦres syntaxes spΘcifient des points de dΘpart pour
  649. l'affichage. Les deux premiΦres permettent de spΘcifier les processus,
  650. les fichiers, les fonctions et les numΘros de lignes. Si un processus
  651. est spΘcifiΘ, il se substitue α tout autre processus donnΘ par l'option
  652. -p. La troisiΦme syntaxe trouve la prochaine ligne correspondant α
  653. l'expression rΘguliΦre ed (1)-style. La quatriΦme recherche en sens
  654. inverse α partir de la ligne actuelle. La barre oblique ou le point
  655. d'interrogation fermant la chaεne peuvent Ωtre omis, α moins qu'une
  656. autre commande ne vienne sur la mΩme ligne. La derniΦre syntaxe
  657. continue l'affichage α partir du fichier et de la ligne o∙ se terminait
  658. le dernier affichage ou α partir de  %file@%line aprΦs dΘclenchement
  659. d'un ΘvΘnement ou de la remise α zΘro de %frame.
  660.  
  661. Si une limite ("count") a ΘtΘ spΘcifiΘe, le nombre de lignes
  662. correspondant sera affichΘ, sinon seules %num_lines lignes seront
  663. affichΘes, cette valeur partant de 10 et pouvant Ωtre changΘ.
  664.  
  665. AprΦs l'affichage d'un bloc de lignes, %list_file devient le nom du
  666. fichier affichΘ et %list_lines le numΘro de la derniΦre ligne de code
  667. source qui a ΘtΘ affichΘe.
  668.  
  669. EXEMPLES
  670. list -c 20
  671. list myfile@1
  672. list myfunc
  673. list /x/
  674. list ?foobar
  675. list /
  676.  
  677. VOIR EGALEMENT
  678. %file, %frame, %line, %list_file, %list_line, emplacement,
  679. print, liste_proc, expr_rΘg
  680. ++
  681.  
  682. ++ map
  683. NOM
  684. map - affiche l'allocation des adresses virtuelles.
  685.  
  686. RESUME
  687. map [-p liste_proc]
  688.  
  689. DESCRIPTION
  690. Affiche la table des adresses virtuelles d'un ou plusieurs processus.
  691. Si aucun argument n'est spΘcifiΘ, affiche la table du processus courant
  692. (%proc). Avec l'option -p, affiche la table de chaque processus
  693. reprΘsentΘ par l'ensemble de processus indiquΘs.
  694.  
  695. VOIR EGALEMENT
  696. create, grab, liste_proc
  697. ++
  698.  
  699.  
  700. ++ symbols
  701. NOM
  702. symbols - affiche les noms, les valeurs et les types des symboles.
  703.  
  704. RESUME
  705. symbols [-p liste_proc] [-o objet] [-n nom_fichier] [-dfgltuv] [modΦle]
  706.  
  707. DESCRIPTION
  708. Affiche la liste des noms de variables visibles dans la trame actuelle
  709. (%frame) des processus spΘcifiΘs (%proc par dΘfaut). Si aucune option
  710. n'est spΘcifiΘe (ou si -l est prΘcisΘe) , elle affiche les noms locaux
  711. dΘfinis dans la fonction actuelle (%func). L'option -f permet
  712. d'afficher uniquement les noms visibles et locaux pour le fichier
  713. actuel (%file). Si "nom_fichier" est spΘcifiΘ dans l'option -n, ce sont les
  714. symboles de ce fichier qui s'affichent. L'option -g affiche uniquement
  715. les noms en gΘnΘral visibles, dΘfinis dans l'objet actuel (fichier
  716. exΘcutable ou bibliothΦque partagΘe). Si elle est accompagnΘe de
  717. l'option -o, l'option -g affiche les noms visibles dΘfinis α
  718. l'intΘrieur d'un objet spΘcifiΘ. L'option -d affiche les variables
  719. intΘgrΘes du dΘbogueur. L'option -u affiche les variables dΘfinies par
  720. l'utilisateur et gΘrΘes par le dΘbogueur.
  721.  
  722. Si un argument de type sh(1) est utilisΘ, celui-ci restreint encore plus
  723. l'affichage pour n'y inclure que les noms de variables correspondants α
  724. l'argument de recherche.
  725.  
  726. L'option -t affiche les types de symboles, en plus de leurs noms.
  727. L'option -v affiche les valeurs de ces symboles. Notez bien que lorsque
  728. le langage actuel est C++, l'option -v n'affiche pas des membres de
  729. classe static. Ces derniers peuvent s'afficher lorsqu'on imprime le
  730. symbole.
  731.  
  732. EXEMPLES
  733. symbols -ftv
  734. symbols -g -o libc.so.1 exec*
  735.  
  736. VOIR EGALEMENT
  737. %file, %frame, %func, modΦle, print, liste_proc
  738. ++
  739.  
  740.  
  741. ++ print
  742. NOM
  743. print - imprime la valeur d'une expression.
  744.  
  745. RESUME
  746. print [-p liste_proc] [-f format] [-v] expr, ...
  747.  
  748. DESCRIPTION
  749. Affiche les rΘsultats de l'Θvaluation des listes d'expressions sΘparΘes
  750. par des virgules. L'Θvaluation de ces expressions s'effectue dans le
  751. contexte des processus spΘcifiΘs (%proc par dΘfaut). L'option -f
  752. requiert un format (which see). Les expressions peuvent comporter des
  753. variables de programme, des variables intΘgrΘes du dΘbogueur
  754. (comme %line par exemple) et des variables dΘfinies par l'utilisateur
  755. ($myvar, $HOME). Lors de l'Θvaluation de l'appel d'une fonction, le
  756. dΘbogueur crΘe une trame de pile pour cette fonction et l'exΘcute. Les
  757. ΘvΘnements du dΘbogueur sont dΘsactivΘs pendant l'exΘcution de la
  758. fonction. L'Θvaluation des expressions se fait en langage actuel
  759. (%lang ou %db_lang). Chaque expression est suivie d'un espace et une
  760. nouvelle ligne est ajoutΘe α la fin, α moins qu'un autre format ne soit
  761. spΘcifiΘ.
  762.  
  763. L'option -v affiche des informations plus dΘtaillΘes. Les informations
  764. supplΘmentaires comprennent des prototypes de fonctions  pour toutes les
  765. fonctions, appelΘs par le dΘbogueur lors de l'Θvaluation de
  766. l'expression. Ceci est utile en C++ afin de voir comment les fonctions
  767. surchargΘes sont rΘsolues. L'option -v affichera Θgalement la structure
  768. gΘnΘrΘe par le compilateur et les membres des classes, comme les
  769. pointeurs en direction des tables de fonctions virtuelles.
  770.  
  771. La commande "set" peut Θgalement Ωtre utilisΘe afin d'Θvaluer des
  772. expressions du langage. Par contre, elle n'imprime pas le rΘsultat d'une
  773. expression. Elle est utilisΘe principalement pour Θvaluer une expression
  774. pouvant avoir des effets secondaires, comme une assignation.
  775.  
  776. EXEMPLES
  777. print %line, %file, %func
  778. print "a[i] == ", a[i]
  779. print *ptr->next
  780. print -f "0x%x\n" main
  781. print -v myfunc(1, 2, 3)
  782.  
  783. VOIR EGALEMENT
  784. %db_lang, %lang, C++, expr, format, liste_proc, scope, set
  785. ++
  786.  
  787. ++ ps
  788. NOM
  789. ps - Θtat du processus.
  790.  
  791. RESUME
  792. ps [-p liste_proc]
  793.  
  794. DESCRIPTION
  795. Affiche la liste d'Θtat des processus sous contr⌠le. Si aucune option -p
  796. n'est spΘcifiΘe, l'Θtat de tous les processus sous contr⌠le est affichΘ.
  797. Le processus actuel (%proc) est signalΘ par un astΘrisque (*).
  798.  
  799. VOIR EGALEMENT
  800. liste_proc
  801. ++
  802.  
  803. ++ pwd
  804. NOM
  805. pwd - affiche le rΘpertoire de travail actuel.
  806.  
  807. RESUME
  808. pwd
  809.  
  810. DESCRIPTION
  811. pwd affiche le rΘpertoire de travail actuel du dΘbogueur.
  812.  
  813. VOIR EGALEMENT
  814. cd
  815. ++
  816.  
  817. ++ quit
  818. NOM
  819. quit - sort du dΘbogueur.
  820.  
  821. RESUME
  822. quit
  823.  
  824. DESCRIPTION
  825. Sort du dΘbogueur. Tous les processus contr⌠lΘs seront arrΩtΘs 
  826. (s'ils ont ΘtΘ crΘΘs) ou libΘrΘs et lancΘs (s'ils Θtaient 
  827. contr⌠lΘs par la commande grab).
  828.  
  829. VOIR EGALEMENT
  830. release
  831. ++
  832.  
  833. ++ release
  834. NOM
  835. release - libΦre un ou plusieurs processus sous contr⌠le.
  836.  
  837. RESUME
  838. release [-s] [-p liste_proc]
  839.  
  840. DESCRIPTION
  841. Les processus indiquΘs (%proc par dΘfaut) ne sont plus sous contr⌠le du
  842. dΘbogueur. Avec l'option -s, chaque processus est libΘrΘ dans un Θtat
  843. arrΩtΘ ; sinon chaque processus est libΘrΘ et peut continuer son
  844. exΘcution. Un processus peut Ωtre libΘrΘ mΩme s'il n'a pas ΘtΘ saisi
  845. par le dΘbogueur ; ce qui signifie que les processus crΘΘs peuvent
  846. aussi Ωtre libΘrΘs.
  847.  
  848. EXEMPLES
  849. release -p p1
  850. release -s
  851.  
  852. VOIR EGALEMENT
  853. liste_proc, quit
  854. ++
  855.  
  856. ++ run
  857. NOM
  858. run - dΘfinit les processus en cours d'exΘcution
  859.  
  860. RESUME
  861. run [-p liste_proc] [-bfr] [-u emplacement]
  862.  
  863. DESCRIPTION
  864. DΘfinit la liste des processus en cours d'exΘcution (%proc par dΘfaut).
  865. L'option -f indique que le dΘbogueur exΘcute le processus en premier
  866. plan: il attendra l'arrΩt du processus avant de rendre la main α
  867. l'utilisateur. L'option -b indique une exΘcution en arriΦre-plan (pas
  868. d'attente). Le contr⌠le passe immΘdiatement aux mains de l'utilisateur
  869. et le processus est lancΘ. Si aucune de ces deux options -f ou -b n'est
  870. spΘcifiΘe, la valeur par dΘfaut est indiquΘe par la variable %wait du
  871. dΘbogueur.
  872.  
  873. L'option -r fait que le processus continue α s'exΘcuter jusqu'au retour
  874. de la fonction actuelle. L'option -u spΘcifie l'adresse (un
  875. "emplacement") d'o∙ il faut commencer l'exΘcution.
  876.  
  877. EXEMPLES
  878. run -p all -b
  879. run -r
  880. run -u 108
  881.  
  882. VOIR EGALEMENT
  883. %wait, emplacement, liste_proc, step
  884. ++
  885.  
  886. ++ script
  887. NOM
  888. script - exΘcute une commande script du dΘbogueur.
  889.  
  890. RESUME
  891. script [-q] fname
  892.  
  893. DESCRIPTION
  894. Lit et exΘcute des commandes du dΘbogueur α partir d'un fichier.
  895. Les commandes sont affichΘes avant leur exΘcution, α moins que l'option
  896. -q ne soit spΘcifiΘe. Les scripts pouvant Ωtre imbriquΘs.
  897. ++
  898.  
  899. ++ set
  900. NOM
  901. set - modifie la valeur d'une variable du dΘbogueur ou d'un programme.
  902.  
  903. RESUME
  904. set [-p liste_proc] [-v] variable_dΘbog_ou_utilisateur [=] expr [,expr...]
  905. set [-p liste_proc] [-v]expression_langue
  906.  
  907. DESCRIPTION
  908. La commande "set" possΦde deux syntaxes. La premiΦre est utilisΘe
  909. afin d'allouer une nouvelle valeur α une variable interne du
  910. dΘbogueur ou une variable dΘfinie par l'utilisateur et gΘrΘe par
  911. le dΘbogueur (par exemple, %lang ou $foo). Les valeurs correctes
  912. pour l'expression "expr" dΘpendent de la variable. Certaines
  913. variables, comme %lang, accepte une sΘrie de nom spΘcialement
  914. dΘfinis. D'autres variables peuvent accepter toutes les
  915. expressions du dΘbogueur ou d'un langage qui peuvent Ωtre
  916. converties en chaεne de caractΦres. Dans le cas d'une liste de
  917. chaεnes de caractΦres (et de variables utilisateurs) sΘparΘes par
  918. des virgules, les valeurs des chaεnes de caractΦres de ces
  919. expressions sont concatΘnΘes. Voir la commande "help" de chaque
  920. variable du dΘbogueur pour afficher les valeurs correctes dans
  921. chaque cas.
  922.  
  923. Dans sa deuxiΦme syntaxe, la commande set peut Ωtre utilisΘe pour
  924. l'Θvaluation de toute expression de langage, bien que
  925. gΘnΘralement elle soit utilisΘe pour l'Θvaluation de l'expression
  926. d'un assignement. Si plusieurs processus sont spΘcifiΘs, la
  927. commande est ΘvaluΘe dans le contexte de chaque processus dans
  928. l'ordre.
  929.  
  930. L'option -v affiche les prototypes des fonctions, pour toutes les
  931. fonctions appelΘes par le dΘbogueur lors de l'Θvaluation de
  932. l'expression. Ceci est utile en C++ afin de voir comment les fonction
  933. surchargΘes sont rΘsolues.
  934.  
  935. EXEMPLES
  936. set %global_path = %global_path, ":src/new/mydir"
  937. set -p all %path = "mydir"
  938.  set %frame 2
  939. set %eax = 0x3421
  940. set x = 3
  941. set -v myfunc(a, b)
  942.  
  943. VOIR EGALEMENT
  944. %db_lang, %lang, C++, expr, liste_proc, scope, uservars
  945. ++
  946.  
  947.  
  948. ++ signal
  949. NOM
  950. signal - dΘfinit ou affiche les signaux pour un processus.
  951.  
  952. RESUME
  953. signal [-p liste_proc] [-iq] [signal ... [commande]]
  954.  
  955. DESCRIPTION
  956. Lorsqu'un signal est transmis α un processus, le dΘbogueur, par dΘfaut,
  957. va intercepter le signal et annoncer cette occurrence. Le signal peut
  958. Ωtre annulΘ α l'aide de la commande "cancel" ou le processus peut
  959. continuer et recevoir le signal. L'option -i accompagnΘe d'un ou
  960. plusieurs noms ou numΘros de signaux (voir "kill"), indique que le
  961. dΘbogueur va ignorer ces signaux (il ne va pas les intercepter pour la
  962. liste de processus donnΘs par liste_proc). Un nom de signal peut Ωtre ou
  963. non accompagnΘ du prΘfixe "SIG". Les majuscules ou les minuscules ont
  964. la mΩme valeur. Si le signal est spΘcifiΘ α nouveau sans l'option -i,
  965. l'action par dΘfaut de ce signal est rΘtablie.
  966.  
  967. Si une commande est donnΘe avec un groupe de signaux, le dΘbogueur
  968. Θtablit un ΘvΘnement pour ce groupe. L'ΘvΘnement peut Ωtre effacΘ,
  969. dΘsactivΘ ou activΘ, tout comme les ΘvΘnements "stop", "onstop" et
  970. "syscall". Des ΘvΘnements multiples peuvent Ωtre allouΘs au mΩme signal.
  971. Effacer tous lesΘvΘnements pour un signal donnΘ n'enlΦve pas l'action
  972. par dΘfaut du dΘbogueur pour ce signal. L'option -q indique que le
  973. signal ne sera pas annoncΘ.
  974.  
  975. Sans arguments, cette commande affiche la liste des signaux
  976. correspondant α la liste des processus fournie par liste_proc.
  977.  
  978. A la diffΘrence de ce qui se produit pour la plupart des commandes, si
  979. l'option -p n'est pas fournie α la commande stop, celle-ci va
  980. s'appliquer α tous les processus dΘrivΘs du programme actuel (%program).
  981.  
  982. EXEMPLES
  983. signal -i fpe emt
  984. signal SIGFPE
  985. signal 8 { if (x == 0) cancel 8; run }
  986.  
  987. VOIR EGALEMENT
  988. assoccmd, cancel, delete, disable, enable, kill, liste_proc, signames
  989. ++
  990.  
  991. ++ step
  992. NOM
  993. step - lance un processus pas α pas.
  994.  
  995. RESUME
  996. step [-p liste_proc] [-ibfoq] [-c nombre]
  997.  
  998. DESCRIPTION
  999. Les processus indiquΘs (%proc par dΘfaut) sont exΘcutΘs pas α pas un
  1000. certain nombre de fois, nombre dΘterminΘ par "nombre" (par dΘfaut
  1001. nombre=1). Si "nombre" est explicitement dΘfini par 0, cela indique
  1002. que l'exΘcution se rΘpΦte, jusqu'a une interruption ou un arrΩt
  1003. provoquΘ par un ΘvΘnement.
  1004.  
  1005. L'option -i indique que les instructions s'exΘcuteront pas α pas ; si
  1006. elle n'est pas spΘcifiΘe, ce seront les commentaires qui seront exΘcutΘs
  1007. pas α pas. L'option -o indique que les appels α des fonctions
  1008. s'exΘcutent comme Θtant une seule instruction ; si elle n'est pas
  1009. spΘcifiΘe, le contenu de l'appel α la fonction sera exΘcutΘ pas α pas.
  1010.  
  1011. L'option -f spΘcifie que le dΘbogueur attend l'arrΩt du processus
  1012. avant de rendre la main α l'utilisateur (c.α.d. que le processus
  1013. s'exΘcute en premier plan). L'option -b indique une exΘcution en
  1014. arriΦre-plan (pas d'attente). Le processus est lancΘ, mais le
  1015. contr⌠le passe immΘdiatement aux mains de l'utilisateur. Si
  1016. aucune de ces deux options -f ou -b n'est spΘcifiΘe, la valeur
  1017. par dΘfaut est indiquΘe par la variable %wait du dΘbogueur.
  1018.  
  1019. L'option -q indique que l'exΘcution pas α pas doit Ωtre
  1020. 'discrΦte' ; le dΘbogueur n'affiche pas l'id du processus en
  1021. cours d'exΘcution et n'imprime pas la ligne du code source qui va
  1022. Ωtre exΘcutΘ.
  1023.  
  1024. EXEMPLES
  1025. step -io
  1026. step -b
  1027. step -p all -c 10
  1028.  
  1029. VOIR EGALEMENT
  1030. %verbose, %wait, processus, liste_proc, run
  1031. ++
  1032.  
  1033.  
  1034. ++ halt
  1035. NOM
  1036. halt - arrΩte un processus s'exΘcutant en arriΦre-plan.
  1037.  
  1038. RESUME
  1039. halt [-p liste_proc]
  1040.  
  1041. DESCRIPTION
  1042. Le dΘbogueur oblige chacun des processus indiquΘs (%proc par
  1043. dΘfaut) α arrΩter immΘdiatemment son exΘcution. La requΩte peut
  1044. ne pas avoir un effet immΘdiat α cause des temps d'attente
  1045. systΦme et des fluctuations dans l'ordre des tΓches.
  1046.  
  1047. La commande "halt" ne s'applique pas aux processus qui
  1048. s'exΘcutent en premier plan, le dΘbogueur ne rendant pas la main
  1049. α l'utilisateur avant l'arrΩt de ces processus. Pour arrΩter un
  1050. processus ou un ensemble de processus s'exΘcutant en premier
  1051. plan, utilisez la touche d'interruption (gΘnΘralement
  1052. "suppression").
  1053.  
  1054. VOIR EGALEMENT
  1055. %wait, liste_proc, run, step
  1056. ++
  1057.  
  1058. ++ syscall
  1059. NOM
  1060. syscall - mets en place le suivi des appels systΦmes.
  1061.  
  1062. RESUME
  1063. syscall [-p liste_proc] [[-eqx] [-c nombre] call ... [commande]]
  1064.  
  1065. DESCRIPTION
  1066. Indique les actions α entreprendre lorsqu'un processus entre dans un
  1067. appel systΦme ou en sort. Si aucun argument n'est spΘcifiΘ, affiche la
  1068. liste des appels actuels pour les processus indiquΘs.
  1069.  
  1070. Lorsqu'un ou plusieurs noms ou numΘros d'appel systΦme sont
  1071. indiquΘs, le dΘbogueur suspend le processus de ces appels systΦme
  1072. en entrΘe (-e, dΘfaut) et/ou en sortie (-x). L'appel systΦme sera
  1073. annoncΘ et toutes les "commandes" qui lui sont associΘes seront
  1074. exΘcutΘes.
  1075.  
  1076. L'option -q spΘcifie que l'ΘvΘnement ne sera pas annoncΘ.
  1077. L'option -c spΘcifie que l'ΘvΘnement se dΘclenchera un certain
  1078. nombre de fois (donnΘ par "nombre") avant que le dΘbogueur
  1079. n'interrompe le processus. Le processus s'arrΩtera α toutes les
  1080. occurrences suivantes.
  1081.  
  1082. Utilisez "help sysnames" pour obtenir une liste des noms des
  1083. appels systΦmes corrects, les majuscules et les minuscules
  1084. n'Θtant pas prise en compte.
  1085.  
  1086. A la diffΘrence de ce qui se produit pour la plupart des
  1087. commandes, si l'option -p n'est pas fournie α la commande
  1088. syscall, celle-ci va s'appliquer α tous les processus dΘrivΘs du
  1089. programme actuel (%program).
  1090.  
  1091. EXEMPLES
  1092. syscall -c 10 write { if (fd == 5) run }
  1093. syscall -qx read
  1094.  
  1095. VOIR EGALEMENT
  1096. %program, assoccmd, delete, disable, enable, events, liste_proc
  1097. ++
  1098.  
  1099.  
  1100. ++ regs
  1101. NOM
  1102. regs - affiche le contenu des registres du processeur.
  1103.  
  1104. RESUME
  1105. regs [-p liste_proc]
  1106.  
  1107. DESCRIPTION
  1108. Affichage hexadΘcimal du contenu des registres du processeur pour
  1109. les processus spΘcifiΘs (par dΘfaut: %proc).
  1110.  
  1111. VOIR EGALEMENT
  1112. dis, dump, liste_proc
  1113. ++
  1114.  
  1115.  
  1116. ++ stack
  1117. NOM
  1118. stack - affiche le retour des appels de fonction.
  1119.  
  1120. RESUME
  1121. stack [-p liste_proc] [-f trame] [-c nombre] [-a adresse ] [ -s pile ]
  1122.  
  1123. DESCRIPTION
  1124. Affiche les fonctions actives pour les processus indiquΘs (%proc par
  1125. dΘfaut). Cet affichage comprend leurs noms, ainsi que les noms et les
  1126. valeurs des arguments et le numΘro de ligne ou d'adresse active dans
  1127. chaque fonction. Les noms des fonctions, les noms des arguments et les
  1128. numΘros de ligne peuvent ne pas Ωtre disponibles lorsque les
  1129. informations symboliques sont insuffisantes.
  1130.  
  1131. "nombre" spΘcifie le nombre de trames α afficher. Si aucun chiffre n'est
  1132. indiquΘ, l'affichage est effectuΘ pour toute la pile. L'option -f
  1133. spΘcifie le numΘro de trame par lequel doit commencer l'affichage. La
  1134. numΘrotation des trames commence par 0 pour le bas de la pile (trame
  1135. initiale).
  1136.  
  1137. Les options -a et -s vous permettent de spΘcifier une adresse de dΘpart
  1138. (compteur du programme) et/ou une valeur de dΘpart pour le pointeur de
  1139. la pile. Ceci est parfois utile lorsque l'on essaye d'obtenir un
  1140. traτage de la pile pour un processus qui a effectuΘ un saut α une
  1141. adresse non-admise ou un processus dont le pointeur de pile a ΘtΘ
  1142. altΘrΘ. Ces deux options ont besoin d'une adresse en base hexadΘcimale.
  1143.  
  1144. EXEMPLES
  1145. stack -p p2
  1146. stack -f 2 -c 3
  1147. stack -a 0x80494958 -s 0xbfff8004
  1148.  
  1149. VOIR EGALEMENT
  1150. liste_proc
  1151. ++
  1152.  
  1153. ++ while
  1154. NOM
  1155. while - boucle conditionnelle.
  1156.  
  1157. RESUME
  1158. while (expr) cmd
  1159.  
  1160. DESCRIPTION
  1161. L'Θvaluation de "expr" s'effectue en langage actuel (%lang ou %db_lang)
  1162. dans le contexte du processus actuel (%proc). Si "expr" est vrai, "cmd"
  1163. est exΘcutΘe. Cette sΘquence se rΘpete ensuite. "cmd" peut correspondre
  1164. α une commande simple ou α un bloc.
  1165.  
  1166. EXEMPLES
  1167. while ($foo < 10) { print $foo, a[$foo]; set $foo = $foo + 1 }
  1168.  
  1169. VOIR EGALEMENT
  1170. %db_lang, %lang, bloc, break, continue, expr, if, scope
  1171. ++
  1172.  
  1173.  
  1174. ++ cd
  1175. NOM
  1176. cd - change le rΘpertoire de travail actuel.
  1177.  
  1178. RESUME
  1179. cd [nom_chemin]
  1180.  
  1181. DESCRIPTION
  1182. cd change le rΘpertoire de travail actuel du dΘbogueur en celui qui
  1183. est spΘcifiΘ par "nomchemin". Si aucun rΘpertoire n'est donnΘ, cd utilise
  1184. le rΘpertoire spΘcifiΘ par la variable d'environnement HOME.
  1185.  
  1186. VOIR EGALEMENT
  1187. pwd
  1188. ++
  1189.  
  1190. ++ change
  1191. NOM
  1192. change - modifie un ΘvΘnement existant.
  1193.  
  1194. RESUME
  1195. change num_ΘvΘnement [-p liste_proc] [-evqx] [-c nombre]
  1196.         [expr_stop|call...|signal...] [{commandes}]
  1197.  
  1198. DESCRIPTION
  1199. num_ΘvΘnement doit Ωtre au dΘbut et correspond au numΘro d'un ΘvΘnement
  1200. existant et correct. Les autres options vous permettent de modifier les
  1201. divers attributs de cet ΘvΘnement: 
  1202. 1) la liste des processus auxquels il s'applique (-p), 
  1203. 2) la verbose (-q pour pas de verbose, -v pour verbose), 
  1204. 3) pour les appels systΦme, si l'ΘvΘnement doit se produire α
  1205.      l'entrΘe de l'appel, α sa sortie ou aux deux α la fois (-ex), 
  1206. 4) pour les ΘvΘnements stop et les appels systΦme le nombre d'occurences
  1207.      de l'ΘvΘnement avant qu'il soit annoncΘ (-c), 
  1208. 5) ainsi que l'expression, la liste d'appels systΦme ou la liste de
  1209.      signaux associΘs α un ΘvΘnement. Pour finir 
  1210. 6) les commandes associΘes, qui devront Ωtre entre accolades {}.
  1211.  
  1212. EXEMPLES
  1213. change 3 -q
  1214. change 5 -p p2 -c 10
  1215. change 7 { print "x == ", x }
  1216. change 9 -x write
  1217.  
  1218. VOIR EGALEMENT
  1219. assoccmd, delete, disable, enable, events, onstop,
  1220. liste_proc, signal, stop, syscall
  1221. ++
  1222.  
  1223. ++ export
  1224. NOM
  1225. export - ajoute un ensemble nom/valeur α l'environnement.
  1226.  
  1227. RESUME
  1228. export $nom_utilisateur
  1229.  
  1230. DESCRIPTION
  1231. La command "export" exporte une variable dΘfinie par
  1232. l'utilisateur et gΘrΘe par le dΘbogueur dans l'environnement. La
  1233. variable "nom_utilisateur" , ainsi que sa valeur actuelle, font alors
  1234. partie de l'environnement qui est reτu par le processus crΘΘ par
  1235. le dΘbogueur. Si la valeur de $nom_utilisateur change, elle doit Ωtre
  1236. exportΘe de nouveau, afin que la nouvelle valeur fasse partie de
  1237. l'environnement. Notez que "nom_utilisateur" est exportΘe sans le
  1238. prΘfixe "$".
  1239.  
  1240. VOIR EGALEMENT
  1241. uservars
  1242. ++
  1243.  
  1244. ++ fc
  1245. NOM
  1246. fc - recherche, modifie et exΘcute de nouveau des commandes.
  1247.  
  1248. RESUME
  1249. fc [-e ename] [-nlr] [premiΦre [derniΦre]]
  1250. fc -e - [old=new] [commande]
  1251.  
  1252. DESCRIPTION
  1253. "fc" permet d'utiliser des commandes d'Θdition et de rappel de
  1254. style ksh(1). Sous sa premiΦre syntaxe, un groupe de commandes de
  1255. "premiΦre" α "derniΦre" sont sΘlectionnΘes α partir des derniΦres
  1256. commandes HISTSIZE qui ont ΘtΘ entrΘes. Les arguments "premiΦre" et
  1257. "derniΦre" peuvent Ωtre spΘcifiΘs, soit en tant que chaεne de
  1258. caractΦres, soit en tant que numΘros. Une chaεne de caractΦres
  1259. est utilisΘe pour localiser les commandes les plus rΘcentes en
  1260. commenτant par la chaεne spΘcifiΘe. Un chiffre nΘgatif peut Ωtre
  1261. donnΘ en tant que dΘcalage α partir du numΘro de la commande
  1262. actuelle.
  1263.  
  1264. Si  l'option -l est spΘcifiΘe, les commandes sont affichΘes sur la
  1265. sortie standard. Autrement, l'Θditeur "ename" est lancΘ sur un fichier
  1266. temporaire contenant les commandes. Si "ename" n'est pas fourni, la
  1267. valeur de la variable d'environnement FCEDIT (par dΘfaut: /usr/bin/ed)
  1268. est utilisΘe comme Θditeur. Lorsque l'Θdition est terminΘe, les
  1269. commandes ΘditΘes sont exΘcutΘes.
  1270.  
  1271. Si "premiΦre" n'est pas spΘcifiΘe, la valeur par dΘfaut est la commande
  1272. prΘcΘdente pour l'Θdition et -16 pour l'affichage. L'option -r inverse
  1273. l'ordre des commandes ; l'option -n supprime le numΘro des commandes
  1274. lors de l'affichage.
  1275.  
  1276. Dans sa deuxiΦme syntaxe, la "commande" est exΘcutΘe de
  1277. nouveau aprΦs que la substitution "old=new" (ancienne=nouvelle)
  1278. ait eu lieu. Si la commande n'est pas spΘcifiΘe, la valeur par
  1279. dΘfaut est la commande prΘcΘdente.
  1280.  
  1281. VOIR EGALEMENT
  1282. %mode
  1283. ++
  1284.  
  1285. ++ logoff
  1286. NOM
  1287. logoff - arrΩte la consignation des sessions.
  1288.  
  1289. RESUME
  1290. logoff
  1291.  
  1292. DESCRIPTION
  1293. Arrete la consignation des sessions.
  1294.  
  1295. VOIR EGALEMENT
  1296. logon
  1297. ++
  1298.  
  1299.  
  1300. ++ logon
  1301. NOM
  1302. logon - lance la consignation des sessions.
  1303.  
  1304. RESUME
  1305. logon [fichier_consignation]
  1306.  
  1307. DESCRIPTION
  1308. Lance la consignation des sessions. Toutes les sorties du
  1309. dΘbogueur sont envoyΘes dans un "fichier_consignation". Chaque
  1310. ligne de sortie est prΘcΘdΘe d'un signe "#" (commentaire). Les
  1311. commandes du dΘbogueur sont Θgalement envoyΘes dans le
  1312. fichier_consignation, mais sans Ωtre prΘcΘdΘes du signe "#". Si
  1313. le nom d'un fichier de consignation n'est pas spΘcifiΘ, le
  1314. dernier fichier de consignation utilisΘ par la session de
  1315. dΘbogage actuelle est celui qui sera utilisΘ. Les nouvelles
  1316. commandes et les nouvelles sorties sont ajoutΘes α ce fichier.
  1317. Les fichiers de consignation peuvent Ωtre utilisΘs comme script
  1318. de commande pour le dΘbogueur.
  1319.  
  1320. VOIR EGALEMENT
  1321. logoff, script
  1322. ++
  1323.  
  1324.  
  1325. ++ onstop
  1326. NOM
  1327. onstop - l'action se poursuit lorsque le processus s'arrΩte.
  1328.  
  1329. RESUME
  1330. onstop [-p liste_proc] [commande]
  1331.  
  1332. DESCRIPTION
  1333. Si aucun argument n'est spΘcifiΘ pour "commande", liste les actions
  1334. onstop en cours pour la liste des processus indiquΘs par "liste_proc".
  1335.  
  1336. "commande" peut correspondre α une commande simple ou α un bloc. Si une
  1337. commande ou un bloc est indiquΘ, ces commandes seront exΘcutΘes α
  1338. chaque arrΩt d'un processus (dans le contexte de ce processus). L'arrΩt
  1339. comprend l'exΘcution pas α pas et l'arrΩt d'un autre ΘvΘnement dΘbogueur
  1340. (signal, syscall,stop).
  1341.  
  1342. A la diffΘrence de ce qui se produit pour la plupart des commandes, si
  1343. l'option -p n'est pas fournie α la commande onstop, celle-ci va
  1344. s'appliquer α tous les processus dΘrivΘs du programme actuel (%program).
  1345.  
  1346. EXEMPLES
  1347. onstop -p p2
  1348. onstop { print i, x[i] }
  1349.  
  1350. VOIR EGALEMENT
  1351. %program, delete, disable, enable, events, signal, stop, syscall
  1352. ++
  1353.  
  1354. ++ rename
  1355. NOM
  1356. rename - change le nom sous lequel un programme est connu.
  1357.  
  1358. RESUME
  1359. rename nom_prog nom
  1360.  
  1361. DESCRIPTION
  1362. Lorsqu'un processus est saisi ou crΘΘ, le nom de
  1363. l'exΘcutable dont dΘrive ce processus peut Ωtre utilisΘ pour
  1364. servir de rΘfΘrence α tous les processus qui dΘrivent de cet
  1365. exΘcutable et servir dans toute liste de processus (liste_proc).
  1366. rename spΘcifie le nouveau nom de ce programme.
  1367.  
  1368. VOIR EGALEMENT
  1369. create, grab, liste_proc
  1370. ++
  1371.  
  1372. ++ %file
  1373. NOM
  1374. %file - le fichier source actuel.
  1375.  
  1376. DESCRIPTION
  1377. %file est dΘfini par le nom du fichier source associΘ α la
  1378. trame actuelle, le cas ΘchΘant, lorsqu'un processus s'arrΩte ou lorsque
  1379. %frame est modifiΘ. Chaque processus a son propre fichier %file. La
  1380. premiΦre commande "list" aprΦs la dΘfinition de %frame, affichera la
  1381. source α partir de %file si aucun nom de fichier n'est indiquΘ. Vous ne
  1382. pouvez pas modifier %file de faτon explicite.
  1383.  
  1384. VOIR EGALEMENT
  1385. %frame, %line, %list_file, %list_line, list
  1386. ++
  1387.  
  1388. ++ %follow
  1389. NOM
  1390. %follow - est-ce que le dΘbogueur doit suivre les processus enfants ?
  1391.  
  1392. DESCRIPTION
  1393. Le dΘbogueur contr⌠le pour l'utilisateur les processus qui ont
  1394. ΘtΘ crΘΘs par le dΘbogueur (avec la commande "create"), ou pris
  1395. en charge (avec la commande "grab") alors qu'il Θtait dΘja en
  1396. train de s'exΘcuter. Si %follow est suivi soit de "all" soit de
  1397. "procs", le dΘbogueur prend Θgalement le contr⌠le des processus
  1398. enfant de tout les processus sous contr⌠le qui utilisent la
  1399. duplication ("fork"). Si %follow est suivi de "none", aucun
  1400. processus enfant ne sera controlΘ. Le mode global de contr⌠le mis
  1401. en place par %follow peut Ωtre remplacΘ par des commandes
  1402. "create" ou "grab" individuelles. Tous les processus contr⌠lΘs 
  1403. peuvent Ωtre libΘrΘs avec la commande "release".
  1404.  
  1405. La valeur par dΘfaut de %follow est "all".
  1406.  
  1407. VOIR EGALEMENT
  1408. create, grab, release, set
  1409. ++
  1410.  
  1411. ++ %frame
  1412. NOM
  1413. %frame - le numΘro de la trame actuelle dans la pile d'appel.
  1414.  
  1415. RESUME
  1416. Indique la portΘe par dΘfaut pour les listings source, les tables
  1417. de symboles, le dΘsassemblage et l'Θvaluation de l'expression.
  1418. %frame est dΘfini par le numΘro de la trame supΘrieure (en
  1419. comptant α partir de 0 pour "_start") lorsqu'un processus
  1420. s'arrΩte. Chaque processus a sa propre %frame. Vous pouvez
  1421. dΘfinir %frame de faτon explicite via la commande "set". La
  1422. dΘfinition de %frame va Θgalement redΘfinir les variables
  1423. associΘes %db_lang, %file, %func, %line et %loc pour maintenir
  1424. une perspective logique du contexte actuel.
  1425.  
  1426. VOIR EGALEMENT
  1427. %db_lang, %file, %func, %line, %loc
  1428. ++
  1429.  
  1430.  
  1431. ++ %func
  1432. NOM
  1433. %func - la fonction actuelle.
  1434.  
  1435. DESCRIPTION
  1436. %func est dΘfini par le nom de la fonction correspondant α la
  1437. trame actuelle (%frame) , dΦs qu'un processus s'arrΩte ou que
  1438. %frame est modifiΘ. Chaque processus a son propre %func. Vous
  1439. pouvez dΘfinir %func de faτon explicite via la commande "set",
  1440. mais uniquement pour une fonction ayant une trame active dans la
  1441. pile ; %frame (ainsi que les variables associΘes %db_lang, %file,
  1442. %func, %line et %loc) sera mis α jour afin de reflΘter le nouveau
  1443. contexte.
  1444.  
  1445. VOIR EGALEMENT
  1446. %frame
  1447. ++
  1448.  
  1449.  
  1450. ++ %lang
  1451. NOM
  1452. %lang - le langage actuel.
  1453.  
  1454. DESCRIPTION
  1455. Indique le langage actuel. S'il est dΘfini, il se substitue α la valeur
  1456. donnΘe par %db_lang. Les chaεnes possibles sont les suivantes:
  1457.         C       ANSI C
  1458.         C++     C++ version 2
  1459. Si %lang n'a pas ΘtΘ dΘfini ou dΘfini par la chaεne nulle (""), le
  1460. dΘbogueur utilise %db_lang comme langage actuel. Les commandes
  1461. utilisant %lang dans l'Θvaluation d'expressions comportent if, print,
  1462. set, stop, while.
  1463.  
  1464. VOIR EGALEMENT
  1465. %db_lang, expr
  1466. ++
  1467.  
  1468. ++ %loc
  1469. NOM
  1470. %loc - l'emplacement actuel.  
  1471.  
  1472. DESCRIPTION
  1473. Indique le point d'exΘcution actuel, %loc est dΘfini par le contenu du
  1474. "program counter" (compteur du programme) pour la trame actuelle
  1475. lorsqu'un processus s'arrΩte ou lorsque %frame est modifiΘ. Chaque
  1476. processus a son propre %loc. Vous ne pouvez pas modifier %loc de faτon
  1477. explicite. La premiΦre commande "dis" aprΦs la dΘfinition des %frame va
  1478. dΘsassembler les instructions commenτant α %loc, si aucun emplacement
  1479. n'est donnΘ de faτon explicite.
  1480.  
  1481. VOIR EGALEMENT
  1482. %frame, dis
  1483. ++
  1484.  
  1485. ++ %list_file
  1486. NOM
  1487. %list_file - le nom du fichier qui a ΘtΘ listΘ en dernier.
  1488.  
  1489. DESCRIPTION
  1490. %list_file garde une trace du dernier fichier affichΘ par la
  1491. commande list. %list_file change α chaque fois que la commande
  1492. list est exΘcutΘe et revient sur le nom du fichier contenant
  1493. l'emplacement actuel (%loc) dans la trame actuelle (%frame) α
  1494. chaque fois qu'un chemin d'exΘcution (ou un processus ne
  1495. contenant qu'un seul chemin d'exΘcution) s'arrΩte ou que %frame
  1496. est modifiΘe. Chaque chemin d'exΘcution (ou chaque processus ne
  1497. contenant qu'un seul chemin d'exΘcution) possΦde sa propre
  1498. %list_file.
  1499.  
  1500. VOIR EGALEMENT
  1501. %file, %frame, %line, %list_line, list
  1502. ++
  1503.  
  1504. ++ %list_line
  1505. NOM
  1506. %list_line - affiche le numΘro de la derniΦre ligne affichΘe.
  1507.  
  1508. DESCRIPTION
  1509. %list_line garde la derniΦre ligne affichΘe par la commande
  1510. "list". %list_line change quand la commande "list" est exΘcutΘe
  1511. et est aussi rΘinitialisΘ au numΘro de ligne qui contient
  1512. l'emplacement actuel (%loc) de la trame actuelle (%frame) quand
  1513. un processus s'arrΩte ou une %frame est changΘe. Chaque processus
  1514. a son propre %list_line.
  1515.  
  1516. VOIR EGALEMENT
  1517. %file, %frame, %line, %list_file, list
  1518. ++
  1519.  
  1520. ++ %line
  1521. NOM
  1522. %line - le numΘro de la ligne actuelle.
  1523.  
  1524. DESCRIPTION
  1525. %line est dΘfini par le numΘro de ligne de l'emplacement actuel (%loc)
  1526. dans la trame actuelle (%frame) lorsqu'un processus s'arrΩte ou lorsque
  1527. %frame est modifiΘ. Chaque processus a son propre %line. La premiΦre
  1528. commande "list" aprΦs la dΘfinition de %frame va afficher la source
  1529. commenτant  α %line si aucun emplacement n'est spΘcifiΘ. Vous ne pouvez
  1530. pas dΘfinir %line de faτon explicite.
  1531.  
  1532. VOIR EGALEMENT
  1533. %frame, %file, %list_file, %list_line, list
  1534. ++
  1535.  
  1536. ++ %mode
  1537. NOM
  1538. %mode - le mode d'Θdition de la ligne actuelle.
  1539.  
  1540. DESCRIPTION
  1541. Debug gΦre les historiques de commandes (ainsi que l'Θdition des commandes)
  1542. du style ksh(1). %mode est le mode d'Θdition utilisΘ pour l'Θdition des
  1543. lignes de commande. %mode contient la valeur de la variable
  1544. d'environnement VISUAL ou, si cette derniΦre n'existe pas, la valeur de
  1545. la variable d'environnement EDITOR. Cette valeur peut Ωtre modifiΘe α
  1546. tout moment en utilisant la commande "set". Les valeurs correctes
  1547. sont "vi" et "emacs". Toute autre valeur de %mode interdira l'Θdition
  1548. des commandes.
  1549.  
  1550. VOIR EGALEMENT
  1551. fc
  1552. ++
  1553.  
  1554. ++ %path
  1555. NOM
  1556. %path - le chemin de recherche local pour les fichiers sources.
  1557.  
  1558. DESCRIPTION
  1559. Chaque programme possΦde son propre %path. La valeur de %path est
  1560. une liste de noms de rΘpertoires, sΘparΘs par deux points.
  1561. Lorsque le dΘbogueur tente d'afficher les lignes de code source α
  1562. partir d'un fichier, il va chercher dans les rΘpertoires indiquΘs
  1563. dans %path un fichier avec le nom correct. Apres avoir recherchΘ
  1564. la liste des chemins d'accΦs locaux pour le programme indiquΘ, le
  1565. dΘbogueur va chercher dans sa liste globale de chemin d'accΦs
  1566. (%global_path).
  1567.  
  1568. VOIR EGALEMENT
  1569. %global_path
  1570. ++
  1571.  
  1572. ++ %proc
  1573. NOM
  1574. %proc - le processus actuel.
  1575.  
  1576. DESCRIPTION
  1577. Cette variable contient le nom du processus actuel. Elle peut Ωtre
  1578. dΘfinie de faτon explicite α l'aide de la commande "set" ou de faτon
  1579. implicite α l'aide de "create", "grab" ou "release". La dΘfinition de
  1580. %proc dΘfinit Θgalement de faτon implicite %program et %frame.
  1581.  
  1582. VOIR EGALEMENT
  1583. %frame, %program, liste_proc
  1584. ++
  1585.  
  1586. ++ %program
  1587. NOM
  1588. %program - le programme actuel.
  1589.  
  1590. DESCRIPTION
  1591. Cette variable comporte le nom du programme qui contient le processus
  1592. actuel (%proc). Vous pouvez modifier ce nom de faτon explicite en
  1593. utilisant la commande "set" ou de faτon implicite avec les commandes
  1594. "create", "grab" ou "release". Les programmes sont nommΘs d'aprΦs le
  1595. fichier exΘcutable dont ils dΘrivent et peuvent Ωtre renommΘs avec la
  1596. commande "rename". La dΘfinition de %program redΘfinit Θgalement de
  1597. faτon implicite %proc, %thread et %frame.
  1598.  
  1599. VOIR EGALEMENT
  1600. %proc, liste_proc
  1601. ++
  1602.  
  1603. ++ %prompt
  1604. NOM
  1605. %prompt - l'invite du dΘbogueur.
  1606.  
  1607. DESCRIPTION
  1608. Le dΘbogueur demande α l'utilisateur une entrΘe en affichant la valeur
  1609. de %prompt. La valeur par dΘfaut est "debug>". Vous pouvez changer la
  1610. valeur de %prompt avec la commande "set".
  1611. ++
  1612.  
  1613. ++ %thisevent
  1614. NOM
  1615. %thisevent - le numΘro de l'ΘvΘnement qui est gΘrΘ actuellement.
  1616.  
  1617. DESCRIPTION
  1618. Avec une commande associΘe, %thisevent Θvaluera le numΘro de l'ΘvΘnement
  1619. auquel les commandes sont associΘes. Vous ne pouvez pas modifier la
  1620. valeur de %thisevent de maniΦre explicite.
  1621.  
  1622. VOIR EGALEMENT
  1623. %lastevent, assoccmd
  1624. ++
  1625.  
  1626.  
  1627. ++ %lastevent
  1628. NOM
  1629. %lastevent - le numΘro de l'ΘvΘnement crΘΘ le plus rΘcent.
  1630.  
  1631. DESCRIPTION
  1632. Apres une commande qui alloue un numΘro d'ΘvΘnement (stop,
  1633. signal, syscall ou onstop), %lastevent Θvaluera jusqu'αu numΘro 
  1634. qui vient d'Ωtre allouΘ. Vous ne pouvez pas modifier la valeur
  1635. de %lastevent de maniΦre explicite.
  1636.  
  1637. VOIR EGALEMENT
  1638. %thisevent
  1639. ++
  1640.  
  1641.  
  1642. ++ assoccmd
  1643. NOM
  1644. assoccmd - une commande du dΘbogueur ou un bloc.
  1645.  
  1646. DESCRIPTION
  1647. Plusieurs commandes acceptent de maniΦre optionnelle une commande
  1648. ou des blocs de commandes associΘs. Ces commandes doivent
  1649. apparaitre en dernier dans la liste des arguments et comprendre
  1650. des commandes possΘdant leurs propres comandes associΘes - ce qui
  1651. revient α dire que les commandes associΘes peuvent Ωtre
  1652. imbriquΘes. Les commandes seront exΘcutΘesα chaque fois que les
  1653. ΘvΘnements en cause (stop, signal, etc.) se produiront. A
  1654.  l'intΘrieur d'une commande associΘe, %thisevent contient le
  1655. numΘro de l'ΘvΘnement traitΘ. Le chemin d'exΘcution ou le
  1656. processus qui rencontre l'ΘvΘnement devient temporairement le
  1657. processus actuel lorsque les commandes seront exΘcutΘes.
  1658.  
  1659. VOIR EGALEMENT
  1660. %thisevent, bloc, onstop, signal, stop, syscall
  1661. ++
  1662.  
  1663. ++ bloc
  1664. NOM
  1665. bloc - une liste de commandes.
  1666.  
  1667. DESCRIPTION
  1668. Une commande ou une liste de commandes sΘparΘes par des
  1669. points-virgules et entre accolades. Les blocs peuvent Ωtre
  1670. utilisΘs comme commandes associΘes (which see) ou peuvent
  1671. apparaεtre indΘpendamment d'autres commandes. Les blocs peuvent
  1672. Ωtre utilisΘs pour regrouper des commandes afin de rediriger leur
  1673. sortie avec une seule redirection (which see).
  1674.  
  1675. EXEMPLES
  1676. { if (i) print *ptr; else print *mptr } > myfile
  1677.  
  1678. VOIR EGALEMENT
  1679. assoccmd, redirection
  1680. ++
  1681.  
  1682. ++ format
  1683. NOM
  1684. format - le format de la sortie de la commande "print".
  1685.  
  1686. DESCRIPTION
  1687. Le format est une chaεne de caractΦres similaire α celle qui est aceptΘe
  1688. par la routine printf du langage C. Chaque format doit avoir
  1689. la syntaxe suivante:
  1690.         %[flags][width][.[precision]][conversion_character]
  1691.         format_character
  1692. Tous les champs doivent avoir la mΩme signification que dans la routine
  1693. printf. La largeur et la prΘcision sont limitΘs α 1024. Les paramΦtres
  1694. depositionnement de printf et les caractΦres au format 'n' ne sont
  1695. pasacceptΘs. Chaque type de format correspond α l'une des expressions
  1696. donnΘes dans la commande print, dans l'ordre dans lequel ils apparaissent
  1697. Les caractΦres qui ne font pas partie des dΘfinitions de format sont
  1698. imprimΘs tel quel. Les caractΦres de formatage ont les significations:
  1699.         c       caractΦre non signΘ
  1700.         d,i     entier dΘcimal signΘ
  1701.         e,E     virgule flottante du style [-]d.ddde+/-dd
  1702.         f       virgule flottante du style [-]ddd.dddd
  1703.         g,G     virgule flottante dans l'un des styles ci-dessus
  1704.         o       entier octal non signΘ
  1705.         p       void * (pointeur gΘnΘral ; adresse hexadΘcimale)
  1706.         s       chaεne de caractΦres
  1707.         u       entier dΘcimal non signΘ
  1708.         x,X     entier hexadΘcimal non signΘ
  1709.         z       dΘbogueur style par dΘfaut pour l'expression
  1710.         %       %
  1711.  
  1712. VOIR EGALEMENT
  1713. print
  1714. ++
  1715.  
  1716. ++ emplacement
  1717. NOM
  1718. emplacement - un adresse α l'intΘrieur d'un processus.
  1719.  
  1720. DESCRIPTION
  1721. La syntaxe d'un indicateur d'adresse est:
  1722.         adresse[+-constante]
  1723.         [nom_proc@][nom_fichier@]ligne
  1724.         [nom_proc@][nom_fichier@]fonction[+-constante]
  1725. Ici "adresse" correspond α l'adresse d'un programme octal ou hexadΘcimal
  1726. et "constante" est un entier dΘcimal.
  1727.  
  1728. EXEMPLES
  1729. 17              un numΘro de ligne du fichier actuel (%file)
  1730. foo.c@17        un numΘro de ligne dans un autre fichier
  1731. 0x80801234      une adresse
  1732. main            un nom ou une Θtiquette de fonction
  1733. main+3          trois octets aprΦs l'Θtiquette
  1734. p1@main         un nom de fonction dans un processus spΘcifiΘ
  1735. %loc            l'emplacement actuel
  1736. %line           le numΘro de ligne et de fichier actuels
  1737. %r0             un registre
  1738. %r0+80          un registre plus un dΘcalage
  1739. %pc-4           un registre moins un dΘcalage
  1740. $myvar          une variable dΘfinie par l'utilisateur
  1741.  
  1742. VOIR EGALEMENT
  1743. %file, %line, %loc, liste_proc, scope, uservars
  1744. ++
  1745.  
  1746. ++ liste_proc
  1747. NOM
  1748. liste_proc - une liste des noms de processus.
  1749.  
  1750. DESCRIPTION
  1751. Une liste de "procnames" (noms de processus), sΘparΘs par des virgules.
  1752. La plupart des commandes acceptent une "liste_proc" avec l'option -p.
  1753. Une liste de ce genre ne doit pas contenir de blancs.
  1754.  
  1755. Un nom de processus (procname) peut Ωtre dΘfini par:
  1756. 1) le mot clΘ "all", signalant tous les processus sous contr⌠le,
  1757. 2) un nom de programme gΘnΘrΘ par un utilisateur ou un dΘbogueur,
  1758.    indiquant tous les processus dΘrivΘs de ce programme,
  1759. 3) un id processus gΘnΘrΘ par le dΘbogueur sous la forme pn (c.α.d. p1,
  1760.    p2...),
  1761. 4) la variable %program du dΘbogueur, indiquant tous les processus
  1762.    dΘrivΘs du programme actuel,
  1763. 5) la variable %proc du dΘbogueur, indiquant le processus actuel,
  1764. 6) un entier dΘcimal correspondant α l'id du processus systΦme d'un
  1765.    processus sous contr⌠le,
  1766. 7) toute variable dΘfinie par un utilisateur (c.α.d. $foo) ayant la
  1767.    valeur d'un entier, interprΘtΘe comme id de processus systΦme,
  1768. 8) toute variable dΘfinie par un utilisateur avec la valeur de la chaεne
  1769.    pouvant s'interprΘter comme une ou plusieurs des formes dΘcrites
  1770.    ci-dessus.
  1771.  
  1772. VOIR EGALEMENT
  1773. liste_proc, %proc, %program, rename, uservars
  1774. ++
  1775.  
  1776. ++ redirection
  1777. NOM
  1778. redirection - changement de la destination de la sortie du dΘbogueur.
  1779.  
  1780. DESCRIPTION
  1781. Une commande ou un bloc de commandes, peut recevoir le suffixe ">",
  1782. suivi d'un nom de fichier ou un "|" et une invite du Shell UNIX(r).
  1783. Ceci entraεne une redirection de la sortie en direction du fichier ou
  1784. l'envoi de cette sortie sur une invite. Vous pouvez Θgalement utiliser
  1785. ">>", qui ajoute la sortie α la fin du fichier, au lieu d'en remplacer
  1786. le contenu, le cas ΘchΘant.
  1787.  
  1788. EXEMPLES
  1789. stack > save.stack
  1790. symbols -gtv | grep int | pg
  1791.  
  1792. VOIR EGALEMENT
  1793. bloc
  1794. ++
  1795.  
  1796. ++ modΦle
  1797. NOM
  1798. modΦle - une expression de recherche de style sh(1).
  1799.  
  1800. DESCRIPTION
  1801. Un ensemble de caractΦres utilisΘ pour filtrer la sortie des commandes
  1802. "symbols".
  1803.         *       Remplace tous les caractΦres, y compris la chaεne "null".
  1804.         ?       Remplace un seul caractere.
  1805.         [...]   Remplace les caractΦres compris entre les crochets, les
  1806.                 registres Θtant acceptΘs et ! en tant que premier
  1807.                 caractere indiquant la nΘgation
  1808.  
  1809. VOIR EGALEMENT
  1810. symbols
  1811. ++
  1812.  
  1813. ++ expr_rΘg
  1814. NOM
  1815. expr_rΘg - une expression de recherche de style ed(1).
  1816.  
  1817. DESCRIPTION
  1818. Une expression de recherche est utilisΘe pour rechercher un modΦle dans
  1819. un fichier source avec la commande "list".
  1820.         .       Est l'Θquivalent d'un caractere quelconque, α
  1821.                 l'exception d'une fin de ligne
  1822.         [...]   Est l'Θquivalent d'un (ou de plusieurs) des caractΦres
  1823.                 compris entre crochets, les  registres Θtant acceptΘs
  1824.                 et ^ indiquant une nΘgation
  1825.         *       Indique zΘro ou plusieurs occurences des expressions
  1826.                 prΘcΘdentes
  1827.         ^       Est l'Θquivalent du caractere "null" au dΘbut d'une
  1828.                 ligne
  1829.         $       Est l'Θquivalent du caractere "null" α la fin d'une
  1830.                 ligne
  1831.         \{m\}   Est l'Θquivalent de m occurences des expressions
  1832.                 prΘcΘdentes
  1833.         \{m,\}  Indique au moins m occurences des expressions de
  1834.                 recherche prΘcΘdentes
  1835.         \{m,n\} Est l'Θquivalent des occurences de m jusqu'α n (compris)
  1836.         \(...\) Est la mΩme Θquivalence que ...
  1837.         \nombre Est l'Θquivalent de la ΘniΦme expression entre
  1838.                 parenthΦses de la mΩme expression
  1839.         \<      Est l'Θquivalent de la chaεne "null" en dΘbut de mot
  1840.         \>      Est l'Θquivalent de la chaεne "null" α la fin d'un mot
  1841.  
  1842. VOIR EGALEMENT
  1843. list
  1844. ++
  1845.  
  1846. ++ uservars
  1847. NOM
  1848. uservars - variables dΘfinies par l'utilisateur et gΘrΘes par le
  1849. dΘbogueur.
  1850.  
  1851. DESCRIPTION
  1852. Les noms commenτant par dollar ($) sont rΘservΘs α l'utilisateur
  1853. du dΘbogueur. Au dΘmarrage, le dΘbogueur importe l'environnement
  1854.  du shell en tant qu'ensemble initial de variables dΘfinies par
  1855. l'utilisateur. Vous pouvez crΘer une nouvelle variable avec la
  1856. commande "set". Les variables dΘfinies par l'utilisateur sont de
  1857. type "chaεne de caractΦres" ; elles sont converties en valeurs
  1858. nuΘmriques chaque fois que cela est nΘcessaire avec strtol(3).
  1859.  
  1860. VOIR EGALEMENT
  1861. export, set
  1862. ++
  1863.  
  1864. ++ %db_lang
  1865. NOM
  1866. %db_lang - la variable interne du dΘbogueur correspondant
  1867. au langage actuel.
  1868.  
  1869. DESCRIPTION
  1870. %db_lang est le langage de l'objet actuel et est utilisΘ par le
  1871. dΘbogueur pour l'Θvaluation des expressions de langage. Il est dΘfini
  1872. par le dΘbogueur en fonction des informations contenues dans le fichier
  1873. objet lui-mΩme. Si le dΘbogueur ne peut pas dΘterminer le langage de
  1874. l'objet actuel, %db_lang prend par dΘfaut la valeur C. Si %lang est
  1875. dΘfini explicitement, il a prioritΘ sur le langage de l'objet actuel.
  1876. Les commandes faisant intervenir %db_lang dans l'Θvaluation
  1877. d'expressions  comportent if, print, set, stop, whatis et while.
  1878.  
  1879. VOIR EGALEMENT
  1880. %lang, C++, expr
  1881. ++
  1882.  
  1883. ++ %global_path
  1884. NOM
  1885. %global_path - le chemin de recherche global du dΘbogueur.
  1886.  
  1887. DESCRIPTION
  1888. La valeur de %global_path doit Ωtre une liste de noms de
  1889. rΘpertoires, sΘparΘs par deux points (":"). Lorsque le dΘbogueur
  1890. tente d'afficher le code source provenant d'un fichier, il va
  1891. chercher dans les rΘpertoires indiquΘs par le %path local les
  1892. fichiers portant le mΩme nom que le programme. Apres avoir
  1893. cherchΘ dans la liste locale, le dΘbogueur va chercher dans la
  1894. liste globale de recherche (%global_path). %global_path peut
  1895. Θgalement Ωtre modifiΘ α l'invite du dΘbogueur avec l'option -s.
  1896.  
  1897. VOIR EGALEMENT
  1898. %path
  1899. ++
  1900.  
  1901. ++ %num_bytes
  1902. NOM
  1903. %num_bytes - le nombre d'octets α afficher par dΘfaut.
  1904.  
  1905. DESCRIPTION
  1906. Si la commande "dump" n'est pas donnΘe avec l'option -c, elle n'affiche
  1907. que %num_bytes octets. La valeur initiale de %num_bytes est 256 et
  1908. elle peut Ωtre modifiΘe avec la commande "set".
  1909.  
  1910. VOIR EGALEMENT
  1911. dump
  1912. ++
  1913.  
  1914. ++ %num_lines
  1915. NOM
  1916. %num_lines -- nombre de lignes α afficher.
  1917.  
  1918. DESCRIPTION
  1919. Si la commande "dis" ou la commande "list" sont donnΘes sans
  1920. l'option -c, chaque commande affiche un nombre de lignes
  1921. Θquivalent α %num_lines. La valeur initiale de %num_lines est de
  1922. 10 et cette valeur peut Ωtre modifiΘe avec la commande "set".
  1923.  
  1924. VOIR EGALEMENT
  1925. dis, list
  1926. ++
  1927.  
  1928. ++ %result
  1929. NOM
  1930. %result - Θtat de l'exΘcution de commandes du dΘbogueur.
  1931.  
  1932. DESCRIPTION
  1933. Apres l'exΘcution de chaque commande du dΘbogueur, le rΘsultat de
  1934.  son exΘcution est conservΘ en %result. 0 indique une exΘcution
  1935. rΘussie. Une autre valeur que 0 indique un Θchec lors de
  1936. l'exΘcution. 
  1937. ++
  1938.  
  1939. ++ %verbose
  1940. NOM
  1941. %verbose - niveau de dΘtails des ΘvΘnements du dΘbogueur.
  1942.  
  1943. DESCRIPTION
  1944. Lorsqu'un processus sous contr⌠le du dΘbogueur s'arrΩte, un message
  1945. indiquant la raison de cet arrΩt s'affiche, ainsi que l'id du processus
  1946. et la ligne source suivante, le cas ΘchΘant, ou la ligne de texte
  1947. dΘsassemblΘ suivante. %verbose permet de contr⌠ler le contenu de ce
  1948. message. Les valeurs possibles sont:
  1949.         quiet   pas de message α l'arrΩt d'un processus,
  1950.         source  seule la source suivante ou la ligne de dΘsassemblage
  1951.                 s'affichent,
  1952.         events  si un ΘvΘnement a provoquΘ l'arrΩt, il est Θgalement
  1953.                 affichΘ (ceci ne vaut pas pour les ΘvΘnements stop
  1954.                 demandΘs, halts ou single steps),
  1955.         reason  la raison pour laquelle cet arrΩt s'est produit,
  1956.                 ainsi que les ΘvΘnements et les stops demandΘs,
  1957.         all     fournit tous les dΘtails disponibles (gΘnΘralement
  1958.                 Θquivalente α reason)
  1959.  
  1960. Le mode par dΘfaut est "reason". Le mode quiet peut Θgalement Ωtre
  1961. spΘcifiΘ comme option -q pour certaines commandes du dΘbogueur. Ces
  1962. options -q individuelles ont la prioritΘ sur le mode verbose.
  1963.  
  1964. VOIR EGALEMENT
  1965. change, signal, step, stop, syscall
  1966. ++
  1967.  
  1968. ++ %wait
  1969. NOM
  1970. %wait - exΘcution synchrone ou asychrone des commandes.
  1971.  
  1972. DESCRIPTION
  1973. Lorsque le dΘbogueur exΘcute un processus, il va normalement attendre
  1974. que le processus s'arrΩte pour rendre la main α l'utilisateur. Si %wait
  1975. est dΘfini par "background", 0 ou "no", le dΘbogueur passe en mode
  1976. asynchrone. En mode asynchrone, les commandes lanτant un processus
  1977. repassent immΘdiatement sous contr⌠le de l'utilisateur, sans attendre
  1978. l'arrΩt du processus. Le mode par dΘfaut est restaurΘ si %wait est
  1979. dΘfini par "foreground", 1 ou "yes". Les options -f et -b des commandes
  1980. run et step ont la prioritΘ sur %wait global.
  1981.  
  1982. VOIR EGALEMENT
  1983. run, step
  1984. ++
  1985.  
  1986. ++ expr_stop
  1987. NOM
  1988. expr_stop - traitement de l'espace adresse des expressions
  1989. d'ΘvΘnements
  1990.  
  1991. DESCRIPTION
  1992. Les expr_stop sont des expressions spΘciales qui sont acceptΘes
  1993. par la commande stop. Une expr_stop consiste en un ou plusieurs
  1994. ΘvΘnements, joints par les opΘrateurs spΘciaux && (and) ou ||
  1995. (or). Ces opΘrateurs sont associΘs α gauche (left-associative),
  1996. mais le dΘbogueur ne garantit pas l'ordre dans lequel leurs
  1997. opΘrandes seront ΘvaluΘs. Chaque ΘvΘnement peut Ωtre:
  1998.         emplacement ( expr ) *lvalue
  1999.  
  2000. Chaque type d'ΘvΘnement stop possΦde une action qui lui permettra d'Ωtre
  2001. pris en compte par le dΘbogueur. Lorsqu'une action de ce type a lieu,
  2002. l'expression stop toute entiere est ΘvaluΘe afin de dΘterminer si elle
  2003. est "vraie". Si cela est le cas, l'ΘvΘnement se dΘclenche de la maniere
  2004. normale (le dΘbogueur informe alors l'utilisateur de l'ΘvΘnement et
  2005. exΘcute les commandes associΘes).
  2006.  
  2007. un "emplacement" correspond α une adresse dans le texte du processus
  2008. o∙ le dΘbogueur peut dΘfinir un point d'interruption. Lorsque le
  2009. processus atteint ce point, le dΘbogueur prend note de cet ΘvΘnement.
  2010. Si α cet emplacement, les stop_events s'appliquent α une fonction,
  2011. l'expression est vraie aussi longtemps que la fonction est active. Si α
  2012. cet emplacement,  les stop_events s'appliquent α une adresse ou α un
  2013. numΘro de ligne prΘcis, l'expression est vraie uniquement lorsque le
  2014. processus atteint cette adresse ou cette ligne. Tapez "help emplacement"
  2015. pour obtenir la syntaxe complΦte de la commande emplacement. Lorsque le
  2016. langage actuel est C++, les emplacements des ΘvΘnements_d'arrΩt peuvent
  2017. faire intervenir des fonctionnalitΘs spΘcifiques α ce langage. Tapez
  2018. "help C++" pour plus de dΘtails.
  2019.  
  2020. "expr" peut Ωtre une expression correct dans le langage actuel (%lang ou
  2021. %db_lang). Le dΘbogueur remarque le stop_event lorsque l'un des
  2022. identificateurs compris dans l'expression voit sa valeur modifiΘe.
  2023. L'expression entiere est ensuite ΘvaluΘe dans le contexte du langage
  2024. actuel.
  2025.  
  2026. "lvalue" peut Ωtre une expression quelconque dans le langage actuel qui
  2027. serait correcte α gauche d'une dΘclaration d'assignement dans ce
  2028. langage. Le dΘbogueur remarque cet ΘvΘnement lorsque le contexte de
  2029. l'emplacement change. Le changement en lui-mΩme rend vrai cette sorte
  2030. de stop_event.
  2031.  
  2032. Des expr_stop plus puissantes peuvent Ωtre crΘΘes en combinant des
  2033. stop_events avec des opΘrateurs && (and). Par exemple, pour s'arrΩter α
  2034. l'intΘrieur d'une fonction a alors que la fonction b est Θgalement
  2035. active, tapez "stop a && b". Pour s'arrΩter lorsque la valeur d'une
  2036. expression x devient vraie α l'intΘrieur d'une fonction y, tapez "stop
  2037. y && (x)".
  2038.  
  2039. EXEMPLES
  2040. stop myfile.c@230
  2041. stop *bar
  2042. stop (x == 5)
  2043. stop foo && (a > 7)
  2044. stop (a == 4) || (b == 7)
  2045.  
  2046. VOIR EGALEMENT
  2047. %db_lang, %lang, C++, expr, emplacement, scope, stop
  2048. ++
  2049.  
  2050. ++ %redir
  2051. NOM
  2052. %redir - le processus d'E/S doit-il Ωtre redirigΘ ?
  2053.  
  2054. DESCRIPTION
  2055. %redir contr⌠le le comportement de la commande create. Par dΘfaut, la
  2056. commande create ne redirige pas les E/S d'un processus qu'elle vient
  2057. de crΘer, α oins que l'option -r ne soit indiquΘe. Si %redir possΦde
  2058.  la valeur 1 ou "yes", create redirigera les E/S du processus, α
  2059. moins que l'option -n ne soit indiquΘe. Le comportement par dΘfaut peut
  2060. Ωtre remis en place en remettant %redir sur 0 ou sur "no".
  2061.  
  2062. VOIR EGALEMENT
  2063. create, grab, input
  2064. ++
  2065.  
  2066.  
  2067. ++ expr
  2068. NOM
  2069. expr - expressions du dΘbogueur
  2070.  
  2071. DESCRIPTION
  2072. Les expressions du dΘbogueur suivent la syntaxe et la sΘmantique
  2073. du langage actuel (%lang ou %db_lang). Le dΘbogueur accepte les
  2074. expressions contenant des combinaisons de variables et de
  2075. fonctions du programme, de noms qualifiΘs, de variables internes
  2076. au dΘbogueur et des variables internes au dΘbogueur dΘfinies par
  2077. l'utilisateur. Un nom qualifiΘ indique un identificateur du
  2078. programme qui ne sera pas visible dans le contexte actuel. La
  2079. syntaxe de ces noms qualifiΘs est la suivante:
  2080.         [[thread_id]@][[fichier_source]@][[fonction]@][[num_ligne]
  2081.         @]identifier
  2082.      ou [[thread_id]@]num_trame@identifier 
  2083.      ou [[thread_id]@]nom_objet@[fichier_source@]identifier
  2084.  
  2085. Le nom qualifiΘ est ΘvaluΘ de gauche α droite et les ambigⁿitΘs peuvent
  2086. Ωtre levΘes par la dΘfinition de @. "num_trame" et "fonction" doivent
  2087. correspondre α des fonctions actives. "nom_objet" indique tout objet
  2088. (fichier exΘcutable ou bibliothΦque partagΘe) composant le processus.
  2089.  
  2090. Lorsque le langage employΘ est le C, la commande "debug" gΦre
  2091. l'Θvalustion de toutes les expressions correctes en C ANSI, α
  2092. l'exception de celles qui impliquent des extensions par macro, par
  2093. structure ou par ΘnumΘrations de dΘclarations de types.
  2094. Un exemple de dΘclaration de type, dans une expression est la suivante:
  2095.        ((struct { int i; char c; } *)p)->c = 'a';
  2096.  
  2097. Lorsque le langage actuel est C++, le dΘbogueur accepte un
  2098. sous-ensemble d'expressions C++. Pour plus de dΘtails, reportez-vous α
  2099. C++.
  2100.  
  2101. Lorsque l'expression commenτe par un tiret (-) ou contient des
  2102. caractΦres ayant une signification spΘciale pour le dΘbogueur, elle
  2103. doit Ωtre entre parenthΦses, entre accolades ou entre crochets. Les
  2104. caractΦres ayant une signification spΘciale sont les suivants: >, >>,
  2105. |, ||, &&, #, les virgules, les points-virgules et les caractΦres de
  2106. retour chariot.
  2107.  
  2108. VOIR EGALEMENT
  2109. %db_lang, %lang, C++, if, print, scope, set, stop, expr_stop,
  2110. uservars, while
  2111. ++
  2112.  
  2113. ++ scope
  2114. NOM
  2115. scope - visibilitΘ d'un identificateur de programme.
  2116.  
  2117. DESCRIPTION
  2118. Les commandes du dΘbogueur qui acceptent des emplacements
  2119. ou des expressions peuvent rΘfΘrencer les identificateurs dans les
  2120. programmes contr⌠lΘs, comme: les fonctions, les paramΩtres, les
  2121. variables, les labels, les types, les structures et les marques d'union,
  2122. les noms de membres et les ΘnumΘrations littΘrales. Les emplacements
  2123. peuvent Θgalement rΘfΘrencer des numΘros de ligne dans le code source.
  2124. La visibilitΘ d'un nom pour le dΘbogueur, α n'importe quel moment,
  2125. dΘpend de l'Θtat du programme α ce moment (contexte) et des informations
  2126. de dΘboguage fournies par le programme au dΘbogueur.
  2127.  
  2128. Les numΘros de lignes du code source, les noms des variables locales
  2129. d'une fonction particuliΦre, les noms des paramΩtres, les noms des types
  2130. les structures, les Θtiquettes d'union, les noms des membres et les
  2131. ΘnumΘrations littΘrales, ne sont disponibles que si le fichier dans
  2132. lequel ils sont rΘfΘrencΘs a ΘtΘ compilΘ en indiquant l'option -g au
  2133. compilateur. Les noms des fonctions et variables statiques ou globales
  2134. sont disponibles si le fichier qui les dΘfinit a ΘtΘ compilΘ avec
  2135. l'option -g ou si la table des symboles du programme n'a pas ΘtΘ
  2136. enlevΘe.
  2137.  
  2138. Les numΘros des lignes du code source, les fonctions et les variables
  2139. statiques ne sont visibles que lorsque le contexte actuel est prΘsent α
  2140. l'intΘrieur du fichier, c'est-α-dire si le programme a ΘtΘ arrΩtΘ α
  2141. l'intΘrieur du code gΘnΘrΘ a partir de ce fichier. Les paramΩtres de
  2142. fonction ne sont visibles que si le contexte actuel est contenu dans
  2143. cette fonction. Les variables locales ne sont visibles que lorsque le
  2144. contexte actuel est visible α l'intΘrieur du bloc qui les dΘfinit.
  2145.  
  2146. Les identificateurs qui ne sont pas visibles dans le contexte courant
  2147. peuvent souvent Ωtre accΘdΘs a des emplacements ou dans des expressions
  2148. en utilisant des noms qualifiΘs. Voir "expr" et "emplacement" pour une
  2149. syntaxe complΦte.
  2150.  
  2151. Les symboles dΘfinis dans les bibliothΘques partagΘes ne peuvent
  2152. Ωtre visualisΘs que si ces bibliothΦques sont chargΘes par
  2153. l'Θditeur de liens dynamiques. GΘnΘralement, au premier lancement
  2154. d'un programme, seuls les symboles dΘfinis dans le programme et
  2155. dans libc.so peuvent Ωtre visualisΘs. Une fois que le programme
  2156. passe l'Θtape _start ou mΩme au delα, d'autres bibliothΦques
  2157. partagΘes sont disponibles. Les symboles des bibliothΦques
  2158. partagΘes chargΘes par des appels α dlopen(3X) ne sont
  2159. disponibles qu'aprΦs un appel.
  2160.  
  2161. VOIR EGALEMENT
  2162. %frame, %func, %line, expr, emplacement
  2163. ++
  2164.  
  2165. ++ whatis
  2166. NOM
  2167. whatis - affiche le type d'une expression.
  2168.  
  2169. RESUME
  2170. whatis [-p liste_proc] expr
  2171.  
  2172. DESCRIPTION
  2173. whatis affiche le type d'expression du contexte actuel (%frame).
  2174. Lorsqu'une liste de processus (liste_proc) est indiquΘe, le type
  2175. d'expression est ΘvaluΘ dans le contexte de chaque processus de cette
  2176. liste. Expr peut correspondre α une expression du langage actuel.
  2177.  
  2178. Si une variable est une structure ou un type de classe, "whatis
  2179. variable" affichera le nom de la structure ou de la classe. "whatis
  2180. structure_tag_name" ou "whatis type_name" affichera toutes les
  2181. informations concernant ce type, y compris les membres de la structure
  2182. et les constantes d'ΘnumΘration.
  2183.  
  2184. Si on lui donne en entrΘe un pointeur en direction d'une classe
  2185. d'objets possΘdant des fonctions virtuelles et que le dΘbogueur peut
  2186. dΘterminer que le type d'objet sur lequel on pointe est dΘrivΘ d'une
  2187. classe de base, whatis affichera a la fois la classe de base et la
  2188. classe dΘrivΘe.
  2189.  
  2190. EXEMPLES
  2191. whatis i
  2192. whatis main
  2193. whatis (i + 1) * 2.0
  2194. whatis struct foobar
  2195.  
  2196. VOIR EGALEMENT
  2197. %db_lang, C++, expr
  2198. ++
  2199.  
  2200. ++ C++
  2201. NOM
  2202. C++ - SpΘcificitΘ du langage C++
  2203.  
  2204. DESCRIPTION
  2205. Le dΘbogueur va reconnaεtre un fichier objet compilΘ α l'aide de la
  2206. version 2.0 de C++ Compilation System ou du traducteur de C++ cfront
  2207. (version 2.1 ou 3.0) et va dΘfinir le langage actuel (%db_lang)
  2208. comme Θtant C++. Les noms s'affichent comme dans la source C++ et non
  2209. comme ils apparaissent dans le fichier objet.
  2210.  
  2211. Lorsque le langage actuel est C++, le dΘbogueur accepte un
  2212. sous-ensemble d'expressions faisant partie de C++, parmi
  2213. lesquelles on trouve les suivantes:
  2214.  
  2215.      o  Toutes les expressions acceptΘes lorsque C constitue le langage
  2216.         actuel,
  2217.      o  Appels adressΘs α des fonctions membre, dont font partie les
  2218.         fonctions membre virtuelles et les fonctions membre statiques,
  2219.      o  Appels adressΘs α des fonctions surchargΘes,
  2220.      o  Expressions utilisant des noms de types comme typedefs,
  2221.      o  Expressions utilisant des fonctions opΘrateur surchargΘes et
  2222.      o  Expressions accΘdant aux membres des classes grΓce au pointeur
  2223.         implicite "this", lorsque le processus ou le chemin d'exΘcution
  2224.         est arrΩtΘ dans une fonction associΘe aux membres des classes.
  2225.  
  2226. Les commandes print et set ont une option -v (verbose) qui permet
  2227. d'afficher des information dΘtaillΘes, comprenant les prototypes
  2228. de toutes les fonctions appelΘes par le dΘbogueur pour
  2229. l'Θvaluation d'une expression. Cette option est particuliΦrement
  2230. utile pour une bonne comprΘhension de ce qui peut se passer dans
  2231. les expressions qui utilisent des fonctions ou des opΘrateurs
  2232. surchargΘs. Cette option -v affiche Θgalement, pour la commande
  2233. print, une structure et des membres de classe gΘnΘrΘs par
  2234. compilateur, tels que des pointeurs de tables de fonctions
  2235. virtuelles.
  2236.  
  2237. Lorsqu'il existe un pointeur d'objet de classe de base avec des
  2238. fonctions virtuelles et que le dΘbogueur peut dΘterminer que le
  2239. type d'objet vers lequel est dirigΘ le pointeur est une classe
  2240. dΘrivΘe de la classe de base, la commande whatis va afficher la
  2241. classe de base et le classe qui en dΘrive. La commande print va
  2242. Θgalement afficher l'objet comme d'un type dΘrivΘ.
  2243.  
  2244. Lors de l'impression d'une structure ou d'une classe, la commande
  2245. print va afficher les membres de classe static, en signalant
  2246. qu'il s'agit de membres statiques. Notez bien que les symboles de
  2247. -v n'affichent pas ce type de membres. Notez Θgalement que les
  2248. membres de classe gΘnΘrΘs par compilateur ne s'affichent qu'avec
  2249. l'option -v de la commande print.
  2250.  
  2251. Les points d'interruption (ΘvΘnements stop) peuvent se dΘfinir avec:
  2252.  
  2253.      o  des fonctions membres de classe, comprenant les fonctions
  2254.         constructor, destructor et de conversion,
  2255.      o  des opΘrateurs surchargΘs et
  2256.      o  des fonctions surchargΘes qui utilisent le prototype complet ou
  2257.      o  des fonctions surchargΘes n'ayant pas d'information prototype.
  2258.         Dans ce cas, le dΘbogueur affiche une liste de fonctions et vous
  2259.         demande d'en sΘlectionner une ou la totalitΘ.
  2260.  
  2261. Un ΘvΘnement stop peut Θgalement Ωtre crΘΘ pour une combinaison
  2262. d'objet spΘcifique et de fonction membre en utilisant la syntaxe
  2263. "stop pointer->function" ou "stop object.function". Le dΘbogueur
  2264. n'arrΩte le processus, au moment ou la fonction est entrΘe, que
  2265. si "ce" pointeur correspond α l'objet spΘcifiΘ. S'il s'agit d'une
  2266. fonction virtuelle, le dΘbogueur dΘfinit le point d'interruption
  2267. sur la fonction de remplacement appropriΘe.
  2268.  
  2269. EXEMPLES
  2270. print *this
  2271. print -v ptr->overloaded_f(1, 2)
  2272. whatis ptr_to_base stop C::f(int)
  2273. stop C::C
  2274. stop C::~C
  2275. stop C::operator int()
  2276. stop C::operator+
  2277. stop ptr->f(char *)
  2278.  
  2279. VOIR EGALEMENT
  2280. %db_lang, expr, print, set, stop, whatis
  2281. ++
  2282.