Stefan Reinauer | 6540ae5 | 2007-07-12 16:35:42 +0000 | [diff] [blame] | 1 | /*****************************************************************************\ |
| 2 | * common.c |
Stefan Reinauer | 6540ae5 | 2007-07-12 16:35:42 +0000 | [diff] [blame] | 3 | ***************************************************************************** |
| 4 | * Copyright (C) 2002-2005 The Regents of the University of California. |
| 5 | * Produced at the Lawrence Livermore National Laboratory. |
| 6 | * Written by Dave Peterson <dsp@llnl.gov> <dave_peterson@pobox.com>. |
| 7 | * UCRL-CODE-2003-012 |
| 8 | * All rights reserved. |
| 9 | * |
Uwe Hermann | 6e56594 | 2008-03-01 19:06:32 +0000 | [diff] [blame] | 10 | * This file is part of nvramtool, a utility for reading/writing coreboot |
Stefan Reinauer | f527e70 | 2008-01-18 15:33:49 +0000 | [diff] [blame] | 11 | * parameters and displaying information from the coreboot table. |
Uwe Hermann | 6e56594 | 2008-03-01 19:06:32 +0000 | [diff] [blame] | 12 | * For details, see http://coreboot.org/nvramtool. |
Stefan Reinauer | 6540ae5 | 2007-07-12 16:35:42 +0000 | [diff] [blame] | 13 | * |
| 14 | * Please also read the file DISCLAIMER which is included in this software |
| 15 | * distribution. |
| 16 | * |
| 17 | * This program is free software; you can redistribute it and/or modify it |
| 18 | * under the terms of the GNU General Public License (as published by the |
| 19 | * Free Software Foundation) version 2, dated June 1991. |
| 20 | * |
| 21 | * This program is distributed in the hope that it will be useful, but |
| 22 | * WITHOUT ANY WARRANTY; without even the IMPLIED WARRANTY OF |
| 23 | * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the terms and |
| 24 | * conditions of the GNU General Public License for more details. |
| 25 | * |
| 26 | * You should have received a copy of the GNU General Public License along |
| 27 | * with this program; if not, write to the Free Software Foundation, Inc., |
Stefan Reinauer | ac7a2d2 | 2009-09-23 21:53:25 +0000 | [diff] [blame] | 28 | * 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA. |
Stefan Reinauer | 6540ae5 | 2007-07-12 16:35:42 +0000 | [diff] [blame] | 29 | \*****************************************************************************/ |
| 30 | |
| 31 | #include "common.h" |
| 32 | |
| 33 | /* basename of this program, as reported by argv[0] */ |
Uwe Hermann | 6e56594 | 2008-03-01 19:06:32 +0000 | [diff] [blame] | 34 | const char prog_name[] = "nvramtool"; |
Stefan Reinauer | 6540ae5 | 2007-07-12 16:35:42 +0000 | [diff] [blame] | 35 | |
| 36 | /* version of this program */ |
Stefan Reinauer | a67aab7 | 2008-09-27 10:08:28 +0000 | [diff] [blame] | 37 | const char prog_version[] = "2.1"; |
Stefan Reinauer | 6540ae5 | 2007-07-12 16:35:42 +0000 | [diff] [blame] | 38 | |
| 39 | /**************************************************************************** |
| 40 | * get_line_from_file |
| 41 | * |
| 42 | * Get a line of input from file 'f'. Store result in 'line' which is an |
| 43 | * array of 'line_buf_size' bytes. |
| 44 | ****************************************************************************/ |
Stefan Reinauer | 90b96b6 | 2010-01-13 21:00:23 +0000 | [diff] [blame] | 45 | int get_line_from_file(FILE * f, char line[], int line_buf_size) |
| 46 | { |
| 47 | if (fgets(line, line_buf_size, f) == NULL) |
| 48 | return LINE_EOF; |
Stefan Reinauer | 6540ae5 | 2007-07-12 16:35:42 +0000 | [diff] [blame] | 49 | |
Stefan Reinauer | 90b96b6 | 2010-01-13 21:00:23 +0000 | [diff] [blame] | 50 | /* If the file contains a line that is too long, then it's best |
Stefan Reinauer | 14e2277 | 2010-04-27 06:56:47 +0000 | [diff] [blame] | 51 | * to let the user know right away rather than passing back a |
Stefan Reinauer | 90b96b6 | 2010-01-13 21:00:23 +0000 | [diff] [blame] | 52 | * truncated result that will lead to problems later on. |
| 53 | */ |
| 54 | return (strlen(line) == ((size_t) (line_buf_size - 1))) ? |
| 55 | LINE_TOO_LONG : OK; |
| 56 | } |
Stefan Reinauer | 6540ae5 | 2007-07-12 16:35:42 +0000 | [diff] [blame] | 57 | |
| 58 | /**************************************************************************** |
| 59 | * out_of_memory |
| 60 | * |
| 61 | * We ran out of memory. Print an error message and die. |
| 62 | ****************************************************************************/ |
Stefan Reinauer | 90b96b6 | 2010-01-13 21:00:23 +0000 | [diff] [blame] | 63 | void out_of_memory(void) |
| 64 | { |
| 65 | fprintf(stderr, "%s: Out of memory.\n", prog_name); |
| 66 | exit(1); |
| 67 | } |
Stefan Reinauer | 6540ae5 | 2007-07-12 16:35:42 +0000 | [diff] [blame] | 68 | |
| 69 | /**************************************************************************** |
| 70 | * usage |
| 71 | * |
| 72 | * Write a usage message to 'outfile'. If 'outfile' is 'stderr' then exit |
| 73 | * with a value of 1. Otherwise exit with a value of 0. |
| 74 | ****************************************************************************/ |
Stefan Reinauer | 90b96b6 | 2010-01-13 21:00:23 +0000 | [diff] [blame] | 75 | void usage(FILE * outfile) |
| 76 | { |
| 77 | fprintf(outfile, |
| 78 | "Usage: %s [-y LAYOUT_FILE | -t] PARAMETER ...\n\n" |
| 79 | " Read/write coreboot parameters or show info from " |
| 80 | "coreboot table.\n\n" |
| 81 | " -y LAYOUT_FILE: Use CMOS layout specified by " |
| 82 | "LAYOUT_FILE.\n" |
| 83 | " -t: Use CMOS layout specified by CMOS option " |
| 84 | "table.\n" |
| 85 | " [-n] -r NAME: Show parameter NAME. If -n is given, " |
| 86 | "show value only.\n" |
| 87 | " -e NAME: Show all possible values for parameter " |
| 88 | "NAME.\n" |
| 89 | " -a: Show names and values for all " |
| 90 | "parameters.\n" |
| 91 | " -w NAME=VALUE: Set parameter NAME to VALUE.\n" |
| 92 | " -p INPUT_FILE: Set parameters according to INPUT_FILE.\n" |
| 93 | " -i: Same as -p but file contents taken from " |
| 94 | "standard input.\n" |
| 95 | " -c [VALUE]: Show CMOS checksum or set checksum to " |
| 96 | "VALUE.\n" |
| 97 | " -l [ARG]: Show coreboot table info for ARG, or " |
| 98 | "all ARG choices.\n" |
| 99 | " -d: Show low-level dump of coreboot table.\n" |
| 100 | " -Y: Show CMOS layout info.\n" |
| 101 | " -b OUTPUT_FILE: Dump CMOS memory contents to file.\n" |
| 102 | " -B INPUT_FILE: Write file contents to CMOS memory.\n" |
| 103 | " -x: Show hex dump of CMOS memory.\n" |
| 104 | " -X DUMPFILE: Show hex dump of CMOS dumpfile.\n" |
| 105 | " -v: Show version info for this program.\n" |
| 106 | " -h: Show this message.\n", prog_name); |
| 107 | exit(outfile == stderr); |
| 108 | } |