summaryrefslogtreecommitdiffstats
path: root/ataprint.h
blob: e7be66134937324c581f16567224e280af6f2ec8 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
/*
 * ataprint.h
 *
 * Home page of code is: https://www.smartmontools.org
 *
 * Copyright (C) 2002-09 Bruce Allen
 * Copyright (C) 2008-23 Christian Franke
 * Copyright (C) 1999-2000 Michael Cornwell <cornwell@acm.org>
 *
 * SPDX-License-Identifier: GPL-2.0-or-later
 */

#ifndef ATAPRINT_H_
#define ATAPRINT_H_

#define ATAPRINT_H_CVSID "$Id: ataprint.h 5483 2023-06-25 17:09:03Z chrfranke $\n"

#include <vector>

// Request to dump a GP or SMART log
struct ata_log_request
{
  bool gpl = false; // false: SMART, true: GP
  unsigned char logaddr = 0; // Log address
  unsigned page = 0; // First page (sector)
  unsigned nsectors = 0; // # Sectors
};

// Options for ataPrintMain
struct ata_print_options
{
  bool a_option = false; // true if '-a' is specified, used to suggest '-x'
  bool drive_info = false;
  int identify_word_level = -1, identify_bit_level = -1;
  bool smart_check_status = false;
  bool smart_general_values = false;
  bool smart_vendor_attrib = false;
  bool smart_error_log = false;
  bool smart_selftest_log = false;
  bool smart_selective_selftest_log = false;

  bool gp_logdir = false, smart_logdir = false;
  unsigned smart_ext_error_log = 0;
  unsigned smart_ext_selftest_log = 0;
  bool retry_error_log = false, retry_selftest_log = false;

  std::vector<ata_log_request> log_requests;

  bool devstat_all_pages = false, devstat_ssd_page = false;
  std::vector<int> devstat_pages;

  unsigned pending_defects_log = 0;

  bool sct_temp_sts = false, sct_temp_hist = false;
  int sct_erc_get = 0; // get(1), get_power_on(2)
  int sct_erc_set = 0; // set(1), set_power_on(2), mfg_default(3)
  unsigned sct_erc_readtime = 0, sct_erc_writetime = 0;
  bool sataphy = false, sataphy_reset = false;

  bool smart_disable = false, smart_enable = false;
  bool smart_auto_offl_disable = false, smart_auto_offl_enable = false;
  bool smart_auto_save_disable = false, smart_auto_save_enable = false;

  int smart_selftest_type = -1; // OFFLINE_FULL_SCAN, ..., see atacmds.h. -1 for no test
  bool smart_selftest_force = false; // Ignore already running test
  ata_selective_selftest_args smart_selective_args; // Extra args for selective self-test

  unsigned sct_temp_int = 0;
  bool sct_temp_int_pers = false;

  enum { FMT_BRIEF = 0x01, FMT_HEX_ID = 0x02, FMT_HEX_VAL = 0x04 };
  unsigned char output_format = 0; // FMT_* flags

  firmwarebug_defs firmwarebugs; // -F options
  bool fix_swapped_id = false; // Fix swapped ID strings returned by some buggy drivers

  ata_vendor_attr_defs attribute_defs; // -v options

  bool ignore_presets = false; // Ignore presets from drive database
  bool show_presets = false; // Show presets and exit
  unsigned char powermode = 0; // Skip check, if disk in idle or standby mode
  unsigned char powerexit = 0; // exit() code for low power mode
  int powerexit_unsup = -1; // exit() code for unsupported power mode or -1 to ignore

  bool get_set_used = false; // true if any get/set command is used
  bool get_aam = false; // print Automatic Acoustic Management status
  int set_aam = 0; // disable(-1), enable(1..255->0..254) Automatic Acoustic Management
  bool get_apm = false; // print Advanced Power Management status
  int set_apm = 0; // disable(-1), enable(2..255->1..254) Advanced Power Management
  bool get_lookahead = false; // print read look-ahead status
  int set_lookahead = 0; // disable(-1), enable(1) read look-ahead
  int set_standby = 0; // set(1..255->0..254) standby timer
  bool set_standby_now = false; // set drive to standby
  bool get_security = false; // print ATA security status
  bool set_security_freeze = false; // Freeze ATA security
  bool get_wcache = false; // print write cache status
  int set_wcache = 0; // disable(-1), enable(1) write cache
  bool sct_wcache_reorder_get = false; // print write cache reordering status
  int sct_wcache_reorder_set = 0; // disable(-1), enable(1) write cache reordering
  bool sct_wcache_reorder_set_pers = false;
  bool sct_wcache_sct_get = false; // print SCT Feature Control of write cache status
  int sct_wcache_sct_set = 0; // determined by ata set features command(1), force enable(2), force disable(3)
  bool sct_wcache_sct_set_pers = false; // persistent or volatile
  bool get_dsn = false; // print DSN status
  int set_dsn = 0; // disable(02h), enable(01h) DSN

  bool farm_log = false;          // Seagate Field Access Reliability Metrics log (FARM) for ATA
  bool farm_log_suggest = false;  // If -x/-xall or -a/-all is run, suggests FARM log if supported
};

int ataPrintMain(ata_device * device, const ata_print_options & options);

#endif