block/rbd: add deprecation documentation for filename keyvalue pairs
Signed-off-by: Jeff Cody <jcody@redhat.com> Message-id: 647f5b5ab7efd8bf567a504c832b1d2d6f719b23.1536704901.git.jcody@redhat.com Signed-off-by: Jeff Cody <jcody@redhat.com>
This commit is contained in:
		
							parent
							
								
									66e6a735e9
								
							
						
					
					
						commit
						3bebd37e04
					
				@ -128,6 +128,21 @@ used instead.
 | 
				
			|||||||
In order to prevent QEMU from automatically opening an image's backing
 | 
					In order to prevent QEMU from automatically opening an image's backing
 | 
				
			||||||
chain, use ``"backing": null'' instead.
 | 
					chain, use ``"backing": null'' instead.
 | 
				
			||||||
 | 
					
 | 
				
			||||||
 | 
					@subsubsection rbd keyvalue pair encoded filenames: "" (since 3.1.0)
 | 
				
			||||||
 | 
					
 | 
				
			||||||
 | 
					Options for ``rbd'' should be specified according to its runtime options,
 | 
				
			||||||
 | 
					like other block drivers.  Legacy parsing of keyvalue pair encoded
 | 
				
			||||||
 | 
					filenames is useful to open images with the old format for backing files;
 | 
				
			||||||
 | 
					These image files should be updated to use the current format.
 | 
				
			||||||
 | 
					
 | 
				
			||||||
 | 
					Example of legacy encoding:
 | 
				
			||||||
 | 
					
 | 
				
			||||||
 | 
					@code{json:@{"file.driver":"rbd", "file.filename":"rbd:rbd/name"@}}
 | 
				
			||||||
 | 
					
 | 
				
			||||||
 | 
					The above, converted to the current supported format:
 | 
				
			||||||
 | 
					
 | 
				
			||||||
 | 
					@code{json:@{"file.driver":"rbd", "file.pool":"rbd", "file.image":"name"@}}
 | 
				
			||||||
 | 
					
 | 
				
			||||||
@subsection vio-spapr-device device options
 | 
					@subsection vio-spapr-device device options
 | 
				
			||||||
 | 
					
 | 
				
			||||||
@subsubsection "irq": "" (since 3.0.0)
 | 
					@subsubsection "irq": "" (since 3.0.0)
 | 
				
			||||||
 | 
				
			|||||||
		Loading…
	
	
			
			x
			
			
		
	
		Reference in New Issue
	
	Block a user