36
+ �� 1 ;; -*-Emacs-Lisp-*-
+ �� 2 ;; hexl-mode -- Edit a file in a hex dump format.
+ �� 3 ;; Copyright (C) 1989 Free Software Foundation, Inc.
+ �� 4
+ �� 5 ;; This file is part of GNU Emacs.
+ �� 6
+ �� 7 ;; GNU Emacs is free software; you can redistribute it and/or modify
+ �� 8 ;; it under the terms of the GNU General Public License as published by
+ �� 9 ;; the Free Software Foundation; either version 1, or (at your option)
+ �� 10 ;; any later version.
+ �� 11
+ �� 12 ;; GNU Emacs is distributed in the hope that it will be useful,
+ �� 13 ;; but WITHOUT ANY WARRANTY; without even the implied warranty of
+ �� 14 ;; MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+ �� 15 ;; GNU General Public License for more details.
+ �� 16
+ �� 17 ;; You should have received a copy of the GNU General Public License
+ �� 18 ;; along with GNU Emacs; see the file COPYING. If not, write to
+ �� 19 ;; the Free Software Foundation, 675 Mass Ave, Cambridge, MA 02139, USA.
+ �� 20
+ �� 21 ;;
+ �� 22 ;; By: Keith Gabryelski (ag@wheaties.ai.mit.edu)
+ �� 23 ;;
+ �� 24 ;; This may be useful in your .emacs:
+ �� 25 ;;
+ �� 26 ;; (autoload 'hexl-find-file "hexl"
+ �� 27 ;; "Edit file FILENAME in hexl-mode." t)
+ �� 28 ;;
+ �� 29 ;; (define-key global-map "\C-c\C-h" 'hexl-find-file)
+ �� 30 ;;
+ �� 31 ;; NOTE: Remember to change HEXL-PROGRAM or HEXL-OPTIONS if needed.
+ �� 32 ;;
+ �� 33 ;; Currently hexl only supports big endian hex output with 16 bit
+ �� 34 ;; grouping.
+ �� 35 ;;
+ �� 36 ;; -iso in `hexl-options' will allow iso characters to display in the
+ �� 37 ;; ASCII region of the screen (if your emacs supports this) instead of
+ �� 38 ;; changing them to dots.
+ �� 39
+ �� 40 ;;
+ �� 41 ;; vars here
+ �� 42 ;;
+ �� 43
+ �� 44 (defvar hexl-program "hexl"
208
+ �� 45 "The program that will hexlify and de-hexlify its stdin.
+ �� 46 `hexl-program' will always be concated with `hexl-options'
+ �� 47 and \"-de\" when dehexlfying a buffer.")
36
+ �� 48
+ �� 49 (defvar hexl-iso ""
+ �� 50 "If your emacs can handle ISO characters, this should be set to
+ �� 51 \"-iso\" otherwise it should be \"\".")
+ �� 52
+ �� 53 (defvar hexl-options (format "-hex %s" hexl-iso)
+ �� 54 "Options to hexl-program that suit your needs.")
+ �� 55
+ �� 56 (defvar hexlify-command (format "%s %s" hexl-program hexl-options)
+ �� 57 "The command to use to hexlify a buffer. It is the concatination of
+ �� 58 `hexl-program' and `hexl-options'.")
+ �� 59
+ �� 60 (defvar dehexlify-command (format "%s -de %s" hexl-program hexl-options)
+ �� 61 "The command to use to unhexlify a buffer. It is the concatination of
+ �� 62 `hexl-program', the option \"-de\", and `hexl-options'.")
+ �� 63
+ �� 64 (defvar hexl-max-address 0
+ �� 65 "Maximum offset into hexl buffer.")
+ �� 66
+ �� 67 (defvar hexl-mode-map nil)
+ �� 68
+ �� 69 ;; routines
+ �� 70
+ �� 71 (defun hexl-mode (&optional arg)
+ �� 72 "\\<hexl-mode-map>
+ �� 73 A major mode for editting binary files in hex dump format.
+ �� 74
+ �� 75 This function automatically converts a buffer into the hexl format
+ �� 76 using the function `hexlify-buffer'.
+ �� 77
208
+ �� 78 Each line in the buffer has an \"address\" (displayed in hexadecimal)
36
+ �� 79 representing the offset into the file that the characters on this line
+ �� 80 are at and 16 characters from the file (displayed as hexadecimal
+ �� 81 values grouped every 16 bits) and as their ASCII values.
+ �� 82
+ �� 83 If any of the characters (displayed as ASCII characters) are
+ �� 84 unprintable (control or meta characters) they will be replaced as
+ �� 85 periods.
+ �� 86
208
+ �� 87 If `hexl-mode' is invoked with an argument the buffer is assumed to be
+ �� 88 in hexl format.
36
+ �� 89
+ �� 90 A sample format:
+ �� 91
+ �� 92 HEX ADDR: 0001 0203 0405 0607 0809 0a0b 0c0d 0e0f ASCII-TEXT
+ �� 93 -------- ---- ---- ---- ---- ---- ---- ---- ---- ----------------
+ �� 94 00000000: 5468 6973 2069 7320 6865 786c 2d6d 6f64 This is hexl-mod
+ �� 95 00000010: 652e 2020 4561 6368 206c 696e 6520 7265 e. Each line re
+ �� 96 00000020: 7072 6573 656e 7473 2031 3620 6279 7465 presents 16 byte
+ �� 97 00000030: 7320 6173 2068 6578 6164 6563 696d 616c s as hexadecimal
+ �� 98 00000040: 2041 5343 4949 0a61 6e64 2070 7269 6e74 ASCII.and print
+ �� 99 00000050: 6162 6c65 2041 5343 4949 2063 6861 7261 able ASCII chara
+ �� 100 00000060: 6374 6572 732e 2020 416e 7920 636f 6e74 cters. Any cont
+ �� 101 00000070: 726f 6c20 6f72 206e 6f6e 2d41 5343 4949 rol or non-ASCII
+ �� 102 00000080: 2063 6861 7261 6374 6572 730a 6172 6520 characters.are
+ �� 103 00000090: 6469 7370 6c61 7965 6420 6173 2070 6572 displayed as per
+ �� 104 000000a0: 696f 6473 2069 6e20 7468 6520 7072 696e iods in the prin
+ �� 105 000000b0: 7461 626c 6520 6368 6172 6163 7465 7220 table character
+ �� 106 000000c0: 7265 6769 6f6e 2e0a region..
+ �� 107
+ �� 108 Movement is as simple as movement in a normal emacs text buffer. Most
+ �� 109 cursor movement bindings are the same (ie. Use \\[hexl-backward-char], \\[hexl-forward-char], \\[hexl-next-line], and \\[hexl-previous-line]
+ �� 110 to move the cursor left, right, down, and up).
+ �� 111
+ �� 112 Advanced cursor movement commands (ala \\[hexl-beginning-of-line], \\[hexl-end-of-line], \\[hexl-beginning-of-buffer], and \\[hexl-end-of-buffer]) are
+ �� 113 also supported.
+ �� 114
+ �� 115 There are several ways to change text in hexl mode:
+ �� 116
+ �� 117 ASCII characters (character between space (0x20) and tilde (0x7E)) are
+ �� 118 bound to self-insert so you can simply type the character and it will
+ �� 119 insert itself (actually overstrike) into the buffer.
+ �� 120
+ �� 121 \\[hexl-quoted-insert] followed by another keystroke allows you to insert the key even if
+ �� 122 it isn't bound to self-insert. An octal number can be supplied in place
+ �� 123 of another key to insert the octal number's ASCII representation.
+ �� 124
+ �� 125 \\[hexl-insert-hex-char] will insert a given hexadecimal value (if it is between 0 and 0xFF)
+ �� 126 into the buffer at the current point.
+ �� 127
+ �� 128 \\[hexl-insert-octal-char] will insert a given octal value (if it is between 0 and 0377)
+ �� 129 into the buffer at the current point.
+ �� 130
+ �� 131 \\[hexl-insert-decimal-char] will insert a given decimal value (if it is between 0 and 255)
+ �� 132 into the buffer at the current point.
+ �� 133
+ �� 134 \\[hexl-save-buffer] will save the buffer in is binary format.
+ �� 135
+ �� 136 \\[hexl-mode-exit] will exit hexl-mode.
+ �� 137
+ �� 138 Note: \\[write-file] will write the file out in HEXL FORMAT.
+ �� 139
+ �� 140 You can use \\[hexl-find-file] to visit a file in hexl-mode.
+ �� 141
+ �� 142 \\[describe-bindings] for advanced commands."
+ �� 143 (interactive "p")
+ �� 144 (if (eq major-mode 'hexl-mode)
+ �� 145 (error "You are already in hexl mode.")
+ �� 146 (kill-all-local-variables)
+ �� 147 (make-local-variable 'hexl-mode-old-local-map)
+ �� 148 (setq hexl-mode-old-local-map (current-local-map))
+ �� 149 (use-local-map hexl-mode-map)
+ �� 150
+ �� 151 (make-local-variable 'hexl-mode-old-mode-name)
+ �� 152 (setq hexl-mode-old-mode-name mode-name)
+ �� 153 (setq mode-name "Hexl")
+ �� 154
+ �� 155 (make-local-variable 'hexl-mode-old-major-mode)
+ �� 156 (setq hexl-mode-old-major-mode major-mode)
+ �� 157 (setq major-mode 'hexl-mode)
+ �� 158
+ �� 159 (let ((modified (buffer-modified-p))
+ �� 160 (read-only buffer-read-only)
+ �� 161 (original-point (1- (point))))
+ �� 162 (if (not (or (eq arg 1) (not arg)))
+ �� 163 ;; if no argument then we guess at hexl-max-address
+ �� 164 (setq hexl-max-address (+ (* (/ (1- (buffer-size)) 68) 16) 15))
+ �� 165 (setq buffer-read-only nil)
+ �� 166 (setq hexl-max-address (1- (buffer-size)))
+ �� 167 (hexlify-buffer)
+ �� 168 (set-buffer-modified-p modified)
+ �� 169 (setq buffer-read-only read-only)
+ �� 170 (hexl-goto-address original-point)))))
+ �� 171
+ �� 172 (defun hexl-save-buffer ()
+ �� 173 "Save a hexl format buffer as binary in visited file if modified."
+ �� 174 (interactive)
+ �� 175 (set-buffer-modified-p (if (buffer-modified-p)
+ �� 176 (save-excursion
+ �� 177 (let ((buf (generate-new-buffer " hexl"))
+ �� 178 (name (buffer-name))
+ �� 179 (file-name (buffer-file-name))
+ �� 180 (start (point-min))
+ �� 181 (end (point-max))
+ �� 182 modified)
+ �� 183 (set-buffer buf)
+ �� 184 (insert-buffer-substring name start end)
+ �� 185 (set-buffer name)
+ �� 186 (dehexlify-buffer)
+ �� 187 (save-buffer)
+ �� 188 (setq modified (buffer-modified-p))
+ �� 189 (delete-region (point-min) (point-max))
+ �� 190 (insert-buffer-substring buf start end)
+ �� 191 (kill-buffer buf)
+ �� 192 modified))
+ �� 193 (message "(No changes need to be saved)")
+ �� 194 nil)))
+ �� 195
+ �� 196 (defun hexl-find-file (filename)
+ �� 197 "Edit file FILENAME in hexl-mode.
+ �� 198 Switch to a buffer visiting file FILENAME, creating one in none exists."
+ �� 199 (interactive "fFilename: ")
+ �� 200 (find-file filename)
+ �� 201 (if (not (eq major-mode 'hexl-mode))
+ �� 202 (hexl-mode)))
+ �� 203
+ �� 204 (defun hexl-mode-exit (&optional arg)
+ �� 205 "Exit hexl-mode returning to previous mode.
+ �� 206 With arg, don't unhexlify buffer."
+ �� 207 (interactive "p")
+ �� 208 (if (or (eq arg 1) (not arg))
+ �� 209 (let ((modified (buffer-modified-p))
+ �� 210 (read-only buffer-read-only)
+ �� 211 (original-point (1+ (hexl-current-address))))
+ �� 212 (setq buffer-read-only nil)
+ �� 213 (dehexlify-buffer)
+ �� 214 (set-buffer-modified-p modified)
+ �� 215 (setq buffer-read-only read-only)
+ �� 216 (goto-char original-point)))
+ �� 217 (setq mode-name hexl-mode-old-mode-name)
+ �� 218 (use-local-map hexl-mode-old-local-map)
+ �� 219 (setq major-mode hexl-mode-old-major-mode)
+ �� 220 ;; Kludge to update mode-line
+ �� 221 (switch-to-buffer (current-buffer))
+ �� 222 )
+ �� 223
+ �� 224 (defun hexl-current-address ()
+ �� 225 "Return current hexl-address."
+ �� 226 (interactive)
+ �� 227 (let ((current-column (- (% (point) 68) 11))
+ �� 228 (hexl-address 0))
+ �� 229 (setq hexl-address (+ (* (/ (point) 68) 16)
+ �� 230 (/ (- current-column (/ current-column 5)) 2)))
+ �� 231 hexl-address))
+ �� 232
+ �� 233 (defun hexl-address-to-marker (address)
+ �� 234 "Return marker for ADDRESS."
+ �� 235 (interactive "nAddress: ")
+ �� 236 (+ (* (/ address 16) 68) 11 (/ (* (% address 16) 5) 2)))
+ �� 237
+ �� 238 (defun hexl-goto-address (address)
+ �� 239 "Goto hexl-mode (decimal) address ADDRESS.
+ �� 240
+ �� 241 Signal error if ADDRESS out of range."
+ �� 242 (interactive "nAddress: ")
+ �� 243 (if (or (< address 0) (> address hexl-max-address))
+ �� 244 (error "Out of hexl region."))
+ �� 245 (goto-char (hexl-address-to-marker address)))
+ �� 246
+ �� 247 (defun hexl-goto-hex-address (hex-address)
209
+ �� 248 "Go to hexl-mode address (hex string) HEX-ADDRESS.
36
+ �� 249
+ �� 250 Signal error if HEX-ADDRESS is out of range."
+ �� 251 (interactive "sHex Address: ")
+ �� 252 (hexl-goto-address (hexl-hex-string-to-integer hex-address)))
+ �� 253
+ �� 254 (defun hexl-hex-string-to-integer (hex-string)
+ �� 255 "Return decimal integer for HEX-STRING."
+ �� 256 (interactive "sHex number: ")
+ �� 257 (let ((hex-num 0))
+ �� 258 (while (not (equal hex-string ""))
+ �� 259 (setq hex-num (+ (* hex-num 16)
+ �� 260 (hexl-hex-char-to-integer (string-to-char hex-string))))
+ �� 261 (setq hex-string (substring hex-string 1)))
+ �� 262 hex-num))
+ �� 263
+ �� 264 (defun hexl-octal-string-to-integer (octal-string)
+ �� 265 "Return decimal integer for OCTAL-STRING."
+ �� 266 (interactive "sOctal number: ")
+ �� 267 (let ((oct-num 0))
+ �� 268 (while (not (equal octal-string ""))
+ �� 269 (setq oct-num (+ (* oct-num 8)
+ �� 270 (hexl-oct-char-to-integer
+ �� 271 (string-to-char octal-string))))
+ �� 272 (setq octal-string (substring octal-string 1)))
+ �� 273 oct-num))
+ �� 274
+ �� 275 ;; move point functions
+ �� 276
+ �� 277 (defun hexl-backward-char (arg)
+ �� 278 "Move to left ARG bytes (right if ARG negative) in hexl-mode."
+ �� 279 (interactive "p")
+ �� 280 (hexl-goto-address (- (hexl-current-address) arg)))
+ �� 281
+ �� 282 (defun hexl-forward-char (arg)
+ �� 283 "Move right ARG bytes (left if ARG negative) in hexl-mode."
+ �� 284 (interactive "p")
+ �� 285 (hexl-goto-address (+ (hexl-current-address) arg)))
+ �� 286
+ �� 287 (defun hexl-backward-short (arg)
+ �� 288 "Move to left ARG shorts (right if ARG negative) in hexl-mode."
+ �� 289 (interactive "p")
+ �� 290 (hexl-goto-address (let ((address (hexl-current-address)))
+ �� 291 (if (< arg 0)
+ �� 292 (progn
+ �� 293 (setq arg (- arg))
+ �� 294 (while (> arg 0)
+ �� 295 (if (not (equal address (logior address 3)))
+ �� 296 (if (> address hexl-max-address)
+ �� 297 (progn
+ �� 298 (message "End of buffer.")
+ �� 299 (setq address hexl-max-address))
+ �� 300 (setq address (logior address 3)))
+ �� 301 (if (> address hexl-max-address)
+ �� 302 (progn
+ �� 303 (message "End of buffer.")
+ �� 304 (setq address hexl-max-address))
+ �� 305 (setq address (+ address 4))))
+ �� 306 (setq arg (1- arg)))
+ �� 307 (if (> address hexl-max-address)
+ �� 308 (progn
+ �� 309 (message "End of buffer.")
+ �� 310 (setq address hexl-max-address))
+ �� 311 (setq address (logior address 3))))
+ �� 312 (while (> arg 0)
+ �� 313 (if (not (equal address (logand address -4)))
+ �� 314 (setq address (logand address -4))
+ �� 315 (if (not (equal address 0))
+ �� 316 (setq address (- address 4))
+ �� 317 (message "Beginning of buffer.")))
+ �� 318 (setq arg (1- arg))))
+ �� 319 address)))
+ �� 320
+ �� 321 (defun hexl-forward-short (arg)
+ �� 322 "Move right ARG shorts (left if ARG negative) in hexl-mode."
+ �� 323 (interactive "p")
+ �� 324 (hexl-backward-short (- arg)))
+ �� 325
+ �� 326 (defun hexl-backward-word (arg)
+ �� 327 "Move to left ARG words (right if ARG negative) in hexl-mode."
+ �� 328 (interactive "p")
+ �� 329 (hexl-goto-address (let ((address (hexl-current-address)))
+ �� 330 (if (< arg 0)
+ �� 331 (progn
+ �� 332 (setq arg (- arg))
+ �� 333 (while (> arg 0)
+ �� 334 (if (not (equal address (logior address 7)))
+ �� 335 (if (> address hexl-max-address)
+ �� 336 (progn
+ �� 337 (message "End of buffer.")
+ �� 338 (setq address hexl-max-address))
+ �� 339 (setq address (logior address 7)))
+ �� 340 (if (> address hexl-max-address)
+ �� 341 (progn
+ �� 342 (message "End of buffer.")
+ �� 343 (setq address hexl-max-address))
+ �� 344 (setq address (+ address 8))))
+ �� 345 (setq arg (1- arg)))
+ �� 346 (if (> address hexl-max-address)
+ �� 347 (progn
+ �� 348 (message "End of buffer.")
+ �� 349 (setq address hexl-max-address))
+ �� 350 (setq address (logior address 7))))
+ �� 351 (while (> arg 0)
+ �� 352 (if (not (equal address (logand address -8)))
+ �� 353 (setq address (logand address -8))
+ �� 354 (if (not (equal address 0))
+ �� 355 (setq address (- address 8))
+ �� 356 (message "Beginning of buffer.")))
+ �� 357 (setq arg (1- arg))))
+ �� 358 address)))
+ �� 359
+ �� 360 (defun hexl-forward-word (arg)
+ �� 361 "Move right ARG words (left if ARG negative) in hexl-mode."
+ �� 362 (interactive "p")
+ �� 363 (hexl-backward-word (- arg)))
+ �� 364
+ �� 365 (defun hexl-previous-line (arg)
209
+ �� 366 "Move vertically up ARG lines [16 bytes] (down if ARG negative) in hexl-mode.
+ �� 367 If there is byte at the target address move to the last byte in that line."
36
+ �� 368 (interactive "p")
+ �� 369 (hexl-next-line (- arg)))
+ �� 370
+ �� 371 (defun hexl-next-line (arg)
209
+ �� 372 "Move vertically down ARG lines [16 bytes] (up if ARG negative) in hexl-mode.
+ �� 373 If there is no byte at the target address move to the last byte in that line."
36
+ �� 374 (interactive "p")
+ �� 375 (hexl-goto-address (let ((address (+ (hexl-current-address) (* arg 16)) t))
+ �� 376 (if (and (< arg 0) (< address 0))
+ �� 377 (progn (message "Out of hexl region.")
+ �� 378 (setq address
+ �� 379 (% (hexl-current-address) 16)))
+ �� 380 (if (and (> address hexl-max-address)
+ �� 381 (< (% hexl-max-address 16) (% address 16)))
+ �� 382 (setq address hexl-max-address)
+ �� 383 (if (> address hexl-max-address)
+ �� 384 (progn (message "Out of hexl region.")
+ �� 385 (setq
+ �� 386 address
+ �� 387 (+ (logand hexl-max-address -16)
+ �� 388 (% (hexl-current-address) 16)))))))
+ �� 389 address)))
+ �� 390
+ �� 391 (defun hexl-beginning-of-buffer (arg)
209
+ �� 392 "Move to the beginning of the hexl buffer.
+ �� 393 Leaves `hexl-mark' at previous position.
+ �� 394 With prefix arg N, puts point N bytes of the way from the true beginning."
36
+ �� 395 (interactive "p")
+ �� 396 (push-mark (point))
+ �� 397 (hexl-goto-address (+ 0 (1- arg))))
+ �� 398
+ �� 399 (defun hexl-end-of-buffer (arg)
209
+ �� 400 "Go to `hexl-max-address' minus ARG."
36
+ �� 401 (interactive "p")
+ �� 402 (push-mark (point))
+ �� 403 (hexl-goto-address (- hexl-max-address (1- arg))))
+ �� 404
+ �� 405 (defun hexl-beginning-of-line ()
+ �� 406 "Goto beginning of line in hexl mode."
+ �� 407 (interactive)
+ �� 408 (goto-char (+ (* (/ (point) 68) 68) 11)))
+ �� 409
+ �� 410 (defun hexl-end-of-line ()
+ �� 411 "Goto end of line in hexl mode."
+ �� 412 (interactive)
+ �� 413 (hexl-goto-address (let ((address (logior (hexl-current-address) 15)))
+ �� 414 (if (> address hexl-max-address)
+ �� 415 (setq address hexl-max-address))
+ �� 416 address)))
+ �� 417
+ �� 418 (defun hexl-scroll-down (arg)
+ �� 419 "Scroll hexl buffer window upward ARG lines; or near full window if no ARG."
+ �� 420 (interactive "P")
+ �� 421 (if (null arg)
+ �� 422 (setq arg (1- (window-height)))
+ �� 423 (setq arg (prefix-numeric-value arg)))
+ �� 424 (hexl-scroll-up (- arg)))
+ �� 425
+ �� 426 (defun hexl-scroll-up (arg)
+ �� 427 "Scroll hexl buffer window upward ARG lines; or near full window if no ARG."
+ �� 428 (interactive "P")
+ �� 429 (if (null arg)
+ �� 430 (setq arg (1- (window-height)))
+ �� 431 (setq arg (prefix-numeric-value arg)))
+ �� 432 (let ((movement (* arg 16))
+ �� 433 (address (hexl-current-address)))
+ �� 434 (if (or (> (+ address movement) hexl-max-address)
+ �� 435 (< (+ address movement) 0))
+ �� 436 (message "Out of hexl region.")
+ �� 437 (hexl-goto-address (+ address movement))
+ �� 438 (recenter 0))))
+ �� 439
+ �� 440 (defun hexl-beginning-of-1k-page ()
+ �� 441 "Goto to beginning of 1k boundry."
+ �� 442 (interactive)
+ �� 443 (hexl-goto-address (logand (hexl-current-address) -1024)))
+ �� 444
+ �� 445 (defun hexl-end-of-1k-page ()
+ �� 446 "Goto to end of 1k boundry."
+ �� 447 (interactive)
+ �� 448 (hexl-goto-address (let ((address (logior (hexl-current-address) 1023)))
+ �� 449 (if (> address hexl-max-address)
+ �� 450 (setq address hexl-max-address))
+ �� 451 address)))
+ �� 452
+ �� 453 (defun hexl-beginning-of-512b-page ()
+ �� 454 "Goto to beginning of 512 byte boundry."
+ �� 455 (interactive)
+ �� 456 (hexl-goto-address (logand (hexl-current-address) -512)))
+ �� 457
+ �� 458 (defun hexl-end-of-512b-page ()
+ �� 459 "Goto to end of 512 byte boundry."
+ �� 460 (interactive)
+ �� 461 (hexl-goto-address (let ((address (logior (hexl-current-address) 511)))
+ �� 462 (if (> address hexl-max-address)
+ �� 463 (setq address hexl-max-address))
+ �� 464 address)))
+ �� 465
+ �� 466 (defun hexl-quoted-insert (arg)
+ �� 467 "Read next input character and insert it.
+ �� 468 Useful for inserting control characters.
+ �� 469 You may also type up to 3 octal digits, to insert a character with that code"
+ �� 470 (interactive "p")
+ �� 471 (hexl-insert-char (read-quoted-char) arg))
+ �� 472
+ �� 473 ;00000000: 0011 2233 4455 6677 8899 aabb ccdd eeff 0123456789ABCDEF
+ �� 474
+ �� 475 (defun hexlify-buffer ()
+ �� 476 "Convert a binary buffer to hexl format"
+ �� 477 (interactive)
+ �� 478 (shell-command-on-region (point-min) (point-max) hexlify-command t))
+ �� 479
+ �� 480 (defun dehexlify-buffer ()
+ �� 481 "Convert a hexl format buffer to binary."
+ �� 482 (interactive)
+ �� 483 (shell-command-on-region (point-min) (point-max) dehexlify-command t))
+ �� 484
+ �� 485 (defun hexl-char-after-point ()
+ �� 486 "Return char for ASCII hex digits at point."
+ �� 487 (setq lh (char-after (point)))
+ �� 488 (setq rh (char-after (1+ (point))))
+ �� 489 (hexl-htoi lh rh))
+ �� 490
+ �� 491 (defun hexl-htoi (lh rh)
+ �� 492 "Hex (char) LH (char) RH to integer."
+ �� 493 (+ (* (hexl-hex-char-to-integer lh) 16)
+ �� 494 (hexl-hex-char-to-integer rh)))
+ �� 495
+ �� 496 (defun hexl-hex-char-to-integer (character)
+ �� 497 "Take a char and return its value as if it was a hex digit."
+ �� 498 (if (and (>= character ?0) (<= character ?9))
+ �� 499 (- character ?0)
+ �� 500 (let ((ch (logior character 32)))
+ �� 501 (if (and (>= ch ?a) (<= ch ?f))
+ �� 502 (- ch (- ?a 10))
+ �� 503 (error (format "Invalid hex digit `%c'." ch))))))
+ �� 504
+ �� 505 (defun hexl-oct-char-to-integer (character)
+ �� 506 "Take a char and return its value as if it was a octal digit."
+ �� 507 (if (and (>= character ?0) (<= character ?7))
+ �� 508 (- character ?0)
+ �� 509 (error (format "Invalid octal digit `%c'." character))))
+ �� 510
+ �� 511 (defun hexl-printable-character (ch)
+ �� 512 "Return a displayable string for character CH."
+ �� 513 (format "%c" (if hexl-iso
+ �� 514 (if (or (< ch 32) (and (>= ch 127) (< ch 160)))
+ �� 515 46
+ �� 516 ch)
+ �� 517 (if (or (< ch 32) (>= ch 127))
+ �� 518 46
+ �� 519 ch))))
+ �� 520
+ �� 521 (defun hexl-self-insert-command (arg)
+ �� 522 "Insert this character."
+ �� 523 (interactive "p")
+ �� 524 (hexl-insert-char last-command-char arg))
+ �� 525
+ �� 526 (defun hexl-insert-char (ch num)
+ �� 527 "Insert a character in a hexl buffer."
+ �� 528 (let ((address (hexl-current-address)))
+ �� 529 (while (> num 0)
+ �� 530 (delete-char 2)
+ �� 531 (insert (format "%02x" ch))
+ �� 532 (goto-char
+ �� 533 (+ (* (/ address 16) 68) 52 (% address 16)))
+ �� 534 (delete-char 1)
+ �� 535 (insert (hexl-printable-character ch))
+ �� 536 (if (eq address hexl-max-address)
+ �� 537 (hexl-goto-address address)
+ �� 538 (hexl-goto-address (1+ address)))
+ �� 539 (setq num (1- num)))))
+ �� 540
+ �� 541 ;; hex conversion
+ �� 542
+ �� 543 (defun hexl-insert-hex-char (arg)
+ �� 544 "Insert a ASCII char ARG times at point for a given hexadecimal number."
+ �� 545 (interactive "p")
+ �� 546 (let ((num (hexl-hex-string-to-integer (read-string "Hex number: "))))
+ �� 547 (if (or (> num 255) (< num 0))
+ �� 548 (error "Hex number out of range.")
+ �� 549 (hexl-insert-char num arg))))
+ �� 550
+ �� 551 (defun hexl-insert-decimal-char (arg)
+ �� 552 "Insert a ASCII char ARG times at point for a given decimal number."
+ �� 553 (interactive "p")
+ �� 554 (let ((num (string-to-int (read-string "Decimal Number: "))))
+ �� 555 (if (or (> num 255) (< num 0))
+ �� 556 (error "Decimal number out of range.")
+ �� 557 (hexl-insert-char num arg))))
+ �� 558
+ �� 559 (defun hexl-insert-octal-char (arg)
+ �� 560 "Insert a ASCII char ARG times at point for a given octal number."
+ �� 561 (interactive "p")
+ �� 562 (let ((num (hexl-octal-string-to-integer (read-string "Octal Number: "))))
+ �� 563 (if (or (> num 255) (< num 0))
+ �� 564 (error "Decimal number out of range.")
+ �� 565 (hexl-insert-char num arg))))
+ �� 566
+ �� 567 ;; startup stuff.
+ �� 568
+ �� 569 (if hexl-mode-map
+ �� 570 nil
+ �� 571 (setq hexl-mode-map (make-sparse-keymap))
+ �� 572
+ �� 573 (define-key hexl-mode-map "\C-a" 'hexl-beginning-of-line)
+ �� 574 (define-key hexl-mode-map "\C-b" 'hexl-backward-char)
+ �� 575 (define-key hexl-mode-map "\C-d" 'undefined)
+ �� 576 (define-key hexl-mode-map "\C-e" 'hexl-end-of-line)
+ �� 577 (define-key hexl-mode-map "\C-f" 'hexl-forward-char)
+ �� 578
+ �� 579 (if (not (eq (key-binding "\C-h") 'help-command))
+ �� 580 (define-key hexl-mode-map "\C-h" 'undefined))
+ �� 581
+ �� 582 (define-key hexl-mode-map "\C-i" 'hexl-self-insert-command)
+ �� 583 (define-key hexl-mode-map "\C-j" 'hexl-self-insert-command)
+ �� 584 (define-key hexl-mode-map "\C-k" 'undefined)
+ �� 585 (define-key hexl-mode-map "\C-m" 'hexl-self-insert-command)
+ �� 586 (define-key hexl-mode-map "\C-n" 'hexl-next-line)
+ �� 587 (define-key hexl-mode-map "\C-o" 'undefined)
+ �� 588 (define-key hexl-mode-map "\C-p" 'hexl-previous-line)
+ �� 589 (define-key hexl-mode-map "\C-q" 'hexl-quoted-insert)
+ �� 590 (define-key hexl-mode-map "\C-t" 'undefined)
+ �� 591 (define-key hexl-mode-map "\C-v" 'hexl-scroll-up)
+ �� 592 (define-key hexl-mode-map "\C-w" 'undefined)
+ �� 593 (define-key hexl-mode-map "\C-y" 'undefined)
+ �� 594
+ �� 595 (let ((ch 32))
+ �� 596 (while (< ch 127)
+ �� 597 (define-key hexl-mode-map (format "%c" ch) 'hexl-self-insert-command)
+ �� 598 (setq ch (1+ ch))))
+ �� 599
+ �� 600 (define-key hexl-mode-map "\e\C-a" 'hexl-beginning-of-512b-page)
+ �� 601 (define-key hexl-mode-map "\e\C-b" 'hexl-backward-short)
+ �� 602 (define-key hexl-mode-map "\e\C-c" 'undefined)
+ �� 603 (define-key hexl-mode-map "\e\C-d" 'hexl-insert-decimal-char)
+ �� 604 (define-key hexl-mode-map "\e\C-e" 'hexl-end-of-512b-page)
+ �� 605 (define-key hexl-mode-map "\e\C-f" 'hexl-forward-short)
+ �� 606 (define-key hexl-mode-map "\e\C-g" 'undefined)
+ �� 607 (define-key hexl-mode-map "\e\C-h" 'undefined)
+ �� 608 (define-key hexl-mode-map "\e\C-i" 'undefined)
+ �� 609 (define-key hexl-mode-map "\e\C-j" 'undefined)
+ �� 610 (define-key hexl-mode-map "\e\C-k" 'undefined)
+ �� 611 (define-key hexl-mode-map "\e\C-l" 'undefined)
+ �� 612 (define-key hexl-mode-map "\e\C-m" 'undefined)
+ �� 613 (define-key hexl-mode-map "\e\C-n" 'undefined)
+ �� 614 (define-key hexl-mode-map "\e\C-o" 'hexl-insert-octal-char)
+ �� 615 (define-key hexl-mode-map "\e\C-p" 'undefined)
+ �� 616 (define-key hexl-mode-map "\e\C-q" 'undefined)
+ �� 617 (define-key hexl-mode-map "\e\C-r" 'undefined)
+ �� 618 (define-key hexl-mode-map "\e\C-s" 'undefined)
+ �� 619 (define-key hexl-mode-map "\e\C-t" 'undefined)
+ �� 620 (define-key hexl-mode-map "\e\C-u" 'undefined)
+ �� 621
+ �� 622 (define-key hexl-mode-map "\e\C-w" 'undefined)
+ �� 623 (define-key hexl-mode-map "\e\C-x" 'hexl-insert-hex-char)
+ �� 624 (define-key hexl-mode-map "\e\C-y" 'undefined)
+ �� 625
+ �� 626 (define-key hexl-mode-map "\ea" 'hexl-beginning-of-1k-page)
+ �� 627 (define-key hexl-mode-map "\eb" 'hexl-backward-word)
+ �� 628 (define-key hexl-mode-map "\ec" 'undefined)
+ �� 629 (define-key hexl-mode-map "\ed" 'undefined)
+ �� 630 (define-key hexl-mode-map "\ee" 'hexl-end-of-1k-page)
+ �� 631 (define-key hexl-mode-map "\ef" 'hexl-forward-word)
+ �� 632 (define-key hexl-mode-map "\eg" 'hexl-goto-hex-address)
+ �� 633 (define-key hexl-mode-map "\eh" 'undefined)
+ �� 634 (define-key hexl-mode-map "\ei" 'undefined)
+ �� 635 (define-key hexl-mode-map "\ej" 'hexl-goto-address)
+ �� 636 (define-key hexl-mode-map "\ek" 'undefined)
+ �� 637 (define-key hexl-mode-map "\el" 'undefined)
+ �� 638 (define-key hexl-mode-map "\em" 'undefined)
+ �� 639 (define-key hexl-mode-map "\en" 'undefined)
+ �� 640 (define-key hexl-mode-map "\eo" 'undefined)
+ �� 641 (define-key hexl-mode-map "\ep" 'undefined)
+ �� 642 (define-key hexl-mode-map "\eq" 'undefined)
+ �� 643 (define-key hexl-mode-map "\er" 'undefined)
+ �� 644 (define-key hexl-mode-map "\es" 'undefined)
+ �� 645 (define-key hexl-mode-map "\et" 'undefined)
+ �� 646 (define-key hexl-mode-map "\eu" 'undefined)
+ �� 647 (define-key hexl-mode-map "\ev" 'hexl-scroll-down)
+ �� 648 (define-key hexl-mode-map "\ey" 'undefined)
+ �� 649 (define-key hexl-mode-map "\ez" 'undefined)
+ �� 650 (define-key hexl-mode-map "\e<" 'hexl-beginning-of-buffer)
+ �� 651 (define-key hexl-mode-map "\e>" 'hexl-end-of-buffer)
+ �� 652
+ �� 653 (define-key hexl-mode-map "\C-c\C-c" 'hexl-mode-exit)
+ �� 654
+ �� 655 (define-key hexl-mode-map "\C-x\C-p" 'undefined)
+ �� 656 (define-key hexl-mode-map "\C-x\C-s" 'hexl-save-buffer)
+ �� 657 (define-key hexl-mode-map "\C-x\C-t" 'undefined))
+ �� 658
+ �� 659 ;; The End.