Bug 812724

Summary: [RFE] Write a separate section 4 man page documenting table formats for each existing DM target
Product: [Fedora] Fedora Reporter: Xiaowei Li <xiaoli>
Component: lvm2Assignee: Peter Rajnoha <prajnoha>
Status: CLOSED WONTFIX QA Contact: Fedora Extras Quality Assurance <extras-qa>
Severity: medium Docs Contact:
Priority: low    
Version: rawhideCC: agk, bmarzins, bmr, dwysocha, extras-orphan, heinzm, jbrassow, jonathan, lvm-team, msnitzer, prajnoha, zkabelac
Target Milestone: ---Keywords: FutureFeature
Target Release: ---   
Hardware: x86_64   
OS: Linux   
Fixed In Version: Doc Type: Enhancement
Doc Text:
Story Points: ---
Clone Of: Environment:
Last Closed: 2019-08-12 21:48:52 UTC Type: Bug
Regression: --- Mount Type: ---
Documentation: --- CRM:
Verified Versions: Category: ---
oVirt Team: --- RHEL 7.3 requirements from Atomic Host:
Cloudforms Team: --- Target Upstream Version:

Description Xiaowei Li 2012-04-16 05:46:59 UTC
Description of problem:
have no introduction to thin and thin-pool table format in dmsetup manpage.

dm-thin is the new feature of F17. thin and thin-pool are the new supported dmsetup table format. So should the introduction to them.

Version-Release number of selected component (if applicable):

How reproducible:

Steps to Reproduce:
1.man dmsetup

Actual results:
have no introduction to thin and thin-pool table format

Expected results:
should include the thin and thin-pool table format introduction.

The introduction is similar to

table format
       supports thin-pool device
       supports thin device

also it's better to provide a example for the thin & thin-pool table format in example section. 

Additional info:

Comment 1 Alasdair Kergon 2012-04-16 19:22:39 UTC
Not mentioning formats in the man page is deliberate.
We will not provide thin/thin-pool examples because we don't expect average users to need this and it's really got nothing to do with dmsetup anyway.  (Should be man -s4).

Comprehensive format information is supposed to be provided in /usr/share instead (take from doc/kernel in the source tree) and there should be a link to this in the dmsetup man page.

Comment 2 Alasdair Kergon 2012-04-16 19:32:49 UTC
(IOW Eventually we might write man pages documenting the dm ioctls in full, but that will involve a lot of work.  In the mean time, lots of target-specific information is already present in documentation files in the source tree and we intended for those to be shipped with the package and discussed patching the spec file to do this, but didn't get around to doing this yet.)

Comment 3 Fedora End Of Life 2013-07-04 06:27:42 UTC
This message is a reminder that Fedora 17 is nearing its end of life.
Approximately 4 (four) weeks from now Fedora will stop maintaining
and issuing updates for Fedora 17. It is Fedora's policy to close all
bug reports from releases that are no longer maintained. At that time
this bug will be closed as WONTFIX if it remains open with a Fedora 
'version' of '17'.

Package Maintainer: If you wish for this bug to remain open because you
plan to fix it in a currently maintained version, simply change the 'version' 
to a later Fedora version prior to Fedora 17's end of life.

Bug Reporter:  Thank you for reporting this issue and we are sorry that 
we may not be able to fix it before Fedora 17 is end of life. If you 
would still like  to see this bug fixed and are able to reproduce it 
against a later version  of Fedora, you are encouraged  change the 
'version' to a later Fedora version prior to Fedora 17's end of life.

Although we aim to fix as many bugs as possible during every release's 
lifetime, sometimes those efforts are overtaken by events. Often a 
more recent Fedora release includes newer upstream software that fixes 
bugs or makes them obsolete.

Comment 4 Fedora End Of Life 2013-08-01 18:02:10 UTC
Fedora 17 changed to end-of-life (EOL) status on 2013-07-30. Fedora 17 is 
no longer maintained, which means that it will not receive any further 
security or bug fix updates. As a result we are closing this bug.

If you can reproduce this bug against a currently maintained version of 
Fedora please feel free to reopen this bug against that version.

Thank you for reporting this bug and we are sorry it could not be fixed.

Comment 5 Peter Rajnoha 2013-08-05 08:08:33 UTC
Reopening and changing the version to "rawhide". Let's have a look at this once there's more time for this...